import {
	ATLASSIAN_MCP_NAME,
	ATLASSIAN_MCP_URL,
	atlassianMcpSetupMessage,
	isAtlassianMcpConnected,
} from './mcp.ts'

/**
 * Describe atlassian MCP connection status, fallbacks, and export surface.
 * @returns Structured helper result for agents.
 * @example
 * import atlassian from 'kody:@kody/atlassian'
 * const result = await atlassian()
 * // => { ... }
 */
export default async function atlassianOverview() {
	return {
		preferred: 'mcp',
		mcp: {
			name: ATLASSIAN_MCP_NAME,
			url: ATLASSIAN_MCP_URL,
			connected: isAtlassianMcpConnected(),
			setup: atlassianMcpSetupMessage(),
		},
		fallback: {
			package: '@kody/jira',
			publicUrl: 'https://kody.codes/@kody/jira',
			auth: ['oauth', 'api-token'],
		},
		exports: ['smoke-test', 'search-jira', 'search-confluence'],
		safety: {
			readsOnlyOnMcpHelpers: true,
			mutationsStayOnJiraFallback: true,
		},
		notes: [
			'Prefer the official Atlassian MCP server (mcp_server_add name=atlassian url=https://mcp.atlassian.com/v1/mcp/authv2).',
			'Helpers call kody.mcp["atlassian"] when connected.',
			'For OAuth or API-token Jira REST, use @kody/jira.',
		],
	}
}