docs: make Maple Cloud deployment checks discoverable to agents

已關閉
#2,007 0 則留言 0 個 reaction 已指派 0 人 在 GitHub 檢視

維護者通常 1 天內回覆

@jasonkuhrt 已經在處理了。

開始於 2026年10月31日。

  • #2008 來自 @jasonkuhrt —— 未關閉

評估

難度
2/5
預估耗時
1-3 小時
新手友好度
25/100
Issue 類型
文件
描述清晰度
描述清楚
活躍度
停滯
技術堆疊
typescript
領域
documentation

研究方向

Start with the AI agent guide at docs/getting-started/ai-agents.md and llms.txt, then check the existing wording in the guide’s Changelog section. Document runnable checks for the listed US and EU endpoints, including the requested region, freshness, revision-header, merge-commit, and dashboard/API distinctions. Done when llms.txt links to the guide, the Changelog wording is corrected, and both files explain how to verify serving revisions.

由索引模型根據 Issue 內容生成。

描述

Written by an AI agent (Codex) on behalf of @jasonkuhrt.

An agent waiting for a Maple Cloud fix needs to distinguish “merged” from “running in my region.” The agent-facing documentation currently points to the product changelog and GitHub releases, but does not explain the existing deployed-revision checks.

Maple already serves public, browser-free signals:

  • GET https://app.maple.dev/version.json: the dashboard asset build's commit.
  • GET https://api.maple.dev/health: the running API Worker's x-maple-revision response header.
  • The equivalent EU endpoints use app.eu.maple.dev and api.eu.maple.dev.

The AI agent guide already owns MCP workflows and public instrumentation skills. It has no deployment-check workflow, and llms.txt does not directly link to that guide.

Please document these existing checks with runnable requests in the guide and link it from llms.txt. Explain region selection, fresh responses, absent revision headers, checking the actual upstream merge commit against serving revisions, and the separate dashboard/API scope. Correct the Changelog section's “one entry per shipped change” wording and point it to the revision checks: an announcement does not identify a region's running commit.

This arose while tracking #2000. It can be solved through the existing agent entry points without adding another endpoint or a general-purpose skill.

主要語言
TypeScript
星號
1.8k
分支
120
平均合併
10 小時 37 分鐘
30 天內合併 PR
708

環境準備

這個專案沒有提供開發容器、Dockerfile 或貢獻指南,環境需要你自己搭建:先看它的 README,通用步驟見我們的新手貢獻指南。

從這裡開始

  1. 先讀完整個 Issue,再讀專案的貢獻指南。
  2. 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
  3. Fork 儲存庫,在一個分支上完成修改。
  4. 送出 Pull Request,並在描述裡引用這個 Issue 編號。

MapleTechLabs/maple 的其他 Issue

查看 MapleTechLabs/maple 的全部 Issue

相似的 Issue

更多 TypeScript Issue

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。