Skip to content

feat(workflows): add declarative orchestration runtime - #618

Open
pascalandr wants to merge 3 commits into
NeuralNomadsAI:devfrom
pascalandr:feat/workflow-host-spike
Open

feat(workflows): add declarative orchestration runtime#618
pascalandr wants to merge 3 commits into
NeuralNomadsAI:devfrom
pascalandr:feat/workflow-host-spike

Conversation

@pascalandr

@pascalandr pascalandr commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Add a versioned JSON/YAML workflow DSL with sequence, condition, parallel, foreach, repeat, agent, shell, gate, and nested saved-workflow nodes.
  • Add bounded concurrency, retries, node deadlines, structured output validation, observed usage budgets, pause/resume, durable gates, cancellation, crash recovery, immutable definition revisions, and retained managed-worktree execution.
  • Preserve the Simple workflow builder and add localized declarative authoring, revision conflict handling, execution trees, usage/output/session monitoring, and recovery controls in the customizable right panel.
  • Extend the OpenCode plugin with read/start/cancel access to saved workflows while keeping definition mutations, gates, approvals, and recovery confirmation on authenticated user APIs.

Safety

  • Default agent tools to disabled and reject execution-capable tool overrides; explicit shell nodes are the command boundary.
  • Use per-workspace callback capabilities, trusted-origin CORS/CSRF checks, atomic latest-revision starts, bounded input/schema/context/history sizes, and safe Markdown URL rendering.
  • Serialize admission, ownership, pause/resume, deletion, and recovery; retain reservations whenever persistence or session termination is ambiguous.
  • Canonically contain managed worktrees and terminate Git/OpenCode process trees on cancellation, timeout, and shutdown.

Validation

  • Server typecheck passed.
  • UI typecheck and production build passed.
  • OpenCode plugin build passed.
  • Full server suite: 335 passed, 4 platform-skipped, 0 failed.
  • Focused UI workflow tests: 18 passed.
  • Markdown safety tests: 15 passed.
  • Final gatekeeper review: zero actionable findings.

Closes #435

Add durable sequential workflow execution with bounded outputs, human review gates, cancellation, restart recovery, lineage-scoped locking, and SSE updates.

Expose workflow creation and monitoring in the right panel and through the CodeNomad plugin bridge. Keep approval mutations on the authenticated user API so plugin credentials cannot bypass a human gate, and preserve workspace lineage across desktop restore.

Cover runtime transitions, restart rebinding, abort containment, route scoping, client reconciliation, restore identity, and plugin messaging with focused tests.
@pascalandr
pascalandr marked this pull request as ready for review July 21, 2026 06:43
Resolve right-panel customization conflicts by registering Workflows through the modular tab registry while retaining keyboard tab navigation and ARIA panel relationships.

Combine workflow and customization translations, keep generic persisted tab IDs, and preserve all upstream settings, auth, filesystem, permission, and Linux launch fixes.

Validated with the UI typecheck and 78 focused registry, workflow, reconciliation, snapshot, and codec tests.
Add versioned JSON/YAML workflow definitions with branching, bounded parallelism, loops, nested workflows, gates, retries, structured outputs, budgets, pause/resume, crash recovery, and managed-worktree execution.

Keep workflow mutation behind authenticated host APIs, scope plugin callbacks with per-workspace capabilities, restrict agent tools and plugin operations, and harden cancellation, persistence, CORS, process cleanup, ownership leases, and stale revision handling.

Extend the right-panel workflow UI with declarative authoring, localized execution monitoring, durable drafts, recovery controls, safe output rendering, and retained-workspace session navigation while preserving the simple builder.

Validated with server typechecks and the full 335-pass server suite, UI/plugin typechecks and builds, focused workflow/UI/Markdown tests, and a zero-finding gatekeeper review.
@pascalandr pascalandr changed the title feat(workflows): add host-managed workflow runs feat(workflows): add declarative orchestration runtime Jul 28, 2026
@github-actions

Copy link
Copy Markdown

PR builds are available as GitHub Actions artifacts:

https://github.com/NeuralNomadsAI/CodeNomad/actions/runs/30383020047

Artifacts expire in 7 days.
Artifacts:

  • pr-618-4ccf771a394c42819d1169d19bfc3bb0ef3fc9ab-tauri-macos
  • pr-618-4ccf771a394c42819d1169d19bfc3bb0ef3fc9ab-tauri-windows
  • pr-618-4ccf771a394c42819d1169d19bfc3bb0ef3fc9ab-tauri-linux
  • pr-618-4ccf771a394c42819d1169d19bfc3bb0ef3fc9ab-electron-macos
  • pr-618-4ccf771a394c42819d1169d19bfc3bb0ef3fc9ab-electron-linux
  • pr-618-4ccf771a394c42819d1169d19bfc3bb0ef3fc9ab-tauri-macos-arm64
  • pr-618-4ccf771a394c42819d1169d19bfc3bb0ef3fc9ab-electron-windows

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Feature Request] Instance to Instance communication?

1 participant