@vorionsys/atsf-core 0.1.0

package/dist/contracts/types.d.ts

@@ -0,0 +1,374 @@
+/**
+ * Output Contract Types (VorionResponse)
+ *
+ * Machine-readable, auditable, replayable output contracts
+ * with confidence scores, assumptions, and invalidity conditions.
+ *
+ * @packageDocumentation
+ */
+import type { ID, Timestamp, ControlAction, TrustLevel } from '../common/types.js';
+/**
+ * Standard Vorion response contract
+ */
+export interface VorionResponse<T = unknown> {
+    /** Response identifier */
+    responseId: ID;
+    /** Request that generated this response */
+    requestId: ID;
+    /** Whether the operation succeeded */
+    success: boolean;
+    /** The actual response payload */
+    payload: T;
+    /** Confidence in this response (0-1) */
+    confidence: ResponseConfidence;
+    /** Assumptions made to generate this response */
+    assumptions: Assumption[];
+    /** Conditions that would invalidate this response */
+    invalidityConditions: InvalidityCondition[];
+    /** Governance decision applied */
+    governance: GovernanceDecision;
+    /** Provenance tracking */
+    provenance: ResponseProvenance;
+    /** Timing information */
+    timing: ResponseTiming;
+    /** Replay information for reproducibility */
+    replay: ReplayInfo;
+    /** Response metadata */
+    metadata: ResponseMetadata;
+}
+/**
+ * Vorion error response
+ */
+export interface VorionErrorResponse {
+    /** Response identifier */
+    responseId: ID;
+    /** Request that generated this error */
+    requestId: ID;
+    /** Always false for errors */
+    success: false;
+    /** Error details */
+    error: ContractError;
+    /** Governance decision that led to error (if applicable) */
+    governance?: GovernanceDecision;
+    /** What was attempted before failure */
+    attempted: AttemptedAction[];
+    /** Suggested remediation steps */
+    remediation: RemediationStep[];
+    /** Timing information */
+    timing: ResponseTiming;
+    /** Response metadata */
+    metadata: ResponseMetadata;
+}
+/**
+ * Confidence information for a response
+ */
+export interface ResponseConfidence {
+    /** Overall confidence score (0-1) */
+    overall: number;
+    /** Confidence breakdown by component */
+    breakdown: ConfidenceComponent[];
+    /** Factors that reduced confidence */
+    reducingFactors: ConfidenceFactor[];
+    /** Factors that increased confidence */
+    boostingFactors: ConfidenceFactor[];
+    /** Confidence calibration source */
+    calibration: 'historical' | 'model' | 'heuristic' | 'expert';
+}
+/**
+ * Component contributing to confidence
+ */
+export interface ConfidenceComponent {
+    component: string;
+    confidence: number;
+    weight: number;
+    explanation: string;
+}
+/**
+ * Factor affecting confidence
+ */
+export interface ConfidenceFactor {
+    factor: string;
+    impact: number;
+    explanation: string;
+}
+/**
+ * An assumption made during processing
+ */
+export interface Assumption {
+    /** Assumption identifier */
+    id: string;
+    /** What was assumed */
+    assumption: string;
+    /** Category of assumption */
+    category: AssumptionCategory;
+    /** How critical is this assumption */
+    criticality: 'low' | 'medium' | 'high' | 'critical';
+    /** Confidence that assumption holds (0-1) */
+    confidence: number;
+    /** What happens if assumption is wrong */
+    fallbackBehavior: string;
+    /** Evidence supporting the assumption */
+    supportingEvidence: string[];
+    /** How to verify the assumption */
+    verification?: string;
+}
+/**
+ * Categories of assumptions
+ */
+export type AssumptionCategory = 'input_validity' | 'context_stability' | 'resource_availability' | 'permission_granted' | 'data_freshness' | 'model_accuracy' | 'external_service' | 'user_intent';
+/**
+ * A condition that would invalidate the response
+ */
+export interface InvalidityCondition {
+    /** Condition identifier */
+    id: string;
+    /** What would make response invalid */
+    condition: string;
+    /** Category of invalidation */
+    category: InvalidityCategory;
+    /** Severity if condition occurs */
+    severity: 'minor' | 'moderate' | 'major' | 'complete';
+    /** How to detect if condition occurs */
+    detection: string;
+    /** Recommended action if condition occurs */
+    recommendedAction: string;
+    /** Time sensitivity (if applicable) */
+    timeLimit?: number;
+}
+/**
+ * Categories of invalidity
+ */
+export type InvalidityCategory = 'temporal' | 'state_change' | 'data_update' | 'permission_revoked' | 'context_shift' | 'external_factor' | 'security_event';
+/**
+ * Governance decision applied to request
+ */
+export interface GovernanceDecision {
+    /** Decision identifier */
+    decisionId: ID;
+    /** Action taken */
+    action: ControlAction;
+    /** Trust level of requester */
+    trustLevel: TrustLevel;
+    /** Rules that were applied */
+    rulesApplied: AppliedRule[];
+    /** Any modifications made to the request */
+    modifications: RequestModification[];
+    /** Constraints applied to the response */
+    constraints: ResponseConstraint[];
+    /** Human approvals obtained (if any) */
+    approvals: Approval[];
+}
+/**
+ * A rule that was applied
+ */
+export interface AppliedRule {
+    ruleId: ID;
+    ruleName: string;
+    effect: string;
+    reason: string;
+}
+/**
+ * Modification made to original request
+ */
+export interface RequestModification {
+    field: string;
+    originalValue: unknown;
+    modifiedValue: unknown;
+    reason: string;
+}
+/**
+ * Constraint applied to response
+ */
+export interface ResponseConstraint {
+    type: 'scope_limit' | 'rate_limit' | 'data_filter' | 'output_redact' | 'capability_restrict';
+    target: string;
+    constraint: string;
+    reason: string;
+}
+/**
+ * Human approval obtained
+ */
+export interface Approval {
+    approver: string;
+    role: string;
+    timestamp: Timestamp;
+    scope: string;
+    expiresAt?: Timestamp;
+}
+/**
+ * Provenance information for the response
+ */
+export interface ResponseProvenance {
+    /** Chain of processing steps */
+    processingChain: ProcessingStep[];
+    /** Data sources used */
+    dataSources: DataSource[];
+    /** Models/algorithms used */
+    modelsUsed: ModelReference[];
+    /** Hash of inputs for verification */
+    inputHash: string;
+    /** Hash of outputs for verification */
+    outputHash: string;
+    /** Full provenance record ID */
+    provenanceRecordId?: ID;
+}
+/**
+ * A step in the processing chain
+ */
+export interface ProcessingStep {
+    stepNumber: number;
+    component: string;
+    action: string;
+    input: string;
+    output: string;
+    durationMs: number;
+}
+/**
+ * A data source used
+ */
+export interface DataSource {
+    sourceId: string;
+    sourceName: string;
+    sourceType: 'database' | 'api' | 'cache' | 'model' | 'user_input' | 'system';
+    dataTimestamp: Timestamp;
+    confidence: number;
+}
+/**
+ * Reference to a model/algorithm used
+ */
+export interface ModelReference {
+    modelId: string;
+    modelName: string;
+    version: string;
+    purpose: string;
+}
+/**
+ * Timing information
+ */
+export interface ResponseTiming {
+    /** When request was received */
+    requestedAt: Timestamp;
+    /** When processing started */
+    processingStartedAt: Timestamp;
+    /** When response was generated */
+    respondedAt: Timestamp;
+    /** Total duration in ms */
+    totalDurationMs: number;
+    /** Time spent in each phase */
+    phases: {
+        parsing: number;
+        governance: number;
+        processing: number;
+        validation: number;
+        serialization: number;
+    };
+}
+/**
+ * Information for replaying the request
+ */
+export interface ReplayInfo {
+    /** Whether this response can be replayed */
+    replayable: boolean;
+    /** Deterministic seed (if applicable) */
+    seed?: string;
+    /** Snapshot of relevant state */
+    stateSnapshot: Record<string, unknown>;
+    /** External dependencies that must match */
+    externalDependencies: ExternalDependency[];
+    /** Instructions for replay */
+    replayInstructions: string;
+}
+/**
+ * External dependency for replay
+ */
+export interface ExternalDependency {
+    name: string;
+    type: 'api' | 'database' | 'service' | 'model';
+    version: string;
+    stateAtRequest: Record<string, unknown>;
+}
+/**
+ * Response metadata
+ */
+export interface ResponseMetadata {
+    /** API version */
+    apiVersion: string;
+    /** Engine version */
+    engineVersion: string;
+    /** Request correlation ID */
+    correlationId: ID;
+    /** Session ID (if applicable) */
+    sessionId?: ID;
+    /** Tags for categorization */
+    tags: string[];
+    /** Custom metadata */
+    custom: Record<string, unknown>;
+}
+/**
+ * Vorion error details
+ */
+export interface ContractError {
+    /** Error code */
+    code: string;
+    /** Error message */
+    message: string;
+    /** Error category */
+    category: ErrorCategory;
+    /** Is this error retryable */
+    retryable: boolean;
+    /** Retry delay suggestion (ms) */
+    retryAfterMs?: number;
+    /** Detailed error context */
+    context: Record<string, unknown>;
+    /** Stack trace (only in development) */
+    stack?: string;
+    /** Nested errors */
+    causes?: ContractError[];
+}
+/**
+ * Error categories
+ */
+export type ErrorCategory = 'validation' | 'authorization' | 'governance' | 'resource' | 'external' | 'internal' | 'timeout' | 'rate_limit' | 'containment';
+/**
+ * Action that was attempted before failure
+ */
+export interface AttemptedAction {
+    action: string;
+    result: 'success' | 'partial' | 'failed';
+    details: string;
+}
+/**
+ * Step for remediation
+ */
+export interface RemediationStep {
+    step: number;
+    action: string;
+    description: string;
+    automated: boolean;
+}
+/**
+ * Request to create a VorionResponse
+ */
+export interface CreateResponseRequest<T = unknown> {
+    requestId: ID;
+    payload: T;
+    confidence?: Partial<ResponseConfidence>;
+    assumptions?: Assumption[];
+    invalidityConditions?: InvalidityCondition[];
+    governance?: GovernanceDecision;
+    metadata?: Partial<ResponseMetadata>;
+}
+/**
+ * Request to create a VorionErrorResponse
+ */
+export interface CreateErrorRequest {
+    requestId: ID;
+    error: Omit<ContractError, 'retryAfterMs'> & {
+        retryAfterMs?: number;
+    };
+    governance?: GovernanceDecision;
+    attempted?: AttemptedAction[];
+    remediation?: RemediationStep[];
+    metadata?: Partial<ResponseMetadata>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/contracts/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/contracts/types.ts"],"names":[],"mappings":"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"}

package/dist/contracts/types.js

@@ -0,0 +1,10 @@
+/**
+ * Output Contract Types (VorionResponse)
+ *
+ * Machine-readable, auditable, replayable output contracts
+ * with confidence scores, assumptions, and invalidity conditions.
+ *
+ * @packageDocumentation
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/contracts/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/contracts/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/enforce/index.d.ts

@@ -0,0 +1,58 @@
+/**
+ * ENFORCE - Policy Decision Point
+ *
+ * Makes enforcement decisions based on rule evaluations and trust levels.
+ *
+ * @packageDocumentation
+ */
+import type { Intent, Decision, ControlAction, TrustLevel, TrustScore } from '../common/types.js';
+import type { EvaluationResult } from '../basis/types.js';
+/**
+ * Enforcement context combining intent and evaluation results
+ */
+export interface EnforcementContext {
+    intent: Intent;
+    evaluation: EvaluationResult;
+    trustScore: TrustScore;
+    trustLevel: TrustLevel;
+}
+/**
+ * Enforcement policy configuration
+ */
+export interface EnforcementPolicy {
+    defaultAction: ControlAction;
+    requireMinTrustLevel?: TrustLevel;
+    escalationRules?: EscalationRule[];
+}
+/**
+ * Escalation rule definition
+ */
+export interface EscalationRule {
+    condition: string;
+    escalateTo: string;
+    timeout: string;
+}
+/**
+ * Policy enforcement service
+ */
+export declare class EnforcementService {
+    private policy;
+    constructor(policy?: EnforcementPolicy);
+    /**
+     * Make an enforcement decision
+     */
+    decide(context: EnforcementContext): Promise<Decision>;
+    /**
+     * Create a decision record
+     */
+    private createDecision;
+    /**
+     * Update enforcement policy
+     */
+    setPolicy(policy: EnforcementPolicy): void;
+}
+/**
+ * Create a new enforcement service instance
+ */
+export declare function createEnforcementService(policy?: EnforcementPolicy): EnforcementService;
+//# sourceMappingURL=index.d.ts.map

package/dist/enforce/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/enforce/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EACV,MAAM,EACN,QAAQ,EACR,aAAa,EACb,UAAU,EACV,UAAU,EAEX,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,gBAAgB,EAAc,MAAM,mBAAmB,CAAC;AAItE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,gBAAgB,CAAC;IAC7B,UAAU,EAAE,UAAU,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,aAAa,CAAC;IAC7B,oBAAoB,CAAC,EAAE,UAAU,CAAC;IAClC,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAoB;gBAEtB,MAAM,CAAC,EAAE,iBAAiB;IAItC;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC;IA+C5D;;OAEG;IACH,OAAO,CAAC,cAAc;IAyBtB;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;CAI3C;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,CAAC,EAAE,iBAAiB,GACzB,kBAAkB,CAEpB"}

package/dist/enforce/index.js

@@ -0,0 +1,77 @@
+/**
+ * ENFORCE - Policy Decision Point
+ *
+ * Makes enforcement decisions based on rule evaluations and trust levels.
+ *
+ * @packageDocumentation
+ */
+import { createLogger } from '../common/logger.js';
+const logger = createLogger({ component: 'enforce' });
+/**
+ * Policy enforcement service
+ */
+export class EnforcementService {
+    policy;
+    constructor(policy) {
+        this.policy = policy ?? { defaultAction: 'deny' };
+    }
+    /**
+     * Make an enforcement decision
+     */
+    async decide(context) {
+        const { intent, evaluation, trustScore, trustLevel } = context;
+        // Check minimum trust level
+        if (this.policy.requireMinTrustLevel !== undefined &&
+            trustLevel < this.policy.requireMinTrustLevel) {
+            logger.info({
+                intentId: intent.id,
+                required: this.policy.requireMinTrustLevel,
+                actual: trustLevel,
+            }, 'Trust level insufficient');
+            return this.createDecision(intent.id, 'deny', evaluation.rulesEvaluated, trustScore, trustLevel);
+        }
+        // Use evaluation result action
+        const action = evaluation.passed ? 'allow' : evaluation.finalAction;
+        logger.info({
+            intentId: intent.id,
+            action,
+            rulesEvaluated: evaluation.rulesEvaluated.length,
+        }, 'Enforcement decision made');
+        return this.createDecision(intent.id, action, evaluation.rulesEvaluated, trustScore, trustLevel);
+    }
+    /**
+     * Create a decision record
+     */
+    createDecision(intentId, action, constraintsEvaluated, trustScore, trustLevel) {
+        return {
+            intentId,
+            action,
+            constraintsEvaluated: constraintsEvaluated.map((r) => ({
+                constraintId: r.ruleId,
+                passed: r.matched,
+                action: r.action,
+                reason: r.reason,
+                details: r.details,
+                durationMs: r.durationMs,
+                evaluatedAt: new Date().toISOString(),
+            })),
+            trustScore,
+            trustLevel,
+            decidedAt: new Date().toISOString(),
+        };
+    }
+    /**
+     * Update enforcement policy
+     */
+    setPolicy(policy) {
+        this.policy = policy;
+        logger.info({ policy }, 'Enforcement policy updated');
+    }
+}
+/**
+ * Create a new enforcement service instance
+ */
+export function createEnforcementService(policy) {
+    return new EnforcementService(policy);
+}
+//# sourceMappingURL=index.js.map

package/dist/enforce/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/enforce/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAWnD,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;AA8BtD;;GAEG;AACH,MAAM,OAAO,kBAAkB;IACrB,MAAM,CAAoB;IAElC,YAAY,MAA0B;QACpC,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,OAA2B;QACtC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;QAE/D,4BAA4B;QAC5B,IACE,IAAI,CAAC,MAAM,CAAC,oBAAoB,KAAK,SAAS;YAC9C,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,oBAAoB,EAC7C,CAAC;YACD,MAAM,CAAC,IAAI,CACT;gBACE,QAAQ,EAAE,MAAM,CAAC,EAAE;gBACnB,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,oBAAoB;gBAC1C,MAAM,EAAE,UAAU;aACnB,EACD,0BAA0B,CAC3B,CAAC;YAEF,OAAO,IAAI,CAAC,cAAc,CACxB,MAAM,CAAC,EAAE,EACT,MAAM,EACN,UAAU,CAAC,cAAc,EACzB,UAAU,EACV,UAAU,CACX,CAAC;QACJ,CAAC;QAED,+BAA+B;QAC/B,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC;QAEpE,MAAM,CAAC,IAAI,CACT;YACE,QAAQ,EAAE,MAAM,CAAC,EAAE;YACnB,MAAM;YACN,cAAc,EAAE,UAAU,CAAC,cAAc,CAAC,MAAM;SACjD,EACD,2BAA2B,CAC5B,CAAC;QAEF,OAAO,IAAI,CAAC,cAAc,CACxB,MAAM,CAAC,EAAE,EACT,MAAM,EACN,UAAU,CAAC,cAAc,EACzB,UAAU,EACV,UAAU,CACX,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,cAAc,CACpB,QAAY,EACZ,MAAqB,EACrB,oBAAkC,EAClC,UAAsB,EACtB,UAAsB;QAEtB,OAAO;YACL,QAAQ;YACR,MAAM;YACN,oBAAoB,EAAE,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAa,EAAE,EAAE,CAAC,CAAC;gBACjE,YAAY,EAAE,CAAC,CAAC,MAAM;gBACtB,MAAM,EAAE,CAAC,CAAC,OAAO;gBACjB,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,UAAU,EAAE,CAAC,CAAC,UAAU;gBACxB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACtC,CAAC,CAAC;YACH,UAAU;YACV,UAAU;YACV,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,MAAyB;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,4BAA4B,CAAC,CAAC;IACxD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,MAA0B;IAE1B,OAAO,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC"}

package/dist/governance/index.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Governance & Authority Engine
+ *
+ * Implements rule hierarchy with hard disqualifiers, soft constraints,
+ * mandatory clarification triggers, and authority management.
+ *
+ * @packageDocumentation
+ */
+import type { ID, ControlAction } from '../common/types.js';
+import type { GovernanceRule, RuleCategory, RuleCondition, RuleEffect, ConditionOperator, Authority, GovernanceRequest, GovernanceResult, GovernanceConfig, RuleQuery } from './types.js';
+export * from './types.js';
+/**
+ * Governance Engine - manages and evaluates governance rules
+ */
+export declare class GovernanceEngine {
+    private config;
+    private rules;
+    private rulesByNamespace;
+    private authorities;
+    private evaluationCache;
+    constructor(config?: Partial<GovernanceConfig>);
+    /**
+     * Register a governance rule
+     */
+    registerRule(rule: GovernanceRule): void;
+    /**
+     * Unregister a rule
+     */
+    unregisterRule(ruleId: ID): void;
+    /**
+     * Register an authority
+     */
+    registerAuthority(authority: Authority): void;
+    /**
+     * Evaluate governance rules for a request
+     */
+    evaluate(request: GovernanceRequest): Promise<GovernanceResult>;
+    /**
+     * Validate a rule
+     */
+    private validateRule;
+    /**
+     * Get cache key for a request
+     */
+    private getCacheKey;
+    /**
+     * Check if an authority is valid for a request
+     */
+    private checkAuthority;
+    /**
+     * Get numeric value for trust level
+     */
+    private getTrustLevelValue;
+    /**
+     * Check if request is within authority scope
+     */
+    private isInScope;
+    /**
+     * Get applicable rules for a request
+     */
+    private getApplicableRules;
+    /**
+     * Check if current time is within schedule
+     */
+    private isInSchedule;
+    /**
+     * Evaluate a condition against a request
+     */
+    private evaluateCondition;
+    /**
+     * Evaluate a composite condition
+     */
+    private evaluateCompositeCondition;
+    /**
+     * Get field value from request
+     */
+    private getFieldValue;
+    /**
+     * Compare values using operator
+     */
+    private compareValues;
+    /**
+     * Calculate confidence in decision
+     */
+    private calculateConfidence;
+    /**
+     * Generate explanation for decision
+     */
+    private generateExplanation;
+    /**
+     * Create a denial result
+     */
+    private createDenialResult;
+    /**
+     * Query rules
+     */
+    queryRules(query: RuleQuery): Promise<GovernanceRule[]>;
+    /**
+     * Get statistics
+     */
+    getStats(): {
+        totalRules: number;
+        byCategory: Record<RuleCategory, number>;
+        byNamespace: Record<string, number>;
+        totalAuthorities: number;
+        cacheSize: number;
+    };
+    /**
+     * Clear evaluation cache
+     */
+    clearCache(): void;
+}
+/**
+ * Create a new governance engine
+ */
+export declare function createGovernanceEngine(config?: Partial<GovernanceConfig>): GovernanceEngine;
+/**
+ * Helper to create a governance rule
+ */
+export declare function createGovernanceRule(name: string, category: RuleCategory, condition: RuleCondition, effect: RuleEffect, options?: Partial<GovernanceRule>): GovernanceRule;
+/**
+ * Helper to create a simple field condition
+ */
+export declare function createFieldCondition(field: string, operator: ConditionOperator, value: unknown): RuleCondition;
+/**
+ * Helper to create a composite condition
+ */
+export declare function createCompositeCondition(logicalOperator: 'AND' | 'OR' | 'NOT', children: RuleCondition[]): RuleCondition;
+/**
+ * Helper to create a rule effect
+ */
+export declare function createRuleEffect(action: ControlAction, reason: string, options?: Partial<RuleEffect>): RuleEffect;
+//# sourceMappingURL=index.d.ts.map

package/dist/governance/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/governance/index.ts"],"names":[],"mappings":"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"}