[PROD] RELEASE2 - 09/15 - ai assistant updates

[vas3a]

This pull request enhances the challenge search agent and project/challenge toolchain to better handle project name resolution, enrich challenge details with winners and phase data, and improve linking to member profiles in generated responses. The changes include updates to both agent instructions and tool interfaces, as well as new and expanded tests to ensure correct behavior.

Project and Challenge Resolution Improvements:

• The fetch-project-by-id tool now accepts either a numeric project id or a project name. When a name is provided, it searches for projects by name, preferring exact matches and surfacing ambiguous results for user disambiguation. The tool's output now includes how the project was resolved and any additional matches. [1] [2] [3]
• The challenge search agent's instructions now specify to resolve project names to ids before searching, using the updated project tool. If multiple matches are found, the user is prompted to clarify.
• The challenge-vector-query-tool input schema now documents that only numeric ids are valid for projectId, and names must be resolved first.

Challenge Details Enrichment:

• The fetch-challenge-by-id tool and its schema now return winners (with handle, userId, and placement) and phases (with detailed timing and status info) when present. [1] [2]
• Agent instructions are updated to describe how and when to use these fields, including guidance on interpreting winners and phase data.

Response Formatting and Linking:

• The agent now links member handles (e.g., challenge winners) to their profile pages using a new MEMBER_PROFILE_BASE_URL, with instructions on formatting and ordering (by placement) these links in markdown. [1] [2]

Testing Enhancements:

• New and extended tests verify correct handling of project name resolution, ambiguous matches, and the new winners/phases fields in challenge results. [1] [2]

---

Project and Name Resolution:

• Updated fetch-project-by-id tool to accept both numeric ids and project names, performing name search with disambiguation and surfacing ambiguous matches. Output now includes resolution method and extra matches. [1] [2]
• Extended tests to cover project name resolution, ambiguity handling, and error scenarios.

Challenge Details and Enrichment:

• Added winners and phases fields to the fetch-challenge-by-id tool, including schema changes and data mapping. [1] [2]
• Expanded tests to verify correct inclusion and omission of winners and phases fields.

Agent Instructions and Output Formatting:

• Updated agent instructions to require project name resolution before searching, and to prompt the user if multiple matches are found.
• Added instructions for linking member handles to profiles in markdown, with placement ordering for winners. [1] [2]
• Clarified when and how to use enriched challenge details, including interpretation of winners and phase data.

Schema and Documentation Updates:

• Improved documentation for challenge-vector-query-tool input, clarifying that only numeric ids are valid for projectId.
• Updated comments and documentation to reflect new tool capabilities and usage patterns.