import {
	LINEAR_MCP_NAME,
	LINEAR_MCP_URL,
	linearMcpSetupMessage,
	isLinearMcpConnected,
} from './mcp.ts'

/**
 * Describe linear-mcp MCP connection status, fallbacks, and export surface.
 * @returns Structured helper result for agents.
 * @example
 * import linear_mcp from 'kody:@kody/linear-mcp'
 * const result = await linear_mcp()
 * // => { ... }
 */
export default async function linearMcpOverview() {
	return {
		package: '@kody/linear-mcp',
		preferred: 'mcp',
		mcp: {
			name: LINEAR_MCP_NAME,
			url: LINEAR_MCP_URL,
			connected: isLinearMcpConnected(),
			setup: linearMcpSetupMessage(),
		},
		oauthApiFallback: {
			package: '@kody/linear',
			publicUrl: 'https://kody.codes/@kody/linear',
		},
		exports: ["smoke-test","list-issues"],
		notes: [
			'This package wraps kody.mcp["linear"]. The MCP server name stays linear.',
			'For OAuth or API-key helpers, use @kody/linear.',
		],
	}
}