export type WorkbenchRole = 'maintainer' | 'committer' | 'contributor';
export type WorkbenchStatus = 'loading' | 'ready' | 'needs-config' | 'error';
export type RoleMode = 'primary' | 'manual' | 'function';
export interface ActiveRoleState {
mode: RoleMode;
role: WorkbenchRole;
functionTag?: 'RM' | 'QA';
}
export interface UserRoleSnapshot {
gitcodeId: string;
userName: string;
displayName: string;
primaryRole: WorkbenchRole;
isTcMember: boolean;
maintainerSigs: string[];
committerRepos: string[];
sigRepos: Record<string, string[]>;
allSigs: Array<{ name: string; isMaintainer: boolean; isCommitter: boolean; repos: string[] }>;
}
export type WorkflowStage =
| 'todo'
| 'in-progress'
| 'review'
| 'blocked'
| 'waiting-acceptance'
| 'done';
export type QueueId =
| 'my-queue'
| 'ready-for-coding'
| 'waiting-on-review'
| 'needs-triage'
| 'needs-review'
| 'blocked'
| 'waiting-on-contributor';
export interface LinkedPr {
number: number;
title: string;
status: 'none' | 'draft' | 'open' | 'needs-review' | 'merged' | 'closed';
url?: string;
updatedAt?: string;
}
export interface LocalWorkspaceState {
hasLocalBranch: boolean;
branchName?: string;
hasUncommittedChanges: boolean;
diffSummary?: string;
suggestedFile?: string;
}
export interface WorkItem {
id: string;
role: WorkbenchRole;
repo: string;
queueId: QueueId;
itemType: 'issue' | 'pr';
issueNumber: number;
issueTitle: string;
issueUrl?: string;
issueLabels: string[];
* 供 PR 卡非门禁标签按平台配色渲染;无色标签/未采集时为 undefined。 */
labelColors?: Record<string, string>;
issueAssignees: string[];
workflowStage: WorkflowStage;
issueState: string;
issueType: string;
progressLabel: string;
ageLabel: string;
author: string;
authorLogin?: string;
* 行动分组据此进「我负责的 PR」(reviewPr)而非「我提交的 PR」。 */
prAssigned?: boolean;
createdLabel: string;
createdAt?: string;
updatedAt?: string;
reason: string;
nextAction: string;
aiPrompt: string;
linkedPr?: LinkedPr;
isUnread?: boolean;
unreadReason?: 'new' | 'updated';
localState: LocalWorkspaceState;
* 角色过滤的「今日」/行动视图,避免组织级海量 issue 淹没个人工作流。 */
isBrowse?: boolean;
* 归属判断(我提交的 Issue/PR)不受关注影响——自己的单子永远走个人归属分组。 */
source?: 'followed';
* 全量拉取时由看板倒排索引填充,单条刷新时由 issue 详情的 kanban_values 填充;未关联则为 undefined。 */
kanbanNames?: string[];
}
export interface KanbanBoard {
id: string;
name: string;
status: number;
}
export interface KanbanCard {
number: number;
title: string;
url?: string;
repo: string;
sourceType: 'issue' | 'pr';
state: string;
itype: string;
sig?: string;
assignee?: string;
priority?: string;
createdAt?: string;
updatedAt?: string;
boardName?: string;
}
export interface DailyComparison {
yesterdayDate: string;
todayDate: string;
summary: {
yesterdayTotal: number;
todayTotal: number;
change: number;
newCount: number;
removedCount: number;
statusChangedCount: number;
};
byDomain: Array<{ domain: string; yesterday: number; today: number; change: number }>;
byDomainState?: Array<{
domain: string;
states: Array<{ state: string; today: number }>;
yesterdayTotal: number;
todayTotal: number;
change: number;
}>;
stateDistribution: Array<{ state: string; yesterday: number; today: number; change: number }>;
typeDistribution: Array<{ itype: string; yesterday: number; today: number; change: number }>;
newItems: ChangeItem[];
removedItems: ChangeItem[];
changes: DetailChange[];
}
export interface ChangeItem {
number: number;
title: string;
url: string;
domain: string;
assignee: string;
state: string;
itype: string;
repo: string;
}
export interface DetailChange {
number: number;
title: string;
url: string;
type: 'state' | 'itype';
from: string;
to: string;
domain: string;
assignee: string;
repo: string;
itype: string;
}
export interface QueueDefinition {
id: QueueId;
title: string;
description: string;
}
export interface QueueSection {
queue: QueueDefinition;
items: WorkItem[];
}
export interface RoleDashboard {
role: WorkbenchRole;
status: WorkbenchStatus;
title: string;
summary: string;
currentUser?: string;
organization?: string;
remoteRepos: string[];
remoteRepoError?: string;
configuredRepos: string[];
message?: string;
lastUpdated?: string;
totals: {
totalItems: number;
blockedItems: number;
itemsWithPr: number;
localWorkInProgress: number;
};
sections: QueueSection[];
}
export type LocalRepositoryRelation = 'official' | 'fork' | 'external';
export type ContributorTaskSectionId = 'continue' | 'start' | 'review' | 'blocked';
export interface LocalRepositoryInfo {
folderName: string;
repoFullName: string;
officialRepoFullName?: string;
localPath: string;
remoteUrl: string;
relation: LocalRepositoryRelation;
isWorktree: boolean;
localState: LocalWorkspaceState;
}
export interface CommunityOverview {
organization: string;
remoteRepoCount: number;
monitoredRepoCount: number;
configuredRepoCount: number;
localRepoCount: number;
officialLocalRepoCount: number;
forkLocalRepoCount: number;
externalLocalRepoCount: number;
remoteOnlyRepoCount: number;
}
export interface CurrentWorkspaceContext {
folderName: string;
repoFullName: string;
officialRepoFullName?: string;
relation: LocalRepositoryRelation;
isWorktree: boolean;
localPath: string;
localState: LocalWorkspaceState;
summary: string;
nextAction: string;
relatedTaskCount: number;
topTask?: WorkItem;
}
export interface ContributorTaskSection {
id: ContributorTaskSectionId;
title: string;
description: string;
items: WorkItem[];
}
export interface ContributorWorkbenchSnapshot {
status: WorkbenchStatus;
title: string;
summary: string;
currentUser?: string;
message?: string;
lastUpdated?: string;
tokenConfigured: boolean;
roles?: UserRoleSnapshot;
demoRole?: string;
viewRole?: WorkbenchRole;
overview: CommunityOverview;
currentRepo?: CurrentWorkspaceContext;
taskSections: ContributorTaskSection[];
activeSigs: string[];
monitoredRepos: string[];
configuredRepos: string[];
remoteRepos: string[];
remoteRepoError?: string;
localRepositories: LocalRepositoryInfo[];
aiAssistant?: string;
issueTemplates?: Record<string, { titlePrefix: string; labels: string[]; body: string }>;
searchActive?: boolean;
searchIds?: number[];
loadingAllOrgIssues?: boolean;
allOrgIssuesProgress?: { done: number; total: number };
pulledAllOrgIssues?: boolean;
syncing?: boolean;
refreshSummary?: { issues: number; prs: number; at: string };
}