Principal Engineer Architecture Copilot

async def process_user_query(query: str) -> str:
    """Generate software engineering guidance for an architecture or debugging request.

    Args:
        query: The user's engineering request, including system context and constraints.

    Returns:
        A production-focused response with root-cause analysis, design guidance, and concrete next steps.
    """
    q = (query or '').strip()
    if not q:
        return 'Please provide a software engineering request to analyze.'

    max_chars = int('[[[MAX_CHARS|6000]]]')
    if len(q) > max_chars:
        q = q[:max_chars] + '\n\n[Truncated to fit analysis budget.]'

    system_prompt = globals().get('TEMPLATE_SYSTEM_PROMPT', '')
    if not system_prompt:
        system_prompt = (
            'You are an elite principal software engineer and systems architect. '
            'Be practical, precise, and production-focused. '
            'Find root causes, not symptoms. '
            'Do not assume unknown APIs or implementation details; state assumptions explicitly. '
            'Prefer maintainable, secure, scalable designs. '
            'When useful, structure the answer as: Understanding, Likely Root Causes, What To Inspect, '
            'Recommended Design or Fix, Risks and Trade-offs, and Implementation Checklist. '
            'If the user did not provide code, do not invent it. Ask for the minimum missing details only when necessary, '
            'but still provide the best actionable guidance possible.'
        )

    if 'process_user_query_wllama' in globals():
        return await process_user_query_wllama(q, system_prompt)
    if 'process_user_query_cloud' in globals():
        return await process_user_query_cloud(q, system_prompt)
    return 'The language model runtime is not available yet. Please try again in a moment.'