docs: vNext v0.0.62 release notes, migration rehberi + component doc updates - #16
Merged
Conversation
vNext runtime v0.0.62 (milestone #28, schema 0.0.47) sürümünü dökümante eder. - blog/: İngilizce release notları (9 issue: #742 contentType, #717 long-poll interaction, #748 function output header/status, #333 vnext-runtime MCP, #744 Dapr-enqueue continuation, #736 deny-only blacklist, #738/#730/#729 fix) - blog-migration/: Türkçe migration rehberi - docs/tools/mcp-runtime.md: yeni vnext-runtime MCP server sayfası (+ sidebar, EN mirror) - HttpTask contentType, State interaction/longPoll, IOutputHandler forward, authorization deny-only semantiği, SOAP escaping notu (TR + EN mirror) Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Reviewer's GuideDocuments vNext runtime v0.0.62 (schema 0.0.47) with new release + migration blog posts, adds MCP runtime server docs and navigation, and updates TR/EN component docs for HTTP Task contentType, state long-poll interaction, async/ sync behavior, authorization grant semantics, multi-task function ScriptResponse forwarding, and SOAP XML escaping behavior. Sequence diagram for state long-poll interaction with interaction.longPollsequenceDiagram
actor Client
participant Runtime
participant StateFunction
Client->>Runtime: GET /api/v1/{domain}/workflows/{wf}/instances/{id}/functions/state
Runtime->>StateFunction: Invoke state function
StateFunction-->>Runtime: State with interaction.longPoll
alt [role allowed in interaction.longPoll.roles]
Note over Runtime: Hold HTTP request open
alt [state transition occurs before fallbackTimeoutSeconds]
StateFunction-->>Runtime: New state after transition
Runtime-->>Client: Response with updated state
else [fallbackTimeoutSeconds elapses]
Runtime-->>Client: Response with fallback state/status
end
alt [interaction.longPoll.terminate == true]
Note over Runtime: Close any open long-poll when state is left
end
else [role not allowed]
Runtime-->>Client: 403 Forbidden
end
Flow diagram for grant evaluation (allow-list vs deny-only blacklist)flowchart TD
A[roles / queryRoles set] --> B{Contains any allow grant?}
B -- Yes --> C[Mode: allow-list
Default: deny
Meaning: only matching allow roles pass]
B -- No<br/>only deny grants --> D[Mode: blacklist
Default: allow
Meaning: everyone allowed
except listed roles]
C --> E[Apply grants
DENY overrides ALLOW]
D --> E[Apply grants
DENY overrides ALLOW]
E --> F[Final access decision]
File-Level Changes
Tips and commandsInteracting with Sourcery
Customizing Your ExperienceAccess your dashboard to:
Getting Help
|
|
Caution Review failedThe pull request is closed. ℹ️ Recent review info⚙️ Run configurationConfiguration used: defaults Review profile: CHILL Plan: Pro Run ID: 📒 Files selected for processing (18)
📝 WalkthroughWalkthroughAdds the v0.0.62 release blog post and migration guide, then updates component and concept documentation (TR and EN) for six new features: HTTP Task Changesv0.0.62 Release Documentation
Sequence Diagram(s)sequenceDiagram
participant Agent as MCP Agent
participant MCP as vnext-runtime MCP Server
participant Orchestration as Orchestration HTTP API
participant npm as npm Registry
Agent->>MCP: connect (stdio or Streamable HTTP/Bearer)
MCP->>npm: fetch vnext-meta package (once at startup)
npm-->>MCP: static meta package (cached in-memory)
Agent->>MCP: invoke ComponentTool / RuntimeTool / MetaTool
MCP->>Orchestration: HTTP GET (User-Agent: vnext-mcp/version, domain-scoped)
Orchestration-->>MCP: component/runtime data
MCP-->>Agent: tool response
Agent->>MCP: invoke MutatingRuntimeTool (requires AllowMutations=true)
MCP->>Orchestration: HTTP mutating request
Orchestration-->>MCP: result
MCP-->>Agent: tool response
Estimated code review effort🎯 2 (Simple) | ⏱️ ~10 minutes Possibly related PRs
Poem
✨ Finishing Touches📝 Generate docstrings
🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
![sourcery-ai[bot]](https://avatars.githubusercontent.com/in/48477?s=60&v=4){kind=small}
![gemini-code-assist[bot]](https://avatars.githubusercontent.com/in/956858?s=60&v=4){kind=small}
There was a problem hiding this comment.
Code Review
This pull request adds comprehensive release notes, migration guides, and documentation updates for vNext v0.0.62, highlighting features such as configurable HTTP Task content types, declarative state long-polling, multi-task function response forwarding, a new vnext-runtime MCP server, and authorization blacklist behavior. The review feedback correctly identifies a minor referencing error in both the Turkish and English mcp-runtime.md documentation files, where the Context7 MCP server for document discovery was incorrectly named burgan-tech/vnext-runtime instead of burgan-tech/vnext-docs.
Important
The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.
|
|
||
| Sunucu **ince ve decoupled**'dır: Orchestration HTTP API'yi tiplenmiş bir `HttpClient` ile çağırır; **DB / Redis / Dapr / Application** referansı yoktur. | ||
|
|
||
| > **Not:** Doküman keşfi bu sunucuda **yer almaz** — bunun için public docs'u semantik aramayla indeksleyen **Context7 MCP** sunucusu (`burgan-tech/vnext-runtime` / `vnext-docs`) kullanılır. Bkz. [AI Destekli Geliştirme](./ai-assisted-development). |
There was a problem hiding this comment.
Context7 üzerinde doküman keşfi için kullanılan MCP sunucusu referansı burgan-tech/vnext-docs olmalıdır. burgan-tech/vnext-runtime bu sayfanın konusu olan canlı runtime MCP sunucusudur ve Context7 üzerinde doküman indeksi olarak yer almaz. Bu referansı sadeleştirerek kafa karışıklığını önleyebiliriz.
Suggested change
| > **Not:** Doküman keşfi bu sunucuda **yer almaz** — bunun için public docs'u semantik aramayla indeksleyen **Context7 MCP** sunucusu (`burgan-tech/vnext-runtime` / `vnext-docs`) kullanılır. Bkz. [AI Destekli Geliştirme](./ai-assisted-development). | |
| > **Not:** Doküman keşfi bu sunucuda **yer almaz** — bunun için public docs'u semantik aramayla indeksleyen **Context7 MCP** sunucusu (`burgan-tech/vnext-docs`) kullanılır. Bkz. [AI Destekli Geliştirme](./ai-assisted-development). |
| `vnext-runtime` is a standalone [Model Context Protocol](https://modelcontextprotocol.io) server that lets MCP-capable agents (Claude Code, Cursor, CI, hosted assistants) discover and read a vNext domain's **components**, **live runtime data**, and the static **`vnext-meta`** package over a single endpoint — so AI tooling can be wired directly against a domain's runtime. | ||
|
|
||
| It is **thin and decoupled**: it calls the Orchestration HTTP API via a typed `HttpClient` and has **no** DB / Redis / Dapr / Application references. | ||
|
|
There was a problem hiding this comment.
Context7 üzerindeki doküman keşfi MCP sunucusu referansı burgan-tech/vnext-docs olmalıdır. İngilizce dokümandaki burgan-tech/vnext-runtime ifadesini kaldırarak tutarlılık sağlayabiliriz.
Suggested change
| > **Note:** Documentation discovery is intentionally **not** in this server — use the **Context7 MCP** server (`burgan-tech/vnext-docs`), which already indexes the public docs with semantic search. See [AI-Assisted Development](./ai-assisted-development). |
12 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Ne değişti
vNext runtime v0.0.62 (milestone #28, schema 0.0.47) sürümünü dökümante eder — v0.0.60 ile aynı konseptte.
Yeni içerik
blog/2026-06-18-v0-0-62.md— İngilizce release notları, milestone'un 9 maddesinin tamamı.blog-migration/2026-06-18-v0-0-62-migration.md— Türkçe migration rehberi (her bölüm "Ne değişti" + "Migrasyon adımları").docs/tools/mcp-runtime.md(+ EN mirror) — yeni vnext-runtime MCP server sayfası;sidebars.tsvetools/index.mdnavigasyonu güncellendi.Güncellenen doküman sayfaları (TR + EN mirror)
tasks/http.mdcontentTypealanıcomponents/workflow.mdinteraction/ Long Poll bölümühow-to/async-sync.mdfunctions/custom.md,interfaces.mdScriptResponseheader/status forwardconcepts/authorization.mdtasks/soap.mdEk fix'ler release notlarında: ChainToken gate (#730), domain replacement subprocess refs (#729).
Reviewer notları
npm run buildher iki locale (tr/en) için başarılı; eklenen sayfa/linklerde kırık link yok (build'deki kırık-anchor uyarıları yalnızca önceden var olan archive/v0.0.60 sayfalarına ait, bu PR'da dokunulmadı).soap.mdveasync-sync.md'nin mevcut EN mirror'ı olmadığından (repo'daki mevcut durum) TR-only güncellendi; yeni MCP sayfası iki locale'de de oluşturuldu.workflow.md/interfaces.mdmirror'ları TR'nin kısaltılmış sürümleri olduğu için birebir tablo satırı yerine eşdeğer kısa bölümler eklendi.context7.jsonyalnızca kimlik bilgisi içeriyor (bölüm listesi yok) — değişiklik gerekmedi.🤖 Generated with Claude Code
Summary by Sourcery
Document vNext runtime v0.0.62, including new integration features, authorization behavior changes, and the new vnext-runtime MCP server.
New Features:
Enhancements:
Documentation:
Summary by CodeRabbit
Release Notes: v0.0.62
New Features
Bug Fixes
Documentation