Docs/update documentation

.github/CONTRIBUTING.md

@@ -483,7 +483,7 @@ In addition, you will need to update the registries:
 8. **Generate Documentation:**  
    Run the documentation generator to create docs for your new tool:
    ```bash
-   ./scripts/generate-docs.sh
+   bun run docs:generate
    ```
 
 ### Naming Conventions

AGENTS.md

@@ -1,12 +1,12 @@
 # AGENTS
 
 ## Ground rules
-- Do not use the pacakge "server-only" in the project.
+- Do not use the package "server-only" in the project.
 - Do not edit any `*/migration/*` files; they are auto-generated.
 - Do not add legacy support; updates should be clean and avoid extra project complexity.
 - We do not need any form of legacy support as the project is under fresh dev, do not add any form of legacy backfill path
 - This project does not support any legacy methods.
-- Project uses `Bun` pacakge manager with turborepo, find project defined scripts in `/pacakge.json` for testing.
+- Project uses the `Bun` package manager with Turborepo; find project-defined scripts in the repository-root `package.json` for testing.
 - Prefer removing lines of code over adding more lines of code to reduce project complexity.
 
 ## Planning

apps/docs/NON_TRANSLATED_WORDS_ES.md

@@ -0,0 +1,108 @@
+# Reporte de texto no traducido en la documentación en español
+
+Fecha de auditoría: 2026-08-27
+
+Estado de remediación: corregidos los hallazgos de alta probabilidad el 2026-08-27.
+
+> Este documento conserva el resultado inicial como registro de auditoría. Los 80 hallazgos de su escaneo conservador se revisaron y corrigieron cuando correspondían a prosa. Una auditoría léxica posterior, más amplia, detectó 153 coincidencias adicionales que requieren revisión contextual; por tanto, este trabajo no certifica todavía la traducción completa del locale español. La validación estructural sí finaliza correctamente.
+
+## Alcance
+
+- Directorio revisado: `content/docs/es`
+- Archivos en español: 239 MDX
+- Archivos de referencia en inglés: 239 MDX
+- La estructura de archivos entre `en` y `es` está completa.
+- Este reporte se centra en prosa visible para el usuario. No considera errores los nombres de producto, nombres de API, identificadores, código, comandos, rutas, claves JSON ni valores enumerados que deban conservarse.
+
+## Resultado
+
+La auditoría inicial detectó texto sin traducir y traducciones híbridas. El escaneo conservador identificó 80 líneas de alta probabilidad distribuidas en 40 archivos. Esos hallazgos se utilizaron como lista de control y ya fueron corregidos. Las cifras se conservan a continuación como referencia histórica.
+
+### Palabras inglesas detectadas en prosa candidata
+
+Los conteos siguientes corresponden únicamente al conjunto conservador de 80 líneas. Una aparición puede ser válida si forma parte de un identificador o valor técnico; por eso la corrección debe hacerse revisando la línea completa.
+
+| Palabra | Apariciones | Palabra | Apariciones | Palabra | Apariciones |
+| --- | ---: | --- | ---: | --- | ---: |
+| get | 17 | at | 11 | not | 10 |
+| if | 9 | where | 9 | all | 7 |
+| include | 6 | last | 5 | select | 5 |
+| as | 4 | on | 4 | follow | 4 |
+| be | 4 | the | 3 | and | 3 |
+| its | 3 | is | 3 | return | 3 |
+| provide | 3 | of | 3 | creating | 3 |
+| once | 3 | each | 3 | set | 2 |
+| between | 2 | in | 2 | only | 2 |
+| can | 2 | about | 2 | more | 2 |
+| using | 2 | first | 2 | are | 2 |
+| than | 2 | what | 2 | it | 1 |
+| want | 1 | click | 1 | run | 1 |
+| needs | 1 | including | 1 | add | 1 |
+| choose | 1 | this | 1 | from | 1 |
+| does | 1 | also | 1 | use | 1 |
+| adding | 1 | do | 1 | for | 1 |
+| running | 1 | new | 1 | allow | 1 |
+| how | 1 | both | 1 | make | 1 |
+
+Además de esas palabras funcionales, la revisión visual encontró vocabulario inglés usado como prosa: `access`, `accounts`, `agent`, `analyzing`, `array`, `browser`, `companies`, `condition`, `configuration`, `contacts`, `data`, `detailed`, `documents`, `domain`, `email`, `folder`, `index`, `integrate`, `operation`, `pagination`, `path`, `powerful`, `required`, `search`, `services`, `status`, `supports`, `task`, `tool`, `tools`, `trigger`, `usage`, `workflow` y `workflows`. Algunos de estos términos pueden conservarse en nombres propios o contratos técnicos, pero no cuando sustituyen prosa española normal.
+
+## Archivos con mayor número de líneas candidatas
+
+| Archivo | Líneas candidatas |
+| --- | ---: |
+| `tools/incidentio.mdx` | 10 |
+| `tools/apollo.mdx` | 6 |
+| `tools/ahrefs.mdx` | 6 |
+| `tools/index.mdx` | 6 |
+| `tools/gitlab.mdx` | 5 |
+| `tools/datadog.mdx` | 4 |
+| `tools/hunter.mdx` | 3 |
+| `triggers/manual.mdx` | 2 |
+| `tools/zendesk.mdx` | 2 |
+| `tools/elasticsearch.mdx` | 2 |
+| `tools/asana.mdx` | 2 |
+| `tools/postgresql.mdx` | 2 |
+| `tools/dropbox.mdx` | 2 |
+| `tools/mysql.mdx` | 2 |
+
+Otros archivos con al menos una línea candidata:
+
+`utilities/custom-tools.mdx`, `triggers/webhook.mdx`, `blocks/router.mdx`, `blocks/response.mdx`, `blocks/api.mdx`, `blocks/wait.mdx`, `blocks/human_in_the_loop.mdx`, `blocks/parallel.mdx`, `blocks/memory.mdx`, `copilot/index.mdx`, `tools/salesforce.mdx`, `tools/arxiv.mdx`, `tools/mailchimp.mdx`, `tools/google_slides.mdx`, `tools/grain.mdx`, `tools/exa.mdx`, `tools/youtube.mdx`, `tools/cursor.mdx`, `tools/browser_use.mdx`, `tools/intercom.mdx`, `tools/x.mdx`, `tools/wikipedia.mdx`, `tools/supabase.mdx`, `tools/grafana.mdx`, `tools/huggingface.mdx` y `tools/calendly.mdx`.
+
+## Hallazgos confirmados representativos
+
+| Ubicación | Texto encontrado | Problema |
+| --- | --- | --- |
+| `triggers/webhook.mdx:40` | `Get Webhook URL — Copy the automatically generated unique endpoint` | Frase completa sin traducir. |
+| `triggers/manual.mdx:17` | `El Manual trigger... Usar it cuando tú want...` | Traducción híbrida e ininteligible. |
+| `triggers/manual.mdx:20` | `Sin configuración needed — solo click Run.` | Palabras de prosa sin traducir. |
+| `blocks/router.mdx:216` | `Router analyzes company size, industry, and needs` | Frase completa sin traducir. |
+| `blocks/response.mdx:49` | `Set Status Codes: Configure appropriate HTTP status codes...` | Título y descripción sin traducir. |
+| `blocks/api.mdx:51` | `Handle authentication: Support various auth methods...` | Título y descripción sin traducir. |
+| `blocks/wait.mdx:38` | `Add time delays: Pause execution between workflow steps` | Título y descripción sin traducir. |
+| `blocks/parallel.mdx:152` | `Parallel Type: Choose between 'count' or 'collection'` | Prosa sin traducir; los valores técnicos pueden conservarse. |
+| `copilot/index.mdx:82` | `Today, Yesterday, This Week, Last Week, Older` | Etiquetas visibles sin traducir; revisar si reflejan literalmente la UI. |
+| `tools/arxiv.mdx:345` | `Integrates ArXiv... search... get... Does not require...` | Párrafo híbrido. |
+| `tools/grain.mdx:935` | `Integrate Grain... Access... Can also trigger...` | Párrafo híbrido. |
+| `tools/elasticsearch.mdx:1770` | `todos its documents... operation is irreversible` | Advertencia crítica parcialmente sin traducir. |
+| `tools/incidentio.mdx:775` | `detailed información about... por its ID` | Descripción híbrida. |
+| `tools/datadog.mdx:300` | `Use para analyzing trends, creating reports...` | Descripción híbrida. |
+| `tools/cursor.mdx:710` | `Interact... launch... work... Supports launching...` | Párrafo mayoritariamente en inglés. |
+| `tools/intercom.mdx:1521` | `todos companies... pagination support... larger than...` | Párrafo híbrido. |
+| `tools/index.mdx:10` | `Tools are powerful components... allow... interact...` | Introducción principal mayoritariamente sin traducir. |
+| `tools/browser_use.mdx:147` | `What debe el browser agent do` | Descripción de campo híbrida. |
+| `tools/mysql.mdx:457` | `WHERE clause condition (without WHERE keyword)` | Explicación sin traducir; `WHERE` debe conservarse. |
+| `tools/huggingface.mdx:150` | `Higher values make output more random` | Explicación sin traducir. |
+
+## Falsos positivos que no deben traducirse automáticamente
+
+- Métodos y protocolos: `GET`, `POST`, `PUT`, `DELETE`, `PATCH`, `HTTP`, `API`, `SDK`, `MCP`.
+- Productos y servicios: `TradingGoose`, `PineTS`, `GitHub`, `HubSpot`, `Datadog`, `Apollo`, etc.
+- Identificadores y claves: `first_name`, `created_at`, `last_activity_at`, `single_select`, `user_id`.
+- Consultas y palabras reservadas: `SELECT`, `FROM`, `WHERE`, `LIMIT`.
+- Valores enumerados exigidos por una API: `running`, `success`, `failed`, `count`, `collection`, cuando representan el valor literal enviado al servicio.
+- Código, comandos, rutas, URLs, variables de entorno y contenido dentro de bloques de código.
+
+## Conclusión
+
+Los 80 hallazgos iniciales fueron revisados en contexto y corregidos cuando correspondían a prosa visible. No se hicieron reemplazos globales porque términos como `get`, `where`, `last` o `running` pueden formar parte de contratos técnicos válidos. La pasada ampliada posterior aún registra 153 coincidencias de alta confianza —incluido texto visible incrustado en JSON/JSX—, que deben revisarse antes de certificar como completa toda la traducción española.

apps/docs/NON_TRANSLATED_WORDS_ZH.md

@@ -0,0 +1,124 @@
+# 中文文档未翻译文本报告
+
+审计日期：2026-08-27
+
+修复状态：已于 2026-08-27 复核并修正本报告列出的 129 行保守扫描候选文本。
+
+> 本文档保留初始审计结果作为记录。修复后，结构验证正常通过。随后执行的更严格词汇审计仍检测到 133 个高置信度候选项，分布在 58 个文件中，其中包括 JSON/JSX 内的用户可见文本。因此，目前仍不能确认整个中文 locale 已完成翻译。
+
+## 范围
+
+- 审查目录：`content/docs/zh`
+- 中文文件总数：239
+- 中文 MDX 文档：229
+- 英文文件总数：239
+- `en` 与 `zh` 的文件结构完整且一致。
+- 本报告关注用户可见的英文散文。产品名称、API 名称、标识符、代码、命令、路径、JSON 键以及必须原样保留的枚举值不计为翻译错误。
+
+## 结论摘要
+
+初始保守扫描检测到至少 129 行高概率未翻译或中英混合文本，分布在 47 个 MDX 文件中，共命中 324 个常见英语功能词。这些候选行现已逐项复核，并在属于用户可见散文时完成修正。
+
+这是最低估计值。为了减少误报，扫描排除了代码块、行内代码、大部分 JSON/JSX 属性，并且通常要求一行至少出现两个常见英语词。因此，只包含一个英文残留词的混合句子可能没有计入。
+
+## 检测到的英语词
+
+下表仅统计上述 129 行候选文本。每个词仍需结合上下文判断，因为它可能出现在 SQL、标识符或 API 枚举中。
+
+| 英语词 | 次数 | 英语词 | 次数 | 英语词 | 次数 |
+| --- | ---: | --- | ---: | --- | ---: |
+| get | 23 | the | 21 | to | 20 |
+| if | 19 | and | 18 | not | 16 |
+| is | 12 | or | 12 | for | 12 |
+| no | 12 | at | 11 | where | 9 |
+| select | 7 | with | 7 | of | 6 |
+| use | 6 | on | 6 | from | 6 |
+| after | 5 | last | 5 | set | 4 |
+| available | 4 | create | 4 | in | 4 |
+| add | 4 | are | 4 | all | 4 |
+| open | 4 | uses | 3 | used | 3 |
+| between | 3 | yes | 3 | that | 2 |
+| your | 2 | run | 2 | most | 2 |
+| each | 2 | make | 2 | this | 2 |
+| do | 2 | once | 2 | creating | 2 |
+| first | 2 | than | 2 | be | 2 |
+| default | 2 | lets | 1 | using | 1 |
+| when | 1 | it | 1 | want | 1 |
+| click | 1 | needs | 1 | over | 1 |
+| including | 1 | choose | 1 | ensure | 1 |
+| before | 1 | does | 1 | both | 1 |
+| only | 1 | its | 1 | allow | 1 |
+| return | 1 | more | 1 |  |  |
+
+人工复核还确认以下英语词被当作普通散文使用：`automatically`、`available`、`collection`、`companies`、`content`、`cost`、`data`、`documents`、`endpoint`、`evaluation`、`execution`、`integrates`、`operation`、`pagination`、`processed`、`required`、`response`、`search`、`services`、`supports`、`tasks`、`tool`、`trigger`、`workflow`。这些词在标识符或产品契约中可能有效，但不应替代正常的简体中文说明。
+
+## 候选行最多的文件
+
+| 文件 | 候选行数 |
+| --- | ---: |
+| `blocks/evaluator.mdx` | 12 |
+| `blocks/parallel.mdx` | 11 |
+| `blocks/router.mdx` | 9 |
+| `blocks/api.mdx` | 9 |
+| `tools/intercom.mdx` | 7 |
+| `blocks/response.mdx` | 6 |
+| `blocks/guardrails.mdx` | 6 |
+| `tools/apollo.mdx` | 5 |
+| `tools/grafana.mdx` | 5 |
+| `tools/kalshi.mdx` | 4 |
+| `tools/incidentio.mdx` | 4 |
+| `tools/hunter.mdx` | 3 |
+| `tools/elasticsearch.mdx` | 3 |
+| `tools/gitlab.mdx` | 3 |
+| `triggers/api.mdx` | 2 |
+| `triggers/manual.mdx` | 2 |
+| `blocks/wait.mdx` | 2 |
+| `tools/google_drive.mdx` | 2 |
+| `tools/google_slides.mdx` | 2 |
+| `tools/zendesk.mdx` | 2 |
+| `tools/postgresql.mdx` | 2 |
+| `tools/index.mdx` | 2 |
+| `tools/mysql.mdx` | 2 |
+
+另外 24 个至少含一行候选文本的文件：
+
+`indicators/inputs.mdx`、`triggers/webhook.mdx`、`triggers/generic.mdx`、`triggers/portfolio.mdx`、`knowledgebase/tags.mdx`、`blocks/human_in_the_loop.mdx`、`blocks/memory.mdx`、`copilot/index.mdx`、`tools/salesforce.mdx`、`tools/arxiv.mdx`、`tools/clay.mdx`、`tools/microsoft_planner.mdx`、`tools/fireflies.mdx`、`tools/youtube.mdx`、`tools/datadog.mdx`、`tools/asana.mdx`、`tools/dropbox.mdx`、`tools/greptile.mdx`、`tools/x.mdx`、`tools/wikipedia.mdx`、`tools/discord.mdx`、`tools/supabase.mdx`、`tools/huggingface.mdx`、`tools/calendly.mdx`。
+
+## 已确认的代表性问题
+
+| 位置 | 检测到的文本 | 问题 |
+| --- | --- | --- |
+| `indicators/inputs.mdx:8` | `该 namespace lets 你 define 参数 that users 可以 configure...` | 严重的中英混合句。 |
+| `triggers/webhook.mdx:40` | `Get Webhook URL — Copy the automatically generated unique endpoint` | 整句未翻译。 |
+| `triggers/generic.mdx:66` | `The trigger passes the full event payload to your workflow...` | 整句未翻译。 |
+| `triggers/manual.mdx:17` | `使用 it 当你 want到执行 workflow immediately...` | 中英混合且难以理解。 |
+| `triggers/manual.mdx:20` | `无配置 needed — 仅 click Run.` | 用户操作说明未翻译。 |
+| `blocks/router.mdx:43` | `Intelligent content routing: Use AI to understand intent and context` | 标题和说明未翻译。 |
+| `blocks/evaluator.mdx:43` | `Score Content Quality: Use AI to evaluate...` | 标题和说明未翻译。 |
+| `blocks/response.mdx:49` | `Set Status Codes: Configure appropriate HTTP status codes...` | 标题和说明未翻译。 |
+| `blocks/api.mdx:42` | `Connect to external services: Make HTTP requests...` | 标题和说明未翻译。 |
+| `blocks/wait.mdx:38` | `Add time delays: Pause execution...` | 标题和说明未翻译。 |
+| `blocks/parallel.mdx:152` | `Parallel Type: Choose between 'count' or 'collection'` | 普通说明未翻译；字面 API 值可以保留。 |
+| `blocks/guardrails.mdx:48` | `Validate JSON Structure: Ensure LLM outputs are valid JSON...` | 标题和说明未翻译。 |
+| `copilot/index.mdx:82` | `Today、Yesterday、This Week、Last Week、Older` | 可见时间分组标签未翻译；需确认是否必须与 UI 保持一致。 |
+| `tools/arxiv.mdx:345` | `Integrates ArXiv... search... get... Does not require...` | 整段为中英混合文本。 |
+| `tools/elasticsearch.mdx:1770` | `全部 its documents. 此 operation is irreversible.` | 关键的不可逆警告未完整翻译。 |
+| `tools/apollo.mdx:1846` | `创建 up 到 100 contacts 在 once... Supports deduplication...` | 整段严重混合。 |
+| `tools/intercom.mdx:1521` | `全部 companies... pagination support... larger than...` | 整段严重混合。 |
+| `tools/greptile.mdx:100` | `查询 repositories 在 natural 语言和 get answers...` | 整段严重混合。 |
+| `tools/index.mdx:10` | `工具 are powerful components... allow... interact...` | 工具章节的主要介绍未正确翻译。 |
+| `tools/huggingface.mdx:150` | `Higher values make output more random` | 参数说明未翻译。 |
+
+## 不应自动翻译的误报
+
+- 协议及方法：`GET`、`POST`、`PUT`、`DELETE`、`PATCH`、`HTTP`、`API`、`SDK`、`MCP`。
+- 产品和服务名称：`TradingGoose`、`PineTS`、`GitHub`、`Intercom`、`Apollo` 等。
+- 标识符及字段名：`first_name`、`created_at`、`last_activity_at`、`single_select`、`user_id`。
+- SQL 关键字和查询：`SELECT`、`FROM`、`WHERE`、`LIMIT`。
+- API 要求的字面枚举值：例如 `yes`、`no`、`open`、`running`、`count`、`collection`。
+- 代码、命令、路径、URL、环境变量以及代码块内容。
+- 已确定的模块或功能专名，例如作为模块名称出现的 `Human in the Loop`；其周围说明仍应使用中文。
+
+## 最终判断
+
+中文 locale 在文件数量和结构上完整，本报告初始列出的 129 行也已完成上下文复核和必要修正。但更严格的后续扫描仍发现 133 个高置信度候选项，尤其是 JSON/JSX 中的用户可见标签、占位符和说明，因此内容翻译仍不能视为全部完成。不能通过全局替换完成修复，因为相同英语词可能既是未翻译散文，也可能是必须保留的技术契约。

apps/docs/README.md

@@ -9,7 +9,7 @@ Run development server:
 bun run dev
 ```
 
-Open http://localhost:3000 with your browser to see the result.
+Open http://localhost:3001 with your browser to see the result.
 
 ## Learn More