cc-viewer 1.6.281 → 1.6.283

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (68) hide show
  1. package/README.md +8 -0
  2. package/concepts/ar/Tool-LSP.md +28 -0
  3. package/concepts/ar/Tool-Workflow.md +26 -0
  4. package/concepts/da/Tool-LSP.md +28 -0
  5. package/concepts/da/Tool-Workflow.md +26 -0
  6. package/concepts/de/Tool-LSP.md +28 -0
  7. package/concepts/de/Tool-Workflow.md +26 -0
  8. package/concepts/en/Tool-LSP.md +28 -0
  9. package/concepts/en/Tool-Workflow.md +26 -0
  10. package/concepts/es/Tool-LSP.md +28 -0
  11. package/concepts/es/Tool-Workflow.md +26 -0
  12. package/concepts/fr/Tool-LSP.md +28 -0
  13. package/concepts/fr/Tool-Workflow.md +26 -0
  14. package/concepts/it/Tool-LSP.md +28 -0
  15. package/concepts/it/Tool-Workflow.md +26 -0
  16. package/concepts/ja/Tool-LSP.md +28 -0
  17. package/concepts/ja/Tool-Workflow.md +26 -0
  18. package/concepts/ko/Tool-LSP.md +28 -0
  19. package/concepts/ko/Tool-Workflow.md +26 -0
  20. package/concepts/no/Tool-LSP.md +28 -0
  21. package/concepts/no/Tool-Workflow.md +26 -0
  22. package/concepts/pl/Tool-LSP.md +28 -0
  23. package/concepts/pl/Tool-Workflow.md +26 -0
  24. package/concepts/pt-BR/Tool-LSP.md +28 -0
  25. package/concepts/pt-BR/Tool-Workflow.md +26 -0
  26. package/concepts/ru/Tool-LSP.md +28 -0
  27. package/concepts/ru/Tool-Workflow.md +26 -0
  28. package/concepts/th/Tool-LSP.md +28 -0
  29. package/concepts/th/Tool-Workflow.md +26 -0
  30. package/concepts/tr/Tool-LSP.md +28 -0
  31. package/concepts/tr/Tool-Workflow.md +26 -0
  32. package/concepts/uk/Tool-LSP.md +28 -0
  33. package/concepts/uk/Tool-Workflow.md +26 -0
  34. package/concepts/zh/Tool-LSP.md +28 -0
  35. package/concepts/zh/Tool-Workflow.md +26 -0
  36. package/concepts/zh-TW/Tool-LSP.md +28 -0
  37. package/concepts/zh-TW/Tool-Workflow.md +26 -0
  38. package/dist/assets/App-ByUIC-yr.css +1 -0
  39. package/dist/assets/App-C-jwJCC7.js +1 -0
  40. package/dist/assets/{MdxEditorPanel-DZNsukah.js → MdxEditorPanel-DcHac_1Y.js} +1 -1
  41. package/dist/assets/Mobile-D4IM7nzP.js +1 -0
  42. package/dist/assets/index-BmzQMRa6.js +2 -0
  43. package/dist/assets/index-Dh0xUI2m.css +1 -0
  44. package/dist/assets/seqResourceLoaders-Bwq1pWpw.css +41 -0
  45. package/dist/assets/seqResourceLoaders-soK06gBr.js +2 -0
  46. package/dist/index.html +2 -2
  47. package/package.json +3 -2
  48. package/server/_paths.js +2 -0
  49. package/server/i18n.js +2 -2
  50. package/server/lib/auth.js +24 -13
  51. package/server/lib/context-watcher.js +10 -6
  52. package/server/lib/proxy-env.js +16 -1
  53. package/server/lib/ultra-agents-api.js +113 -0
  54. package/server/proxy.js +23 -15
  55. package/server/routes/auth.js +4 -3
  56. package/server/routes/events.js +5 -2
  57. package/server/routes/ultra-agents.js +20 -0
  58. package/server/server.js +2 -0
  59. package/ultraAgents/README.md +62 -0
  60. package/ultraAgents/code-expert.json +45 -0
  61. package/ultraAgents/research-expert.json +45 -0
  62. package/dist/assets/App-C9RgVVSe.js +0 -1
  63. package/dist/assets/App-Ce0JeS8W.css +0 -1
  64. package/dist/assets/Mobile-DYlkN9q2.js +0 -1
  65. package/dist/assets/index-CWPrqkgG.js +0 -2
  66. package/dist/assets/index-wU9AHa7Y.css +0 -1
  67. package/dist/assets/seqResourceLoaders-CS74SVvL.js +0 -2
  68. package/dist/assets/seqResourceLoaders-qVFYq-6q.css +0 -41
package/README.md CHANGED
@@ -205,6 +205,14 @@ You can customize plugins directly, manage all cc-viewer processes, and cc-viewe
205
205
 
206
206
  More features waiting for you to discover... for example: the system supports Agent Team and ships with a built-in Code Reviewer. Codex Code Reviewer integration is coming very soon (I strongly recommend using Codex to review Claude Code's code).
207
207
 
208
+ <a href="https://www.star-history.com/?repos=weiesky%2Fcc-viewer&type=date&legend=top-left">
209
+ <picture>
210
+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=weiesky/cc-viewer&type=date&theme=dark&legend=top-left" />
211
+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=weiesky/cc-viewer&type=date&legend=top-left" />
212
+ <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=weiesky/cc-viewer&type=date&legend=top-left" />
213
+ </picture>
214
+ </a>
215
+
208
216
  ## License
209
217
 
210
218
  MIT
@@ -0,0 +1,28 @@
1
+ # LSP
2
+
3
+ يستعلم من خوادم بروتوكول خادم اللغة (LSP) للحصول على ذكاء الشيفرة — التعريفات والمراجع والتلميحات والرموز والتنفيذات وتسلسل الاستدعاءات. أكثر دقة من البحث النصي لأنه يفهم الشيفرة دلاليًا.
4
+
5
+ ## متى تستخدمه
6
+
7
+ - الانتقال إلى تعريف رمز (`goToDefinition`) أو العثور على كل مرجع له (`findReferences`)
8
+ - قراءة توقيعات الأنواع / التوثيق لرمز ما (`hover`)
9
+ - سرد الرموز في ملف واحد (`documentSymbol`) أو البحث عنها عبر المشروع بأكمله (`workspaceSymbol`)
10
+ - العثور على تنفيذات واجهة أو طريقة مجردة (`goToImplementation`)
11
+ - التنقل في تسلسل استدعاءات دالة (`prepareCallHierarchy` و`incomingCalls` و`outgoingCalls`)
12
+
13
+ ## المعاملات
14
+
15
+ - `operation` (string، مطلوب): إحدى العمليات المذكورة أعلاه.
16
+ - `filePath` (string، مطلوب): الملف المراد العمل عليه.
17
+ - `line` (number، مطلوب): رقم السطر يبدأ من 1، كما هو معروض في المحرر.
18
+ - `character` (number، مطلوب): إزاحة الحرف تبدأ من 1، كما هي معروضة في المحرر.
19
+
20
+ ## ملاحظات
21
+
22
+ - يتطلب خادم LSP مُهيَّأً لنوع الملف هذا؛ وإلا فإن الاستدعاء يُرجع خطأً.
23
+ - يبدأ السطر والحرف من 1 (إحداثيات المحرر)، وليس من 0.
24
+ - فضِّل LSP على `Grep` عندما تحتاج إلى تنقل دلالي (تعريف/مرجع حقيقي) بدلاً من تطابق نصي.
25
+
26
+ ## مفاهيم ذات صلة
27
+
28
+ - يكمّل `Read` و`Edit` عند التنقل في الشيفرة وتعديلها.
@@ -0,0 +1,26 @@
1
+ # Workflow
2
+
3
+ يشغّل نصًا برمجيًا ينسّق العديد من الوكلاء الفرعيين بشكل حتمي — التوزيع المتوازي والمسارات والحلقات والتحقق — للأعمال الواسعة جدًا أو غير المؤكدة جدًا أو الكبيرة جدًا بحيث لا يستوعبها سياق واحد.
4
+
5
+ ## متى تستخدمه
6
+
7
+ - تفكيك مهمة كبيرة وتغطيتها بالتوازي عبر العديد من الوكلاء
8
+ - التحقق المتبادل من النتائج بتحقق مستقل أو تنافسي قبل الاعتماد عليها
9
+ - التعامل مع نطاق لا يستوعبه سياق واحد: عمليات الترحيل والتدقيقات والمسوحات الواسعة متعددة الملفات
10
+
11
+ ## كيف يعمل
12
+
13
+ - يعمل في الخلفية؛ ويتم إشعارك عند انتهائه. تابع التقدم المباشر عبر `/workflows`.
14
+ - ينسّق النص البرمجي الوكلاء باستخدام `agent()` و`parallel()` و`pipeline()` و`phase()`.
15
+ - يدفق `pipeline()` كل عنصر عبر المراحل دون حاجز (الوضع الافتراضي)؛ بينما `parallel()` حاجز ينتظر جميع النتائج.
16
+ - مع `schema`، يُرجع كل `agent()` بيانات منظمة ومُتحقَّقًا منها بدلاً من نص حر.
17
+
18
+ ## ملاحظات
19
+
20
+ - لا يعمل إلا عندما يختار المستخدم صراحةً تنسيق متعدد الوكلاء؛ فقد يُنشئ العديد من الوكلاء ويستهلك قدرًا كبيرًا من الرموز (token).
21
+ - التزامن محدود بسقف لكل سير عمل؛ والوكلاء الزائدون ينتظرون في طابور ويعملون كلما تحررت الفتحات.
22
+ - لوكيل فرعي واحد، استخدم أداة `Agent` بدلاً من ذلك — واحتفظ بـ Workflow للتوزيع المتوازي الحقيقي.
23
+
24
+ ## مفاهيم ذات صلة
25
+
26
+ - يُبنى على أداة `Agent`، مشغّلاً العديد من الوكلاء ضمن تدفق تحكم حتمي.
@@ -0,0 +1,28 @@
1
+ # LSP
2
+
3
+ Forespørger Language Server Protocol-servere (LSP) for kodeintelligens — definitioner, referencer, hover, symboler, implementeringer og kaldhierarki. Mere præcist end tekstsøgning, fordi det forstår kode semantisk.
4
+
5
+ ## Hvornår skal det bruges
6
+
7
+ - Spring til et symbols definition (`goToDefinition`) eller find alle referencer (`findReferences`)
8
+ - Læs typesignaturer / dokumentation for et symbol (`hover`)
9
+ - List symboler i én fil (`documentSymbol`) eller søg efter dem på tværs af projektet (`workspaceSymbol`)
10
+ - Find implementeringer af en grænseflade eller abstrakt metode (`goToImplementation`)
11
+ - Gennemløb kaldhierarkiet for en funktion (`prepareCallHierarchy`, `incomingCalls`, `outgoingCalls`)
12
+
13
+ ## Parametre
14
+
15
+ - `operation` (streng, påkrævet): en af de operationer, der er nævnt ovenfor.
16
+ - `filePath` (streng, påkrævet): den fil, der skal arbejdes på.
17
+ - `line` (tal, påkrævet): 1-baseret linjenummer, som vist i editoren.
18
+ - `character` (tal, påkrævet): 1-baseret tegnforskydning, som vist i editoren.
19
+
20
+ ## Noter
21
+
22
+ - Kræver en konfigureret LSP-server til den filtype; ellers returnerer kaldet en fejl.
23
+ - Linje og tegn er 1-baserede (editorkoordinater), ikke 0-baserede.
24
+ - Foretræk LSP frem for `Grep`, når du har brug for semantisk navigation (sand definition/reference) frem for et tekstmatch.
25
+
26
+ ## Relaterede begreber
27
+
28
+ - Supplerer `Read` og `Edit`, når du navigerer i og ændrer kode.
@@ -0,0 +1,26 @@
1
+ # Workflow
2
+
3
+ Kører et script, der deterministisk orkestrerer mange underagenter — fan-out, pipelines, løkker og verifikation — til arbejde, der er for bredt, for usikkert eller for stort til en enkelt kontekst.
4
+
5
+ ## Hvornår skal det bruges
6
+
7
+ - Nedbryd en stor opgave og dæk den parallelt på tværs af mange agenter
8
+ - Krydstjek fund med uafhængig eller adversarial verifikation, før du fæster lid til dem
9
+ - Tag fat på skala, som én kontekst ikke kan rumme: migreringer, audits, brede gennemløb af mange filer
10
+
11
+ ## Sådan fungerer det
12
+
13
+ - Kører i baggrunden; du får besked, når det er færdigt. Følg den løbende fremdrift med `/workflows`.
14
+ - Scriptet koordinerer agenter med `agent()`, `parallel()`, `pipeline()` og `phase()`.
15
+ - `pipeline()` streamer hvert element gennem stadierne uden barriere (standard); `parallel()` er en barriere, der venter på alle resultater.
16
+ - Med et schema returnerer hvert `agent()` valideret struktureret data i stedet for fri tekst.
17
+
18
+ ## Noter
19
+
20
+ - Kører kun, når brugeren udtrykkeligt vælger orkestrering med flere agenter; det kan starte mange agenter og forbruge betydelige tokens.
21
+ - Samtidigheden er begrænset pr. workflow; overskydende agenter sættes i kø og kører, efterhånden som pladser bliver ledige.
22
+ - Til en enkelt underagent skal du bruge `Agent`-værktøjet i stedet — gem Workflow til reel fan-out.
23
+
24
+ ## Relaterede begreber
25
+
26
+ - Bygger på `Agent`-værktøjet og kører mange agenter under deterministisk kontrolflow.
@@ -0,0 +1,28 @@
1
+ # LSP
2
+
3
+ Fragt Language-Server-Protocol-(LSP-)Server nach Code-Intelligenz ab — Definitionen, Referenzen, Hover-Informationen, Symbole, Implementierungen und Aufrufhierarchie. Präziser als eine Textsuche, weil es Code semantisch versteht.
4
+
5
+ ## Wann zu verwenden
6
+
7
+ - Zur Definition eines Symbols springen (`goToDefinition`) oder jede Referenz finden (`findReferences`)
8
+ - Typsignaturen / Dokumentation für ein Symbol lesen (`hover`)
9
+ - Symbole in einer Datei auflisten (`documentSymbol`) oder projektweit danach suchen (`workspaceSymbol`)
10
+ - Implementierungen einer Schnittstelle oder abstrakten Methode finden (`goToImplementation`)
11
+ - Die Aufrufhierarchie einer Funktion durchlaufen (`prepareCallHierarchy`, `incomingCalls`, `outgoingCalls`)
12
+
13
+ ## Parameter
14
+
15
+ - `operation` (string, erforderlich): eine der oben aufgeführten Operationen.
16
+ - `filePath` (string, erforderlich): die zu bearbeitende Datei.
17
+ - `line` (number, erforderlich): 1-basierte Zeilennummer, wie im Editor angezeigt.
18
+ - `character` (number, erforderlich): 1-basierter Zeichenoffset, wie im Editor angezeigt.
19
+
20
+ ## Hinweise
21
+
22
+ - Erfordert einen konfigurierten LSP-Server für diesen Dateityp; andernfalls gibt der Aufruf einen Fehler zurück.
23
+ - Zeile und Zeichen sind 1-basiert (Editor-Koordinaten), nicht 0-basiert.
24
+ - Bevorzuge LSP gegenüber `Grep`, wenn du semantische Navigation (echte Definition/Referenz) statt einer textuellen Übereinstimmung benötigst.
25
+
26
+ ## Verwandte Konzepte
27
+
28
+ - Ergänzt `Read` und `Edit` beim Navigieren und Ändern von Code.
@@ -0,0 +1,26 @@
1
+ # Workflow
2
+
3
+ Führt ein Skript aus, das viele Subagenten deterministisch orchestriert — Fan-out, Pipelines, Schleifen und Verifizierung — für Arbeit, die zu breit, zu unsicher oder zu groß für einen einzelnen Kontext ist.
4
+
5
+ ## Wann zu verwenden
6
+
7
+ - Eine große Aufgabe zerlegen und parallel über viele Agenten hinweg abdecken
8
+ - Ergebnisse durch unabhängige oder adversariale Verifizierung gegenprüfen, bevor man sich auf sie verlässt
9
+ - Einen Umfang bewältigen, den ein einzelner Kontext nicht fassen kann: Migrationen, Audits, breite dateiübergreifende Durchläufe
10
+
11
+ ## Funktionsweise
12
+
13
+ - Läuft im Hintergrund; du wirst benachrichtigt, wenn es fertig ist. Verfolge den Live-Fortschritt mit `/workflows`.
14
+ - Das Skript koordiniert Agenten mit `agent()`, `parallel()`, `pipeline()` und `phase()`.
15
+ - `pipeline()` streamt jedes Element ohne Barriere durch die Stufen (Standard); `parallel()` ist eine Barriere, die auf alle Ergebnisse wartet.
16
+ - Mit einem `schema` gibt jeder `agent()` validierte strukturierte Daten statt Freitext zurück.
17
+
18
+ ## Hinweise
19
+
20
+ - Läuft nur, wenn sich der Benutzer ausdrücklich für eine Multi-Agenten-Orchestrierung entscheidet; es kann viele Agenten erzeugen und erhebliche Token verbrauchen.
21
+ - Die Nebenläufigkeit ist pro Workflow gedeckelt; überschüssige Agenten werden in eine Warteschlange gestellt und laufen, sobald Plätze frei werden.
22
+ - Für einen einzelnen Subagenten verwende stattdessen das Werkzeug `Agent` — reserviere Workflow für echtes Fan-out.
23
+
24
+ ## Verwandte Konzepte
25
+
26
+ - Baut auf dem Werkzeug `Agent` auf und führt viele Agenten unter deterministischem Kontrollfluss aus.
@@ -0,0 +1,28 @@
1
+ # LSP
2
+
3
+ Queries Language Server Protocol (LSP) servers for code intelligence — definitions, references, hovers, symbols, implementations, and call hierarchy. More precise than text search because it understands code semantically.
4
+
5
+ ## When to Use
6
+
7
+ - Jump to a symbol's definition (`goToDefinition`) or find every reference (`findReferences`)
8
+ - Read type signatures / documentation for a symbol (`hover`)
9
+ - List symbols in one file (`documentSymbol`) or search them across the project (`workspaceSymbol`)
10
+ - Find implementations of an interface or abstract method (`goToImplementation`)
11
+ - Walk the call hierarchy of a function (`prepareCallHierarchy`, `incomingCalls`, `outgoingCalls`)
12
+
13
+ ## Parameters
14
+
15
+ - `operation` (string, required): one of the operations listed above.
16
+ - `filePath` (string, required): the file to operate on.
17
+ - `line` (number, required): 1-based line number, as shown in the editor.
18
+ - `character` (number, required): 1-based character offset, as shown in the editor.
19
+
20
+ ## Notes
21
+
22
+ - Requires a configured LSP server for that file type; otherwise the call returns an error.
23
+ - Line and character are 1-based (editor coordinates), not 0-based.
24
+ - Prefer LSP over `Grep` when you need semantic navigation (true definition/reference) rather than a textual match.
25
+
26
+ ## Related Concepts
27
+
28
+ - Complements `Read` and `Edit` when navigating and changing code.
@@ -0,0 +1,26 @@
1
+ # Workflow
2
+
3
+ Runs a script that orchestrates many subagents deterministically — fan-out, pipelines, loops, and verification — for work that is too broad, too uncertain, or too large for a single context.
4
+
5
+ ## When to Use
6
+
7
+ - Decompose a large task and cover it in parallel across many agents
8
+ - Cross-check findings with independent or adversarial verification before committing to them
9
+ - Take on scale one context can't hold: migrations, audits, broad multi-file sweeps
10
+
11
+ ## How It Works
12
+
13
+ - Runs in the background; you are notified when it finishes. Watch live progress with `/workflows`.
14
+ - The script coordinates agents with `agent()`, `parallel()`, `pipeline()`, and `phase()`.
15
+ - `pipeline()` streams each item through stages with no barrier (default); `parallel()` is a barrier that waits for all results.
16
+ - With a schema, each `agent()` returns validated structured data instead of free text.
17
+
18
+ ## Notes
19
+
20
+ - Only runs when the user explicitly opts into multi-agent orchestration; it can spawn many agents and consume significant tokens.
21
+ - Concurrency is capped per workflow; excess agents queue and run as slots free up.
22
+ - For a single subagent, use the `Agent` tool instead — reserve Workflow for real fan-out.
23
+
24
+ ## Related Concepts
25
+
26
+ - Builds on the `Agent` tool, running many agents under deterministic control flow.
@@ -0,0 +1,28 @@
1
+ # LSP
2
+
3
+ Consulta servidores Language Server Protocol (LSP) para obtener inteligencia de código: definiciones, referencias, información al pasar el cursor, símbolos, implementaciones y jerarquía de llamadas. Más preciso que la búsqueda de texto porque entiende el código de forma semántica.
4
+
5
+ ## Cuándo usarlo
6
+
7
+ - Saltar a la definición de un símbolo (`goToDefinition`) o encontrar cada una de sus referencias (`findReferences`)
8
+ - Leer las firmas de tipos / la documentación de un símbolo (`hover`)
9
+ - Listar los símbolos de un archivo (`documentSymbol`) o buscarlos en todo el proyecto (`workspaceSymbol`)
10
+ - Encontrar las implementaciones de una interfaz o un método abstracto (`goToImplementation`)
11
+ - Recorrer la jerarquía de llamadas de una función (`prepareCallHierarchy`, `incomingCalls`, `outgoingCalls`)
12
+
13
+ ## Parámetros
14
+
15
+ - `operation` (string, obligatorio): una de las operaciones enumeradas arriba.
16
+ - `filePath` (string, obligatorio): el archivo sobre el que operar.
17
+ - `line` (number, obligatorio): número de línea basado en 1, tal como se muestra en el editor.
18
+ - `character` (number, obligatorio): desplazamiento de carácter basado en 1, tal como se muestra en el editor.
19
+
20
+ ## Notas
21
+
22
+ - Requiere un servidor LSP configurado para ese tipo de archivo; de lo contrario, la llamada devuelve un error.
23
+ - La línea y el carácter están basados en 1 (coordenadas del editor), no en 0.
24
+ - Prefiere LSP frente a `Grep` cuando necesites navegación semántica (definición/referencia real) en lugar de una coincidencia textual.
25
+
26
+ ## Conceptos relacionados
27
+
28
+ - Complementa a `Read` y `Edit` al navegar y modificar código.
@@ -0,0 +1,26 @@
1
+ # Workflow
2
+
3
+ Ejecuta un script que orquesta muchos subagentes de forma determinista —distribución en abanico, canalizaciones, bucles y verificación— para trabajo demasiado amplio, demasiado incierto o demasiado grande para un solo contexto.
4
+
5
+ ## Cuándo usarlo
6
+
7
+ - Descomponer una tarea grande y cubrirla en paralelo a través de muchos agentes
8
+ - Contrastar los hallazgos con una verificación independiente o adversarial antes de confiar en ellos
9
+ - Abordar una escala que un solo contexto no puede contener: migraciones, auditorías, barridos amplios en múltiples archivos
10
+
11
+ ## Cómo funciona
12
+
13
+ - Se ejecuta en segundo plano; se te notifica cuando termina. Sigue el progreso en directo con `/workflows`.
14
+ - El script coordina agentes con `agent()`, `parallel()`, `pipeline()` y `phase()`.
15
+ - `pipeline()` transmite cada elemento a través de las etapas sin barrera (por defecto); `parallel()` es una barrera que espera todos los resultados.
16
+ - Con un `schema`, cada `agent()` devuelve datos estructurados y validados en lugar de texto libre.
17
+
18
+ ## Notas
19
+
20
+ - Solo se ejecuta cuando el usuario opta explícitamente por la orquestación multiagente; puede generar muchos agentes y consumir una cantidad considerable de token.
21
+ - La concurrencia tiene un límite por workflow; los agentes sobrantes se ponen en cola y se ejecutan a medida que se liberan espacios.
22
+ - Para un solo subagente, usa en su lugar la herramienta `Agent`; reserva Workflow para una verdadera distribución en abanico.
23
+
24
+ ## Conceptos relacionados
25
+
26
+ - Se basa en la herramienta `Agent`, ejecutando muchos agentes bajo un flujo de control determinista.
@@ -0,0 +1,28 @@
1
+ # LSP
2
+
3
+ Interroge les serveurs Language Server Protocol (LSP) pour obtenir de l'intelligence de code — définitions, références, info-bulles, symboles, implémentations et hiérarchie d'appels. Plus précis qu'une recherche textuelle, car il comprend le code de manière sémantique.
4
+
5
+ ## Quand l'utiliser
6
+
7
+ - Sauter à la définition d'un symbole (`goToDefinition`) ou trouver chacune de ses références (`findReferences`)
8
+ - Lire les signatures de types / la documentation d'un symbole (`hover`)
9
+ - Lister les symboles d'un fichier (`documentSymbol`) ou les rechercher dans tout le projet (`workspaceSymbol`)
10
+ - Trouver les implémentations d'une interface ou d'une méthode abstraite (`goToImplementation`)
11
+ - Parcourir la hiérarchie d'appels d'une fonction (`prepareCallHierarchy`, `incomingCalls`, `outgoingCalls`)
12
+
13
+ ## Paramètres
14
+
15
+ - `operation` (string, requis) : l'une des opérations énumérées ci-dessus.
16
+ - `filePath` (string, requis) : le fichier sur lequel opérer.
17
+ - `line` (number, requis) : numéro de ligne commençant à 1, tel qu'affiché dans l'éditeur.
18
+ - `character` (number, requis) : décalage de caractère commençant à 1, tel qu'affiché dans l'éditeur.
19
+
20
+ ## Notes
21
+
22
+ - Nécessite un serveur LSP configuré pour ce type de fichier ; sinon, l'appel renvoie une erreur.
23
+ - La ligne et le caractère commencent à 1 (coordonnées de l'éditeur), pas à 0.
24
+ - Préférez LSP à `Grep` lorsque vous avez besoin d'une navigation sémantique (définition/référence réelle) plutôt que d'une correspondance textuelle.
25
+
26
+ ## Concepts associés
27
+
28
+ - Complète `Read` et `Edit` lors de la navigation dans le code et de sa modification.
@@ -0,0 +1,26 @@
1
+ # Workflow
2
+
3
+ Exécute un script qui orchestre de nombreux sous-agents de manière déterministe — diffusion en éventail, pipelines, boucles et vérification — pour un travail trop vaste, trop incertain ou trop volumineux pour un seul contexte.
4
+
5
+ ## Quand l'utiliser
6
+
7
+ - Décomposer une tâche volumineuse et la couvrir en parallèle sur de nombreux agents
8
+ - Recouper les résultats par une vérification indépendante ou contradictoire avant de s'y fier
9
+ - Prendre en charge une échelle qu'un seul contexte ne peut contenir : migrations, audits, balayages étendus sur plusieurs fichiers
10
+
11
+ ## Fonctionnement
12
+
13
+ - S'exécute en arrière-plan ; vous êtes notifié à la fin. Suivez la progression en direct avec `/workflows`.
14
+ - Le script coordonne les agents avec `agent()`, `parallel()`, `pipeline()` et `phase()`.
15
+ - `pipeline()` fait transiter chaque élément à travers les étapes sans barrière (par défaut) ; `parallel()` est une barrière qui attend tous les résultats.
16
+ - Avec un `schema`, chaque `agent()` renvoie des données structurées validées plutôt qu'un texte libre.
17
+
18
+ ## Notes
19
+
20
+ - Ne s'exécute que lorsque l'utilisateur opte explicitement pour une orchestration multi-agents ; il peut générer de nombreux agents et consommer une quantité importante de token.
21
+ - La concurrence est plafonnée par workflow ; les agents excédentaires sont mis en file d'attente et s'exécutent à mesure que des emplacements se libèrent.
22
+ - Pour un seul sous-agent, utilisez plutôt l'outil `Agent` — réservez Workflow à une véritable diffusion en éventail.
23
+
24
+ ## Concepts associés
25
+
26
+ - S'appuie sur l'outil `Agent`, en exécutant de nombreux agents sous un flux de contrôle déterministe.
@@ -0,0 +1,28 @@
1
+ # LSP
2
+
3
+ Interroga i server del Language Server Protocol (LSP) per ottenere intelligenza sul codice — definizioni, riferimenti, hover, simboli, implementazioni e gerarchia delle chiamate. Più preciso della ricerca testuale perché comprende il codice in modo semantico.
4
+
5
+ ## Quando usare
6
+
7
+ - Saltare alla definizione di un simbolo (`goToDefinition`) o trovare ogni riferimento (`findReferences`)
8
+ - Leggere le firme di tipo / la documentazione di un simbolo (`hover`)
9
+ - Elencare i simboli in un file (`documentSymbol`) o cercarli in tutto il progetto (`workspaceSymbol`)
10
+ - Trovare le implementazioni di un'interfaccia o di un metodo astratto (`goToImplementation`)
11
+ - Percorrere la gerarchia delle chiamate di una funzione (`prepareCallHierarchy`, `incomingCalls`, `outgoingCalls`)
12
+
13
+ ## Parametri
14
+
15
+ - `operation` (string, obbligatorio): una delle operazioni elencate sopra.
16
+ - `filePath` (string, obbligatorio): il file su cui operare.
17
+ - `line` (number, obbligatorio): numero di riga a base 1, come mostrato nell'editor.
18
+ - `character` (number, obbligatorio): offset di carattere a base 1, come mostrato nell'editor.
19
+
20
+ ## Note
21
+
22
+ - Richiede un server LSP configurato per quel tipo di file; altrimenti la chiamata restituisce un errore.
23
+ - Riga e carattere sono a base 1 (coordinate dell'editor), non a base 0.
24
+ - Preferisci LSP a `Grep` quando hai bisogno di navigazione semantica (definizione/riferimento reali) anziché di una corrispondenza testuale.
25
+
26
+ ## Concetti correlati
27
+
28
+ - Complementa `Read` ed `Edit` quando navighi e modifichi il codice.
@@ -0,0 +1,26 @@
1
+ # Workflow
2
+
3
+ Esegue uno script che orchestra molti subagenti in modo deterministico — fan-out, pipeline, loop e verifica — per lavoro troppo ampio, troppo incerto o troppo grande per un singolo contesto.
4
+
5
+ ## Quando usare
6
+
7
+ - Scomporre un compito grande e coprirlo in parallelo su molti agenti
8
+ - Verificare i risultati con una verifica indipendente o avversaria prima di farli propri
9
+ - Affrontare una scala che un singolo contesto non può contenere: migrazioni, audit, ampie scansioni multi-file
10
+
11
+ ## Come funziona
12
+
13
+ - Viene eseguito in background; ricevi una notifica al termine. Osserva il progresso in tempo reale con `/workflows`.
14
+ - Lo script coordina gli agenti con `agent()`, `parallel()`, `pipeline()` e `phase()`.
15
+ - `pipeline()` fa scorrere ogni elemento attraverso gli stadi senza barriera (default); `parallel()` è una barriera che attende tutti i risultati.
16
+ - Con uno schema, ogni `agent()` restituisce dati strutturati validati anziché testo libero.
17
+
18
+ ## Note
19
+
20
+ - Viene eseguito solo quando l'utente sceglie esplicitamente l'orchestrazione multi-agente; può generare molti agenti e consumare un numero significativo di token.
21
+ - La concorrenza è limitata per ciascun workflow; gli agenti in eccesso si accodano e vengono eseguiti man mano che si liberano slot.
22
+ - Per un singolo subagente, usa invece il tool `Agent` — riserva Workflow per un vero fan-out.
23
+
24
+ ## Concetti correlati
25
+
26
+ - Si basa sul tool `Agent`, eseguendo molti agenti sotto un flusso di controllo deterministico.
@@ -0,0 +1,28 @@
1
+ # LSP
2
+
3
+ Language Server Protocol (LSP) サーバーに問い合わせてコードインテリジェンス — 定義、参照、ホバー、シンボル、実装、呼び出し階層 — を取得します。コードを意味的に理解するため、テキスト検索よりも正確です。
4
+
5
+ ## 使用タイミング
6
+
7
+ - シンボルの定義へジャンプする (`goToDefinition`)、またはすべての参照を見つける (`findReferences`)
8
+ - シンボルの型シグネチャ / ドキュメントを読む (`hover`)
9
+ - 1 つのファイル内のシンボルを一覧する (`documentSymbol`)、またはプロジェクト全体で検索する (`workspaceSymbol`)
10
+ - インターフェースや抽象メソッドの実装を見つける (`goToImplementation`)
11
+ - 関数の呼び出し階層をたどる (`prepareCallHierarchy`、`incomingCalls`、`outgoingCalls`)
12
+
13
+ ## パラメータ
14
+
15
+ - `operation` (string, required): 上記のいずれかの操作。
16
+ - `filePath` (string, required): 操作対象のファイル。
17
+ - `line` (number, required): エディタに表示される 1 始まりの行番号。
18
+ - `character` (number, required): エディタに表示される 1 始まりの文字オフセット。
19
+
20
+ ## 注意事項
21
+
22
+ - そのファイルタイプ用に構成された LSP サーバーが必要です。そうでない場合、呼び出しはエラーを返します。
23
+ - line と character は 0 始まりではなく 1 始まり (エディタ座標) です。
24
+ - テキストの一致ではなく意味的なナビゲーション (真の定義/参照) が必要な場合は、`Grep` よりも LSP を優先してください。
25
+
26
+ ## 関連概念
27
+
28
+ - コードをナビゲートして変更する際に `Read` と `Edit` を補完します。
@@ -0,0 +1,26 @@
1
+ # Workflow
2
+
3
+ 多数のサブエージェントを決定論的にオーケストレーションする — ファンアウト、パイプライン、ループ、検証 — スクリプトを実行します。単一のコンテキストには広すぎる、不確実すぎる、または大きすぎる作業向けです。
4
+
5
+ ## 使用タイミング
6
+
7
+ - 大きなタスクを分解し、多数のエージェントにまたがって並列にカバーする
8
+ - 結果を採用する前に、独立したまたは敵対的な検証でクロスチェックする
9
+ - 単一のコンテキストでは保持できない規模に取り組む: 移行、監査、広範な複数ファイルの一括処理
10
+
11
+ ## 仕組み
12
+
13
+ - バックグラウンドで実行され、完了時に通知されます。`/workflows` でライブの進捗を確認できます。
14
+ - スクリプトは `agent()`、`parallel()`、`pipeline()`、`phase()` でエージェントを調整します。
15
+ - `pipeline()` は各アイテムをバリアなしでステージにストリームします (デフォルト)。`parallel()` はすべての結果を待つバリアです。
16
+ - スキーマを指定すると、各 `agent()` は自由テキストではなく検証済みの構造化データを返します。
17
+
18
+ ## 注意事項
19
+
20
+ - ユーザーがマルチエージェントオーケストレーションを明示的に選択した場合にのみ実行されます。多数のエージェントを起動し、かなりの token を消費する可能性があります。
21
+ - 同時実行数はワークフローごとに上限が設けられています。超過したエージェントはキューに入り、スロットが空き次第実行されます。
22
+ - 単一のサブエージェントには、代わりに `Agent` ツールを使用してください — Workflow は真のファンアウトに留めてください。
23
+
24
+ ## 関連概念
25
+
26
+ - `Agent` ツールを基盤とし、決定論的な制御フローのもとで多数のエージェントを実行します。
@@ -0,0 +1,28 @@
1
+ # LSP
2
+
3
+ Language Server Protocol (LSP) 서버에 질의하여 코드 인텔리전스 — 정의, 참조, 호버, 심볼, 구현, 호출 계층 — 를 가져옵니다. 코드를 의미적으로 이해하므로 텍스트 검색보다 정확합니다.
4
+
5
+ ## 사용 시점
6
+
7
+ - 심볼의 정의로 이동하거나 (`goToDefinition`) 모든 참조를 찾기 (`findReferences`)
8
+ - 심볼의 타입 시그니처 / 문서 읽기 (`hover`)
9
+ - 한 파일의 심볼을 나열하거나 (`documentSymbol`) 프로젝트 전체에서 검색하기 (`workspaceSymbol`)
10
+ - 인터페이스나 추상 메서드의 구현 찾기 (`goToImplementation`)
11
+ - 함수의 호출 계층 따라가기 (`prepareCallHierarchy`, `incomingCalls`, `outgoingCalls`)
12
+
13
+ ## 매개변수
14
+
15
+ - `operation` (string, 필수): 위에 나열된 작업 중 하나.
16
+ - `filePath` (string, 필수): 작업할 파일.
17
+ - `line` (number, 필수): 에디터에 표시되는 1부터 시작하는 줄 번호.
18
+ - `character` (number, 필수): 에디터에 표시되는 1부터 시작하는 문자 오프셋.
19
+
20
+ ## 참고사항
21
+
22
+ - 해당 파일 타입에 맞게 구성된 LSP 서버가 필요합니다. 그렇지 않으면 호출이 오류를 반환합니다.
23
+ - line과 character는 0부터가 아니라 1부터 시작합니다 (에디터 좌표).
24
+ - 텍스트 일치가 아니라 의미적 탐색 (실제 정의/참조)이 필요할 때는 `Grep`보다 LSP를 선호하십시오.
25
+
26
+ ## 관련 개념
27
+
28
+ - 코드를 탐색하고 변경할 때 `Read`와 `Edit`를 보완합니다.
@@ -0,0 +1,26 @@
1
+ # Workflow
2
+
3
+ 여러 서브에이전트를 결정론적으로 오케스트레이션하는 — 팬아웃, 파이프라인, 루프, 검증 — 스크립트를 실행합니다. 단일 컨텍스트에 담기에는 너무 광범위하거나, 너무 불확실하거나, 너무 큰 작업을 위한 것입니다.
4
+
5
+ ## 사용 시점
6
+
7
+ - 큰 작업을 분해하여 여러 에이전트에 걸쳐 병렬로 처리하기
8
+ - 결과를 채택하기 전에 독립적이거나 적대적인 검증으로 교차 확인하기
9
+ - 단일 컨텍스트가 담을 수 없는 규모를 다루기: 마이그레이션, 감사, 광범위한 다중 파일 일괄 작업
10
+
11
+ ## 작동 원리
12
+
13
+ - 백그라운드에서 실행되며, 완료 시 알림을 받습니다. `/workflows`로 실시간 진행 상황을 확인하십시오.
14
+ - 스크립트는 `agent()`, `parallel()`, `pipeline()`, `phase()`로 에이전트를 조율합니다.
15
+ - `pipeline()`은 각 항목을 배리어 없이 단계들로 스트리밍합니다 (기본값). `parallel()`은 모든 결과를 기다리는 배리어입니다.
16
+ - 스키마를 지정하면 각 `agent()`는 자유 텍스트 대신 검증된 구조화 데이터를 반환합니다.
17
+
18
+ ## 참고사항
19
+
20
+ - 사용자가 다중 에이전트 오케스트레이션을 명시적으로 선택한 경우에만 실행됩니다. 많은 에이전트를 생성하고 상당한 token을 소비할 수 있습니다.
21
+ - 동시성은 워크플로우별로 상한이 있습니다. 초과된 에이전트는 큐에 들어가며 슬롯이 비는 대로 실행됩니다.
22
+ - 단일 서브에이전트의 경우 대신 `Agent` 도구를 사용하십시오 — Workflow는 진정한 팬아웃을 위해 남겨두십시오.
23
+
24
+ ## 관련 개념
25
+
26
+ - `Agent` 도구를 기반으로 하여, 결정론적 제어 흐름 아래에서 여러 에이전트를 실행합니다.
@@ -0,0 +1,28 @@
1
+ # LSP
2
+
3
+ Spør Language Server Protocol-servere (LSP) om kodeintelligens — definisjoner, referanser, hover, symboler, implementeringer og kallhierarki. Mer presist enn tekstsøk fordi det forstår kode semantisk.
4
+
5
+ ## Når skal det brukes
6
+
7
+ - Hopp til et symbols definisjon (`goToDefinition`) eller finn alle referanser (`findReferences`)
8
+ - Les typesignaturer / dokumentasjon for et symbol (`hover`)
9
+ - List symboler i én fil (`documentSymbol`) eller søk etter dem på tvers av prosjektet (`workspaceSymbol`)
10
+ - Finn implementeringer av et grensesnitt eller en abstrakt metode (`goToImplementation`)
11
+ - Gå gjennom kallhierarkiet til en funksjon (`prepareCallHierarchy`, `incomingCalls`, `outgoingCalls`)
12
+
13
+ ## Parametre
14
+
15
+ - `operation` (streng, påkrevd): en av operasjonene nevnt ovenfor.
16
+ - `filePath` (streng, påkrevd): filen det skal arbeides på.
17
+ - `line` (tall, påkrevd): 1-basert linjenummer, slik det vises i editoren.
18
+ - `character` (tall, påkrevd): 1-basert tegnforskyvning, slik det vises i editoren.
19
+
20
+ ## Notater
21
+
22
+ - Krever en konfigurert LSP-server for den filtypen; ellers returnerer kallet en feil.
23
+ - Linje og tegn er 1-baserte (editorkoordinater), ikke 0-baserte.
24
+ - Foretrekk LSP fremfor `Grep` når du trenger semantisk navigasjon (sann definisjon/referanse) i stedet for et tekstmatch.
25
+
26
+ ## Relaterte begreper
27
+
28
+ - Utfyller `Read` og `Edit` når du navigerer i og endrer kode.
@@ -0,0 +1,26 @@
1
+ # Workflow
2
+
3
+ Kjører et skript som deterministisk orkestrerer mange underagenter — fan-out, pipelines, løkker og verifisering — for arbeid som er for bredt, for usikkert eller for stort for én enkelt kontekst.
4
+
5
+ ## Når skal det brukes
6
+
7
+ - Bryt ned en stor oppgave og dekk den parallelt på tvers av mange agenter
8
+ - Kryssjekk funn med uavhengig eller adversariell verifisering før du fester lit til dem
9
+ - Ta på deg skala som én kontekst ikke kan romme: migreringer, revisjoner, brede gjennomganger av mange filer
10
+
11
+ ## Slik fungerer det
12
+
13
+ - Kjører i bakgrunnen; du får beskjed når det er ferdig. Følg fremdriften i sanntid med `/workflows`.
14
+ - Skriptet koordinerer agenter med `agent()`, `parallel()`, `pipeline()` og `phase()`.
15
+ - `pipeline()` streamer hvert element gjennom stadiene uten barriere (standard); `parallel()` er en barriere som venter på alle resultater.
16
+ - Med et schema returnerer hvert `agent()` validerte strukturerte data i stedet for fri tekst.
17
+
18
+ ## Notater
19
+
20
+ - Kjører bare når brukeren uttrykkelig velger orkestrering med flere agenter; det kan starte mange agenter og bruke betydelige tokens.
21
+ - Samtidigheten er begrenset per workflow; overskytende agenter settes i kø og kjøres etter hvert som plasser blir ledige.
22
+ - For én enkelt underagent bruker du `Agent`-verktøyet i stedet — reserver Workflow for reell fan-out.
23
+
24
+ ## Relaterte begreper
25
+
26
+ - Bygger på `Agent`-verktøyet og kjører mange agenter under deterministisk kontrollflyt.
@@ -0,0 +1,28 @@
1
+ # LSP
2
+
3
+ Odpytuje serwery Language Server Protocol (LSP) o inteligencję kodu — definicje, referencje, podpowiedzi (hover), symbole, implementacje i hierarchię wywołań. Bardziej precyzyjne niż wyszukiwanie tekstowe, ponieważ rozumie kod semantycznie.
4
+
5
+ ## Kiedy używać
6
+
7
+ - Przejść do definicji symbolu (`goToDefinition`) lub znaleźć każdą referencję (`findReferences`)
8
+ - Odczytać sygnatury typów / dokumentację symbolu (`hover`)
9
+ - Wylistować symbole w jednym pliku (`documentSymbol`) lub wyszukać je w całym projekcie (`workspaceSymbol`)
10
+ - Znaleźć implementacje interfejsu lub metody abstrakcyjnej (`goToImplementation`)
11
+ - Przejść hierarchię wywołań funkcji (`prepareCallHierarchy`, `incomingCalls`, `outgoingCalls`)
12
+
13
+ ## Parametry
14
+
15
+ - `operation` (string, wymagany): jedna z operacji wymienionych powyżej.
16
+ - `filePath` (string, wymagany): plik, na którym wykonać operację.
17
+ - `line` (liczba, wymagany): numer wiersza liczony od 1, tak jak pokazano w edytorze.
18
+ - `character` (liczba, wymagany): przesunięcie znaku liczone od 1, tak jak pokazano w edytorze.
19
+
20
+ ## Uwagi
21
+
22
+ - Wymaga skonfigurowanego serwera LSP dla danego typu pliku; w przeciwnym razie wywołanie zwraca błąd.
23
+ - Wiersz i znak są liczone od 1 (współrzędne edytora), a nie od 0.
24
+ - Preferuj LSP zamiast `Grep`, gdy potrzebujesz nawigacji semantycznej (prawdziwa definicja/referencja), a nie dopasowania tekstowego.
25
+
26
+ ## Powiązane pojęcia
27
+
28
+ - Uzupełnia `Read` i `Edit` podczas nawigacji po kodzie i jego zmieniania.