docs: Forge-first onboarding, Forge & Quick Runner guides, v0.0.79 transition semantics - #23
Merged
Merged
Conversation
… updateData/lock semantics for v0.0.79 - Archive local-dev and multi-domain guides (tr+en) under docs/archive with deprecation banners; manual docker-compose setup stays as reference only - Add Forge-based development environment setup guide (forge-setup): extension install, AI plugin, project creation (AI init / Create Project), automatic Workflow CLI install with manual fallback, local & remote environments, troubleshooting repo map - Add Forge usage guide (forge-usage): Forge Tools panels, explorer context menus, all component designers with metadata + configuration screenshots, publish-to-CLI mapping (wf update / --all / csx --all) - Add Flow Quick Runner guide (quick-runner): annotated main screen (14 numbered regions), start instance, fire transition, pseudo-ui state view rendering, Data/History/Correlations/Raw tabs, instance details modal, long-poll behavior, Function Quick Runner with get-branches-func - 40+ real screenshots captured from VS Code with the live extension under static/img/tools/forge/ - Document v0.0.79 transition execution model in workflow.md (tr+en): Busy-as-mutex, admission matrix (state/shared vs cancel/exit vs updateData), status-neutral reserve updateData semantics incl. subflow parent handling - Extend v0.0.79 release notes with #877 (Busy-as-mutex, updateData v2, immediate InstanceData persistence) and #874 (business-focused tracing, Aether 1.0.34); add breaking-changes items 8-10; move release date to 2026-08-13 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Reviewer's GuideDocs PR that re-centers Getting Started around Forge, adds detailed Forge usage and Flow Quick Runner guides with extensive screenshots, and documents v0.0.79 transition execution semantics (Busy-as-mutex, status-neutral updateData, immediate InstanceData persistence) and tracing changes across blog, breaking-changes, and workflow component docs in both TR and EN. Sequence diagram for Busy-as-mutex transition execution modelsequenceDiagram
actor Client
participant Runtime
Client->>Runtime: stateTransition
alt instance Active
Runtime->>Runtime: [status lock Active→Busy]
Runtime->>Runtime: [run transition pipeline]
Runtime->>Runtime: [evaluate auto transitions]
else instance Busy
Runtime-->>Client: 409 Conflict
end
Client->>Runtime: cancel
Runtime->>Runtime: [status lock]
Runtime->>Runtime: [bypass Busy check]
Runtime->>Runtime: [start cancel flow]
Client->>Runtime: exit
Runtime->>Runtime: [status lock]
Runtime->>Runtime: [bypass Busy check]
Runtime->>Runtime: [start exit flow]
Client->>Runtime: updateData
Runtime->>Runtime: [no status lock, no Busy check]
Runtime->>Runtime: [persist InstanceData rows]
Runtime->>Runtime: [evaluate autos at order 90]
Runtime-->>Client: updateData response
Flow diagram for Forge-first development environment setupflowchart LR
A[Install vNextForgeExtension] --> B[Install AIToolkitPlugin]
B --> C[CreateProject via vnext-init or ForgeCreateProject]
C --> D[Install WorkflowCLI]
D --> E[AddEnvironment Local_or_Remote]
E --> F[DevelopFlows with Forge and QuickRunner]
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 Plus Run ID: ⛔ Files ignored due to path filters (35)
📒 Files selected for processing (24)
📝 WalkthroughWalkthroughThe PR documents v0.0.79 workflow execution changes and adds Forge setup, usage, Quick Runner, archive, and navigation documentation in Turkish and English. ChangesWorkflow and release documentation
Forge documentation and navigation
Estimated code review effort: 3 (Moderate) | ~20 minutes Possibly related PRs
✨ 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}
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.
Özet
Getting Started akışı Forge merkezli hale getirildi (eski local-dev/multi-domain rehberleri arşivlendi), Forge kullanımı ve Flow Quick Runner için gerçek ekran görüntülü detaylı kılavuzlar eklendi; v0.0.79 için updateData/lock yürütme semantiği (#877) ve tracing (#874) dokümante edildi.
Değişiklikler
Getting Started yeniden yapılandırması
local-devvemulti-domainrehberleridocs/archive/altına taşındı (deprecation banner + sidebar'da daraltılmış Arşiv kategorisi); manuel docker-compose kurulumu yalnızca referans olarak duruyor.getting-started/forge-setup): extension kurulumu → opsiyonel AI plugin → proje oluşturma (AIvnext-init/ Forge Create Project) → CLI otomatik kurulum + manuel fallback → Local/Remote environment ekleme → flow geliştirme; Forge–CLI–Runtime ilişkisi ve sorun giderme repo haritası.Yeni araç kılavuzları
tools/forge-usage): Forge Tools panelleri (Settings/Project/Environments/Package Deploy/Quick Run), Explorer sağ-tık menüleri, 7 component tasarımcısı (metadata + scroll'lu configuration ekranları), Publish→CLI eşlemesi (wf update,--all,csx --all).tools/quick-runner): kırmızı çerçeveli 14 numaralı bölgeyle işaretlenmiş ana ekran, Start Instance, Fire Transition (şema tabanlı form + Generate), pseudo-ui State View render davranışı, Data/History/Correlations/Raw, Instance Details modalı, long-poll, Function Quick Runner (get-branches-func).static/img/tools/forge/.v0.0.79 içerik güncellemeleri
workflow.md(tr+en): yeni Transition Yürütme Modeli bölümü — Busy-as-mutex, kabul matrisi (state/shared: lock+busy check; cancel/exit: busy check muaf; updateData: koşulsuz), reserveupdateDatasemantiği (status-neutral, subflow'da parent'ta karşılanır ve forward edilmez, auto'lar her updateData sonrası order 90'da değerlendirilir) ve flow tasarım notları (vnext #877).HistorySequencekaldırımı).Etkilenen Bölüm
docs/)architecture/)business/)product/)blog/)Dil
Local Doğrulama
npm run buildbaşarılı (her iki locale)npm run startile gözle kontrol edildiİlgili Phase / Issue
🤖 Generated with Claude Code
Summary by Sourcery
Rework docs to make Forge-based development the primary onboarding path, add detailed guides for Forge usage and Flow Quick Runner, and document the v0.0.79 Busy-as-mutex transition execution model and tracing changes in both release notes and workflow component docs.
New Features:
Enhancements:
Documentation:
Summary by CodeRabbit
updateDatais now status-neutral and restarts retry processing from the beginning.