added cursor.md files to root and sub folders

README.md

@@ -74,15 +74,10 @@ non-calling tests:
 
 
 
-
-
-
-
 This project is licensed under the [Apache 2.0 License](LICENSE).
 
 
 
-
 "building-mcp-track-enterprise" for Track 1"
 "building-mcp-track-consumer" for Track 1"
 "building-mcp-track-creative" for Track 1"

cursor.md

@@ -0,0 +1,258 @@
+# Cluas — Cursor Project Guide
+Mode: Surgical (1)
+
+Cursor should follow all rules below unless explicitly overridden.
+
+---
+
+# 1. Operational Mode
+
+## Surgical Mode Rules
+- Do not refactor unless explicitly instructed.
+- Do not modify multiple files unless I list them.
+- Never modify architecture, directories, or file names without approval.
+- Suggest changes through tickets or plans before acting.
+- Show diffs before application.
+- When uncertain, ask before reading or writing.
+
+## Scope Minimization
+- Default to reading only the file(s) mentioned in the prompt.
+- If the task affects a directory, request confirmation before a bulk read.
+- Use subfolder-level cursor.md files to override local behavior.
+
+---
+
+# 2. Project Overview
+
+Cluas is a multi-agent research assistant with:
+- Four character agents with distinct personas (`src/characters`)
+- An MCP-based tool layer (`src/cluas_mcp`)
+- A shared utility layer (`src/utils`)
+- A Gradio-based UI (`src/gradio`)
+- An orchestration layer (`src/orchestrator.py`)
+- Local JSON-based memory and cache (`src/data`)
+
+---
+
+# 3. Repository Structure
+
+src/
+characters/ # persona logic
+cluas_mcp/ # MCP servers & entrypoints
+academic/
+common/
+domain/
+news/
+observation/
+web/
+data/ # stored memory & cache (never modify)
+gradio/ # UI
+utils/ # shared utilities
+orchestrator.py # high-level orchestrator
+
+
+---
+
+# 4. Safe Editing Areas
+
+Cursor may edit:
+- `src/characters/*`
+- `src/cluas_mcp/*` except where noted as fragile
+- `src/gradio/app.py`
+- `src/utils/*`
+- Implementation-level code supporting tools
+- Small, isolated improvements
+
+---
+
+# 5. Restricted / Fragile Areas
+
+- `src/orchestrator.py` — changes require explicit approval
+- `src/data/*` — never modify programmatically or structurally
+- Any file not listed as safe
+- Any control-plane glue code unless specifically permitted
+- Any config or naming conventions
+
+---
+
+# 6. Architectural Notes
+
+## Characters Layer
+- Each file defines a persona with specific expertise.
+- Output formatting conventions must remain stable.
+- Do not merge personas; do not modify persona names or roles.
+
+## MCP Layer
+Contains specialized tool entrypoints:
+- `academic/`: arXiv, PubMed, Semantic Scholar fetchers
+- `news/`: news API search
+- `observation/`: bird/weather observational tools
+- `web/`: trending and general web search
+- `common/`: shared HTTP, memory, cache logic
+
+Rules:
+- Do not alter API endpoint URLs without instruction.
+- Network logic should be consistent across tools.
+- Retry, caching, and rate-limiting must remain stable.
+
+## Utilities
+- `model_list_groq.py` and others should remain small and self-contained.
+- Avoid large rewrites; maintain consistency.
+
+## Gradio UI
+- Keep user-facing function names and event wiring intact.
+
+## Orchestrator
+- Treat as a fragile, single-source-of-truth.
+- Do not rewrite flow control, dispatch, or agent coordination without approval.
+
+---
+
+# 7. Code Conventions
+
+## General
+- Follow existing stylistic patterns.
+- Prefer explicitness over magic.
+- Use docstrings consistent with current style.
+
+## Import rules
+- Maintain import locality.
+- Avoid introducing top-level cross-layer dependencies.
+
+## Error handling
+- Follow existing try/except patterns.
+- Do not remove error metadata or context.
+
+---
+
+# 8. Ticket Workflow (Required Before Major Changes)
+
+When asked for anything non-trivial:
+
+1. Produce a numbered list of proposed tickets.
+2. Each ticket contains:
+   - Goal
+   - Impacted files
+   - Expected risk
+   - Estimated complexity
+3. Wait for explicit approval before generating code.
+
+Example ticket structure:
+
+[Ticket 1] Improve arXiv query building
+Files: src/cluas_mcp/academic/arxiv.py
+Risk: Low
+Complexity: Low
+Notes: Only adjust parsing logic.
+
+
+---
+
+# 9. Diff Workflow
+
+For all modifications:
+- Always show a diff preview.
+- Only write code after explicit approval.
+- Keep diffs minimal, targeted, and reversible.
+- Do not auto-format unrelated areas.
+
+---
+
+# 10. Performance & Credit Preservation
+
+- Do not scan the whole repo without being asked.
+- Limit reads to single files or small folders.
+- Ask before reading directories > 10 files.
+- Prefer incremental review over full-context analysis.
+- Avoid speculative work.
+
+---
+
+# 11. Subfolder `cursor.md` Rules
+
+If a directory contains its own `cursor.md`:
+- That file overrides root rules *for that directory only*.
+- Root-level rules apply everywhere else.
+- Local rules must remain compatible with Surgical Mode.
+
+---
+
+# 12. MCP Tool Guidelines
+
+When editing MCP server/entrypoint modules:
+- Maintain signatures required by the MCP spec.
+- Preserve tool names, IDs, argument shapes.
+- Keep responses deterministic unless instructed otherwise.
+- Do not alter output contract formats.
+- Keep HTTP client logic consistent across tools.
+
+---
+
+# 13. Persona/Character Guidelines
+
+- Personas have fixed tone, knowledge windows, and behavioral constraints.
+- Do not alter identity, speech patterns, or output styles.
+- Internal logic may be improved but not reimagined.
+
+---
+
+# 14. Orchestrator Guidelines (High-Risk Zone)
+
+Before editing `orchestrator.py`, always:
+1. Generate a plan.
+2. Produce tickets.
+3. Wait for explicit approval.
+
+Disallowed without authorization:
+- Rewiring tool routing
+- Changing conversation state logic
+- Modifying persona dispatch
+- Changing execution order or concurrency rules
+
+---
+
+# 15. Testing / Validation Rules
+
+- Follow current usage patterns; do not introduce new frameworks.
+- Keep tests inline or minimal.
+- Ensure MCP tools remain usable without breaking contract.
+
+---
+
+# 16. Prompt Templates (For Cursor Tasks)
+
+## General Improvement
+“Review only this file: <file>. Identify small improvements. No refactors.”
+
+## Write a patch
+“Prepare a diff for tickets 1 and 2 only.”
+
+## Ask for a plan
+“Before editing, give me a plan and a ticket list.”
+
+## Isolated folder work
+“Limit analysis to src/cluas_mcp/news.”
+
+---
+
+# 17. Maintenance Guidelines
+
+- Keep modifications atomic.
+- Maintain existing naming conventions.
+- Avoid unnecessary abstraction.
+- Keep folder boundaries clean.
+- Preserve backward compatibility.
+
+---
+
+# 18. Quick Summary for Cursor
+
+- Surgical Mode only.
+- Minimal diffs.
+- Ask before reading large scopes.
+- Never refactor without permission.
+- Use tickets + plans before substantial work.
+- Preserve architecture, personas, orchestrator flow.
+- Subfolder cursor.md files override root rules.
+
+

src/characters/cursor.md

@@ -0,0 +1,18 @@
+# src/characters — Purpose
+Contains the four corvid persona definitions.
+
+# Important files
+- corvus.py
+- magpie.py
+- raven.py
+- crow.py
+
+# Context rules (Surgical)
+- Load only files in this folder unless explicitly instructed.
+- Cross-persona edits require explicit ticket approval.
+- Do not modify persona identity, tone, or output patterns.
+- Avoid network or MCP calls inside persona logic; use entrypoints.
+
+# Ignore
+- __pycache__
+- .DS_Store

src/cluas_mcp/abstract_filtered.py

@@ -1,38 +0,0 @@
-import requests
-import feedparser
-
-KEYWORDS = ['corvid','crow','raven','corvus','jay','magpie','jackdaw','rook','chough','nutcracker']
-
-def search_arxiv_clean(keywords, max_results=10):
-    query = " OR ".join(keywords)
-    url = (
-        "https://export.arxiv.org/api/query?"
-        f"search_query=all:({query})&"
-        f"start=0&max_results={max_results}&"
-        "sortBy=lastUpdatedDate&sortOrder=descending"
-    )
-
-    data = requests.get(url).text
-    feed = feedparser.parse(data)
-
-    cleaned = []
-
-    for entry in feed.entries:
-        # skip if summary missing or empty
-        if not hasattr(entry, "summary") or not entry.summary.strip():
-            continue
-
-        cleaned.append({
-            "title": entry.title,
-            "abstract": entry.summary.replace("\n", " "),
-            "authors": [a.name for a in entry.authors],
-            "published": entry.published,
-            "link": entry.link,
-        })
-
-    return cleaned
-
-if __name__ == "__main__":
-    results = search_arxiv_clean(KEYWORDS, max_results=1)
-    for r in results:
-        print(r)

src/cluas_mcp/academic/cursor.md

@@ -0,0 +1,16 @@
+# src/cluas_mcp/academic — Purpose
+Academic search clients and entrypoint.
+
+# Context rules
+- Load only academic/* files unless cross-tool work is requested.
+- Maintain API contracts and query patterns.
+- Avoid modifying tests in other folders.
+
+# Important files
+- arxiv.py
+- pubmed.py
+- semantic_scholar.py
+- academic_search_entrypoint.py
+
+# Ignore
+- __pycache__

src/cluas_mcp/blah.py

@@ -1,4 +0,0 @@
-cluas.corvus.search_papers("topic")
-cluas.magpie.find_trending("topic")
-cluas.raven.get_environmental_data("location")
-cluas.crow.analyze_patterns("dataset")

src/cluas_mcp/common/cursor.md

@@ -0,0 +1,17 @@
+# src/cluas_mcp/common — Purpose
+Shared helpers: http, cache, memory, formatting.
+
+# Context rules
+- Load only the specific file being edited.
+- Modifications are high-impact; always ticket changes first.
+- Preserve helper interfaces.
+
+# Important files
+- api_clients.py
+- cache.py
+- formatting.py
+- http.py
+- memory.py
+
+# Ignore
+- __pycache__

src/cluas_mcp/cursor.md

@@ -0,0 +1,23 @@
+# src/cluas_mcp — Purpose
+MCP tools, clients, and entrypoints used by character agents.
+
+# Architecture
+- academic/
+- news/
+- web/
+- observation/
+- common/
+- domain/
+
+# Context rules
+- Load only the specific submodule being edited.
+- Do not refactor across tool types without ticket approval.
+- Preserve MCP server contracts and entrypoint signatures.
+
+# Important files
+- server.py
+- tool_router.py
+- abstract_filtered.py
+
+# Ignore
+- __pycache__, result.xml, .DS_Store, blah.py

src/cluas_mcp/news/cursor.md

@@ -0,0 +1,13 @@
+# src/cluas_mcp/news — Purpose
+News search clients and entrypoint.
+
+# Context rules
+- Load only this folder unless explicitly told to cross-check.
+- Preserve API keys, endpoints, and response formats.
+
+# Important files
+- news_api_search.py
+- news_search_entrypoint.py
+
+# Ignore
+- __pycache__

src/cluas_mcp/observation/cursor.md

@@ -0,0 +1,15 @@
+# src/cluas_mcp/observation — Purpose
+Observation tools: eBird, weather, etc.
+
+# Context rules
+- Only load this folder unless cross-tool analysis requested.
+- Keep network and caching logic consistent.
+- Preserve entrypoint output format.
+
+# Important files
+- ebird.py
+- observation_entrypoint.py
+- weather.py
+
+# Ignore
+- __pycache__, .DS_Store

src/cluas_mcp/result.xml

@@ -1 +0,0 @@
-{'title': 'Measurement of the $ψ(2S)$ to $J/ψ$ cross-section ratio as a function of centrality in PbPb collisions at $\\sqrt{s_{\\text{NN}}}$ = 5.02 TeV', 'abstract': 'The dissociation of quarkonium states with different binding energies produced in heavy-ion collisions is a powerful probe for investigating the formation and properties of the quark-gluon plasma. The ratio of production cross-sections of $ψ(2S)$ and $J/ψ$ mesons times the ratio of their branching fractions into the dimuon final state is measured as a function of centrality using data collected by the LHCb detector in PbPb collisions at $\\sqrt{s_{\\text{NN}}}$ = 5.02 TeV. The measured ratio shows no dependence on the collision centrality, and is compared to the latest theory predictions and to the recent measurements in literature.', 'authors': ['LHCb collaboration', 'R. Aaij', 'A. S. W. Abdelmotteleb', 'C. Abellan Beteta', 'F. Abudinén', 'T. Ackernley', 'A. A. Adefisoye', 'B. Adeva', 'M. Adinolfi', 'P. Adlarson', 'C. Agapopoulou', 'C. A. Aidala', 'Z. Ajaltouni', 'S. Akar', 'K. Akiba', 'P. Albicocco', 'J. Albrecht', 'F. Alessio', 'M. Alexander', 'Z. Aliouche', 'P. Alvarez Cartelle', 'R. Amalric', 'S. Amato', 'J. L. Amey', 'Y. Amhis', 'L. An', 'L. Anderlini', 'M. Andersson', 'A. Andreianov', 'P. Andreola', 'M. Andreotti', 'D. Andreou', 'A. Anelli', 'D. Ao', 'F. Archilli', 'M. Argenton', 'S. Arguedas Cuendis', 'A. Artamonov', 'M. Artuso', 'E. Aslanides', 'R. Ataíde Da Silva', 'M. Atzeni', 'B. Audurier', 'D. Bacher', 'I. Bachiller Perea', 'S. Bachmann', 'M. Bachmayer', 'J. J. Back', 'P. Baladron Rodriguez', 'V. Balagura', 'A. Balboni', 'W. Baldini', 'L. Balzani', 'H. Bao', 'J. Baptista de Souza Leite', 'C. Barbero Pretel', 'M. Barbetti', 'I. R. Barbosa', 'R. J. Barlow', 'M. Barnyakov', 'S. Barsuk', 'W. Barter', 'M. Bartolini', 'J. Bartz', 'J. M. Basels', 'S. Bashir', 'G. Bassi', 'B. Batsukh', 'P. B. Battista', 'A. Bay', 'A. Beck', 'M. Becker', 'F. Bedeschi', 'I. B. Bediaga', 'N. A. Behling', 'S. Belin', 'K. Belous', 'I. Belov', 'I. Belyaev', 'G. Benane', 'G. Bencivenni', 'E. Ben-Haim', 'A. Berezhnoy', 'R. Bernet', 'S. Bernet Andres', 'A. Bertolin', 'C. Betancourt', 'F. Betti', 'J. Bex', 'Ia. Bezshyiko', 'J. Bhom', 'M. S. Bieker', 'N. V. Biesuz', 'P. Billoir', 'A. Biolchini', 'M. Birch', 'F. C. R. Bishop', 'A. Bitadze', 'A. Bizzeti', 'T. Blake', 'F. Blanc', 'J. E. Blank', 'S. Blusk', 'V. Bocharnikov', 'J. A. Boelhauve', 'O. Boente Garcia', 'T. Boettcher', 'A. Bohare', 'A. Boldyrev', 'C. S. Bolognani', 'R. Bolzonella', 'R. B. Bonacci', 'N. Bondar', 'A. Bordelius', 'F. Borgato', 'S. Borghi', 'M. Borsato', 'J. T. Borsuk', 'S. A. Bouchiba', 'M. Bovill', 'T. J. V. Bowcock', 'A. Boyer', 'C. Bozzi', 'A. Brea Rodriguez', 'N. Breer', 'J. Brodzicka', 'A. Brossa Gonzalo', 'J. Brown', 'D. Brundu', 'E. Buchanan', 'A. Buonaura', 'L. Buonincontri', 'A. T. Burke', 'C. Burr', 'J. S. Butter', 'J. Buytaert', 'W. Byczynski', 'S. Cadeddu', 'H. Cai', 'A. C. Caillet', 'R. Calabrese', 'S. Calderon Ramirez', 'L. Calefice', 'S. Cali', 'M. Calvi', 'M. Calvo Gomez', 'P. Camargo Magalhaes', 'J. I. Cambon Bouzas', 'P. Campana', 'D. H. Campora Perez', 'A. F. Campoverde Quezada', 'S. Capelli', 'L. Capriotti', 'R. Caravaca-Mora', 'A. Carbone', 'L. Carcedo Salgado', 'R. Cardinale', 'A. Cardini', 'P. Carniti', 'L. Carus', 'A. Casais Vidal', 'R. Caspary', 'G. Casse', 'M. Cattaneo', 'G. Cavallero', 'V. Cavallini', 'S. Celani', 'D. Cervenkov', 'S. Cesare', 'A. J. Chadwick', 'I. Chahrour', 'M. Charles', 'Ph. Charpentier', 'E. Chatzianagnostou', 'M. Chefdeville', 'C. Chen', 'S. Chen', 'Z. Chen', 'A. Chernov', 'S. Chernyshenko', 'X. Chiotopoulos', 'V. Chobanova', 'S. Cholak', 'M. Chrzaszcz', 'A. Chubykin', 'V. Chulikov', 'P. Ciambrone', 'X. Cid Vidal', 'G. Ciezarek', 'P. Cifra', 'P. E. L. Clarke', 'M. Clemencic', 'H. V. Cliff', 'J. Closier', 'C. Cocha Toapaxi', 'V. Coco', 'J. Cogan', 'E. Cogneras', 'L. Cojocariu', 'S. Collaviti', 'P. Collins', 'T. Colombo', 'M. Colonna', 'A. Comerma-Montells', 'L. Congedo', 'A. Contu', 'N. Cooke', 'I. Corredoira', 'A. Correia', 'G. Corti', 'J. J. Cottee Meldrum', 'B. Couturier', 'D. C. Craik', 'M. Cruz Torres', 'E. Curras Rivera', 'R. Currie', 'C. L. Da Silva', 'S. Dadabaev', 'L. Dai', 'X. Dai', "E. Dall'Occo", 'J. Dalseno', "C. D'Ambrosio", 'J. Daniel', 'A. Danilina', "P. d'Argent", 'G. Darze', 'A. Davidson', 'J. E. Davies', 'A. Davis', 'O. De Aguiar Francisco', 'C. De Angelis', 'F. De Benedetti', 'J. de Boer', 'K. De Bruyn', 'S. De Capua', 'M. De Cian', 'U. De Freitas Carneiro Da Graca', 'E. De Lucia', 'J. M. De Miranda', 'L. De Paula', 'M. De Serio', 'P. De Simone', 'F. De Vellis', 'J. A. de Vries', 'F. Debernardis', 'D. Decamp', 'V. Dedu', 'S. Dekkers', 'L. Del Buono', 'B. Delaney', 'H. -P. Dembinski', 'J. Deng', 'V. Denysenko', 'O. Deschamps', 'F. Dettori', 'B. Dey', 'P. Di Nezza', 'I. Diachkov', 'S. Didenko', 'S. Ding', 'L. Dittmann', 'V. Dobishuk', 'A. D. Docheva', 'C. Dong', 'A. M. Donohoe', 'F. Dordei', 'A. C. dos Reis', 'A. D. Dowling', 'W. Duan', 'P. Duda', 'M. W. Dudek', 'L. Dufour', 'V. Duk', 'P. Durante', 'M. M. Duras', 'J. M. Durham', 'O. D. Durmus', 'A. Dziurda', 'A. Dzyuba', 'S. Easo', 'E. Eckstein', 'U. Egede', 'A. Egorychev', 'V. Egorychev', 'S. Eisenhardt', 'E. Ejopu', 'L. Eklund', 'M. Elashri', 'J. Ellbracht', 'S. Ely', 'A. Ene', 'J. Eschle', 'S. Esen', 'T. Evans', 'F. Fabiano', 'L. N. Falcao', 'Y. Fan', 'B. Fang', 'L. Fantini', 'M. Faria', 'K. Farmer', 'D. Fazzini', 'L. Felkowski', 'M. Feng', 'M. Feo', 'A. Fernandez Casani', 'M. Fernandez Gomez', 'A. D. Fernez', 'F. Ferrari', 'F. Ferreira Rodrigues', 'M. Ferrillo', 'M. Ferro-Luzzi', 'S. Filippov', 'R. A. Fini', 'M. Fiorini', 'M. Firlej', 'K. L. Fischer', 'D. S. Fitzgerald', 'C. Fitzpatrick', 'T. Fiutowski', 'F. Fleuret', 'M. Fontana', 'L. F. Foreman', 'R. Forty', 'D. Foulds-Holt', 'V. Franco Lima', 'M. Franco Sevilla', 'M. Frank', 'E. Franzoso', 'G. Frau', 'C. Frei', 'D. A. Friday', 'J. Fu', 'Q. Führing', 'Y. Fujii', 'T. Fulghesu', 'E. Gabriel', 'G. Galati', 'M. D. Galati', 'A. Gallas Torreira', 'D. Galli', 'S. Gambetta', 'M. Gandelman', 'P. Gandini', 'B. Ganie', 'H. Gao', 'R. Gao', 'T. Q. Gao', 'Y. Gao', 'Y. Gao', 'Y. Gao', 'L. M. Garcia Martin', 'P. Garcia Moreno', 'J. García Pardiñas', 'P. Gardner', 'K. G. Garg', 'L. Garrido', 'C. Gaspar', 'R. E. Geertsema', 'L. L. Gerken', 'E. Gersabeck', 'M. Gersabeck', 'T. Gershon', 'S. Ghizzo', 'Z. Ghorbanimoghaddam', 'L. Giambastiani', 'F. I. Giasemis', 'V. Gibson', 'H. K. Giemza', 'A. L. Gilman', 'M. Giovannetti', 'A. Gioventù', 'L. Girardey', 'P. Gironella Gironell', 'C. Giugliano', 'M. A. Giza', 'E. L. Gkougkousis', 'F. C. Glaser', 'V. V. Gligorov', 'C. Göbel', 'E. Golobardes', 'D. Golubkov', 'A. Golutvin', 'S. Gomez Fernandez', 'W. Gomulka', 'F. Goncalves Abrantes', 'M. Goncerz', 'G. Gong', 'J. A. Gooding', 'I. V. Gorelov', 'C. Gotti', 'J. P. Grabowski', 'L. A. Granado Cardoso', 'E. Graugés', 'E. Graverini', 'L. Grazette', 'G. Graziani', 'A. T. Grecu', 'L. M. Greeven', 'N. A. Grieser', 'L. Grillo', 'S. Gromov', 'C. Gu', 'M. Guarise', 'L. Guerry', 'M. Guittiere', 'V. Guliaeva', 'P. A. Günther', 'A. -K. Guseinov', 'E. Gushchin', 'Y. Guz', 'T. Gys', 'K. Habermann', 'T. Hadavizadeh', 'C. Hadjivasiliou', 'G. Haefeli', 'C. Haen', 'M. Hajheidari', 'G. Hallett', 'M. M. Halvorsen', 'P. M. Hamilton', 'J. Hammerich', 'Q. Han', 'X. Han', 'S. Hansmann-Menzemer', 'L. Hao', 'N. Harnew', 'T. H. Harris', 'M. Hartmann', 'S. Hashmi', 'J. He', 'F. Hemmer', 'C. Henderson', 'R. D. L. Henderson', 'A. M. Hennequin', 'K. Hennessy', 'L. Henry', 'J. Herd', 'P. Herrero Gascon', 'J. Heuel', 'A. Hicheur', 'G. Hijano Mendizabal', 'J. Horswill', 'R. Hou', 'Y. Hou', 'N. Howarth', 'J. Hu', 'W. Hu', 'X. Hu', 'W. Huang', 'W. Hulsbergen', 'R. J. Hunter', 'M. Hushchyn', 'D. Hutchcroft', 'M. Idzik', 'D. Ilin', 'P. Ilten', 'A. Inglessi', 'A. Iniukhin', 'A. Ishteev', 'K. Ivshin', 'R. Jacobsson', 'H. Jage', 'S. J. Jaimes Elles', 'S. Jakobsen', 'E. Jans', 'B. K. Jashal', 'A. Jawahery', 'V. Jevtic', 'E. Jiang', 'X. Jiang', 'Y. Jiang', 'Y. J. Jiang', 'M. John', 'A. John Rubesh Rajan', 'D. Johnson', 'C. R. Jones', 'T. P. Jones', 'S. Joshi', 'B. Jost', 'J. Juan Castella', 'N. Jurik', 'I. Juszczak', 'D. Kaminaris', 'S. Kandybei', 'M. Kane', 'Y. Kang', 'C. Kar', 'M. Karacson', 'D. Karpenkov', 'A. Kauniskangas', 'J. W. Kautz', 'M. K. Kazanecki', 'F. Keizer', 'M. Kenzie', 'T. Ketel', 'B. Khanji', 'A. Kharisova', 'S. Kholodenko', 'G. Khreich', 'T. Kirn', 'V. S. Kirsebom', 'O. Kitouni', 'S. Klaver', 'N. Kleijne', 'K. Klimaszewski', 'M. R. Kmiec', 'S. Koliiev', 'L. Kolk', 'A. Konoplyannikov', 'P. Kopciewicz', 'P. Koppenburg', 'M. Korolev', 'I. Kostiuk', 'O. Kot', 'S. Kotriakhova', 'A. Kozachuk', 'P. Kravchenko', 'L. Kravchuk', 'M. Kreps', 'P. Krokovny', 'W. Krupa', 'W. Krzemien', 'O. Kshyvanskyi', 'S. Kubis', 'M. Kucharczyk', 'V. Kudryavtsev', 'E. Kulikova', 'A. Kupsc', 'B. K. Kutsenko', 'D. Lacarrere', 'P. Laguarta Gonzalez', 'A. Lai', 'A. Lampis', 'D. Lancierini', 'C. Landesa Gomez', 'J. J. Lane', 'R. Lane', 'G. Lanfranchi', 'C. Langenbruch', 'J. Langer', 'O. Lantwin', 'T. Latham', 'F. Lazzari', 'C. Lazzeroni', 'R. Le Gac', 'H. Lee', 'R. Lefèvre', 'A. Leflat', 'S. Legotin', 'M. Lehuraux', 'E. Lemos Cid', 'O. Leroy', 'T. Lesiak', 'E. D. Lesser', 'B. Leverington', 'A. Li', 'C. Li', 'H. Li', 'K. Li', 'L. Li', 'M. Li', 'P. Li', 'P. -R. Li', 'Q. Li', 'S. Li', 'T. Li', 'T. Li', 'Y. Li', 'Y. Li', 'Z. Lian', 'X. Liang', 'S. Libralon', 'C. Lin', 'T. Lin', 'R. Lindner', 'H. Linton', 'V. Lisovskyi', 'R. Litvinov', 'F. L. Liu', 'G. Liu', 'K. Liu', 'S. Liu', 'W. Liu', 'Y. Liu', 'Y. Liu', 'Y. L. Liu', 'A. Lobo Salvia', 'A. Loi', 'T. Long', 'J. H. Lopes', 'A. Lopez Huertas', 'S. López Soliño', 'Q. Lu', 'C. Lucarelli', 'D. Lucchesi', 'M. Lucio Martinez', 'V. Lukashenko', 'Y. Luo', 'A. Lupato', 'E. Luppi', 'K. Lynch', 'X. -R. Lyu', 'G. M. Ma', 'S. Maccolini', 'F. Machefert', 'F. Maciuc', 'B. Mack', 'I. Mackay', 'L. M. Mackey', 'L. R. Madhan Mohan', 'M. J. Madurai', 'A. Maevskiy', 'D. Magdalinski', 'D. Maisuzenko', 'M. W. Majewski', 'J. J. Malczewski', 'S. Malde', 'L. Malentacca', 'A. Malinin', 'T. Maltsev', 'G. Manca', 'G. Mancinelli', 'C. Mancuso', 'R. Manera Escalero', 'F. M. Manganella', 'D. Manuzzi', 'D. Marangotto', 'J. F. Marchand', 'R. Marchevski', 'U. Marconi', 'E. Mariani', 'S. Mariani', 'C. Marin Benito', 'J. Marks', 'A. M. Marshall', 'L. Martel', 'G. Martelli', 'G. Martellotti', 'L. Martinazzoli', 'M. Martinelli', 'D. Martinez Gomez', 'D. Martinez Santos', 'F. Martinez Vidal', 'A. Martorell i Granollers', 'A. Massafferri', 'R. Matev', 'A. Mathad', 'V. Matiunin', 'C. Matteuzzi', 'K. R. Mattioli', 'A. Mauri', 'E. Maurice', 'J. Mauricio', 'P. Mayencourt', 'J. Mazorra de Cos', 'M. Mazurek', 'M. McCann', 'L. Mcconnell', 'T. H. McGrath', 'N. T. McHugh', 'A. McNab', 'R. McNulty', 'B. Meadows', 'G. Meier', 'D. Melnychuk', 'F. M. Meng', 'M. Merk', 'A. Merli', 'L. Meyer Garcia', 'D. Miao', 'H. Miao', 'M. Mikhasenko', 'D. A. Milanes', 'A. Minotti', 'E. Minucci', 'T. Miralles', 'B. Mitreska', 'D. S. Mitzel', 'A. Modak', 'R. A. Mohammed', 'R. D. Moise', 'S. Mokhnenko', 'E. F. Molina Cardenas', 'T. Mombächer', 'M. Monk', 'S. Monteil', 'A. Morcillo Gomez', 'G. Morello', 'M. J. Morello', 'M. P. Morgenthaler', 'J. Moron', 'W. Morren', 'A. B. Morris', 'A. G. Morris', 'R. Mountain', 'H. Mu', 'Z. M. Mu', 'E. Muhammad', 'F. Muheim', 'M. Mulder', 'K. Müller', 'F. Muñoz-Rojas', 'R. Murta', 'P. Naik', 'T. Nakada', 'R. Nandakumar', 'T. Nanut', 'I. Nasteva', 'M. Needham', 'N. Neri', 'S. Neubert', 'N. Neufeld', 'P. Neustroev', 'J. Nicolini', 'D. Nicotra', 'E. M. Niel', 'N. Nikitin', 'Q. Niu', 'P. Nogarolli', 'P. Nogga', 'C. Normand', 'J. Novoa Fernandez', 'G. Nowak', 'C. Nunez', 'H. N. Nur', 'A. Oblakowska-Mucha', 'V. Obraztsov', 'T. Oeser', 'S. Okamura', 'A. Okhotnikov', 'O. Okhrimenko', 'R. Oldeman', 'F. Oliva', 'M. Olocco', 'C. J. G. Onderwater', "R. H. O'Neil", 'D. Osthues', 'J. M. Otalora Goicochea', 'P. Owen', 'A. Oyanguren', 'O. Ozcelik', 'F. Paciolla', 'A. Padee', 'K. O. Padeken', 'B. Pagare', 'P. R. Pais', 'T. Pajero', 'A. Palano', 'M. Palutan', 'X. Pan', 'G. Panshin', 'L. Paolucci', 'A. Papanestis', 'M. Pappagallo', 'L. L. Pappalardo', 'C. Pappenheimer', 'C. Parkes', 'D. Parmar', 'B. Passalacqua', 'G. Passaleva', 'D. Passaro', 'A. Pastore', 'M. Patel', 'J. Patoc', 'C. Patrignani', 'A. Paul', 'C. J. Pawley', 'A. Pellegrino', 'J. Peng', 'M. Pepe Altarelli', 'S. Perazzini', 'D. Pereima', 'H. Pereira Da Costa', 'A. Pereiro Castro', 'P. Perret', 'A. Perrevoort', 'A. Perro', 'M. J. Peters', 'K. Petridis', 'A. Petrolini', 'J. P. Pfaller', 'H. Pham', 'L. Pica', 'M. Piccini', 'L. Piccolo', 'B. Pietrzyk', 'G. Pietrzyk', 'D. Pinci', 'F. Pisani', 'M. Pizzichemi', 'V. Placinta', 'M. Plo Casasus', 'T. Poeschl', 'F. Polci', 'M. Poli Lener', 'A. Poluektov', 'N. Polukhina', 'I. Polyakov', 'E. Polycarpo', 'S. Ponce', 'D. Popov', 'S. Poslavskii', 'K. Prasanth', 'C. Prouve', 'D. Provenzano', 'V. Pugatch', 'G. Punzi', 'S. Qasim', 'Q. Q. Qian', 'W. Qian', 'N. Qin', 'S. Qu', 'R. Quagliani', 'R. I. Rabadan Trejo', 'J. H. Rademacker', 'M. Rama', 'M. Ramírez García', 'V. Ramos De Oliveira', 'M. Ramos Pernas', 'M. S. Rangel', 'F. Ratnikov', 'G. Raven', 'M. Rebollo De Miguel', 'F. Redi', 'J. Reich', 'F. Reiss', 'Z. Ren', 'P. K. Resmi', 'R. Ribatti', 'G. R. Ricart', 'D. Riccardi', 'S. Ricciardi', 'K. Richardson', 'M. Richardson-Slipper', 'K. Rinnert', 'P. Robbe', 'G. Robertson', 'E. Rodrigues', 'A. Rodriguez Alvarez', 'E. Rodriguez Fernandez', 'J. A. Rodriguez Lopez', 'E. Rodriguez Rodriguez', 'J. Roensch', 'A. Rogachev', 'A. Rogovskiy', 'D. L. Rolf', 'P. Roloff', 'V. Romanovskiy', 'A. Romero Vidal', 'G. Romolini', 'F. Ronchetti', 'T. Rong', 'M. Rotondo', 'S. R. Roy', 'M. S. Rudolph', 'M. Ruiz Diaz', 'R. A. Ruiz Fernandez', 'J. Ruiz Vidal', 'A. Ryzhikov', 'J. Ryzka', 'J. J. Saavedra-Arias', 'J. J. Saborido Silva', 'R. Sadek', 'N. Sagidova', 'D. Sahoo', 'N. Sahoo', 'B. Saitta', 'M. Salomoni', 'I. Sanderswood', 'R. Santacesaria', 'C. Santamarina Rios', 'M. Santimaria', 'L. Santoro', 'E. Santovetti', 'A. Saputi', 'D. Saranin', 'A. Sarnatskiy', 'G. Sarpis', 'M. Sarpis', 'C. Satriano', 'A. Satta', 'M. Saur', 'D. Savrina', 'H. Sazak', 'F. Sborzacchi', 'L. G. Scantlebury Smead', 'A. Scarabotto', 'S. Schael', 'S. Scherl', 'M. Schiller', 'H. Schindler', 'M. Schmelling', 'B. Schmidt', 'S. Schmitt', 'H. Schmitz', 'O. Schneider', 'A. Schopper', 'N. Schulte', 'S. Schulte', 'M. H. Schune', 'R. Schwemmer', 'G. Schwering', 'B. Sciascia', 'A. Sciuccati', 'I. Segal', 'S. Sellam', 'A. Semennikov', 'T. Senger', 'M. Senghi Soares', 'A. Sergi', 'N. Serra', 'L. Sestini', 'A. Seuthe', 'Y. Shang', 'D. M. Shangase', 'M. Shapkin', 'R. S. Sharma', 'I. Shchemerov', 'L. Shchutska', 'T. Shears', 'L. Shekhtman', 'Z. Shen', 'S. Sheng', 'V. Shevchenko', 'B. Shi', 'Q. Shi', 'Y. Shimizu', 'E. Shmanin', 'R. Shorkin', 'J. D. Shupperd', 'R. Silva Coutinho', 'G. Simi', 'S. Simone', 'N. Skidmore', 'T. Skwarnicki', 'M. W. Slater', 'J. C. Smallwood', 'E. Smith', 'K. Smith', 'M. Smith', 'A. Snoch', 'L. Soares Lavra', 'M. D. Sokoloff', 'F. J. P. Soler', 'A. Solomin', 'A. Solovev', 'I. Solovyev', 'N. S. Sommerfeld', 'R. Song', 'Y. Song', 'Y. Song', 'Y. S. Song', 'F. L. Souza De Almeida', 'B. Souza De Paula', 'E. Spadaro Norella', 'E. Spedicato', 'J. G. Speer', 'E. Spiridenkov', 'P. Spradlin', 'V. Sriskaran', 'F. Stagni', 'M. Stahl', 'S. Stahl', 'S. Stanislaus', 'E. N. Stein', 'O. Steinkamp', 'O. Stenyakin', 'H. Stevens', 'D. Strekalina', 'Y. Su', 'F. Suljik', 'J. Sun', 'L. Sun', 'D. Sundfeld', 'W. Sutcliffe', 'P. N. Swallow', 'K. Swientek', 'F. Swystun', 'A. Szabelski', 'T. Szumlak', 'Y. Tan', 'Y. Tang', 'M. D. Tat', 'A. Terentev', 'F. Terzuoli', 'F. Teubert', 'E. Thomas', 'D. J. D. Thompson', 'H. Tilquin', 'V. Tisserand', "S. T'Jampens", 'M. Tobin', 'L. Tomassetti', 'G. Tonani', 'X. Tong', 'D. Torres Machado', 'L. Toscano', 'D. Y. Tou', 'C. Trippl', 'G. Tuci', 'N. Tuning', 'L. H. Uecker', 'A. Ukleja', 'D. J. Unverzagt', 'B. Urbach', 'E. Ursov', 'A. Usachov', 'A. Ustyuzhanin', 'U. Uwer', 'V. Vagnoni', 'V. Valcarce Cadenas', 'G. Valenti', 'N. Valls Canudas', 'H. Van Hecke', 'E. van Herwijnen', 'C. B. Van Hulse', 'R. Van Laak', 'M. van Veghel', 'G. Vasquez', 'R. Vazquez Gomez', 'P. Vazquez Regueiro', 'C. Vázquez Sierra', 'S. Vecchi', 'J. J. Velthuis', 'M. Veltri', 'A. Venkateswaran', 'M. Verdoglia', 'M. Vesterinen', 'D. Vico Benet', 'P. Vidrier Villalba', 'M. Vieites Diaz', 'X. Vilasis-Cardona', 'E. Vilella Figueras', 'A. Villa', 'P. Vincent', 'F. C. Volle', 'D. vom Bruch', 'N. Voropaev', 'K. Vos', 'C. Vrahas', 'J. Wagner', 'J. Walsh', 'E. J. Walton', 'G. Wan', 'C. Wang', 'G. Wang', 'H. Wang', 'J. Wang', 'J. Wang', 'J. Wang', 'J. Wang', 'M. Wang', 'N. W. Wang', 'R. Wang', 'X. Wang', 'X. Wang', 'X. W. Wang', 'Y. Wang', 'Y. W. Wang', 'Z. Wang', 'Z. Wang', 'Z. Wang', 'J. A. Ward', 'M. Waterlaat', 'N. K. Watson', 'D. Websdale', 'Y. Wei', 'J. Wendel', 'B. D. C. Westhenry', 'C. White', 'M. Whitehead', 'E. Whiter', 'A. R. Wiederhold', 'D. Wiedner', 'G. Wilkinson', 'M. K. Wilkinson', 'M. Williams', 'M. J. Williams', 'M. R. J. Williams', 'R. Williams', 'Z. Williams', 'F. F. Wilson', 'M. Winn', 'W. Wislicki', 'M. Witek', 'L. Witola', 'G. Wormser', 'S. A. Wotton', 'H. Wu', 'J. Wu', 'X. Wu', 'Y. Wu', 'Z. Wu', 'K. Wyllie', 'S. Xian', 'Z. Xiang', 'Y. Xie', 'A. Xu', 'J. Xu', 'L. Xu', 'L. Xu', 'M. Xu', 'Z. Xu', 'Z. Xu', 'Z. Xu', 'K. Yang', 'S. Yang', 'X. Yang', 'Y. Yang', 'Z. Yang', 'V. Yeroshenko', 'H. Yeung', 'H. Yin', 'X. Yin', 'C. Y. Yu', 'J. Yu', 'X. Yuan', 'Y Yuan', 'E. Zaffaroni', 'M. Zavertyaev', 'M. Zdybal', 'F. Zenesini', 'C. Zeng', 'M. Zeng', 'C. Zhang', 'D. Zhang', 'J. Zhang', 'L. Zhang', 'S. Zhang', 'S. Zhang', 'Y. Zhang', 'Y. Z. Zhang', 'Z. Zhang', 'Y. Zhao', 'A. Zharkova', 'A. Zhelezov', 'S. Z. Zheng', 'X. Z. Zheng', 'Y. Zheng', 'T. Zhou', 'X. Zhou', 'Y. Zhou', 'V. Zhovkovska', 'L. Z. Zhu', 'X. Zhu', 'X. Zhu', 'V. Zhukov', 'J. Zhuo', 'Q. Zou', 'D. Zuliani', 'G. Zunica'], 'published': '2024-11-08T16:15:18Z', 'link': 'https://arxiv.org/abs/2411.05669v2'}

src/cluas_mcp/web/cursor.md

@@ -0,0 +1,13 @@
+# src/cluas_mcp/web — Purpose
+Trending and web search utilities.
+
+# Context rules
+- Only load files in this folder unless prompted otherwise.
+- Maintain search and response contracts.
+
+# Important files
+- trending.py
+- web_search_entrypoint.py
+
+# Ignore
+- __pycache__

src/gradio/cursor.md

@@ -0,0 +1,13 @@
+# src/gradio — Purpose
+Gradio UI glue; contains app.py and handlers.
+
+# Context rules
+- Only load app.py and referenced handlers for edits.
+- UI text updates allowed if ticket-approved.
+- Do not modify event wiring or state management without approval.
+
+# Important files
+- app.py
+
+# Ignore
+- __pycache__, .DS_Store

src/utils/cursor.md

@@ -0,0 +1,13 @@
+# src/utils — Purpose
+Utility scripts and small helpers.
+
+# Context rules
+- Only edit files here with explicit ticket.
+- Do not move files or refactor large blocks.
+
+# Important files
+- model_list_groq.py
+
+# Ignore
+- __pycache__
+- .DS_Store