跳到正文
DEV Community· BBT·· 10 天前AI 評分55

如何在 osFoundry 讓 Claude Code 讀取 GitNest 檢查結果,並提出待批准的重跑請求

osFoundry में Claude Code से GitNest checks कैसे पढ़वाएं और आपकी मंज़ूरी वाला rerun कैसे प्रस्तावित करवाएं

AI 導讀

這份指南示範如何在 osFoundry 連接 Claude Code,讀取 GitNest change set 的檢查結果,並提出須經用戶批准的單項重跑請求。

正文

इस गाइड के अंत तक आप Claude Code से पूछ सकेंगे "क्या checkout वाला change set green है?" और जवाब osFoundry से पढ़कर मिलेगा, आपके local test run से अंदाज़ा लगाकर नहीं। Claude Code change set के composed commit पर चले checks की list दिखाता है, बताता है कि कौन-सा fail हुआ, और अगर वह flaky लगे तो सिर्फ़ उसी एक check के लिए retry की request डालता है। Claude Code के माँगते ही retry शुरू नहीं होता। वह osFoundry में "Retry GitNest check" card के रूप में पहुँचता है, जिस पर change set का version और exact commit लिखा होता है, और तभी चलता है जब आप Approve retry पर क्लिक करते हैं।

कौन क्या करता है

Claude Code osFoundry
लॉगिन आपकी मशीन पर उसका अपना sign-in वह connection जिसे आपने एक workspace के लिए एक बार approve किया था, osfoundry:read और osfoundry:write scopes के साथ
कौन-सी repository सर्वर जो list करता है, उसमें से चुनता है सिर्फ़ वे GitNest repositories जो उस project में assigned हैं जिसमें connection है
Checks पढ़ना एक change set पर list_gitnest_checks change set के मौजूदा composed commit का सीमित status लौटाता है
Checks चलाना कभी नहीं आपकी registered runner मशीनें उन्हें चलाती हैं। osFoundry आपका code execute नहीं करता
Check को retry करना propose_gitnest_check_rerun, जो destructive marked है, इसलिए Claude Code पहले आपसे पूछता है "Needs your approval" (आपकी मंज़ूरी चाहिए) के नीचे एक card। Approve retry उसी एक finished check को फिर से queue में डालता है
क्या दोबारा जाँचा जाता है कुछ नहीं Approve करते समय: repository access, change set version, commit और check state

सेटअप

1. Claude Code में osFoundry जोड़ें

$ claude mcp add --transport http -s user osfoundry https://api.osfoundry.io/api/v1/external-mcp

osFoundry CLI osfoundry agent connect claude --print से यही line print करता है। Claude Code में /mcp चलाएं, osfoundry चुनें और Authenticate पर जाएं। Browser में osFoundry खुलता है और आप एक workspace चुनते हैं। इसके बाद tools mcp__osfoundry__… के रूप में दिखने लगते हैं।

2. पक्का करें कि repository में checks और एक runner हो

जो check कभी चला ही नहीं, उसे न पढ़ा जा सकता है न retry किया जा सकता है। GitNest में repository का settings page खोलें। यहाँ दो panels काम के हैं:

  • Check runners: "Checks run on your machine, not ours — osFoundry never executes your code on its own infrastructure." (checks आपकी मशीन पर चलते हैं, osFoundry की मशीन पर नहीं)। Register runner आपको एक बार token देता है और उसे start करने की command, OSF_RUNNER_TOKEN=… osfoundry-runner --api https://api.osfoundry.io। Runner न हो तो panel चेतावनी देता है "Checks will stay queued until one is."
  • Required checks: .osfoundry/checks.yaml से लिए गए नाम। "A change set cannot merge until every check named here has passed on its commit."

3. Repository को एक project में रखें, और connection को भी उसी project में

GitNest में repository के Project section में लिखा होता है "Connected agents in this project can use approved GitNest read tools when their connection owner still has repository access." Picker सिर्फ़ repository owner को मिलता है। एक project चुनें, और osFoundry पुष्टि करता है "Repository project updated"।

फिर key icon → Connected खोलें, Claude Code connection चुनें और Projects के नीचे उसे उसी project में जोड़ें।

Claude Code connection को उस project में जोड़ना जिसमें repository है

उदाहरण: Claude Code connection को उस project में जोड़ना जिसमें repository है

उसी panel में Tools के नीचे, "All supported tools are on by default." इस गाइड में इस्तेमाल होने वाले tools list gitnest work, list gitnest checks, list gitnest saved results, read gitnest work और propose gitnest check rerun के रूप में दिखते हैं। अगर आप चाहते हैं कि Claude Code checks को सिर्फ़ पढ़ सके, तो propose gitnest check rerun से tick हटाएं और Save tools पर क्लिक करें।

एक असली run

Tool और argument के नाम वही हैं जो osFoundry का सर्वर tools/list से लौटाता है। Repository, change set, IDs, check के नाम और जवाब उदाहरण के लिए हैं।

Example

You: Is the checkout-retry change set in shop-api green? If a check failed
     for a reason that isn't the code, ask osFoundry to retry it.

Claude Code → mcp__osfoundry__list_granted_resources {}
            ← project "Payments" · GitNest repository "shop-api"
Claude Code → mcp__osfoundry__list_gitnest_work {"repository_id": "…", "kind": "changes"}
            ← "Fix double charge on checkout retry" (cs_4e81a0) · version 3
Claude Code → mcp__osfoundry__list_gitnest_checks {"repository_id": "…", "change_set_id": "cs_4e81a0"}
            ← composed commit 9c1e47a…: unit passed · lint passed · e2e failed
Claude Code → mcp__osfoundry__list_gitnest_saved_results {"repository_id": "…", "limit": 10}
            ← 2 saved results behind this change set
Claude Code → mcp__osfoundry__read_gitnest_work {"repository_id": "…", "kind": "runs", "item_id": "…"}
            ← run summary: payment client tests passed locally

Claude Code: unit and lint passed on 9c1e47a. e2e failed. The change only
             touches the payment client, and its tests passed in the saved
             run, so a retry is reasonable. Shall I propose one?

You: Yes.

Claude Code → mcp__osfoundry__propose_gitnest_check_rerun
                {"repository_id": "…", "change_set_id": "cs_4e81a0",
                 "check_name": "e2e", "expected_change_set_version": 3,
                 "expected_composition_oid": "9c1e47a…",
                 "idempotency_key": "rerun-5b0c…"}
            ← proposal waiting for the owner

Claude Code: The retry is waiting under Connected → Needs your approval.
             Tell me when you've approved it and I'll read the checks again.

Propose call से पहले Claude Code इसलिए पूछता है क्योंकि tool पर destructiveHint: true annotation है। यह उसका अपना permission prompt है, osFoundry की approval से अलग।

Approve करने से पहले change set को खुद देख लें। GitNest में उसके review page पर checks panel tabs के ऊपर होता है और composed commit को एक line में summarise करता है, यहाँ "Checks did not pass: e2e", और नीचे हर check अपने status के साथ। जो change set compose नहीं हुआ है उसमें कोई panel नहीं दिखता, और बिना checks वाले commit पर tick के बजाय "No checks have run against this commit" लिखा आता है।

Bell में " proposes retrying a GitNest check" दिखता है। Key icon → Connected → आपका connection → Needs your approval के नीचे card में लिखा होता है:

Retry GitNest check in shop-api
Change set: cs_4e81a0 · expected version 3
Reviewed commit: 9c1e47a…
Check to retry: e2e
Review change set before approving
Expires …
[ Approve retry ]  [ Decline ]

Needs your approval के नीचे एक Retry GitNest check proposal

उदाहरण: Needs your approval के नीचे एक Retry GitNest check proposal

"Review change set before approving" वही review page खोलता है। अगर card पर वही commit है जिसे आपने देखा था, तो Approve retry पर क्लिक करें। e2e check उस commit के लिए फिर से queue में चला जाता है और आपका runner उसे उठा लेता है। फिर Claude Code को बताएं, और वह एक बार फिर list_gitnest_checks call करेगा।

सीमा कहाँ है

Retry एक commit को निशाना बनाता है, branch को नहीं। propose_gitnest_check_rerun में expected_change_set_version और expected_composition_oid ज़रूरी हैं, इसलिए card पर हमेशा लिखा होता है कि Claude Code ने किस composed commit को fail होते देखा। अगर card के इंतज़ार के दौरान कोई change set को recompose कर दे, तो जिस commit को आप approve करेंगे वह card वाला नहीं रहता। क्लिक करते समय osFoundry version, commit और check state दोबारा जाँचता है, और पुराना card नहीं चलता। तब panel में दिखता है "Could not decide this proposal. Its access may have changed." Claude Code से checks दोबारा पढ़ने और नए commit के लिए propose करने को कहें।

सिर्फ़ finished check को ही retry किया जा सकता है। Tool के description में लिखा है "retry one finished check", और check state भी दोबारा जाँच का हिस्सा है। जो check पहले से फिर queue में है या चल रहा है, क्योंकि किसी और ने उसे retry किया या change set recompose हुआ, उसे दूसरी बार queue नहीं किया जाता।

एक proposal में एक check। check_name अधिकतम 200 characters की एक single string है। पूरी suite को retry करने के लिए हर check का अलग card बनता है, और हर एक का फ़ैसला आप करते हैं। इससे flaky e2e का retry चुपचाप कोई security scan दोबारा नहीं चला देता जिसे आप fail ही रहने देना चाहते हैं।

इस पूरे रास्ते में कुछ भी osFoundry की मशीनों पर नहीं चलता और न ही code बदलता है। Checks आपके registered runners पर चलते हैं। Retry approve करने से बस एक check फिर से queue होता है, इससे ज़्यादा कुछ नहीं। न recompose, न merge, न publish। Merge अब भी तब तक रुका रहता है जब तक हर required check उस commit पर pass न हो जाए।

पढ़ा जाने वाला डेटा कम से कम रहता है। list_gitnest_checks सिर्फ़ मौजूदा composed commit का सीमित status लौटाता है। list_gitnest_saved_results और read_gitnest_work local bindings और credentials शामिल नहीं करते, इसलिए Claude Code आपको बता सकता है कि test fail हुआ, लेकिन आपका runner token या local checkout path कभी नहीं देखता।

आज़माने के लिए, किसी खाली मशीन पर एक runner register करें, ऐसा change set push करें जिसमें कोई check हो जो आपको पता है flaky है, और Claude Code से पूछें कि क्या वह green है। GitNest page पर repository, change set और checks की screens हैं, और Connected page approval panel के बारे में बताता है।

來源:DEV Community · dev.to