@criticalbridge/brain-client 1.0.0

package/dist/types/best-practices-kg.types.d.ts

@@ -0,0 +1,112 @@
+export type BPKGRelationshipType = 'RELATES_TO' | 'PREREQUISITE_OF' | 'CONTRADICTS' | 'SUPERSEDES' | 'COMPLEMENTS' | 'PART_OF';
+export type BPKGRelationshipStrength = 'weak' | 'moderate' | 'strong';
+export type BPKGRelationshipStatus = 'active' | 'deprecated' | 'pending_review';
+export interface BPKGRelationship {
+    id: string;
+    sourcePracticeId: string;
+    targetPracticeId: string;
+    type: BPKGRelationshipType;
+    strength: BPKGRelationshipStrength;
+    status: BPKGRelationshipStatus;
+    description?: string;
+    entityId: string;
+    confidenceScore?: number;
+    tags?: string[];
+    createdAt: string;
+    updatedAt: string;
+    createdBy?: string;
+}
+export interface BPKGRelationshipWithDetails extends BPKGRelationship {
+    sourcePractice: {
+        id: string;
+        title: string;
+        status: string;
+    };
+    targetPractice: {
+        id: string;
+        title: string;
+        status: string;
+    };
+}
+export interface BPKGContradictionRelationship extends BPKGRelationship {
+    type: 'CONTRADICTS';
+    conflictAreas: string[];
+    severity: 'minor' | 'moderate' | 'major' | 'critical';
+    resolution?: string;
+    applicableContext?: string;
+}
+export interface BPKGGraphTraversalResult {
+    practices: Array<{
+        id: string;
+        title: string;
+        status: string;
+        depth: number;
+    }>;
+    relationships: BPKGRelationship[];
+    pathLength: number;
+}
+export interface BPKGConflictDetectionResult {
+    hasConflicts: boolean;
+    conflicts: BPKGContradictionRelationship[];
+    overallSeverity: 'none' | 'minor' | 'moderate' | 'major' | 'critical';
+    affectedPracticeIds: string[];
+}
+export interface BPKGRecommendation {
+    practiceId: string;
+    title: string;
+    relationshipType: BPKGRelationshipType;
+    relevanceScore: number;
+    reason: string;
+    path?: string[];
+}
+export interface BPKGRecommendationResult {
+    sourcePracticeId: string;
+    recommendations: BPKGRecommendation[];
+    totalRelatedPractices: number;
+    executionTimeMs: number;
+}
+export interface BPKGStatistics {
+    practiceCount: number;
+    relationshipCount: number;
+    relationshipsByType: Partial<Record<BPKGRelationshipType, number>>;
+}
+export interface BPKGRelationshipQueryOptions {
+    types?: BPKGRelationshipType[];
+    minStrength?: BPKGRelationshipStrength;
+    status?: BPKGRelationshipStatus;
+    limit?: number;
+    offset?: number;
+    includeDeprecated?: boolean;
+}
+export interface BPKGRecommendationQueryOptions {
+    limit?: number;
+    relationshipTypes?: BPKGRelationshipType[];
+    minRelevanceScore?: number;
+    maxDepth?: number;
+    excludePracticeIds?: string[];
+}
+export interface BPKGTraverseBody {
+    practiceId: string;
+    maxDepth?: number;
+    relationshipTypes?: BPKGRelationshipType[];
+    direction?: 'outgoing' | 'incoming' | 'both';
+}
+export interface BPKGRelationshipsForPracticeBody {
+    practiceId: string;
+    options?: BPKGRelationshipQueryOptions;
+}
+export interface BPKGRecommendationsBody {
+    practiceId: string;
+    options?: BPKGRecommendationQueryOptions;
+}
+export interface BPKGShortestPathBody {
+    sourcePracticeId: string;
+    targetPracticeId: string;
+    maxDepth?: number;
+}
+export interface BPKGDetectConflictsBody {
+    practiceId: string;
+}
+export interface BPKGResultResponse<T> {
+    result: T;
+}

package/dist/types/best-practices-kg.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=best-practices-kg.types.js.map

package/dist/types/best-practices-kg.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"best-practices-kg.types.js","sourceRoot":"","sources":["../../src/types/best-practices-kg.types.ts"],"names":[],"mappings":""}

package/dist/types/bias-threshold-policy.types.d.ts

@@ -0,0 +1,37 @@
+import type { RiskTier } from './risk-classification.types';
+export interface BiasThresholdSet {
+    disparateImpactRatio: number;
+    demographicParityDifference: number;
+    equalizedOddsDifference: number;
+    equalOpportunityDifference: number;
+    calibrationDifference: number;
+    proxyCorrelationThreshold: number;
+    minimumGroupSize: number;
+    significanceLevel: number;
+}
+export interface BiasThresholdRuleWire {
+    useCase?: string;
+    riskTier?: RiskTier;
+    thresholds: BiasThresholdSet;
+    requireForPromotion: boolean;
+    gateTiers?: RiskTier[];
+}
+export interface BiasThresholdPolicyWire {
+    entityId: string;
+    version: number;
+    rules: BiasThresholdRuleWire[];
+    updatedAt: string;
+    updatedBy: string;
+}
+export interface GetBiasThresholdPolicyResponse {
+    entityId: string;
+    policy: BiasThresholdPolicyWire | null;
+}
+export interface UpdateBiasThresholdPolicyBody {
+    rules: BiasThresholdRuleWire[];
+    updatedBy?: string;
+}
+export interface UpdateBiasThresholdPolicyResponse {
+    entityId: string;
+    policy: BiasThresholdPolicyWire;
+}

package/dist/types/bias-threshold-policy.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=bias-threshold-policy.types.js.map

package/dist/types/bias-threshold-policy.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bias-threshold-policy.types.js","sourceRoot":"","sources":["../../src/types/bias-threshold-policy.types.ts"],"names":[],"mappings":""}

package/dist/types/change-approval-gate.types.d.ts

@@ -0,0 +1,110 @@
+export type ChangeApprovalRiskTier = 'low' | 'medium' | 'high' | 'critical';
+export declare const CHANGE_APPROVAL_TIERS: readonly ["low", "medium", "high", "critical"];
+export declare const CHANGE_APPROVAL_MAX_JUSTIFICATION_LENGTH: 2048;
+export declare const DEFAULT_CHANGE_APPROVAL_POLICIES: Readonly<Record<ChangeApprovalRiskTier, ChangeApprovalPolicy>>;
+export interface ChangeApprovalPolicy {
+    tier: ChangeApprovalRiskTier;
+    minHumanApprovers: number;
+    requireRationale: boolean;
+    distinctApprovers: boolean;
+    allowedApproverRoles: string[];
+    requireExplicitCriticalAck: boolean;
+    approvalTimeoutMinutes: number;
+    blockOnAnyReject: boolean;
+}
+export interface ChangeApprovalPolicyOverride {
+    entityId: string;
+    tier: ChangeApprovalRiskTier;
+    overrides: Partial<Omit<ChangeApprovalPolicy, 'tier'>>;
+    updatedBy: string;
+    updatedAt: string;
+    version: number;
+}
+export interface ChangeApprovalPolicyAuditEntry {
+    id: string;
+    entityId: string;
+    tier: ChangeApprovalRiskTier;
+    changedBy: string;
+    changedAt: string;
+    previousVersion: number | null;
+    newVersion: number;
+    previousOverride: ChangeApprovalPolicyOverride['overrides'] | null;
+    newOverride: ChangeApprovalPolicyOverride['overrides'];
+    justification: string;
+    casLost?: boolean;
+}
+export interface TierPolicyView {
+    tier: ChangeApprovalRiskTier;
+    effective: ChangeApprovalPolicy;
+    override: ChangeApprovalPolicyOverride | null;
+}
+export interface ListChangeApprovalPoliciesResponse {
+    entityId: string;
+    policies: TierPolicyView[];
+}
+export interface GetChangeApprovalPolicyResponse extends TierPolicyView {
+    entityId: string;
+}
+export interface GetChangeApprovalPolicyAuditResponse {
+    entityId: string;
+    tier: ChangeApprovalRiskTier;
+    entries: ChangeApprovalPolicyAuditEntry[];
+}
+export interface SetChangeApprovalPolicyOverrideBody {
+    overrides: Partial<Omit<ChangeApprovalPolicy, 'tier'>>;
+    justification: string;
+}
+export interface ClearChangeApprovalPolicyOverrideBody {
+    justification: string;
+}
+export type ChangeApprovalChangeKind = 'skill' | 'agent';
+export type ChangeApprovalDecisionType = 'approve' | 'reject';
+export interface ChangeApprovalDecision {
+    id: string;
+    entityId: string;
+    changeId: string;
+    changeKind: ChangeApprovalChangeKind;
+    tier: ChangeApprovalRiskTier;
+    approver: string;
+    approverRole?: string;
+    decision: ChangeApprovalDecisionType;
+    rationale: string;
+    decidedAt: string;
+    acknowledgesCriticalRisk?: boolean;
+    policySnapshot: ChangeApprovalPolicy;
+    policyVersion: number | null;
+}
+export interface ChangeApprovalGateVerdict {
+    passed: boolean;
+    reason?: string;
+    policy: ChangeApprovalPolicy;
+    decisions: ChangeApprovalDecision[];
+    effectiveApprovals: number;
+    hasRejection: boolean;
+    criticalAckSatisfied: boolean;
+}
+export interface RecordChangeApprovalDecisionBody {
+    changeKind: ChangeApprovalChangeKind;
+    tier: ChangeApprovalRiskTier;
+    approver: string;
+    approverRole?: string;
+    decision: ChangeApprovalDecisionType;
+    rationale: string;
+    acknowledgesCriticalRisk?: boolean;
+}
+export interface RecordChangeApprovalDecisionResponse {
+    entityId: string;
+    changeId: string;
+    decision: ChangeApprovalDecision;
+}
+export interface ListChangeApprovalDecisionsResponse {
+    entityId: string;
+    changeId: string;
+    decisions: ChangeApprovalDecision[];
+}
+export interface GetChangeApprovalVerdictResponse {
+    entityId: string;
+    changeId: string;
+    tier: ChangeApprovalRiskTier;
+    verdict: ChangeApprovalGateVerdict;
+}

package/dist/types/change-approval-gate.types.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CHANGE_APPROVAL_POLICIES = exports.CHANGE_APPROVAL_MAX_JUSTIFICATION_LENGTH = exports.CHANGE_APPROVAL_TIERS = void 0;
+exports.CHANGE_APPROVAL_TIERS = [
+    'low',
+    'medium',
+    'high',
+    'critical',
+];
+exports.CHANGE_APPROVAL_MAX_JUSTIFICATION_LENGTH = 2048;
+exports.DEFAULT_CHANGE_APPROVAL_POLICIES = Object.freeze({
+    low: {
+        tier: 'low',
+        minHumanApprovers: 0,
+        requireRationale: false,
+        distinctApprovers: false,
+        allowedApproverRoles: ['role:compliance-officer'],
+        requireExplicitCriticalAck: false,
+        approvalTimeoutMinutes: 1440,
+        blockOnAnyReject: false,
+    },
+    medium: {
+        tier: 'medium',
+        minHumanApprovers: 1,
+        requireRationale: true,
+        distinctApprovers: false,
+        allowedApproverRoles: ['role:compliance-officer'],
+        requireExplicitCriticalAck: false,
+        approvalTimeoutMinutes: 240,
+        blockOnAnyReject: false,
+    },
+    high: {
+        tier: 'high',
+        minHumanApprovers: 2,
+        requireRationale: true,
+        distinctApprovers: true,
+        allowedApproverRoles: ['role:compliance-officer', 'role:risk-officer'],
+        requireExplicitCriticalAck: false,
+        approvalTimeoutMinutes: 60,
+        blockOnAnyReject: true,
+    },
+    critical: {
+        tier: 'critical',
+        minHumanApprovers: 2,
+        requireRationale: true,
+        distinctApprovers: true,
+        allowedApproverRoles: ['role:compliance-officer', 'role:cfo', 'role:risk-officer'],
+        requireExplicitCriticalAck: true,
+        approvalTimeoutMinutes: 30,
+        blockOnAnyReject: true,
+    },
+});
+//# sourceMappingURL=change-approval-gate.types.js.map

package/dist/types/change-approval-gate.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-approval-gate.types.js","sourceRoot":"","sources":["../../src/types/change-approval-gate.types.ts"],"names":[],"mappings":";;;AAoCa,QAAA,qBAAqB,GAAG;IACnC,KAAK;IACL,QAAQ;IACR,MAAM;IACN,UAAU;CAC0C,CAAC;AAmB1C,QAAA,wCAAwC,GAAG,IAAa,CAAC;AAuBzD,QAAA,gCAAgC,GAEzC,MAAM,CAAC,MAAM,CAAC;IAChB,GAAG,EAAE;QACH,IAAI,EAAE,KAAK;QACX,iBAAiB,EAAE,CAAC;QACpB,gBAAgB,EAAE,KAAK;QACvB,iBAAiB,EAAE,KAAK;QACxB,oBAAoB,EAAE,CAAC,yBAAyB,CAAC;QACjD,0BAA0B,EAAE,KAAK;QACjC,sBAAsB,EAAE,IAAI;QAC5B,gBAAgB,EAAE,KAAK;KACxB;IACD,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,iBAAiB,EAAE,CAAC;QACpB,gBAAgB,EAAE,IAAI;QACtB,iBAAiB,EAAE,KAAK;QACxB,oBAAoB,EAAE,CAAC,yBAAyB,CAAC;QACjD,0BAA0B,EAAE,KAAK;QACjC,sBAAsB,EAAE,GAAG;QAC3B,gBAAgB,EAAE,KAAK;KACxB;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,iBAAiB,EAAE,CAAC;QACpB,gBAAgB,EAAE,IAAI;QACtB,iBAAiB,EAAE,IAAI;QACvB,oBAAoB,EAAE,CAAC,yBAAyB,EAAE,mBAAmB,CAAC;QACtE,0BAA0B,EAAE,KAAK;QACjC,sBAAsB,EAAE,EAAE;QAC1B,gBAAgB,EAAE,IAAI;KACvB;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,iBAAiB,EAAE,CAAC;QACpB,gBAAgB,EAAE,IAAI;QACtB,iBAAiB,EAAE,IAAI;QACvB,oBAAoB,EAAE,CAAC,yBAAyB,EAAE,UAAU,EAAE,mBAAmB,CAAC;QAClF,0BAA0B,EAAE,IAAI;QAChC,sBAAsB,EAAE,EAAE;QAC1B,gBAAgB,EAAE,IAAI;KACvB;CACF,CAAC,CAAC"}

package/dist/types/connection.types.d.ts

@@ -0,0 +1,100 @@
+export interface ConnectionMetadata {
+    id: string;
+    name: string;
+    type?: string;
+    provider?: string;
+    credentials: 'Corporate' | 'Individual';
+    protocol?: 'API' | 'MCP' | 'OAuth2' | 'HTTP' | 'REST' | 'GraphQL' | 'WebSocket';
+    authentication?: 'none' | 'basic' | 'bearer' | 'oauth2' | 'oauth1' | 'digest' | 'custom' | 'query' | 'header' | 'aws-signature-v4' | 'mtls' | 'hmac' | 'saml' | 'jwt' | 'session' | 'service-account' | 'service-account-dwd' | 'jwt-service-account' | 'OAuth' | 'OAuth2' | 'Service';
+    activity?: 'Active' | 'Inactive';
+    stage?: 'Development' | 'Staging' | 'Operational';
+    status: 'Online' | 'Offline';
+    operation?: 'Success' | 'Failed' | 'Error' | 'Not in Use';
+    loadControl?: 'auto' | 'manual' | 'disabled';
+    endpoint?: string;
+    region?: string;
+    vaultKeyId?: string;
+    tags?: string[];
+    source?: 'entity' | 'vendor' | 'criticalbridge';
+    sourceName?: string;
+    isSystemProvided?: boolean;
+    workflowId?: string;
+    workflowName?: string;
+    nodeId?: string;
+    nodeType?: string;
+    entityId?: string;
+    createdAt: string;
+    updatedAt: string;
+    createdBy?: string;
+    updatedBy?: string;
+    lastTested?: string;
+    lastError?: string;
+    allowedMinters?: ConnectionAllowedMinters;
+    reachability?: ConnectionReachability;
+}
+export interface ConnectionAllowedMinters {
+    userIds?: string[];
+    roles?: string[];
+}
+export type ConnectionReachability = 'cloud-reachable' | 'client-only';
+interface ConnectionWriteFields {
+    type?: string;
+    provider?: string;
+    endpoint?: string;
+    region?: string;
+    vaultKeyId?: string;
+    tags?: string[];
+    workflowId?: string;
+    workflowName?: string;
+    nodeId?: string;
+    nodeType?: string;
+    isSystemProvided?: boolean;
+    allowedMinters?: ConnectionAllowedMinters;
+    reachability?: ConnectionReachability;
+}
+export interface ConnectionCreateBody extends ConnectionWriteFields {
+    id: string;
+    name: string;
+    credentials: 'Corporate' | 'Individual';
+    status?: 'Online' | 'Offline';
+}
+export interface ConnectionUpdateBody extends ConnectionWriteFields {
+    name?: string;
+    credentials?: 'Corporate' | 'Individual';
+    status?: 'Online' | 'Offline';
+}
+export interface ListConnectionsResponse {
+    connections: ConnectionMetadata[];
+    entityId: string;
+    count: number;
+}
+export interface GetConnectionResponse {
+    connection: ConnectionMetadata;
+    entityId: string;
+}
+export interface ConnectionWriteResponse {
+    connection: ConnectionMetadata;
+    entityId: string;
+}
+export interface PutCredentialResponse {
+    vaultKeyId: string;
+    entityId: string;
+    connectionId: string;
+}
+export interface ScopedCredential {
+    kind: 'raw' | 'derived';
+    value: Record<string, unknown>;
+    expiresAt: string;
+    scope: {
+        entityId: string;
+        connectionId: string;
+        userId: string;
+    };
+}
+export interface RefreshedCredentialResponse {
+    vaultKeyId: string;
+    entityId: string;
+    connectionId: string;
+    refreshedAt: string;
+}
+export {};

package/dist/types/connection.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=connection.types.js.map

package/dist/types/connection.types.js.map

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