import type { WorkflowGroup } from '../core/plugin-types.ts';
export const REQUIRED_WORKFLOW = 'session-management';
export const WORKFLOW_DISCOVERY_WORKFLOW = 'workflow-discovery';
export const DEBUG_WORKFLOW = 'doctor';
type WorkflowName = string;
function normalizeWorkflowNames(workflowNames: WorkflowName[]): WorkflowName[] {
return workflowNames.map((name) => name.trim().toLowerCase()).filter(Boolean);
}
function isWorkflowGroup(value: WorkflowGroup | undefined): value is WorkflowGroup {
return Boolean(value);
}
export function isDebugEnabled(): boolean {
const value = process.env.XCODEBUILDMCP_DEBUG ?? '';
return value.toLowerCase() === 'true' || value === '1';
}
export function isWorkflowDiscoveryEnabled(): boolean {
const value = process.env.XCODEBUILDMCP_EXPERIMENTAL_WORKFLOW_DISCOVERY ?? '';
return value.toLowerCase() === 'true' || value === '1';
}
/**
* Resolve selected workflow names to only include workflows that
* match real workflows, ensuring the mandatory workflows are always included.
*
* @param workflowNames - The list of selected workflow names
* @returns The list of workflows to register.
*/
export function resolveSelectedWorkflowNames(
workflowNames: WorkflowName[] = [],
availableWorkflowNames: WorkflowName[] = [],
): {
selectedWorkflowNames: WorkflowName[];
selectedNames: WorkflowName[] | null;
} {
const normalizedNames = normalizeWorkflowNames(workflowNames);
const baseAutoSelected = [REQUIRED_WORKFLOW];
if (isWorkflowDiscoveryEnabled()) {
baseAutoSelected.push(WORKFLOW_DISCOVERY_WORKFLOW);
}
if (isDebugEnabled()) {
baseAutoSelected.push(DEBUG_WORKFLOW);
}
let selectedNames: WorkflowName[] | null = null;
if (normalizedNames.length > 0) {
selectedNames = [...new Set([...baseAutoSelected, ...normalizedNames])];
}
// Filter selected names to only include workflows that match real workflows.
let selectedWorkflowNames: WorkflowName[];
if (selectedNames) {
selectedWorkflowNames = selectedNames.filter((workflowName) =>
availableWorkflowNames.includes(workflowName),
);
} else if (isWorkflowDiscoveryEnabled()) {
selectedWorkflowNames = [...availableWorkflowNames];
} else {
selectedWorkflowNames = availableWorkflowNames.filter(
(workflowName) => workflowName !== WORKFLOW_DISCOVERY_WORKFLOW,
);
}
return { selectedWorkflowNames, selectedNames };
}
/**
* Resolve selected workflow groups to only include workflow groups that
* match real workflow groups, ensuring the mandatory workflow groups are always included.
*
* @param workflowNames - The list of selected workflow names
* @param workflowGroups - The map of workflow groups
* @returns The list of workflow groups to register.
*/
export function resolveSelectedWorkflows(
workflowNames: WorkflowName[] = [],
workflowGroupsParam?: Map<WorkflowName, WorkflowGroup>,
): {
selectedWorkflows: WorkflowGroup[];
selectedNames: WorkflowName[] | null;
} {
const resolvedWorkflowGroups = workflowGroupsParam ?? new Map<WorkflowName, WorkflowGroup>();
const availableWorkflowNames = [...resolvedWorkflowGroups.keys()];
const selection = resolveSelectedWorkflowNames(workflowNames, availableWorkflowNames);
const selectedWorkflows = selection.selectedWorkflowNames
.map((workflowName) => resolvedWorkflowGroups.get(workflowName))
.filter(isWorkflowGroup);
return { selectedWorkflows, selectedNames: selection.selectedNames };
}
export function collectToolNames(workflows: WorkflowGroup[]): string[] {
const toolNames = new Set<string>();
for (const workflow of workflows) {
for (const tool of workflow.tools) {
if (tool?.name) {
toolNames.add(tool.name);
}
}
}
return [...toolNames];
}
