mcp_knowledge library

MCP Knowledge — orchestration facade for the MakeMind knowledge stack.

0.2.0 redesign per REDESIGN-PLAN.md Phase 8:

Orchestrator only. mcp_knowledge defines no ports of its own. It composes the runtimes provided by mcp_fact_graph, mcp_skill, mcp_profile, mcp_philosophy, and mcp_knowledge_ops, and exposes them through thin facades.
Standard ports only. All consumed capabilities are the capability-named standard ports defined in mcp_bundle. No consumer-sliced legacy ports remain.
No bridges. The six legacy bridge/ files were deleted — consumers query the standard ports directly.
No raw-accessor adapters. The five legacy adapters/ files were deleted; the runtimes expose their adapters themselves.

Quick start (scenario G — full orchestration)

import 'package:mcp_knowledge/mcp_knowledge.dart';

final factGraph = FactGraphRuntime.inMemory();
await factGraph.initialize();

final system = KnowledgeSystem(
  config: KnowledgeConfig.defaults,
  ports: KnowledgePorts(
    facts: factGraph.facts,
    claims: factGraph.claims,
    // ... other capabilities
    llm: StubLlmPort(),
    mcp: const StubMcpPort(),
  ),
  factGraph: factGraph,
  // skillRuntime: ...
  // profileRuntime: ...
  // philosophyEngine: ...
  // opsRuntime: ...
);

final result = await system.profile.apply('p1', entityId: 'e1');

Scenario H — partial orchestration

final system = KnowledgeSystem(
  config: KnowledgeConfig.defaults,
  factGraph: factGraph,
  skillRuntime: skillRuntime,
  // philosophyEngine and opsRuntime intentionally omitted
);

Classes

AbsolutePeriod: Absolute period - a fixed date range.
ActionConfig: Action step configuration.
ActionContext: Context for action execution.
ActionExecutionContext: Action execution context.
ActionHandlerPort: Port for external action handlers.
ActionResult: Action execution result.
ActionType: Step action type constants.
AggregateResult: Aggregation result.
AggregationConfig: Configuration for aggregating multiple metrics.
Alert: Alert instance.
AlertAction: Alert action definition.
AlertCondition: Alert condition definition.
AlertManager: Alert manager for managing alert rules and evaluating alerts.
AlertRule: Alert rule definition.
AllSuccessMerge: All branches must succeed; aggregate by type.
AlwaysTrueCondition: A condition that always evaluates to true (for default case).
AnySuccessMerge: N of M branches must succeed.
AppliedIntervention: Individual intervention applied during pipeline processing.
AppraisalCacheConfig: Configuration for caching appraisal port behavior.
AppraisalEngine: Engine for computing appraisal metrics at runtime.
AppraisalEnginePort: Engine contract for appraisal metric computation.
AppraisalMetadata: Metadata about the appraisal computation.
AppraisalMetricDef: Definition of an appraisal metric.
AppraisalPort: Port for appraisal operations over profile dimensions.
AppraisalPortAdapter: Adapter implementing bundle.AppraisalPort.
AppraisalResult: Complete result of appraisal metric computation.
AppraisalSection: Section defining metrics and their aggregation.
ApprovalCompletedEvent: Approval completed event.
ApprovalDecision: Individual approval decision.
ApprovalEvent: Event emitted when approval status changes.
ApprovalPort: Port for requesting and managing approvals.
ApprovalRecord: Historical approval record.
ApprovalRequest: Approval request details.
ApprovalRequestedEvent: Approval requested event.
ApprovalResult: Result of an approval request.
ApprovalRouter: Routes approval requests to appropriate approvers.
ApprovalRoutingRequest: Request for approval routing resolution.
ApprovalRoutingRules: Configuration for approval routing rules.
ApprovalTimeoutConfig: Configuration for approval timeout behavior.
ApproverSpec: Specification for an approver or approver group.
ArrayExpr: Array literal (e.g., [1, 2, 3]).
Artifact: Generated artifact from skill execution.
ArtifactFormat: Common artifact formats.
ArtifactQuery: Query for artifacts.
ArtifactStoragePort: Port for artifact storage operations. Reference: Design Section 2.11 - Run artifacts
Asset: Asset (embedded file/data).
AssetPort: Port for asset retrieval.
AssetPortAdapter: Implements bundle.AssetPort on top of ArtifactStoragePort.
AstNode: Base class for all AST nodes.
AudienceConfig: Configuration for audience adaptation.
AudiencePreferences: Audience preferences.
AuditActor: Actor who performed the audited operation.
AuditContext: Contextual information for an audit event.
AuditEntry: Audit entry for tracking candidate changes. Reference: Design Section 2.3 - AuditEntry
AuditEvent: A recorded audit event capturing an operation performed in the system.
AuditFilter: Filter criteria for querying audit events.
AuditPort: Port for audit event recording.
AuditPortAdapter: Adapter wrapping an internal AuditRecorder to expose the standard port.AuditPort contract.
AuditRecorder: Abstract audit recorder interface.
AuditResource: Resource targeted by the audited operation.
Author: Author information.
Automation: Automation defines scheduled or triggered actions.
AutomationQuery: Query for automations.
AutomationStoragePort: Port for automation storage operations. Reference: Design Section 2.10
BehaviorAction: An action a step performs — a tool or skill invocation. The engine itself does not run it; a host-supplied dispatcher does.
BehaviorEngine: The engine.
BehaviorRunnable: Binds a BehaviorEngine to a definition's steps so it can be run or resumed by id.
BehaviorRunState: Persisted snapshot of a run.
BehaviorStep: A single behavior step.
BestEffortMerge: Best-effort merge with partial failure handling.
BinaryExpr: Binary operation (e.g., a + b, a * b).
BooleanNormalization: Boolean normalization: converts truthy/falsy to 1.0/0.0. Threshold determines the boundary (default: 0.5). Values >= threshold → 1.0, values < threshold → 0.0.
BranchBudget: Pre-allocated budget for a specific branch.
BranchContext: Branch-specific context wrapper with state isolation.
BranchMerger: Merges results from parallel branches.
BranchResult: Result from a single parallel branch.
BranchSpec: Specification for a parallel branch.
BudgetAllocationStrategy: Budget allocation strategy for parallel branches.
BudgetCheckResult: Budget check result.
BudgetCost: Budget cost estimate for an operation.
BudgetReservation: Reservation handle for budget.
BudgetTracker: Budget tracker for monitoring execution resource usage.
BudgetUsage: Budget usage snapshot at a point in time.
BundleBudget: BundleBudget defines constraints for context generation.
BundleBuildInput: Input for the bundle build workflow.
BundleBuildOutput: Output of the bundle build workflow.
BundleBuildWorkflow: Workflow for assembling and publishing bundles.
BundleComponents: Components to include in the bundle build.
BundleIntegrity: Integrity information for a built bundle.
BundleLoadedEvent: Bundle loaded event.
BundleLoader: Abstract loader for skill bundles.
BundlePublishedEvent: Emitted when a bundle is published.
BundleRubric: Rubric definition for evaluation.
BundleValidationError: A single validation error or warning.
BundleValidationResult: Validation result for a bundle.
BundleValidator: Abstract bundle validator.
CacheConfig: Cache configuration hints.
CachedGraphStorage: Cached graph storage wrapper.
CachingAppraisalEnginePort: AppraisalEnginePort decorator that adds caching.
CallExpr: Function call (e.g., length(str)).
CancellationAuditEvent: Audit event for cancellation tracking.
CancellationExecutor: Executes cancellation with 5 phases: halt, rollback, cleanup, notify, audit.
CancellationReason: Reason for workflow cancellation.
CancellationRequest: Request to cancel a running workflow.
CancellationResult: Result of the full cancellation process.
Candidate: Candidate represents an assembled fact/event pending confirmation.
CandidateCreatedEvent: Candidate created event.
CandidateDeduplicator: Content-hash deduplicator for candidate records.
CandidateField: A field in a candidate with value and confidence.
CandidateQuery: Query for candidates.
CandidateRecord: Canonical candidate record.
CandidatesPort: Port for candidate fact operations.
CandidatesPortAdapter: Implements bundle.CandidatesPort on top of FactGraphService and CandidateStoragePort.
CandidateStoragePort: Port for candidate storage operations.
CandidateSummaryInfo: Summary of a created candidate.
Capability: A capability that a profile can have.
CapabilityBuilder: Fluent builder for creating capabilities.
CapabilityComposer: Composes capabilities from multiple skills.
CapabilityConflict: A conflict between capabilities.
CapabilityRouter: Capability-based router - routes based on skill capabilities.
CaretConstraint: Caret constraint (^x.y.z).
CascadeRefreshExecutor: Cascade refresh executor using topological sort (Kahn's algorithm) for determining refresh order of dependent summaries.
CascadeRefreshRequest: Request parameters for a cascade refresh execution.
CascadeRefreshResult: Result of a cascade refresh execution.
CausalOrderEnforcer: Causal order enforcer that ensures happens-before relationships.
CausalOrderingContract: Causal ordering contract for happens-before relationships.
ChainConfig: Configuration for chain execution mode.
ChainExecutor: Executes skills sequentially, passing outputs as inputs to the next skill.
ChainResult: Result from chain execution.
ChainStepResult: A single step in a chain execution.
ChannelDeliveryResult: Delivery result for a specific channel.
Checkpoint: Checkpoint for resumable execution.
CheckpointCreatedEvent: Emitted when a checkpoint is created during execution.
CheckpointManager: Checkpoint manager interface for persistence operations.
CheckpointRestoredEvent: Emitted when a checkpoint is restored during recovery.
CheckResult: Result of a step pre/post check.
CircuitBreaker: Circuit breaker for failing services.
CircuitBreakerConfig: Configuration for circuit breaker behavior.
CircuitBreakerListener: Listener for circuit breaker state changes.
CircuitBreakerRegistry: Registry for managing multiple circuit breakers.
CircuitBreakerStats: Circuit breaker statistics.
Claim: A verifiable assertion - the single canonical type for all packages.
ClaimExtractionConfig: Claim extraction configuration.
ClaimExtractor: Claim extractor with all strategies implemented.
ClaimFeatures: Features extracted from a claim for pattern mining. Reference: Design Section 2.15.3.2 - ClaimFeatures.
ClaimQuery: Query descriptor for ClaimsPort.queryClaims.
ClaimSignal: ClaimSignal represents a signal from claim validation for pattern mining.
ClaimsPort: Port for claim operations.
ClaimsPortAdapter: Implements bundle.ClaimsPort on top of ContextService and ContextStoragePort.
ClaimsRecordedEvent: Claims recorded event.
ClaimValidationEntry: Single-claim validation entry.
ClaimValidationReport: Aggregate validation report.
Classification: Classification represents operational categorization applied to targets.
ClassificationQuery: Query for classifications.
ClassificationStoragePort: Port for classification storage operations. Reference: Design Section 2.7
ClassifierMemory: ClassifierMemory stores successful classification decisions for pattern matching.
ClassifierMemoryQuery: Query for classifier memories.
ClassifierMemoryStoragePort: Port for classifier memory storage operations. Reference: Design Section 2.12.3
CleanupResult: Result of resource cleanup.
Clock: Clock abstraction for testability.
Cluster: A cluster of similar signals.
ClusteringParams: Top-level clustering configuration combining algorithm choice, parameters, and optional dimension reduction.
CodeComplexityExtractor: Code complexity extractor.
CompatConfig: Compatibility requirements for a profile.
CompensationAction: Action to perform for compensation.
CompensationConfig: Configuration for compensation behavior during cancellation.
CompensationFailure: Record of a compensation failure for a specific stage.
CompensationResult: Result of compensation execution.
CompetitionConfig: Configuration for competition execution mode.
CompetitionExecutor: Executes skills in parallel and selects the best result.
CompetitionResult: Result from competition execution.
CompetitorOutcome: Outcome of a single competitor in competition mode.
CompileTimeVerifier: Compile-time capability verification.
CompositeCapabilities: Composed capabilities from multiple skills.
CompositeCondition: Composite condition combining multiple conditions.
CompositeHook: Composite hook - combines multiple hooks.
CompositeRouter: Composite router - tries multiple routing strategies in sequence.
CompositeTrigger: Composite trigger that combines multiple triggers.
ComputationMeta: Computation metadata.
ComputedSource: Source that computes metric from other metrics using expression.
ConcurrentEvaluationConfig: Configuration for concurrent policy evaluation.
ConditionalExpr: Conditional/ternary (e.g., a ? b : c).
ConditionalRouter: Conditional router - routes based on conditions.
ConditionConfig: Condition step configuration.
ConditionDetail: Detail about a single condition.
ConditionEvaluationResult: Result of evaluating a single policy condition.
ConditionResult: Individual condition evaluation result.
ConfidenceThresholdConfig: Configuration for confidence threshold behavior in appraisal.
ConfirmationResult: Result of confirming a candidate.
Conflict: Conflict detected during execution.
ConflictDetector: Detects conflicts between capability declarations.
ConflictPath: A path showing how a conflict arose.
ConflictReport: Report describing the detected conflict.
ConflictResolution: Conflict resolution configuration for Ethos merging.
ConflictResolver: Resolves value conflicts between two priorities.
ConsistencyChecker: Detects duplicate factId and triple conflicts before a write.
ConsoleLogSink: Console log sink.
ConsumedOpsPorts: Value type holding only the consumed ports (10 required + 7 optional).
ContextBudget: Budget constraints for a context bundle.
ContextBuildingService: Service that builds SkillContext optionally enriched via a ContextBundlePort.
ContextBundle: Context bundle from FactGraph for skill execution.
ContextBundlePort: Port for context bundle construction.
ContextBundlePortAdapter: Implements bundle.ContextBundlePort on top of ContextService.
ContextBundleQuery: Query for context bundles.
ContextBundleRequest: Request for ContextBundlePort.buildContextBundle.
ContextClaim: Claim from context.
ContextEntity: Entity from context.
ContextEvent: Event from context.
ContextHasher: Helper for generating context hash.
ContextModification: Context modification.
ContextService: Service for L2 ContextOps Layer operations.
ContextState: Mutable state container for skill execution.
ContextStoragePort: Port for context storage operations.
ContextView: View/summary from context.
ControlSignal: The signal a handler returns to drive the engine loop.
CronTrigger: Cron-based trigger.
CurationFilters: Filters for narrowing the curation scope.
CurationInput: Input for curation pipeline.
CurationOutput: Output of curation pipeline.
CurationPipeline: Pipeline for curating candidates into facts.
CustomMerge: Custom merge via external reference.
CustomNormalization: Custom normalization using expression. Expression should contain 'value' variable and return 0-1.
Dashboard: Dashboard configuration model.
DashboardPanel: A single panel on a dashboard.
DashboardVariable: Dashboard variable for dynamic filtering.
DataPermission: Permission for data access.
DateRange: Helper class for resolved date ranges.
DateTimeRange: A time range with start and end.
DBSCANParams: DBSCAN parameters per spec section 7.1.
DeadLetterQueue: Dead letter queue for managing failed events.
DeadlineApproachingEvent: Emitted when an execution is approaching its deadline.
DeadlineProvider: Provider for deadline information.
DeadlineSource: Describes where deadline data comes from.
DeadlineTrigger: Deadline-aware trigger.
DecisionBranch: Decision branch for decision actions.
DecisionEnginePort: Engine contract for decision policy evaluation.
DecisionGuidance: Guidance returned when a policy condition matches.
DecisionModifier: Additional modifier for a decision.
DecisionPolicy: A single decision policy.
DecisionPolicyEvaluator: Evaluator that matches policies against appraisal results.
DecisionPolicySection: Section containing decision policies.
DecisionPort: Port for decision evaluation.
DecisionPortAdapter: Adapter implementing bundle.DecisionPort.
DecisionResult: Decision result wrapper type per design/02-ports.md §6. Wraps DecisionGuidance with evaluation metadata for downstream consumers.
DefaultBranchMerger: Default implementation of branch result merging.
DefaultBundleLoader: Default bundle loader implementation.
DefaultBundleValidator: Default bundle validator implementation.
DefaultDecisionEnginePort: Default sequential evaluator backed by condition matching.
DefaultEthosSeeder: Seeds a default ethos into an EthosStorePort when the store is empty.
DefaultPolicyConditionEvaluator: Default condition evaluator using PolicyCondition's built-in evaluate method.
DefaultRetryPolicy: Default retry policy for event handlers.
DefaultRubricEvaluationEngine: Default implementation of RubricEvaluationEngine.
DefaultRuntimeContext: Default implementation of RuntimeProfileContext.
DelegateeRestriction: Restriction on valid delegatees.
DelegationPolicy: Policy governing delegation behavior.
DelegationRequest: Request to delegate an approval to another person.
DelegationResult: Result of a delegation attempt.
DependencyAuditExtractor: Dependency audit extractor.
DependencyEdge: A dependency edge in the graph.
DependencyFailed: Cancellation due to a dependency failure.
DependencyGraph: Complete dependency graph.
DependencyNode: A node in the dependency graph.
DependencyResolverService: Main service interface for dependency resolution.
DependencyTree: Tree representation of dependencies for display.
DimensionMeasurement: Measurement for a single dimension.
DimensionReductionConfig: Dimension reduction configuration for high-dimensional signal data.
DimensionScore: Score for a single dimension.
DirectionalAttitude: Fundamental posture toward a domain.
DisambiguationDecision: DisambiguationDecision stores explicit user decisions for future automatic resolution.
DlqOrderingAction: Send event to dead letter queue.
DlqProcessResult: Result of processing a dead letter entry.
DocumentationExtractor: Documentation extractor.
DuringGenerationResult: During-generation intervention result.
EmptyConstraint: Constraint that allows no versions.
EmptyLlmPort: Empty LLM port that throws on use.
EnginePorts: Container for the three internal engine contracts plus the optional consumed standard ports (FactsPort/PatternsPort/SummariesPort/LlmPort).
EngineResult: Result of a run / resume.
EntitiesPort: Port for entity operations in the fact graph.
EntitiesPortAdapter: Implements bundle.EntitiesPort on top of FactGraphService + EntityStoragePort + RelationStoragePort.
Entity: Entity represents a resolved real-world object in the fact graph.
EntityLink: Entity link for candidate. Reference: Design Section 2.3 - EntityLink
EntityQuery: Query descriptor for EntitiesPort.queryEntities.
EntityRecord: Canonical entity record.
EntityStoragePort: Port for entity storage operations.
EphemeralStateStore: In-memory store — the ephemeral profile. A suspended run survives only for the process lifetime.
EqualSplitAllocation: Divide budget evenly among all branches.
ErrorAggregator: Collects errors from parallel execution.
ErrorContext: Rich error context for debugging.
ErrorLogger: Error logger interface (adapter pattern).
ErrorResponse: Standardized error response for API surfaces.
EscalationAction: Action to take at an escalation threshold.
EscalationConfig: Escalation configuration for deadline triggers.
EscalationLevel: A single escalation level definition.
EscalationPolicy: Policy for escalating unresolved approvals.
EscalationThreshold: Threshold at which escalation is triggered.
Ethos: Root philosophy definition containing all components.
EthosMetadata: Version, author, timestamps, context metadata for an Ethos.
EthosRecord: Canonical ethos record.
EthosScope: Domain-specific applicability scope for an Ethos.
EthosStorePort: Port for ethos storage.
EvaluationConfig: Configuration for skill evaluation.
EvaluationInput: Typed evaluation input snapshot. Reference: Design Section 2.16.5 - EvaluationInput.
EvaluationOutput: Typed evaluation output snapshot. Reference: Design Section 2.16.5 - EvaluationOutput.
EvaluationResult: Result of a single evaluation set run.
EvaluationRun: EvaluationRun represents a deterministic evaluation execution.
EvaluationRunQuery: Query for evaluation runs.
EventBatchConfig: Batch configuration for event triggers.
EventBusConfig: Event bus configuration.
EventCircuitBreaker: Circuit breaker for event handlers.
EventCircuitState: Circuit breaker state for a handler.
EventConfig: Event configuration.
EventDebounceConfig: Debounce configuration for event triggers.
EventFilter: Structured filter for event triggers.
EventMetricNames: Standard metric names for the event system.
EventMetrics: Metrics collection for the event system.
EventPersister: Persist events to KvStoragePort after publishing via EventPort.
EventPort: Event port for pub/sub.
EventPortConfig: EventPort adapter configuration.
EventPublisher: Abstract event publisher contract.
EventReplayer: Replays persisted events for execution recovery and debugging.
EventRouter: Routes incoming OpsEvent instances to matching registered handlers.
EventStorageKeys: Key conventions for event persistence in KvStoragePort.
EventStreams: Logical stream identifiers for event grouping.
EventSubscriber: Abstract event subscriber contract.
EventTracing: Distributed tracing integration for events.
EventTrigger: Event-driven trigger.
Evidence: Evidence represents the original, immutable input data.
EvidenceFragment: Evidence fragment.
EvidencePort: Port for evidence extraction operations.
EvidencePortAdapter: Implements bundle.EvidencePort with heuristic fallbacks.
EvidenceQuery: Query for evidence.
EvidenceReference: Reference to evidence used in verification.
EvidenceService: Service for L0 Evidence Layer operations.
EvidenceStoragePort: Port for evidence storage operations.
EvolutionProposal: Proposed change to an Ethos based on feedback patterns.
EvolutionProposedEvent: Evolution proposed event.
EvolutionRecord: A record of an evolution event for audit and history.
ExecutionBudget: Execution budget constraints.
ExecutionBudgetConfig: Execution budget configuration (mirrors mcp_skill ExecutionBudget).
ExecutionCancelledEvent: Emitted when an execution is cancelled.
ExecutionCompletedEvent: Emitted when an execution completes (successfully or not).
ExecutionConfig: Execution configuration.
ExecutionContext: Context passed through execution stages.
ExecutionEngine: Central execution coordinator.
ExecutionEngineConfig: Execution engine configuration.
ExecutionError: A single execution error with context.
ExecutionEvent: Base execution event.
ExecutionEventListener: Execution event listener with individual callback methods.
ExecutionFailedEvent: Emitted when an execution fails.
ExecutionFilter: Filter criteria for listing executions.
ExecutionLimits: Execution limits for expression evaluation security.
ExecutionLogger: Execution logger with additional methods for pipeline/workflow lifecycle.
ExecutionManager: Manages execution lifecycle for scheduled tasks.
ExecutionMetadata: Execution metadata.
ExecutionMetrics: Performance metrics for an execution.
ExecutionPlan: Execution plan for selected skills.
ExecutionQueue: Priority-ordered execution queue.
ExecutionQueuedEvent: Emitted when an execution is added to the queue.
ExecutionRequest: Request to enqueue an execution.
ExecutionResult: Result of skill execution.
ExecutionResumedEvent: Execution resumed event.
ExecutionRetryEvent: Emitted when an execution is retried.
ExecutionRolledBackEvent: Emitted when an execution is rolled back.
ExecutionStartedEvent: Emitted when an execution begins running.
ExecutionStateMachine: Valid state transitions for the execution state machine.
ExecutionTarget: Execution target definition.
ExecutionTrace: Execution trace for debugging.
ExpressionCondition: Complex condition using expression language.
ExpressionEnginePort: Engine contract for expression formatting and condition evaluation.
ExpressionError: Expression evaluation error.
ExpressionEvaluationContext: Context for expression evaluation with 9 root objects.
ExpressionEvaluator: Expression evaluator for conditions and mappings.
ExpressionHandlerAdapter: Adapter for expression-based handlers.
ExpressionInterpolator: Interpolates template strings using the full expression evaluation context.
ExpressionPolicy: A single expression policy.
ExpressionPolicyEvaluator: Evaluator that matches expression policies and applies styles.
ExpressionPolicySection: Section containing expression policies.
ExpressionPort: Port for expression/template formatting operations.
ExpressionPortAdapter: Adapter implementing mcp_bundle's bundle.ExpressionPort.
ExpressionResult: Result of expression policy evaluation.
ExpressionResultMetadata: Metadata about expression evaluation.
ExpressionStyle: Complete expression style configuration.
ExpressionStyleFormatter: Formatter that applies expression style to raw content.
ExtractionRule: ExtractionRule stores patterns for extracting fields from evidence without LLM.
ExtractionRuleQuery: Query for extraction rules.
ExtractionRuleStoragePort: Port for extraction rule storage operations. Reference: Design Section 2.12.1
ExtractionValidator: ExtractionValidator defines validation rules for extracted facts.
ExtractionValidatorQuery: Query for extraction validators.
ExtractionValidatorStoragePort: Port for extraction validator storage operations. Reference: Design Section 2.12.2
ExtractorConfig: Configuration for measurement extraction.
Fact: Fact represents a confirmed fact in the fact graph.
FactCluster: FactCluster groups multiple Facts that represent the same real-world occurrence.
FactClusterAuditEntry: Audit entry for cluster operations.
FactClusterQuery: Query for fact clusters.
FactClusterStoragePort: Port for fact cluster storage operations. Reference: Design Section 2.6.1
FactConfirmedEvent: Fact confirmed event.
FactEdge: An edge connecting two nodes in the fact graph.
FactFacade: Thin facade over the fact-graph standard ports.
FactGraph: A graph structure for storing and querying facts.
FactGraphConfig: FactGraph configuration.
FactGraphEventIntegration: Integration between events and fact-graph operations.
FactGraphRuntime: Phase 2 composition root for mcp_fact_graph.
FactGraphService: Service for L1 FactGraph Layer operations.
FactGraphSource: Source that queries FactGraph for facts/events and computes metric.
FactGraphUpdatedEvent: Emitted when a fact graph entity is created, updated, or deleted.
FactNode: A node in the fact graph representing a piece of knowledge.
FactPolicy: FactPolicy defines rules for classification, evaluation, and settlement.
FactQuery: Query descriptor for FactsPort.queryFacts.
FactRecord: Canonical fact record used by FactsPort.
FactSource: Source information for a fact.
FactsPort: Port for fact graph fact operations.
FactsPortAdapter: Implements the capability port bundle.FactsPort on top of FactGraphService and FactStoragePort.
FactStoragePort: Port for fact storage operations.
FactSummary: Summary of a promoted fact.
FailFastPolicy: Cancel all branches on first error.
FailSlowPolicy: Wait for all branches, then report errors.
FallbackHandler<T>: Handler for fallback operations.
FallbackRecovery: Fallback recovery: try alternative implementations in order.
FeatureAvailability: Feature availability based on degradation level.
FeatureFlags: Feature flags.
FeatureVector: Feature vector for pattern mining.
FeedbackEvent: Action result feedback for philosophy evolution.
FilterCondition: Structured filter condition for event filtering.
Finding: Finding from rubric evaluation.
FirstAvailableAllocation: Shared pool allocation — first-come, first-served.
FirstMatchResolver: First match resolver.
FixedClock: Fixed clock for deterministic tests.
FixedRouter: Fixed router - always returns the same skills.
FormatConfig: Configuration for response format.
FormattedResponse: Formatted response from expression processing.
Fragment: Fragment represents an extracted piece of data from evidence.
FragmentSummary: Summary of an extracted fragment.
FunctionHandler: Function-based handler for simple cases.
FunctionRegistry: Registry of functions available in expressions.
Gate: Quality gate definition.
GateCheck: Record of a quality gate check.
GateCondition: Gate condition.
GateConditionResult: Result of evaluating a single gate condition.
GateEvaluatedEvent: Gate evaluated event.
GateEvaluationResult: Structured result of a gate evaluation.
GateEvaluator: Evaluates quality gates.
GateResult: Gate evaluation result.
GenerationContext: Context for artifact generation (for reproducibility).
GrammarConfig: Grammar configuration.
GraphEdge: An edge in the FactGraph connecting entities.
GraphQuery: A fluent query builder for fact graphs.
GraphStorage: Abstract interface for graph storage.
GroupingExpr: Grouping/parenthesized expression.
GuardEvaluator: Evaluates guard expressions over a state map.
HaltResult: Result of halting running stages.
HandlerConfig: Handler execution configuration.
HandlerContext: Context provided to handlers.
HandlerFilter: Filter for querying handlers.
HandlerInfo: Handler metadata information.
HandlerRegistrationService: Service for registering and managing stage handlers.
HandlerRegistry: Registry of stage handlers.
HDBSCANParams: HDBSCAN parameters per spec section 7.1.
HealthCheck: Health check definition.
HealthChecker: Health checker for running health checks.
HealthCheckResult: Health check result.
HealthReport: Health report containing results from all checks.
HedgingConfig: Configuration for hedging language.
HedgingPhrases: Custom hedging phrases.
HierarchicalParams: Hierarchical clustering parameters per spec section 7.1.
HighestPriorityResolver: Highest priority resolver.
HistogramBucket: Histogram bucket definition.
HistogramMetric: Histogram metric with distribution information.
IdempotencyContract: Idempotency contract for at-least-once delivery.
IdempotencyKeyStrategy: Idempotency key generation strategies.
IdempotencyRecord: IdempotencyRecord prevents duplicate execution of operations.
IdempotentHandler: Idempotent handler wrapper using KvStoragePort for deduplication state. Key convention: "idempotency:{eventId}"
IdentifierExpr: Identifier reference (e.g., inputs, steps).
IndexConfig: Index configuration.
IndexExpr: Index access (e.g., arr[0]).
IndexPort: Port for knowledge index management.
IndexPortAdapter: Implements bundle.IndexPort with an in-memory registry.
IndexRebuildInput: Input for the index rebuild pipeline.
IndexRebuildOutput: Output of the index rebuild pipeline.
IndexRebuildPipeline: Pipeline for rebuilding search indexes.
IngestConfig: Configuration for the ingest pipeline.
IngestInput: Input for the ingest pipeline.
IngestOutput: Output of the ingest pipeline.
IngestPipeline: Pipeline for ingesting content into the fact graph.
IngestSourceInfo: Source metadata for ingest provenance tracking.
InMemoryArtifactStorage: In-memory implementation of ArtifactStoragePort.
InMemoryAuditRecorder: In-memory audit recorder for testing.
InMemoryAutomationStorage: In-memory implementation of AutomationStoragePort.
InMemoryCandidateStorage: In-memory implementation of CandidateStoragePort.
InMemoryCheckpointManager: In-memory checkpoint manager for testing.
InMemoryClassificationStorage: In-memory implementation of ClassificationStoragePort.
InMemoryClassifierMemoryStorage: In-memory implementation of ClassifierMemoryStoragePort.
InMemoryContextStorage: In-memory implementation of ContextStoragePort.
InMemoryEntityStorage: In-memory implementation of EntityStoragePort.
InMemoryEventPort: In-memory event port for testing.
InMemoryEvidenceStorage: In-memory implementation of EvidenceStoragePort.
InMemoryExtractionRuleStorage: In-memory implementation of ExtractionRuleStoragePort.
InMemoryExtractionValidatorStorage: In-memory implementation of ExtractionValidatorStoragePort.
InMemoryFactClusterStorage: In-memory implementation of FactClusterStoragePort.
InMemoryFactStorage: In-memory implementation of FactStoragePort.
InMemoryKvStoragePort: In-memory KV storage for testing.
InMemoryLogSink: In-memory log sink for testing.
InMemoryMetricSink: In-memory metric sink for testing.
InMemoryPackageRegistry: In-memory package registry for testing.
InMemoryPolicyStorage: In-memory implementation of PolicyStoragePort.
InMemoryRelationStorage: In-memory implementation of RelationStoragePort.
InMemoryRubricCache: In-memory rubric cache with TTL.
InMemoryRubricRegistry: In-memory rubric registry.
InMemoryRunStorage: In-memory implementation of RunStoragePort.
InMemorySkillOpsStorage: In-memory implementation of SkillOpsStoragePort.
InMemoryStorageContainer: Container for all in-memory storage implementations.
InMemoryStoragePort<T>: In-memory typed storage for testing.
InMemoryTraceSink: In-memory trace sink for testing.
InMemoryViewStorage: In-memory implementation of ViewStoragePort.
InternalContextBundle: InternalContextBundle represents an internal context bundle for LLM operations.
InterpolationExpr: String interpolation segment.
InterventionEngine: The pipeline intervention engine that applies Philosophy at three stages.
InterventionResult: Result of a pipeline intervention.
InvokeHandler: Invoke a named handler for compensation.
IsolatePolicy: Errors do not affect other branches.
JudgmentCriterion: Conditional decision rule with preferred action.
KMeansParams: K-Means parameters per spec section 7.1.
KnowledgeConfig: System-wide configuration.
KnowledgeEvent: Base class for all knowledge events.
KnowledgeEventBus: Event bus for knowledge system.
KnowledgePorts: Flat container of standard ports consumed by KnowledgeSystem.
KnowledgeSource: Knowledge source configuration.
KnowledgeSystem: Unified knowledge management orchestrator.
KvEthosStoreAdapter: Default EthosStorePort implementation backed by a KvStoragePort.
KvStateStore: Durable store — the runbook profile. Persists each run as JSON through an injected key/value backend, so a suspended run survives process restarts. The backend is supplied as three functions to keep this module free of any specific storage-port dependency; hosts adapt their real KV port.
KvStoragePort: Key-value storage port.
LambdaExpr: Lambda expression (e.g., x => x + 1).
LanguageConfig: Configuration for language and localization.
LiteralExpr: Literal value (number, string, boolean, null).
LLMCallLog: LLMCallLog tracks LLM API calls for optimization and cost analysis.
LLMCallPurpose: LLM call purposes.
LlmCapabilities: LLM capabilities configuration.
LlmChunk: Streaming chunk.
LLMCostAnalytics: LLM cost analytics helper.
LlmDerivedSource: Source that uses LLM for complex analysis.
LlmExtractionExtractor: LLM-based extraction extractor.
LlmHandlerAdapter: Adapter that invokes the LlmPort with a prompt template.
LlmMessage: LLM message for multi-turn conversations.
LlmPort: Abstract LLM Port interface.
LlmRequest: LLM request.
LlmResponse: LLM response.
LlmRouter: LLM-based router - uses LLM to select appropriate skills.
LlmTool: Tool definition for function calling.
LlmToolCall: Tool call from LLM.
LlmUsage: Token usage information.
LockFile: Complete lock file representation.
LockFileDiff: Difference between two lock files.
LockFileEntry: A single package entry in the lock file.
LockFileMetadata: Metadata about lock file resolution.
LockVerification: Result of lock file verification.
LockVerificationIssue: A verification issue.
LogEntry: Log entry.
LogError: Structured error information attached to a log entry.
Logger: Base logger providing structured logging with context propagation.
LoggerConfig: Logger configuration.
LoggingConfig: Logging configuration.
LoggingHook: Logging hook - logs events to console/logger.
LogicalExpr: Logical operation (e.g., a && b, a || b).
LogNormalization: Logarithmic normalization: log(value + 1) / scale, clamped to 0, 1.
LogSampling: Log sampling configuration.
LogSink: Log sink interface.
LoopConfig: Loop step configuration.
ManualExtractor: Manual measurement extractor (passthrough).
ManualTrigger: Manual trigger.
MatchedCriterion: Matched judgment criterion result.
McpBundle: Placeholder representing an assembled MCP bundle artifact.
McpPort: Port for Model Context Protocol operations.
McpToolHandlerAdapter: Adapter that invokes an MCP tool via the standard McpPort.
MeasurementExtractor: Base class for measurement extractors.
MeasurementExtractorRegistry: Registry for measurement extractors.
MeasurementSource: Source of a measurement.
MemberExpr: Member access (e.g., obj.field or obj?.field).
MemoryGraphStorage: In-memory graph storage.
MemorySkillRegistry: In-memory implementation of SkillBundleRegistry.
MergeResolver: Merge resolver.
MergeResult: Merged result from all parallel branches.
MergeStackingPolicy: Merge all profiles into one combined profile.
MergeStrategy: Strategy for merging parallel branch results.
Metric: Metric data point.
MetricCacheConfig: Configuration for the metric caching service.
MetricCacheEntry: A cached metric computation result.
MetricCachingService: Three-level metric caching service.
MetricComputeResult: Internal computation result carrier (pre-normalization output).
MetricEvent: Metric event for streaming.
MetricPort: Metric computation port.
MetricQueryExtractor: Metric query extractor.
MetricResult: Result for a single computed metric.
MetricResultConverter: Utility for converting compute results to output MetricResults.
MetricsCollector: Metrics collector.
MetricsConfig: Metrics collection configuration.
MetricsHook: Metrics hook - tracks performance metrics.
MetricSink: Metric sink interface.
MetricSource: Definition of how to compute a metric value.
MetricSpec: Specification for on-demand metric computation.
MetricsPort: Port for evaluation metric operations.
MetricsPortAdapter: Adapter implementing bundle.MetricsPort.
MetricTimer: Metric timer.
MetricTrendAnalysis: Analysis of metric trends over time.
MetricValue: Metric value.
MigrationInfo: Migration information for a profile version per §2.
MigrationResult: Result of a migration operation.
MigrationScriptRunner: Interface for running migration scripts per §4.
MigrationStep: A single step in a migration path.
MiningStatistics: Mining statistics.
MinMaxNormalization: MinMax normalization: scale value from min, max to 0, 1.
MonitoringConfig: Monitoring and observability configuration for the event system.
MostRestrictiveResolver: Most restrictive resolver.
MultiLayerContext: Multi-layer context for tension detection.
MultiLogSink: Multi-sink that writes to multiple sinks.
MultiSkillConfig: Configuration for multi-skill execution.
MultiSkillResult: Result from multi-skill execution.
MultiSkillRuntime: Unified runtime for multi-skill execution.
NoOp: No compensation action needed.
NoOpApplicationHook: No-op hook for default behavior.
NoOpCircuitBreakerListener: Default no-op listener.
NormalizationConfig: Configuration for normalizing raw metric values to 0-1 range.
Notification: Notification to send.
NotificationEventHandlers: Notification handlers triggered by events.
NotificationPort: Port for sending notifications.
NotificationRecord: Historical notification record.
NotificationResult: Result of sending a notification.
NotificationSentEvent: Emitted when a notification is sent.
NullCoalesceExpr: Null coalescing (e.g., a ?? b).
ObjectEntry: Key-value pair in object literal.
ObjectExpr: Object literal (e.g., {key: value}).
OpenQuestion: OpenQuestion represents an unresolved item requiring attention.
OpsEvent: Rich event model for knowledge ops.
OpsEventMeta: Metadata attached to every ops event for tracing and provenance.
OpsEventPublisher: Concrete publisher that enriches events with trace context and publishes through the EventPort.
OpsEventSubscriber: Concrete subscriber that converts PortEvent streams into OpsEvent streams with managed subscriptions.
OpsFacade: Thin facade over OpsRuntime / standard ops ports.
OpsPorts: Aggregated port container for mcp_knowledge_ops.
OpsRuntime: High-level facade that assembles the execution engine, scheduler, runbook executor, audit recorder, and the five provided-port adapters.
OrderingAction: Action to take when an ordering violation is detected.
OrderingGuarantees: Declares the ordering and delivery guarantees for an event stream.
OrderingViolation: Describes an ordering violation.
OrderingViolationHandler: Handles ordering violations gracefully.
OutcomeContext: Context passed to an outcome handler.
OutcomeRegistry: Open registry of outcome handlers. Resolution supports a name:arg form so a single handler can be parameterized (e.g. goto:<id>).
OutputMapping: Maps output of one skill to input of the next.
OutputSpec: Output specification for a skill.
PackageChange: A package addition or removal.
PackageDowngrade: A package version downgrade.
PackageId: Unique identifier for a package.
PackageRef: Reference to a package with version constraint.
PackageRegistry: Interface for package registries.
PackageSpec: Specification of a package's dependencies.
PackageUpgrade: A package version upgrade.
PanelPosition: Grid position for a dashboard panel.
PanelQuery: Query definition for a dashboard panel.
ParallelConfig: Configuration for parallel execution mode.
ParallelContextFactory: Factory for creating isolated branch contexts from a parent context.
ParallelErrorPolicy: Error handling policy for parallel execution.
ParallelExecutionConfig: Configuration for parallel execution.
ParallelExecutor: Executes skills in parallel with configurable aggregation.
ParallelOutcome: Outcome of a single skill in parallel execution.
ParallelPolicyEvaluator: Evaluates policies concurrently with configurable batching and conflict resolution per design/06-concurrency.md §3.
ParallelResult: Result from parallel execution.
ParallelStageExecutor: Executes stages in parallel with concurrency control.
Parameter: A parameter definition for skill inputs.
Parser: Parses tokens into an AST.
PassthroughExpressionEnginePort: Identity engine port: returns content unchanged.
PassthroughNormalization: Passthrough normalization: value is already in 0-1 range, just clamp.
PathResult: Path result for graph traversal.
Pattern: Pattern represents a discovered recurring pattern.
PatternMatch: Pattern match result.
PatternMiner: L0 pattern miner for the FactGraph layer.
PatternMiningInput: Input for pattern mining pipeline.
PatternMiningOutput: Output of pattern mining pipeline.
PatternMiningPipeline: Pipeline for mining patterns from facts.
PatternQuery: Query descriptor for PatternsPort.queryPatterns.
PatternRecord: Canonical pattern record.
PatternsPort: Port for pattern operations.
PatternsPortAdapter: Implements bundle.PatternsPort on top of SkillOpsStoragePort.
PatternSummary: Summary of a discovered pattern.
PendingExecution: A pending execution waiting in the queue.
Period: Base class for Period types.
PermissionCapabilities: Permission model for skill execution.
PermissionEnforcer: Enforces permission constraints during skill execution.
PersistenceConfig: Configuration for FactGraph persistence behavior.
PersistenceResult: Result of a persistence operation.
PersistentCheckpointManager: Persistent checkpoint manager using KvStoragePort.
PhilosophyConfig: Philosophy configuration.
PhilosophyEngine: Sole PhilosophyPort implementation in mcp_philosophy.
PhilosophyEvaluatedEvent: Philosophy evaluated event.
PhilosophyEvaluationContext: Context for philosophy evaluation.
PhilosophyEvaluator: The core evaluation engine that applies an Ethos against a runtime context to produce actionable PhilosophyGuidance.
PhilosophyFacade: Thin facade over PhilosophyPort / PhilosophyEngine.
PhilosophyGuidance: Result of evaluating an Ethos against a context.
PhilosophyInterventionHandlerAdapter: Adapter that invokes PhilosophyPort.intervene as a stage handler.
PhilosophyPort: Abstract port interface for Philosophy operations.
PhilosophyProhibitionHandlerAdapter: Adapter that invokes PhilosophyPort.checkProhibitions as a stage handler.
PipeExpr: Pipe expression (e.g., value | transform).
Pipeline<TInput, TOutput>: Base pipeline interface for data processing flows.
PipelineCompletedEvent: Pipeline completed event.
PipelineConfig: Pipeline configuration.
PipelineContext: Pipeline data for intervention.
PipelineDefinition: Pipeline definition.
PipelineError: Pipeline execution error.
PipelineEvent: Base pipeline event.
PipelineEventListener: Pipeline event listener.
PipelineExecutor: Executes pipelines.
PipelineFailedEvent: Emitted when a pipeline fails during execution.
PipelineHandler<TInput, TOutput>: Base interface for pipeline stage handlers.
PipelineHandlerRegistry: Registry for pipeline handlers.
PipelineMetrics: Pipeline execution metrics.
PipelinePort: Port for pipeline execution.
PipelinePortAdapter: Adapter exposing internal pipelines via the standard PipelinePort contract.
PipelineResult<T>: Pipeline execution result.
PipelineRunHandle: Pipeline run handle.
PipelineStage: A stage within a pipeline.
PipelineStageCompletedEvent: Emitted when a pipeline stage completes successfully.
PipelineStartedEvent: Emitted when a pipeline execution begins.
Policy: Base interface for all policy types (Decision, Expression).
PolicyCondition: Condition for when a policy applies.
PolicyConditionEvaluator: Interface for evaluating policy conditions per §3.
PolicyEvaluationError: Error during policy evaluation.
PolicyEvaluationExplanation: Explanation of a policy evaluation.
PolicyEvaluationMetadata: Metadata about the evaluation process.
PolicyEvaluationResult<P>: Result of parallel policy evaluation.
PolicyMatch<P>: A matching policy with evaluation metadata.
PolicyQuery: Query for policies.
PolicyRule: Rule within a policy.
PolicyStoragePort: Port for policy storage operations. Reference: Design Section 2.8
PortEvent: Event data.
PortPermission: Permission for a port operation.
PortRequirement: A specific port requirement.
PostGenerationResult: Post-generation intervention result.
PreGenerationResult: Pre-generation intervention result.
PreTimeoutWarning: Warning notification before timeout occurs.
PriorityCalculator: Scoring functions for curation queue item ordering.
Procedure: A procedure defines the execution steps of a skill.
ProcedureError: Aggregated procedure-level error.
ProcedureExecutor: Executes a single procedure.
ProcedureStep: A step in a procedure.
ProcessWithWarningAction: Process event with warning logged.
Profile: Represents an AI profile/persona definition.
ProfileApplicationMetadata: Metadata for profile application execution per design/03-runtime.md §5.
ProfileApplicationResult: Complete profile application result per design/03-runtime.md §5.
ProfileAppliedEvent: Profile applied event (runs the 3-pillar pipeline).
ProfileAppraisal: Profile appraisal result.
ProfileAwareSkillRuntime: Profile-aware runtime that integrates with mcp_profile.
ProfileBinding: Profile binding.
ProfileBuilder: Fluent builder for creating profiles.
ProfileBuildInput: Input for the profile build workflow.
ProfileBuildOutput: Output of the profile build workflow.
ProfileBuildWorkflow: Workflow for building profiles from patterns or manual input.
ProfileBundle: A bundled profile artifact.
ProfileCandidate: Candidate profile generated from a pattern.
ProfileConfig: Profile configuration.
ProfileContext: Profile context for runtime evaluation.
ProfileDefinition: Definition of a profile to be built.
ProfileEvaluationConfig: Configuration for profile evaluation.
ProfileEvaluationResult: Result of a single profile evaluation test case.
ProfileFacade: Thin facade over profile.ProfileRuntime.
ProfileGroup: Profile group for organizing related profiles.
ProfileManifest: Identity and metadata for a profile bundle.
ProfileMigration: Describes a migration between two profile versions.
ProfileQueryCriteria: Criteria for querying profile history.
ProfileQueryPort: Port for querying profile history.
ProfileRegistry: Registry for managing profiles.
ProfileRenderer: Renders profiles into prompts.
ProfileRenderOptions: Options for profile rendering.
ProfileRun: Profile evaluation run entity for persistence.
ProfileRuntime: Profile application runtime per docs/03_DDD/core-runtime.md v0.2.0.
ProfileRuntimeHook: Hook for runtime events per design/03-runtime.md §6.
ProfileSection: A section within a profile.
ProfileStackConfig: Configuration for profile stacking behavior.
ProfileStackingPolicy: Policy for stacking profiles.
ProfileSummariesPort: Port for profile summary retrieval.
ProfileSummariesPortAdapter: Adapter implementing bundle.ProfileSummariesPort.
ProfileTestCase: A single test case for profile evaluation.
ProfileVersion: Parsed semantic version per design/05-versioning.md §2.
ProfileVersionMigrator: Handles migration of profile data between versions per §4.
ProfileVersionResolver: Resolves profile versions based on constraints and lifecycle per §3.
Prohibition: Absolute boundary with severity classification.
ProhibitionCheck: Individual prohibition check result.
ProhibitionCheckRequest: Request to check prohibitions.
ProhibitionCheckResult: Result of prohibition checks.
ProhibitionCheckResults: Helper for creating ProhibitionCheckResult with computed violation data.
ProhibitionException: Exception condition for a prohibition.
ProhibitionViolatedEvent: Prohibition violated event.
PromptTemplate: MCP prompt template.
ProportionalAllocation: Allocate budget proportionally by weight.
ProposedChange: Specific change details for an evolution proposal.
ProvidedCapabilities: Capabilities a skill provides.
PubGrubResolver: PubGrub-style dependency resolver implementation.
QualityGate: Quality gate for procedure validation.
QueryFilter: Query filter types.
QueryResult<T>: Result of a graph query with pagination info.
QuerySort: Sort specification.
QueueConfig: Configuration for the execution queue.
QueueDlqConfig: Dead letter queue configuration for failed executions.
QueueOverflowEvent: Emitted when the execution queue exceeds its capacity.
QueueRateLimitConfig: Rate limiting configuration for queue processing.
QueueStats: Statistics for the execution queue.
QuorumPolicy: Policy defining how many approvals are required.
RecoveryManager: Orchestrates recovery of failed pipeline executions.
RecoveryResult: Result of a recovery attempt.
RedactionConfig: Redaction configuration for sensitive data in logs.
RefreshResult: Result of refreshing a single node.
ReinforcementEngine: Engine that analyzes feedback to detect reinforcement patterns and propose philosophy evolution.
ReinforcementPattern: A detected reinforcement pattern from feedback history.
Relation: Relation represents connections between entities.
RelationQuery: Query for relations.
RelationStoragePort: Port for relation storage operations. Reference: Design Section 2.5
RelationTypes: Common relation types.
RelativePeriod: Relative period - a duration from reference time.
RenderedSection: A rendered section.
ReplaceStackingPolicy: Highest-priority profile wins entirely (no merging).
ReplayEventResult: Result of replaying a single event.
ReplayResult: Aggregate result of replaying events for an execution.
RequiredCapabilities: Capabilities a skill requires.
ReservedAllocation: Pre-allocated budget reservations per branch.
ResilientExecutor: Executor that combines retry logic with circuit breaker.
ResilientRetryConfig: Retry configuration.
ResolutionCheck: Result of resolution check.
ResolutionConfig: Configuration for dependency resolution.
ResolutionError: Resolution error.
ResolutionMetadata: Metadata about how a package was resolved.
ResolutionMetrics: Resolution metrics.
ResolutionOption: Available resolution option for a tension.
ResolutionResult: Result of dependency resolution.
ResolutionWarning: Resolution warning.
ResourceCleanup: Resource cleanup definition.
ResourceCleanupResult: Result of cleaning up a single resource.
ResourceContent: Resource content read from an MCP server.
ResourceInfo: Resource information.
ResponseValidation: ResponseValidation represents the result of validating an LLM response.
RetrievalPort: Port for knowledge retrieval operations.
RetrievalPortAdapter: Implements bundle.RetrievalPort on top of FactGraphService.
RetrieverConfig: Retriever configuration.
RetryConfig: Retry configuration.
RetryExecutor: Executes an operation with configurable retry logic.
RetryPolicy: Retry policy with per-stage overrides.
ReviewCompletedEvent: Review completed event.
ReviewRequest: Review request for human review steps.
ReviewRequestedEvent: Review requested event.
ReviewResponse: Response to a review request.
RollbackConfig: Configuration for rollback behavior.
RollbackHandler: Orchestrates rollback of completed pipeline stages.
RollbackResult: Aggregate result of a rollback operation across all stages.
RollbackStageResult: Result of rolling back a single stage.
RouterBuilder: Router builder for fluent construction.
RoutingCondition: Condition for matching a routing rule against request context.
RoutingRule: A single routing rule that maps conditions to approver specifications.
Rubric: Rubric represents evaluation criteria for skills.
RubricCache: Interface for rubric caching.
RubricDimension: Evaluation dimension within a rubric. Reference: Design Section 2.16.4 - RubricDimension with measurementMethod.
RubricEvaluationEngine: Interface for rubric evaluation engines.
RubricQuery: Query for rubrics.
RubricRegistry: Interface for rubric registry.
RubricScore: Rubric score from evaluation.
Run: Run represents an execution log of automation with full reproducibility.
Runbook: Runbook definition.
RunbookAction: Runbook action.
RunbookApprovalRecord: Approval record for approval steps.
RunbookConfig: Runbook configuration.
RunbookContext: Runbook execution context.
RunbookDescriptor: Runbook descriptor.
RunbookError: Runbook execution error.
RunbookExecution: Result of a runbook execution.
RunbookExecutionError: Execution error details.
RunbookExecutor: Runbook executor.
RunbookMcpTools: MCP tool schema definitions for runbook operations.
RunbookMetrics: Runbook execution metrics.
RunbookPort: Port for runbook execution.
RunbookPortAdapter: Adapter wrapping a RunbookExecutor and a runbook registry to expose the standard port.RunbookPort contract.
RunbookResult: Runbook execution result.
RunbookStep: Runbook step.
RunbookStepResult: Runbook step result.
RunbookTrigger: Trigger definition for a runbook.
RunbookVariable: Runbook variable.
RunInput: Complete input snapshot for reproducibility.
RunOutput: Complete output snapshot for audit.
RunScript: Run a script for compensation.
RunsPort: Port for run record operations.
RunsPortAdapter: Implements bundle.RunsPort on top of RunStoragePort.
RunStoragePort: Port for run storage operations. Reference: Design Section 2.11
RuntimeContextBuilder: Fluent builder for RuntimeProfileContext.
RuntimeHook: Runtime hook for observability and lifecycle events.
RuntimeProfileContext: Immutable context for profile evaluation.
RuntimeVerifier: Runtime capability verification.
Schedule: A schedule definition (spec-compliant).
ScheduleConfig: Configuration for a scheduled task.
ScheduleCreatedEvent: Emitted when a new schedule is created.
ScheduleDeletedEvent: Emitted when a schedule is deleted.
ScheduleMeta: Schedule metadata for scheduled triggers.
ScheduleMissedEvent: Emitted when a scheduled execution was missed.
SchedulePausedEvent: Emitted when a schedule is paused.
Scheduler: Scheduler for managing pipeline triggers.
SchedulerConfig: Scheduler configuration.
ScheduleRegisteredEvent: Emitted when a schedule is registered.
ScheduleRegistration: Registration result returned after creating a schedule.
ScheduleResumedEvent: Emitted when a schedule is resumed from pause.
ScheduleRetryConfig: Retry configuration for scheduled executions.
SchedulerExecution: Execution record managed by the scheduler.
SchedulerMcpTools: MCP tool schema definitions for scheduler operations.
SchedulerStatus: Overall scheduler status.
ScheduleTarget: Target for a scheduled/triggered action.
ScheduleTriggeredEvent: Emitted when a schedule is triggered and an execution is created.
ScheduleTriggerPort: Port for scheduled and event-based triggers.
ScheduleTriggerPortAdapter: Adapter exposing the internal Scheduler via the standard ScheduleTriggerPort contract.
ScheduleUpdatedEvent: Emitted when a schedule is updated.
ScoreBreakdown: Score breakdown for transparency.
ScoreLevel: Score level definition. Reference: Design Section 2.16.4 - score range with min/max.
SectionBuilder: Fluent builder for creating sections.
SecurityScanExtractor: Security scan extractor.
SemanticVersion: Semantic version following SemVer 2.0 specification.
SharedBudgetTracker: Thread-safe budget tracking for parallel execution.
ShortCircuitConfig: Short-circuit optimization configuration.
SigmoidNormalization: Sigmoid normalization: smooth S-curve transition around midpoint.
Skill: A skill definition representing an AI capability.
SkillAction: Action from skill execution.
SkillBuildInput: Input for the skill build workflow.
SkillBuildOutput: Output of the skill build workflow.
SkillBuildWorkflow: Workflow for building skills from patterns.
SkillBundle: A skill bundle containing procedures and resources.
SkillBundleRegistry: Abstract registry for runtime use.
SkillCandidate: Candidate skill generated from a pattern.
SkillCapability: A named capability a skill provides.
SkillConfig: Skill configuration.
SkillContext: Context for skill execution.
SkillContextBuilder: Builder pattern for constructing SkillContext instances.
SkillExecutedEvent: Skill executed event.
SkillExecutionPort: Port for skill execution.
SkillExecutionResult: Skill execution result.
SkillExecutor: Executes skills.
SkillExpressionEvaluator: Main expression evaluator for mcp_skill.
SkillFacade: Thin facade over skill.SkillRuntime.
SkillGroup: Skill group for organizing related skills.
SkillManifest: Skill manifest - Identity and metadata.
SkillOpsService: Service for L3 SkillOps Layer operations.
SkillOpsStoragePort: Port for skill operations storage.
SkillPorts: Container for the ports required by SkillRuntime and friends.
SkillQuery: Query for skills.
SkillRef: Reference to a skill for multi-skill execution.
SkillRegistry: Registry for managing skill definitions.
SkillRegistryPort: Port for skill bundle registry.
SkillRegistryPortAdapter: Adapter that implements bundle.SkillRegistryPort over SkillBundleRegistry.
SkillResult: Standard result from skill execution.
SkillResultPersistence: Default implementation of skill result persistence.
SkillResultPersistenceContract: Contract for persisting skill results.
SkillResultQuery: Query parameters for retrieving skill results.
SkillResultRetrieval: Service for retrieving skill results from FactGraph.
SkillRouter: Abstract skill router interface.
SkillRun: SkillRun represents a single execution of a skill.
SkillRunHandle: Handle for an executing or completed skill run.
SkillRunMapper: Maps between skill-domain types and canonical run records.
SkillRuntime: Main runtime for executing skills.
SkillRuntimePort: Port for skill execution.
SkillRuntimePortAdapter: Adapter that implements bundle.SkillRuntimePort by delegating to a concrete mcp_skill SkillRuntime.
SkillRunWithClaims: A skill run with its associated claims.
SkillStep: A step in a skill definition (legacy model).
SkillStoragePort: Port for skill storage operations.
SkillTrigger: Skill trigger definition.
SkipAction: Skip the event.
SkipRecovery: Skip recovery: mark step as skipped and continue.
SourceInfo: Describes where a piece of evidence came from.
Span: Trace span.
SpanData: Completed span data.
SpanEvent: Span event.
SpecProfileBundle: Spec-compliant profile bundle per schema v0.1.0.
StackedEvaluationResult<P>: Result of evaluating policies across multiple stacked profiles.
StackedPolicyEvaluator: Evaluates policies across multiple stacked profiles concurrently per §5.
StackingProfileRuntime: Runtime that supports multiple profiles via stacking.
StackStackingPolicy: Evaluate all profiles in sequence, accumulate results.
Stage: Stage definition for pipelines and workflows.
StageCompensation: Compensation definition for a specific stage.
StageCompletedEvent: Stage completed event.
StageExecutor: Executes individual stages.
StageFailedEvent: Stage failed event.
StageHaltResult: Result of halting a single stage.
StageHandler<TInput, TOutput>: Base stage handler interface.
StageOutput: Stage output for state tracking.
StageResult: Stage execution result.
StageRetryConfig: Stage retry configuration.
StageSkippedEvent: Stage skipped event.
StageStartedEvent: Stage started event.
StandardApprovalRouter: Standard implementation of ApprovalRouter.
StandardCapabilities: Standard capability IDs.
StandardExpressionPolicies: Standard expression policies per §10.
StandardMetrics: Standard metric definitions as per §6.
StandardPolicies: Standard decision policies as per §7.
StandardRunbooks: Factory class for creating standard operational runbooks.
StateAdjuster: Adjusts PhilosophyGuidance intensity based on state weighting.
StateConflict: A detected conflict between parallel branches.
StateConflictDetector: Detects conflicting state mutations across parallel branches.
StateSnapshot: Snapshot of a branch's state mutations.
StateStore: Persistence boundary for runs.
StateTransition: Record of a state transition.
StateWeighting: Dynamic adjustment factors for philosophy execution intensity.
StateWeightingImpact: Audit record of how state modified philosophy output.
StaticSource: Source with a fixed constant value.
Step: A step in a procedure execution flow.
StepAction: Step action configuration.
StepCheck: Step check for pre/post validation.
StepContext: Step-level context for recovery strategies. Provides step identity and input hash for cache key generation.
StepError: Error information for a single step.
StepExecution: Tracks individual step execution state.
StepExecutor: Executes individual procedure steps.
StepMigrationResult: Result of a single migration step.
StepResult: Result from a single step execution.
StepResultAccessor: Interface for objects that support property access in expressions.
StoragePort<T>: Generic storage port for typed entities.
StubAppraisalEnginePort: Stub engine port returning stable defaults (test/bootstrap use).
StubAppraisalPort: Stub appraisal port for testing.
StubApprovalPort: Stub implementation for testing.
StubAssetPort: Stub implementation for testing.
StubAuditPort: Stub implementation for testing.
StubCandidatesPort: Stub implementation for testing.
StubClaimsPort: Stub implementation for testing.
StubContextBundlePort: Stub implementation for testing.
StubDecisionEnginePort: Stub engine port that always returns defaultProceed.
StubDecisionPort: Stub decision port for testing.
StubEntitiesPort: Stub implementation for testing.
StubEthosStorePort: Stub implementation for testing.
StubEvidencePort: Stub evidence port for testing.
StubExpressionPort: Stub expression port for testing.
StubFactsPort: Stub implementation for testing.
StubLlmPort: Stub LLM port for testing.
StubMcpPort: Stub MCP port for testing.
StubMetricPort: Stub metric port for testing.
StubMetricsPort: Stub implementation for testing.
StubNotificationPort: Stub implementation for testing.
StubPatternsPort: Stub implementation for testing.
StubPhilosophyPort: Stub philosophy port for testing.
StubPipelinePort: Stub implementation for testing.
StubProfileQueryPort: Stub implementation for testing.
StubProfileSummariesPort: Stub implementation for testing.
StubRetrievalPort: Stub implementation for testing.
StubRunbookPort: Stub implementation for testing.
StubRunsPort: Stub implementation for testing.
StubScheduleTriggerPort: Stub implementation for testing.
StubSkillRuntimePort: Stub implementation for testing.
StubSummariesPort: Stub implementation for testing.
StubWorkflowPort: Stub implementation for testing.
Subscription: A managed subscription with lifecycle control and statistics.
SubscriptionStats: Statistics for a subscription.
SuggestedFix: Suggested fix for resolution error.
SummariesPort: Port for summary operations.
SummariesPortAdapter: Implements bundle.SummariesPort on top of ContextStoragePort.
SummaryMetric: Summary metric with percentile information.
SummaryNode: SummaryNode represents a cumulative summary stored as a graph node.
SummaryNodeQuery: Query for summary nodes.
SummaryPeriod: Simple period for summary time range.
SummaryRecord: Canonical summary record.
SummaryRefreshedEvent: Summary refreshed event.
SummaryRefreshInput: Input for summary refresh pipeline.
SummaryRefreshOutput: Output of summary refresh pipeline.
SummaryRefreshPipeline: Pipeline for refreshing stale summaries with cascade support.
SummaryScheduler: Periodic driver for stale-summary refresh.
SystemClock: System clock implementation.
SystemEventType: Standard system event type constants for scheduler integration.
SystemShutdown: Cancellation due to system shutdown.
SystemShutdownEvent: System shutdown event.
TaskExecution: Task execution record.
TemplateVariable: A template variable within section content.
Tension: Detected tension between Philosophy and another layer.
TensionDetectedEvent: Tension detected event.
TensionDetector: Detects and resolves conflicts between Philosophy and other layers.
TensionResolution: Resolution of a detected tension.
TensionSource: Source of a tension (which layers are in conflict).
TestCoverageExtractor: Test coverage extractor.
TestSection: Test section.
ThresholdCondition: Simple metric threshold comparison.
TildeConstraint: Tilde constraint (~x.y.z).
TimeoutExceeded: Cancellation due to timeout being exceeded.
Token: A single token from the tokenizer.
Tokenizer: Tokenizes an expression string into a list of tokens.
ToneConfig: Configuration for communication tone.
ToolInfo: Tool information.
ToolResult: Tool execution result.
TraceContext: Trace context for propagating distributed tracing information.
TraceEntry: A single trace entry.
Tracer: Tracer for distributed tracing.
TraceSink: Trace sink interface.
TracingHook: Tracing hook - adds distributed tracing support.
TransformConfig: Transform step configuration.
Trigger: Base trigger interface.
TriggerInfo: Information about what triggered a runbook execution.
UiSection: UI section.
UnaryExpr: Unary operation (e.g., !x, -x, not x).
UnresolvedIssue: An unresolved issue preventing candidate confirmation.
UnresolvedItem: An unresolved item queued for review.
UserRequested: Cancellation initiated by a user.
ValidatedCandidate: Validated candidate with re-evaluated confidence.
ValidationContext: Context in which a claim was validated. Reference: Design Section 2.15.3.1 - ValidationContext.
ValidationError: Structured validation error with field and constraint information.
ValidationIssue: A single validation issue found during response validation.
ValidationOutcome: Outcome details from claim validation. Reference: Design Section 2.15.3.1 - ValidationOutcome (class, not enum).
ValidationResult: Validation result.
ValuePriority: Ordered principle for value conflict resolution.
ValueResolution: Value conflict resolution result.
VerifiableClaim: VerifiableClaim represents an assertion to be verified against the fact graph.
VerificationResult: Result of capability verification.
VersionCompatibility: Compatibility information for a profile version per §2.
VersionConstraint: Version constraint specification per §2.
VersionConstraintParsed: Parsed version constraint details per §2.
VersionedGraphStorage: Graph storage with versioning support.
VersionedProfile: Lightweight container pairing a version string with its lifecycle status.
VersionedProfileRegistry: Versioned profile registry.
VersionedSkillRegistry: A versioned skill registry with history.
VersionRange: A range of versions.
VersionResolutionConfig: Configuration for version resolution behavior.
VersionUnion: Union of multiple version ranges.
View: View represents an aggregated computation over events/facts.
ViewPeriod: View period (simplified, aligned with Period from mcp_bundle).
ViewQuery: Query for views.
ViewStoragePort: Port for view storage operations.
VocabularyConfig: Vocabulary configuration.
WaitCondition: Wait condition for advanced waiting scenarios.
WaitWithTimeoutAction: Wait for dependency with timeout.
Workflow<TInput, TOutput>: Base workflow interface.
WorkflowActionHandler: Action handler interface.
WorkflowActionHandlerRegistry: Action handler registry.
WorkflowApprovalReceivedEvent: Emitted when a workflow approval decision is received.
WorkflowApprovalRequest: Workflow-level approval request for gate-controlled steps.
WorkflowApprovalRequestedEvent: Emitted when a workflow requires human approval.
WorkflowApprovalResponse: Workflow-level response to an approval request.
WorkflowCancelledEvent: Workflow cancelled event.
WorkflowCompletedEvent: Emitted when a workflow completes all steps.
WorkflowConfig: Workflow configuration.
WorkflowContext: Workflow execution context.
WorkflowDefinition: Workflow definition.
WorkflowDescriptor: Workflow descriptor.
WorkflowError: Workflow execution error.
WorkflowEvent: Base workflow event.
WorkflowEventIgnoredEvent: Event ignored event.
WorkflowEventListener: Workflow event listener.
WorkflowExecution: Workflow execution.
WorkflowExecutor: Executes workflows using a state-machine model.
WorkflowFailedEvent: Emitted when a workflow fails.
WorkflowGateEvaluatedEvent: Emitted when a workflow gate is evaluated.
WorkflowMetrics: Workflow execution metrics.
WorkflowPort: Port for workflow execution.
WorkflowPortAdapter: Adapter exposing internal workflows via the standard WorkflowPort contract.
WorkflowResult<T>: Workflow execution result.
WorkflowRunHandle: Workflow run handle.
WorkflowStage: Workflow stage with additional type information.
WorkflowStartedEvent: Emitted when a workflow execution begins.
WorkflowStateEnteredEvent: State entered event.
WorkflowStateExitedEvent: State exited event.
WorkflowStepCompletedEvent: Emitted when a workflow step completes.
WorkflowTransitionEvent: Transition event.
WorkflowTransitionGuardedEvent: Transition guarded event.
ZScoreNormalization: ZScore normalization: standardize using mean and standard deviation. Output is clamped to 0, 1 using sigmoid on z-score.

Enums

ActionStatus: Action execution status.
ActorType: Type of actor performing an audited operation.
AggregationMethod: Aggregation methods (§7).
AggregationStrategy: Aggregation strategies for parallel results.
AggregationType: How to aggregate results from multiple branches.
AlertActionType: Alert action type.
AlertConditionType: Alert condition type.
AlertSeverity: Alert severity.
AlertState: Alert state.
ApprovalDecisionType: Type of decision made by an approver.
ApprovalEventType: Type of approval event.
ApprovalPolicy: Approval policy determines how approvals are collected.
ApprovalPriority: Priority of approval request.
ApprovalStatus: Status of an approval request.
ArtifactType: Type of artifact.
AttitudeDomain: Domain of attitude applicability.
AudienceContext: Audience context.
AuditOutcome: Outcome of an audited operation.
AutomationTriggerType: Type of automation trigger.
BehaviorRunStatus: Status of a behavior run.
BranchStatus: Status of a branch execution.
BundleValidationSeverity: Severity levels for validation issues.
CacheLevel: Cache hierarchy levels.
CandidateStatus: Candidate lifecycle states.
CapabilityConflictType: Types of capability conflicts.
CheckpointStatus: Checkpoint status for tracking.
CheckSeverity: Check severity determines behavior on check failure.
CheckType: Check type for step pre/post checks.
CircuitBreakerState: Circuit breaker states.
CircuitState: Circuit breaker state.
CircuitStatus: Circuit breaker status.
ClaimExtractionStrategy: Claim extraction strategy.
ClaimSignalType: Type of claim signal.
ClaimStatus: Verification state of the claim.
ClaimType: Semantic type of the claim content.
ClaimValidationMode: Validation mode for claims.
ClassificationStatus: Status of a classification.
ClusteringAlgorithm: Clustering algorithm options.
ComparisonOperator: Comparison operators for threshold conditions.
CompensationFailurePolicy: Policy for handling compensation failures.
CompensationMode: Mode of compensation execution.
CompositeOperator: Composite trigger operator.
ConditionType: Condition types.
ConflictKind: Conflict classification returned by ConsistencyChecker.check.
ConflictStrategy: Strategy for merging conflicting Ethos instances.
ConflictType: Type of state conflict between branches.
ConsumerOrdering: Ordering semantics for event consumers.
ControlPrimitive: Physical control primitives the engine can execute.
CrossStreamOrdering: Ordering semantics across multiple event streams.
CurationStrategy: Curation strategy.
DeadlineSourceType: Source type for deadline data.
DecisionAction: Actions that can be recommended by a decision policy.
DecisionType: Type of disambiguation decision.
DegradationLevel: Service degradation levels.
DeliverySemantics: Delivery semantics for event transport.
DependencyType: Type of dependency relationship.
Directness: Directness levels.
DlqAction: Action to take when processing a dead letter entry.
EdgeType: Types of edges in the fact graph. Reference: 03-data-model-specification.md Section 2.17
Empathy: Empathy levels.
EntityStatus: Entity status.
ErrorLogLevel: Error logging levels.
EscalationActionType: Escalation action type.
EvaluationStatus: Evaluation status. Reference: Design Section 2.16.5 - running | completed | failed
EvidenceRelation: Evidence relation to claim.
EvidenceSourceType: Types of evidence sources. Reference: Design Section 2.2 - text | image | file | message | api
EvidenceStatus: Evidence processing status.
EvolutionType: Type of evolution.
ExecutionState: Execution state machine states.
ExecutionStatus: Task execution status.
ExecutionStrategy: Execution strategy.
Expertise: Expertise levels.
ExportFormat: Export format for audit data.
ExpressionErrorStrategy: Error recovery strategies for expression evaluation.
ExpressionErrorType: Expression error types.
ExpressionSyntax: Expression syntax types.
ExtractorType: Extractor types for fragment extraction. Reference: Design Section 2.2 - ExtractorType: rule | ocr | llm | manual
FactAggregation: Aggregation functions for fact queries.
FactClusterStatus: Status of a fact cluster.
FactStatus: Fact status.
FallbackStrategy: Fallback strategy for error recovery.
FeedbackOutcome: Outcome classification for feedback.
FilterOperator: Operators for filter conditions.
FindingType: Finding types. Reference: Design Section 2.16.5.
Formality: Formality levels.
FragmentStatus: Fragment status. Reference: Design Section 2.5 - proposed | confirmed | rejected
GateAction: Actions for quality gate failures.
GateFailure: Gate failure handling strategy.
HealthCheckType: Health check type.
HealthStatus: Health status.
HedgingLevel: Hedging levels.
HedgingPosition: Hedging position.
IdempotencyStatus: Status of an idempotency record.
IndexRebuildMode: Index rebuild mode.
InterventionPoint: Pipeline stage for philosophy intervention.
InterventionType: Types of pipeline intervention.
IssueSeverity: Severity of validation issues.
IssueType: Types of unresolved issues.
JargonLevel: Jargon levels.
Length: Response length types.
LinkStatus: Link status.
LlmOutputType: LLM output types for llm_derived source.
LockVerificationIssueType: Types of verification issues.
LogFormat: Log output format.
LogLevel: Log levels.
MeasurementSourceType: Types of measurement sources.
MeasurementType: Measurement types for dimensions. Reference: Design Section 2.16.4
MemorySource: Source of the classification memory.
MetricSourceType: Source type for metric computation.
MetricType: Metric type.
ModifierType: Types of decision modifiers.
MultiSkillErrorStrategy: Error handling strategies for multi-skill execution.
MultiSkillMode: Multi-skill execution modes.
NodeType: Types of nodes in the fact graph.
NotificationChannel: Channel for notification delivery.
NotificationPriority: Priority of notification.
NotificationStatus: Status of a notification.
NotificationType: Type of notification.
OnErrorStrategy: Error handling strategy.
OnFailure: Failure handling strategy.
OpsErrorCategory: Category of an ops error code.
OpsErrorCode: Structured error codes for all knowledge ops operations.
PanelType: Panel display type.
ParameterType: Parameter types.
PartialFailureAction: Action to take on partial failure in best-effort mode.
PatternDirection: Direction of a detected reinforcement pattern.
PatternScope: Scope for pattern mining analysis.
PatternStatus: Pattern status. Reference: Design Section 2.16.1 - observed | proposed | confirmed | rejected | merged | codified | deprecated | archived
PeriodDirection: Direction of relative period from reference time.
PeriodUnit: Period unit for relative periods.
PolicyType: Type of policy.
PortType: Port types that a skill can require.
PriorityAlgorithm: Available priority calculation algorithms per spec section 4.1.
ProfileRunStatus: Status of a profile evaluation run.
ProfileScope: Application scope for a profile.
ProfileStackMode: Stacking mode determines how multiple profiles are combined.
ProfileVersionStatus: Version lifecycle states.
ProhibitionSeverity: Severity of a prohibition: hard = blocking, soft = warning.
ProposalStatus: Status of an evolution proposal.
RecoveryOutcome: Outcome of a recovery attempt.
RecoveryStatus: Status of a recovery attempt.
RecoveryStrategy: Strategy for recovering a failed execution.
RefreshPriority: Priority strategy for summary refresh ordering.
RelationStatus: Status of a relation.
ResolutionErrorType: Resolution error types.
ResolutionState: Resolution state for candidates. Reference: Design Section 2.3 - Status vs ResolutionState Matrix
ResolutionStrategy: Strategy for resolving a tension.
RollbackStatus: Status of a rollback operation.
RubricStatus: Rubric status. Reference: Design Section 2.16.4 - draft | active | deprecated
RuleStatus: Status of an extraction rule.
RuleType: Type of extraction rule.
RunbookCategory: Runbook category for classification.
RunbookExecutionStatus: Runbook execution status.
RunbookOnFailure: On failure behavior.
RunbookSeverity: Runbook severity level.
RunbookStepType: Runbook step types matching spec §3.
RunbookVariableType: Runbook variable types.
RunStatus: Status of a run.
ScheduleStatus: Status of a schedule.
SectionOrdering: Section ordering strategies.
SectionType: Types of profile sections.
SelectionCriteria: Selection criteria for competition mode.
SentenceComplexity: Sentence complexity.
SkillRunStatus: Status of a skill run.
SkillStatus: Skill status. Reference: Design Section 2.16.2 - draft | testing | testFail | active | published | suspended | deprecated
SourceType: Types of fact sources.
SpanStatus: Span status.
StageStatus: Stage execution status.
StepExecutionStatus: Step execution status.
StepStatus: Status of an individual step.
StepType: Step type enum matching action types.
StreamOrdering: Ordering semantics within a single event stream.
Structure: Response structure types.
SummaryScope: Scope for summary refresh.
SummaryStatus: Summary status. Reference: Design Section 2.15.1 - created | active | stale | refreshFail | archived
TargetType: Target type for scheduled executions.
TensionLayer: Which layer is involved in a tension.
TensionSeverity: Severity of a tension.
TimeoutAction: Actions available when an approval times out.
TokenType: Token types for the expression language.
ToneConfidence: Tone confidence levels.
TraceType: Trace entry types.
TrendDirection: Trend direction for metric analysis.
TriggerType: Types of skill triggers.
ValidationIssueType: Types of validation issues.
ValidatorSeverity: Severity levels for validation failures.
VerificationVerdict: Verification verdict.
VersionConstraintType: Version constraint types.
VersionSelectionStrategy: Version selection strategy.
ViewStatus: View status.
ViolationType: Types of ordering violations.
VisualPreference: Visual preference.
VoicePreference: Voice preference.
WaitType: Wait condition type.
WorkflowStageType: Workflow stage types.
WorkflowStatus: Workflow status.

Extensions

AggregationMethodExtension on AggregationMethod
ComparisonOperatorExtension on ComparisonOperator
ConflictResolutionExtension on ConflictResolution
DecisionActionExtension on DecisionAction
DirectionalAttitudeExtensions on DirectionalAttitude: Extensions for DirectionalAttitude additional behavior.
EthosExtensions on Ethos: Extensions for Ethos domain-specific behavior beyond the contract.
EthosMetadataExtensions on EthosMetadata: Extensions for EthosMetadata additional behavior.
EvaluationContextExtensions on PhilosophyEvaluationContext: Extensions for PhilosophyEvaluationContext additional behavior.
EvolutionProposalExtensions on EvolutionProposal: Extensions for EvolutionProposal additional behavior.
FeedbackEventExtensions on FeedbackEvent: Extensions for FeedbackEvent additional behavior.
JudgmentCriterionExtensions on JudgmentCriterion: Extensions for JudgmentCriterion additional behavior.
ModifierTypeExtension on ModifierType
PhilosophyGuidanceExtensions on PhilosophyGuidance: Extensions for PhilosophyGuidance additional behavior.
PipelineContextExtensions on PipelineContext
ProfileScopeExtension on ProfileScope
ProfileSpecSections on Profile: Extension to extract appraisal/decision/expression sections from Profile.
ProhibitionExtensions on Prohibition: Extensions for Prohibition additional behavior.
QueryableGraph on FactGraph: Extension to add query method to FactGraph.
StateWeightingExtensions on StateWeighting: Extensions for StateWeighting additional behavior.
TensionExtensions on Tension: Extensions for Tension additional behavior.
ValuePriorityExtensions on ValuePriority: Extensions for ValuePriority additional behavior.

Constants

metadataSourceCandidateKey → const String: Metadata key used to stamp candidateId on fact records when the bundle-level FactRecord does not carry an explicit sourceCandidateIds field. Allows hosts to propagate provenance without a breaking change to the public bundle contract.
metadataSourceCandidateListKey → const String: Metadata key used when writing back a candidate hint in the reverse direction.

Functions

cosineSimilarity(List<double> a, List<double> b) → double: Cosine similarity helper.
createResolver(ConflictResolution strategy) → ConflictResolver: Factory to create a resolver from a ConflictResolution strategy.
mergeDecisionPolicies(List<SpecProfileBundle> profiles) → DecisionPolicySection?: Merge decision policies from multiple profiles (§7.3). Policies are prefixed with profile ID and boosted by profile priority.
mergeExpressionPolicies(List<SpecProfileBundle> profiles) → ExpressionPolicySection?: Merge expression policies from multiple profiles.
mergeExpressionStyles(List<ExpressionStyle> styles) → ExpressionStyle: Merge expression styles from multiple policies (§7.4).
mergeMetrics(List<SpecProfileBundle> profiles) → List<AppraisalMetricDef>: Merge metrics from multiple profiles (§7.2). First occurrence wins (profiles are assumed sorted by priority).
resolveConflictingGuidance(List<DecisionGuidance> matches, ConflictResolution strategy) → DecisionGuidance: Resolve conflicting guidance from multiple matched policies.
selectClusteringParams({required int dataSize, required int dimensions, int? expectedClusters}) → ClusteringParams: Adaptive clustering parameter selection per spec section 7.1.

Typedefs

ActionDispatcher = Future<Map<String, dynamic>?> Function(BehaviorAction action, Map<String, dynamic> state): Runs a step's action. Host-supplied — the engine never invokes tools or skills directly. Returns an output map merged into state, or null.
ActionHandler = Future Function(Map<String, dynamic> args, ExecutionContext context): Handler for skill actions.
ArtifactBytesResolver = Future<List<int>> Function(Artifact artifact): Resolves an Artifact.contentRef into a byte list. Downstream adapter packages (filesystem, S3, Firestore) provide real implementations.
CanonicalEvent = FactCluster: Backward compatibility alias.
CanonicalStatus = FactClusterStatus: Backward compatibility alias.
ClusterAuditEntry = FactClusterAuditEntry: Backward compatibility alias.
ConflictResolutionStrategy = ConflictResolution: Alias for use in stacking/resolution contexts.
DefaultProfileContext = DefaultRuntimeContext: Alias for DefaultRuntimeContext.
EvaluationContext = PhilosophyEvaluationContext: Backward-compatible alias for PhilosophyEvaluationContext.
Event = Fact: Backward compatibility alias.
EventErrorHandler = void Function(OpsEvent event, String handlerPattern, Object error, StackTrace stackTrace): Error callback invoked when a handler throws.
EventHandler = Future<void> Function(OpsEvent event): Handler function for processing an event.
EventInterceptor = Future<void> Function(OpsEvent event, Future<void> next()): Chain-of-responsibility interceptor applied before handler execution.
EventQuery = FactQuery: Backward compatibility alias.
EventStatus = FactStatus: Backward compatibility alias.
EventStoragePort = FactStoragePort: Backward compatibility alias.
ExpressionFilter = dynamic Function(dynamic value, List<String> args): A filter that transforms values in expressions.
ExpressionFunction = dynamic Function(List args, ProfileContext context): A function that can be called from expressions.
ExtractionMethod = ExtractorType: Backward compatibility alias.
InMemoryEventStorage = InMemoryFactStorage: Backward compatibility alias.
MeasurementExtractorFactory = MeasurementExtractor Function(String dimensionId): Factory for creating measurement extractors.
OutcomeHandler = ControlSignal Function(OutcomeContext ctx): A handler: maps an outcome occurrence to a control signal.
PipelineExecutorFn = Future Function(String pipelineId, Map<String, dynamic> input): Pipeline executor function type.
PipelineFactory = Pipeline Function(): Factory for building a concrete pipeline on demand.
PipelineInputDecoder = dynamic Function(Map<String, dynamic> input): Decoder from a map input to a pipeline's typed TInput.
ProfileApplicationHook = ProfileRuntimeHook: Alias for backward compatibility.
ProfileContextBuilder = RuntimeContextBuilder: Alias for RuntimeContextBuilder.
ScheduledAction = Future<void> Function(Map<String, dynamic> data): Action to execute when triggered.
ScheduledTask = Schedule: Backward-compatible alias for Schedule.
SourceMetadata = SourceInfo: Backward compatibility alias for SourceInfo.
VerifiableClaimType = ClaimType: Backward compatibility aliases.
VerificationStatus = ClaimStatus: Backward compatibility alias.
WorkflowExecutorFn = Future Function(String pipelineId, Map<String, dynamic> input): Workflow executor function type.
WorkflowFactory = Workflow Function(): Factory for building a concrete workflow on demand.
WorkflowInputDecoder = dynamic Function(Map<String, dynamic> input): Decoder from a map input to a workflow's typed TInput.

Exceptions / Errors

ActionExecutionException: Action execution failure within a step.
AggregateError: Aggregated error from parallel execution.
AssetNotFoundException: Asset not found in knowledge port.
BudgetExceededException: Budget exceeded (tokens, calls, duration).
CheckpointException: Checkpoint exception.
CircuitOpenException: Exception thrown when circuit breaker is open.
EthosValidationException: Thrown when an Ethos structure is invalid.
EvaluationException: Thrown when evaluation logic encounters an error.
EventExpiredException: Exception thrown when an event is outside the idempotency window.
EvolutionException: Thrown when evolution proposal generation or application fails.
ExecutionException: Exception during skill execution.
ExpressionException: Base exception for expression evaluation errors.
ExpressionTimeoutException: Expression evaluation timeout.
FactConflictException: Exception raised when a candidate fact violates consistency rules.
FactGraphPortException: FactGraph port failure.
GateException: Exception thrown when a quality gate evaluation fails.
InputValidationException: Input validation failure.
InterventionException: Thrown when pipeline intervention fails.
KnowledgePortException: Knowledge port failure.
LlmPortException: LLM port failure.
McpPortException: MCP tool/resource port failure.
MigrationScriptRequiredException: Exception thrown when a breaking migration requires a script.
MissingMeasurementException: Missing measurement for a rubric dimension.
NoMigrationPathException: Exception thrown when no migration path exists between versions.
OpsException: Abstract base class for all knowledge ops exceptions.
OpsTimeoutException: Exception thrown when an operation exceeds its timeout.
OutputValidationException: Output validation failure.
ParallelExecutionException: Exception thrown during parallel execution.
PermanentOpsException: Exception indicating a permanent, non-retryable failure.
PermissionDeniedException: Permission denied.
PermissionException: Exception thrown when a permission check fails.
PhilosophyException: Base exception for all philosophy-related errors.
PhilosophyFacadeException: Exception for philosophy facade operations.
PipelineException: Exception thrown during pipeline execution.
PipelineExecutionException: Pipeline execution exception.
PolicyEvaluationException: Exception thrown when policy evaluation fails with failOnError.
PolicyException: Base policy exception.
PolicyNotFoundException: Exception thrown when a policy is not found.
PolicyViolationException: Policy violation detected.
PortException: Base port exception.
ProcedureNotFoundException: Procedure not found in skill.
ProfileException: Profile exception raised by the facade.
ProfileNotFoundException: Exception thrown when a profile is not found.
ProhibitionViolationException: Thrown when a hard prohibition is violated.
QualityGateException: Quality gate failure.
RateLimitException: Rate limit exceeded.
ResourceException: Exception thrown when a required resource is unavailable or exhausted.
RetrieverNotFoundException: Retriever not found in knowledge port.
RetryableException: Retryable exception marker.
RetryableOpsException: Exception indicating a retryable transient failure.
RubricException: Base rubric exception.
RubricNotFoundException: Rubric not found in registry.
RubricValidationException: Rubric validation failure.
RunbookStepException: Runbook step exception.
SchemaValidationException: Schema validation failure.
SecurityException: Security violation in expression.
SkillException: Skill exception raised by SkillFacade.run.
SkillExecutionException: Base execution exception.
SkillLoadException: Skill loading failure.
SkillNotFoundException: Skill not found in registry.
SkillParseException: Skill bundle parse failure.
SkillRoutingException: Skill routing failure.
SkillTimeoutException: Operation timeout.
SkillValidationException: Base validation exception.
SkillVersionException: Skill version mismatch or constraint failure.
StageException: Exception thrown during stage execution.
StepExecutionException: Step execution failure.
SyntaxException: Syntax error in expression.
TensionResolutionException: Thrown when tension resolution fails.
TimeoutException: Timeout exception.
TypeCoercionException: Type coercion failure.
UnknownExtractorException: Unknown extractor type referenced.
UnknownFunctionException: Unknown function referenced.
UnsupportedActionException: Unsupported action type.
ValidationException: Exception thrown when input validation fails.
VersionConstraintException: Exception thrown when no version matches a constraint.
WorkflowException: Workflow exception.

mcp_knowledge library

Quick start (scenario G — full orchestration)

Scenario H — partial orchestration

Classes

Enums

Extensions

Constants

Functions

Typedefs

Exceptions / Errors

mcp_knowledge package

mcp_knowledge library