devchain-cli 0.22.0 → 0.23.0

package/dist/server/modules/storage/interfaces/storage.interface.d.ts

@@ -1,6 +1,6 @@
 import type { FeatureFlagConfig } from '../../../common/config/feature-flags';
 import type { PreparedEvent } from '../../events/services/durable-event-registry.service';
-import { Project, CreateProject, UpdateProject, ProjectWorkspace, DeleteProjectWorkspaceResult, Status, CreateStatus, UpdateStatus, Epic, CreateEpic, UpdateEpic, Prompt, CreatePrompt, UpdatePrompt, Tag, CreateTag, UpdateTag, Provider, CreateProvider, ProviderModel, CreateProviderModel, ProviderEffort, CreateProviderEffort, UpdateProvider, ProviderMcpMetadata, UpdateProviderMcpMetadata, ProviderPluginDefault, ProjectProviderPluginOverride, UpsertProviderPluginDefault, UpsertProjectProviderPluginOverride, EnvScopesMap, AgentProfile, CreateAgentProfile, UpdateAgentProfile, ProfileProviderConfig, CreateProfileProviderConfig, UpdateProfileProviderConfig, Agent, CreateAgent, UpdateAgent, EpicRecord, CreateEpicRecord, UpdateEpicRecord, Document, CreateDocument, UpdateDocument, EpicComment, CreateEpicComment, Guest, CreateGuest, Watcher, CreateWatcher, UpdateWatcher, Subscriber, CreateSubscriber, UpdateSubscriber, Review, CreateReview, UpdateReview, ReviewComment, ReviewCommentEnriched, CreateReviewComment, UpdateReviewComment, ReviewCommentTarget, ReviewStatus, ReviewCommentStatus, CommunitySkillSource, CreateCommunitySkillSource, LocalSkillSource, CreateLocalSkillSource, ScheduledEpic, CreateScheduledEpic, UpdateScheduledEpic, UpdateScheduledEpicRuntimeState, ScheduledEpicRun, CreateScheduledEpicRun, UpdateScheduledEpicRun, ScheduledEpicRunStatus, CreateExternalTaskLink, ExternalTaskLink, IntegrationConnection, IntegrationCredentials, IntegrationProvider, ReplaceIntegrationConnection, CreateEpicWithExternalTaskLink, CreateEpicWithExternalTaskLinkResult, CreateExternalManagedSubtaskLink, UpdateExternalManagedSubtaskLink, ExternalManagedSubtaskLink, ConfirmExternalManagedSubtaskLink, ConfirmExternalManagedSubtaskLinkResult } from '../models/domain.models';
+import { Project, CreateProject, UpdateProject, ProjectWorkspace, DeleteProjectWorkspaceResult, Status, CreateStatus, UpdateStatus, Epic, CreateEpic, UpdateEpic, Prompt, CreatePrompt, UpdatePrompt, Tag, CreateTag, UpdateTag, Provider, CreateProvider, ProviderModel, CreateProviderModel, ProviderEffort, CreateProviderEffort, UpdateProvider, ProviderMcpMetadata, UpdateProviderMcpMetadata, ProviderPluginDefault, ProjectProviderPluginOverride, UpsertProviderPluginDefault, UpsertProjectProviderPluginOverride, EnvScopesMap, AgentProfile, CreateAgentProfile, UpdateAgentProfile, ProfileProviderConfig, CreateProfileProviderConfig, UpdateProfileProviderConfig, Agent, CreateAgent, UpdateAgent, EpicRecord, CreateEpicRecord, UpdateEpicRecord, Document, CreateDocument, UpdateDocument, EpicComment, CreateEpicComment, Guest, CreateGuest, Watcher, CreateWatcher, UpdateWatcher, Subscriber, CreateSubscriber, UpdateSubscriber, Review, CreateReview, UpdateReview, ReviewComment, ReviewCommentEnriched, CreateReviewComment, UpdateReviewComment, ReviewCommentTarget, ReviewStatus, ReviewCommentStatus, CommunitySkillSource, CreateCommunitySkillSource, LocalSkillSource, CreateLocalSkillSource, ScheduledEpic, CreateScheduledEpic, UpdateScheduledEpic, UpdateScheduledEpicRuntimeState, ScheduledEpicRun, CreateScheduledEpicRun, UpdateScheduledEpicRun, ScheduledEpicRunStatus, CreateExternalTaskLink, ExternalTaskLink, IntegrationConnection, IntegrationConnectionLookup, IntegrationCredentials, IntegrationProvider, ReplaceIntegrationConnection, CreateEpicWithExternalTaskLink, CreateEpicWithExternalTaskLinkResult, CreateExternalManagedSubtaskLink, UpdateExternalManagedSubtaskLink, ExternalManagedSubtaskLink, ConfirmExternalManagedSubtaskLink, ConfirmExternalManagedSubtaskLinkResult, EpicRelationCandidate, EpicRelationListItem, EpicRelationSummary, EpicRelationWriteContext, SetEpicRelationResult, DeleteEpicRelationResult, SetEpicRelation, ExternalEstimateLoggedMinutesEntry, ExternalEstimateLogDailyCheckpoint, ExternalEstimateLogIdentity, ExternalEstimateLogOperationMutation, ExternalEstimateLogState, PrepareExternalEstimateLogOperation, SetExternalEstimateLoggedMinutes, StoreExternalEstimateLogResolution } from '../models/domain.models';
 export type VerifyIntegrationCredentials = (credentials: IntegrationCredentials) => Promise<void>;
 export interface ListOptions {
     limit?: number;
@@ -73,6 +73,18 @@ export interface ListSubEpicsForParentsOptions {
 export interface ListParentChildrenOptions extends ListOptions {
     statusId?: string;
 }
+export interface ListEpicRelationCandidatesOptions extends ListOptions {
+    q?: string;
+    excludeMcpHidden?: boolean;
+    workspaceId?: string;
+}
+export interface EpicRelationReadOptions {
+    excludeMcpHidden?: boolean;
+    workspaceId?: string;
+}
+export interface ListEpicRelationsOptions extends EpicRelationReadOptions, ListOptions {
+    relatedEpicId?: string;
+}
 export interface CreateEpicForProjectInput {
     title: string;
     description?: string | null;
@@ -112,6 +124,7 @@ export interface ProjectStorage {
     deleteProject(id: string): Promise<void>;
     getProjectByRootPath(rootPath: string): Promise<Project | null>;
     findProjectContainingPath(absolutePath: string): Promise<Project | null>;
+    getProjectWorkspaceSnapshot(projectId: string): Promise<Project[]>;
     getFeatureFlags(): FeatureFlagConfig;
 }
 export interface ProjectWorkspaceStorage {
@@ -132,7 +145,7 @@ export interface StatusStorage {
 }
 export interface EpicStorage {
     createEpic(data: CreateEpic, eventFactory?: (epic: Epic) => PreparedEvent | null): Promise<Epic>;
-    createEpicWithinTransaction(data: CreateEpic, eventFactory?: (epic: Epic) => PreparedEvent | null): Promise<Epic>;
+    createEpicWithinTransaction(data: CreateEpic, eventFactory?: (epic: Epic) => PreparedEvent | null, beforeEventAppend?: (epic: Epic) => Promise<void>): Promise<Epic>;
     getEpic(id: string): Promise<Epic>;
     listEpics(projectId: string, options?: ListOptions): Promise<ListResult<Epic>>;
     listEpicsByStatus(statusId: string, options?: ListOptions): Promise<ListResult<Epic>>;
@@ -140,7 +153,7 @@ export interface EpicStorage {
     listAssignedEpics(projectId: string, options: ListAssignedEpicsOptions): Promise<ListResult<Epic>>;
     createEpicForProject(projectId: string, input: CreateEpicForProjectInput, eventFactory?: (epic: Epic) => PreparedEvent | null): Promise<Epic>;
     updateEpic(id: string, data: UpdateEpic, expectedVersion: number, eventFactory?: FactualEventFactory<Epic, Epic>): Promise<Epic>;
-    deleteEpic(id: string, eventFactory?: (epic: Epic) => PreparedEvent | null): Promise<void>;
+    deleteEpic(id: string, eventFactory?: (epic: Epic, workspaceId: string) => PreparedEvent | null): Promise<void>;
     listSubEpics(parentId: string, options?: ListOptions): Promise<ListResult<Epic>>;
     listParentChildren(parentId: string, options?: ListParentChildrenOptions): Promise<ListResult<Epic>>;
     listSubEpicsForParents(projectId: string, parentIds: string[], options?: ListSubEpicsForParentsOptions): Promise<Map<string, Epic[]>>;
@@ -148,13 +161,19 @@ export interface EpicStorage {
     countEpicsByStatus(statusId: string): Promise<number>;
     updateEpicsStatus(oldStatusId: string, newStatusId: string): Promise<number>;
     listEpicComments(epicId: string, options?: ListOptions): Promise<ListResult<EpicComment>>;
-    createEpicComment(data: CreateEpicComment): Promise<EpicComment>;
+    createEpicComment(data: CreateEpicComment, eventFactory?: FactualEventFactory<EpicComment, Epic>): Promise<EpicComment>;
     deleteEpicComment(id: string): Promise<void>;
     deleteEpicCommentScoped(epicId: string, commentId: string): Promise<boolean>;
     getEpicsByIdPrefix(projectId: string, prefix: string): Promise<Array<{
         id: string;
         title: string;
     }>>;
+    setEpicRelation(data: SetEpicRelation, context?: EpicRelationWriteContext): Promise<SetEpicRelationResult>;
+    deleteEpicRelation(epicId: string, relatedEpicId: string, context?: EpicRelationWriteContext): Promise<DeleteEpicRelationResult>;
+    listEpicRelations(epicId: string, options?: ListEpicRelationsOptions): Promise<ListResult<EpicRelationListItem>>;
+    summarizeEpicRelationsBatch(epicIds: string[], options?: EpicRelationReadOptions): Promise<Map<string, EpicRelationSummary>>;
+    listEpicRelationCandidates(epicId: string, options?: ListEpicRelationCandidatesOptions): Promise<ListResult<EpicRelationCandidate>>;
+    getWorkspaceEpicsByIdPrefix(epicId: string, prefix: string, options?: EpicRelationReadOptions): Promise<EpicRelationCandidate[]>;
 }
 export interface PromptStorage {
     createPrompt(data: CreatePrompt): Promise<Prompt>;
@@ -389,28 +408,57 @@ export interface SessionStorage {
 }
 export interface IntegrationStorage {
     replaceIntegrationConnection(data: ReplaceIntegrationConnection, verify: VerifyIntegrationCredentials, eventFactory?: FactualEventFactory<IntegrationConnection, IntegrationConnection | null>): Promise<IntegrationConnection>;
-    getIntegrationConnection(provider: IntegrationProvider): Promise<IntegrationConnection | null>;
-    listIntegrationConnections(): Promise<IntegrationConnection[]>;
-    getIntegrationConnectionCredentials(provider: IntegrationProvider): Promise<IntegrationCredentials | null>;
-    disconnectIntegrationConnection(provider: IntegrationProvider, eventFactory?: (connection: IntegrationConnection) => PreparedEvent | null, options?: {
+    getIntegrationConnection(identity: IntegrationConnectionLookup): Promise<IntegrationConnection | null>;
+    getIntegrationConnectionById(connectionId: string): Promise<IntegrationConnection | null>;
+    assignUnassignedIntegrationConnection(connectionId: string, projectId: string, eventFactory?: FactualEventFactory<IntegrationConnection, IntegrationConnection>): Promise<IntegrationConnection>;
+    listIntegrationConnectionsByLegacySourceConnectionId(legacySourceConnectionId: string): Promise<IntegrationConnection[]>;
+    listIntegrationConnections(projectId?: string): Promise<IntegrationConnection[]>;
+    getIntegrationConnectionCredentials(identity: IntegrationConnectionLookup): Promise<IntegrationCredentials | null>;
+    getIntegrationConnectionCredentialsById(connectionId: string): Promise<IntegrationCredentials | null>;
+    disconnectIntegrationConnection(identity: IntegrationConnectionLookup, eventFactory?: (connection: IntegrationConnection) => PreparedEvent | null, options?: {
+        acknowledgeOrphanRisk?: boolean;
+    }): Promise<boolean>;
+    disconnectIntegrationConnectionById(connectionId: string, eventFactory?: (connection: IntegrationConnection) => PreparedEvent | null, options?: {
+        acknowledgeOrphanRisk?: boolean;
+    }): Promise<boolean>;
+    disconnectUnassignedIntegrationConnection(connectionId: string, eventFactory?: (connection: IntegrationConnection) => PreparedEvent | null, options?: {
         acknowledgeOrphanRisk?: boolean;
     }): Promise<boolean>;
-    updateIntegrationConnectionSyncSetting(provider: IntegrationProvider, subtaskSyncEnabled: boolean, eventFactory?: FactualEventFactory<IntegrationConnection, IntegrationConnection>): Promise<IntegrationConnection>;
+    updateIntegrationConnectionSyncSetting(identity: IntegrationConnectionLookup, subtaskSyncEnabled: boolean, eventFactory?: FactualEventFactory<IntegrationConnection, IntegrationConnection>): Promise<IntegrationConnection>;
+    updateIntegrationConnectionSyncSettingById(connectionId: string, subtaskSyncEnabled: boolean, eventFactory?: FactualEventFactory<IntegrationConnection, IntegrationConnection>): Promise<IntegrationConnection>;
     createExternalTaskLink(data: CreateExternalTaskLink): Promise<ExternalTaskLink>;
     createEpicWithExternalTaskLink(data: CreateEpicWithExternalTaskLink, eventFactory?: (result: CreateEpicWithExternalTaskLinkResult) => PreparedEvent | null): Promise<CreateEpicWithExternalTaskLinkResult>;
     findExternalTaskLink(provider: IntegrationProvider, remoteScopeKey: string, remoteTaskId: string): Promise<ExternalTaskLink | null>;
     listExternalTaskLinksByRemoteScope(provider: IntegrationProvider, remoteScopeKey: string): Promise<ExternalTaskLink[]>;
+    listExternalTaskLinksByRemoteTask(provider: IntegrationProvider, remoteTaskId: string): Promise<ExternalTaskLink[]>;
     listExternalTaskLinksForEpic(epicId: string): Promise<ExternalTaskLink[]>;
     listExternalTaskLinksForEpics(epicIds: string[]): Promise<ExternalTaskLink[]>;
     createExternalManagedSubtaskLink(data: CreateExternalManagedSubtaskLink): Promise<ExternalManagedSubtaskLink>;
     getExternalManagedSubtaskLink(id: string): Promise<ExternalManagedSubtaskLink>;
     listExternalManagedSubtaskLinksByProvider(provider: IntegrationProvider): Promise<ExternalManagedSubtaskLink[]>;
+    listExternalManagedSubtaskLinksByConnection(connectionId: string): Promise<ExternalManagedSubtaskLink[]>;
     listExternalManagedSubtaskLinksForEpicSnapshot(epicIdSnapshot: string): Promise<ExternalManagedSubtaskLink[]>;
     updateExternalManagedSubtaskLink(id: string, data: UpdateExternalManagedSubtaskLink): Promise<ExternalManagedSubtaskLink>;
     findRecognizedManagedSubtask(epicId: string, provider: IntegrationProvider, remoteScopeKey: string, remoteTaskId: string): Promise<ExternalManagedSubtaskLink | null>;
     confirmExternalManagedSubtaskLink(data: ConfirmExternalManagedSubtaskLink): Promise<ConfirmExternalManagedSubtaskLinkResult>;
     removeExternalManagedSubtaskLink(id: string): Promise<boolean>;
 }
-export interface StorageService extends ProjectStorage, ProjectWorkspaceStorage, StatusStorage, EpicStorage, PromptStorage, TagStorage, ProviderStorage, ProviderPluginPolicyStorage, SkillSourceStorage, AgentProfileStorage, ProfileProviderConfigStorage, AgentStorage, RecordStorage, DocumentStorage, GuestStorage, WatcherStorage, SubscriberStorage, ReviewStorage, ScheduledEpicStorage, SessionStorage, IntegrationStorage {
+export interface ExternalEstimateLogStorage {
+    getExternalEstimateLogState(identity: ExternalEstimateLogIdentity): Promise<ExternalEstimateLogState | null>;
+    getExternalEstimateLogDailyCheckpoint(identity: ExternalEstimateLogIdentity): Promise<ExternalEstimateLogDailyCheckpoint | null>;
+    listExternalEstimateLogStatesByRemoteTask(provider: IntegrationProvider, remoteTaskId: string): Promise<ExternalEstimateLogState[]>;
+    listExternalEstimateLoggedMinutes(provider: IntegrationProvider, identities: ReadonlyArray<{
+        remoteScopeKey: string;
+        remoteTaskId: string;
+    }>): Promise<ExternalEstimateLoggedMinutesEntry[]>;
+    setExternalEstimateLoggedMinutes(data: SetExternalEstimateLoggedMinutes): Promise<ExternalEstimateLogState>;
+    prepareExternalEstimateLogOperation(data: PrepareExternalEstimateLogOperation): Promise<ExternalEstimateLogState>;
+    markExternalEstimateLogOperationOutcomeUnknown(data: ExternalEstimateLogOperationMutation): Promise<ExternalEstimateLogState>;
+    confirmExternalEstimateLogOperation(data: ExternalEstimateLogOperationMutation): Promise<ExternalEstimateLogState>;
+    clearExternalEstimateLogOperation(data: ExternalEstimateLogOperationMutation): Promise<ExternalEstimateLogState>;
+    storeExternalEstimateLogResolution(data: StoreExternalEstimateLogResolution): Promise<ExternalEstimateLogState>;
+    applyExternalEstimateLogResolution(data: ExternalEstimateLogOperationMutation): Promise<ExternalEstimateLogState>;
+}
+export interface StorageService extends ProjectStorage, ProjectWorkspaceStorage, StatusStorage, EpicStorage, PromptStorage, TagStorage, ProviderStorage, ProviderPluginPolicyStorage, SkillSourceStorage, AgentProfileStorage, ProfileProviderConfigStorage, AgentStorage, RecordStorage, DocumentStorage, GuestStorage, WatcherStorage, SubscriberStorage, ReviewStorage, ScheduledEpicStorage, SessionStorage, IntegrationStorage, ExternalEstimateLogStorage {
 }
 export declare const STORAGE_SERVICE = "STORAGE_SERVICE";

package/dist/server/modules/storage/interfaces/storage.interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage.interface.js","sourceRoot":"","sources":["../../../../src/modules/storage/interfaces/storage.interface.ts"],"names":[],"mappings":";;;AAmvBa,QAAA,eAAe,GAAG,iBAAiB,CAAC"}
+{"version":3,"file":"storage.interface.js","sourceRoot":"","sources":["../../../../src/modules/storage/interfaces/storage.interface.ts"],"names":[],"mappings":";;;AA64Ba,QAAA,eAAe,GAAG,iBAAiB,CAAC"}

package/dist/server/modules/storage/local/delegates/epic.delegate.d.ts

@@ -1,5 +1,5 @@
-import { type CreateEpicForProjectInput, type ListAssignedEpicsOptions, type ListParentChildrenOptions, type ListOptions, type ListProjectEpicsOptions, type ListResult, type ListSubEpicsForParentsOptions, type FactualEventFactory } from '../../interfaces/storage.interface';
-import { type Agent, type CreateEpic, type CreateEpicComment, type CreateTag, type Epic, type EpicComment, type Status, type Tag, type UpdateEpic } from '../../models/domain.models';
+import { type CreateEpicForProjectInput, type ListAssignedEpicsOptions, type ListEpicRelationCandidatesOptions, type ListEpicRelationsOptions, type EpicRelationReadOptions, type ListParentChildrenOptions, type ListOptions, type ListProjectEpicsOptions, type ListResult, type ListSubEpicsForParentsOptions, type FactualEventFactory } from '../../interfaces/storage.interface';
+import { type Agent, type CreateEpic, type CreateEpicComment, type CreateTag, type Epic, type EpicComment, type EpicRelationCandidate, type EpicRelationListItem, type EpicRelationSummary, type EpicRelationWriteContext, type SetEpicRelationResult, type DeleteEpicRelationResult, type SetEpicRelation, type Status, type Tag, type UpdateEpic } from '../../models/domain.models';
 import { BaseStorageDelegate, type StorageDelegateContext } from './base-storage.delegate';
 import type { PreparedEvent } from '../../../events/services/durable-event-registry.service';
 export interface EpicStorageDelegateDependencies {
@@ -13,8 +13,9 @@ export declare class EpicStorageDelegate extends BaseStorageDelegate {
     private readonly dependencies;
     constructor(context: StorageDelegateContext, dependencies: EpicStorageDelegateDependencies);
     createEpic(data: CreateEpic, eventFactory?: (epic: Epic) => PreparedEvent | null): Promise<Epic>;
-    createEpicInCurrentTransaction(data: CreateEpic, eventFactory?: (epic: Epic) => PreparedEvent | null): Promise<Epic>;
+    createEpicInCurrentTransaction(data: CreateEpic, eventFactory?: (epic: Epic) => PreparedEvent | null, beforeEventAppend?: (epic: Epic) => Promise<void>): Promise<Epic>;
     private insertEpic;
+    private appendEpicEvent;
     getEpic(id: string): Promise<Epic>;
     private getEpicSync;
     listEpics(projectId: string, options?: ListOptions): Promise<ListResult<Epic>>;
@@ -23,7 +24,7 @@ export declare class EpicStorageDelegate extends BaseStorageDelegate {
     listAssignedEpics(projectId: string, options: ListAssignedEpicsOptions): Promise<ListResult<Epic>>;
     createEpicForProject(projectId: string, input: CreateEpicForProjectInput, eventFactory?: (epic: Epic) => PreparedEvent | null): Promise<Epic>;
     updateEpic(id: string, data: UpdateEpic, expectedVersion: number, eventFactory?: FactualEventFactory<Epic, Epic>): Promise<Epic>;
-    deleteEpic(id: string, eventFactory?: (epic: Epic) => PreparedEvent | null): Promise<void>;
+    deleteEpic(id: string, eventFactory?: (epic: Epic, workspaceId: string) => PreparedEvent | null): Promise<void>;
     listSubEpics(parentId: string, options?: ListOptions): Promise<ListResult<Epic>>;
     listParentChildren(parentId: string, options?: ListParentChildrenOptions): Promise<ListResult<Epic>>;
     listSubEpicsForParents(projectId: string, parentIds: string[], options?: ListSubEpicsForParentsOptions): Promise<Map<string, Epic[]>>;
@@ -31,13 +32,37 @@ export declare class EpicStorageDelegate extends BaseStorageDelegate {
     countEpicsByStatus(statusId: string): Promise<number>;
     updateEpicsStatus(oldStatusId: string, newStatusId: string): Promise<number>;
     listEpicComments(epicId: string, options?: ListOptions): Promise<ListResult<EpicComment>>;
-    createEpicComment(data: CreateEpicComment): Promise<EpicComment>;
+    createEpicComment(data: CreateEpicComment, eventFactory?: FactualEventFactory<EpicComment, Epic>): Promise<EpicComment>;
+    private insertEpicComment;
     deleteEpicComment(id: string): Promise<void>;
     deleteEpicCommentScoped(epicId: string, commentId: string): Promise<boolean>;
     getEpicsByIdPrefix(projectId: string, prefix: string): Promise<Array<{
         id: string;
         title: string;
     }>>;
+    setEpicRelation(data: SetEpicRelation, context: EpicRelationWriteContext): Promise<SetEpicRelationResult>;
+    deleteEpicRelation(epicId: string, relatedEpicId: string, context: EpicRelationWriteContext): Promise<DeleteEpicRelationResult>;
+    listEpicRelations(epicId: string, options?: ListEpicRelationsOptions): Promise<ListResult<EpicRelationListItem>>;
+    summarizeEpicRelationsBatch(epicIds: string[], options?: EpicRelationReadOptions): Promise<Map<string, EpicRelationSummary>>;
+    listEpicRelationCandidates(epicId: string, options?: ListEpicRelationCandidatesOptions): Promise<ListResult<EpicRelationCandidate>>;
+    getWorkspaceEpicsByIdPrefix(epicId: string, prefix: string, options?: EpicRelationReadOptions): Promise<EpicRelationCandidate[]>;
+    private validateRelationPairSync;
+    private authorizeRelationWriteSync;
+    private assertRelationReadWorkspace;
+    private getRelationContextSync;
+    private canonicalRelationPair;
+    private toStoredRelation;
+    private static readonly ELIGIBLE_ROUTE_SOURCE_PREDICATE;
+    private assertNoEligibleRouteCycleSync;
+    private findOutgoingEligibleRouteSync;
+    private deleteOutgoingEligibleRouteSync;
+    private ensureEpicIsNotRouteEndpointSync;
+    private assertPromotionKeepsEligibleRoutesSync;
+    private toFocalRelationType;
+    private mapEpicRelation;
+    private mapRelationCandidate;
+    private normalizeRelationListLimit;
+    private normalizeRelationListOffset;
     private ensureValidEpicParentSync;
     private buildMcpHiddenExclusionPredicate;
     private ensureValidAgentSync;