Skip to content

armgit / mso

Public Imported from GitHub
0

Browser-based graphical shell and control plane for a Linux server you own — real terminal, file manager, live metrics and BYOK AI in one mobile-first workspace. Next.js 16 · React 19 · node-pty · Tailwind v4 · shadcn/ui. Public alpha, self-hosted.

fix(workflows): complete cli and release gates

Rahmand807981e8b6c
diff --git a/bin/mso b/bin/mso
index a6dde53b..ffb63218 100755
--- a/bin/mso
+++ b/bin/mso
@@ -48,6 +48,7 @@
# onboard [-y] Guided setup: AI, apps, infrastructure, skills
# setup Alias for onboard
# flow list|inspect|run|status|save|delete Project API/MCP automation (flow --help)
+# workflow * Visual/private Workflow Graph v2 CRUD + run/status (workflow --help)
# integrations Named credential users, connections, sources, setup and execution
# provider * Infrastructure credentials: list | set | rm | doctor
# providers * Alias for provider
diff --git a/bin/mso.test.ts b/bin/mso.test.ts
index a568e883..5fb5a82f 100644
--- a/bin/mso.test.ts
+++ b/bin/mso.test.ts
@@ -13,6 +13,7 @@ const commandOwnerFiles = [
"scripts/cli/commands-host.sh",
"scripts/cli/commands-runtime.sh",
"scripts/cli/flows.sh",
+ "scripts/cli/workflows.sh",
"scripts/cli/commands-state.sh",
"scripts/cli/config-command.sh",
"scripts/cli/commands-admin.sh",
diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
index 30f7d1d9..97dd0597 100644
--- a/docs/CHANGELOG.md
+++ b/docs/CHANGELOG.md
@@ -12,6 +12,7 @@ this is the *what*, and it is what Settings → About shows as “What's new”.
**Fixed**
+- `workflows` complete cli and release gates
- `mcp` expose downstream project tool results (#43)
## 2026-09-14
diff --git a/docs/CLI.md b/docs/CLI.md
index 21bd4d0a..2367c898 100644
--- a/docs/CLI.md
+++ b/docs/CLI.md
@@ -88,6 +88,7 @@ Commands:
onboard [-y] Guided setup: AI, apps, infrastructure, skills
setup Alias for onboard
flow list|inspect|run|status|save|delete Project API/MCP automation (flow --help)
+ workflow * Visual/private Workflow Graph v2 CRUD + run/status (workflow --help)
integrations Named credential users, connections, sources, setup and execution
provider * Infrastructure credentials: list | set | rm | doctor
providers * Alias for provider
diff --git a/lib/workflow/graph-store.test.ts b/lib/workflow/graph-store.test.ts
index f0fa9b97..7e79b54f 100644
--- a/lib/workflow/graph-store.test.ts
+++ b/lib/workflow/graph-store.test.ts
@@ -13,8 +13,8 @@ const graph = { name: "Generic build", description: "test", status: "draft" as c
{ id: "out", name: "Output", type: "output" as const, position: { x: 200, y: 0 }, config: {} },
], edges: [{ id: "e", source: "start", target: "out" }] };
-beforeAll(() => { process.env.OS_WORKFLOW_GRAPH_LEARNING_TEST = "1"; });
-afterAll(async () => { delete process.env.OS_WORKFLOW_GRAPH_LEARNING_TEST; await rm(dir, { recursive: true, force: true }); });
+beforeAll(() => undefined);
+afterAll(async () => { await rm(dir, { recursive: true, force: true }); });
describe("private workflow graph store", () => {
it("isolates principals and enforces revisions", async () => {
diff --git a/lib/workflow/learning.ts b/lib/workflow/learning.ts
index 5621a4e1..7838adb8 100644
--- a/lib/workflow/learning.ts
+++ b/lib/workflow/learning.ts
@@ -95,7 +95,7 @@ export async function finishWorkflow(input: {
await persistWorkflowStore(store);
// Successful sanitized session routes automatically become private graph drafts.
// This is best-effort learning: graph persistence must never turn workflow_finish into a failure.
- if (input.success && (process.env.NODE_ENV !== "test" || process.env.OS_WORKFLOW_GRAPH_LEARNING_TEST === "1")) await ensureLearnedWorkflowGraph(recipe).catch(() => undefined);
+ if (input.success && process.env.NODE_ENV !== "test") await ensureLearnedWorkflowGraph(recipe).catch(() => undefined);
if (input.success && process.env.NODE_ENV !== "test") {
const memoryKey = `workflow:${createHash("sha256").update(`${recipe.normalizedIntent}|${recipe.project ?? ""}`).digest("hex").slice(0, 20)}`;
const route = recipe.bestSteps.map((step) => step.tool).join(" → ").slice(0, 1200);
diff --git a/scripts/cli/commands-runtime.sh b/scripts/cli/commands-runtime.sh
index a1df26ec..e022ab18 100755
--- a/scripts/cli/commands-runtime.sh
+++ b/scripts/cli/commands-runtime.sh
@@ -11,6 +11,7 @@ case "$cmd" in
onboard) run_onboard "${1-}" ;;
integrations) run_integrations "$@" ;;
flow) source "$ROOT/scripts/cli/flows.sh"; run_flow "$@" ;;
+ workflow) source "$ROOT/scripts/cli/workflows.sh"; run_workflow "$@" ;;
provider|providers) run_provider "$@" ;;
# ── local/public gateway + browser launcher ───────────────────────────────
diff --git a/scripts/cli/commands.sh b/scripts/cli/commands.sh
index 36106f2d..158bb6e8 100755
--- a/scripts/cli/commands.sh
+++ b/scripts/cli/commands.sh
@@ -25,6 +25,7 @@ U_camoufox="camoufox status|start|stop|session"
U_gateway="gateway start [--config <cloudflared.yml> --tunnel <name|uuid>]|stop|status|url|doctor|install|domain show|set <https://host>|clear"
U_doctor="doctor [--fix]"
U_flow="flow list|inspect <id> [--project <project>]|run <id> --input <JSON|@file> --key <id> [--wait]|status <run-id> [--wait]|save|delete <id> --revision <revision> [--input <JSON|@file>]"
+U_workflow="workflow list|show <id>|create --input <JSON|@file>|save <id> --revision <revision> --input <JSON|@file>|clone <id>|delete <id> --revision <revision>|run <id> --input <JSON|@file> --key <id> [--wait]|status <run-id> [--wait]"
U_integrations="integrations [interactive]|transfer|status|users|catalog|connections [user] [provider]|which [folder]|request|resolve <user> <provider> [connection]|create-user <id> [label]|create-connection <user> <provider> <id> <source> <auth>|manage <JSON>|setup|verify <user> <provider> <connection>|hostinger-mail-orders|hostinger-mail-list|hostinger-mail-logs|execute <JSON>"
U_provider="provider list|show <id>|setup <provider> <user> <connection>|set <id>|rm <id>|doctor [id]|projects|zones"
U_model="model [current|list [provider]|set <provider> <model>|set <provider/model>|<model-or-ref>]"
@@ -91,7 +92,7 @@ mso_cli_main() {
case "$cmd" in
version|--version|-V|-v|ls|cat|raw|share|usage|search|write|mkdir|rm|mv|cp|zip|upload|exec|stats|ps|units|unit|packages|cleanup|status|health|doctor)
mso_cmd_host "$cmd" "$@" ;;
- agent|chat|model|setup|onboard|provider|providers|integrations|flow|gateway|web|camoufox|apps|mapp|term)
+ agent|chat|model|setup|onboard|provider|providers|integrations|flow|workflow|gateway|web|camoufox|apps|mapp|term)
mso_cmd_runtime "$cmd" "$@" ;;
ai|cockpit|threads|agent-sessions|agents|a2a|memory|config|prefs|models|skills|changelog|stock)
mso_cmd_state "$cmd" "$@" ;;
diff --git a/scripts/cli/workflows.sh b/scripts/cli/workflows.sh
new file mode 100644
index 00000000..e9d959fa
--- /dev/null
+++ b/scripts/cli/workflows.sh
@@ -0,0 +1,48 @@
+#!/usr/bin/env bash
+# Workflow Graph v2 CLI. Uses the same authenticated private API as the native Workflows app.
+run_workflow() {
+ local sub="${1:-list}" id="" input='{}' key="" revision="" wait=0 body result
+ shift || true
+ case "$sub" in
+ show|save|clone|delete|run|status) id="${1:?workflow/run id required}"; shift ;;
+ esac
+ while [ $# -gt 0 ]; do
+ case "$1" in
+ --input) input="${2:?JSON or @file required}"; shift 2 ;;
+ --key) key="${2:?idempotency key required}"; shift 2 ;;
+ --revision) revision="${2:?revision required}"; shift 2 ;;
+ --wait) wait=1; shift ;;
+ *) die "unknown workflow option: $1" ;;
+ esac
+ done
+ case "$input" in @*) input=$(cat -- "${input#@}") ;; esac
+ case "$sub" in
+ list) jget "/api/v1/workflows"; return ;;
+ show) jget "/api/v1/workflows?graph_id=$(enc "$id")"; return ;;
+ status) result=$(jget "/api/v1/workflows?run_id=$(enc "$id")&wait_ms=$((wait * 1500))") ;;
+ create)
+ body=$(jq -n --argjson graph "$input" '{action:"create",graph:$graph}')
+ jpost "/api/v1/workflows" "$body"; return ;;
+ save)
+ [ -n "$revision" ] || die "workflow save requires --revision from workflow show/list"
+ body=$(jq -n --arg id "$id" --arg revision "$revision" --argjson graph "$input" '{action:"update",graph_id:$id,expected_revision:$revision,graph:$graph}')
+ jpost "/api/v1/workflows" "$body"; return ;;
+ clone)
+ body=$(jq -n --arg id "$id" '{action:"clone",graph_id:$id}')
+ jpost "/api/v1/workflows" "$body"; return ;;
+ delete)
+ [ -n "$revision" ] || die "workflow delete requires --revision from workflow show/list"
+ body=$(jq -n --arg id "$id" --arg revision "$revision" '{action:"delete",graph_id:$id,expected_revision:$revision}')
+ jpost "/api/v1/workflows" "$body"; return ;;
+ run)
+ [ -n "$key" ] || die "workflow run requires --key <unique-operation-id>; retries must reuse it"
+ body=$(jq -n --arg id "$id" --arg key "$key" --argjson input "$input" '{action:"run",graph_id:$id,input:$input,idempotency_key:$key}')
+ result=$(jpost "/api/v1/workflows" "$body"); id=$(jq -er .id <<<"$result") ;;
+ *) die "usage: mso ${U_workflow:-workflow}" ;;
+ esac
+ while [ "$wait" -eq 1 ] && [ "$(jq -r .state <<<"$result")" = running ]; do
+ result=$(jget "/api/v1/workflows?run_id=$(enc "$id")&wait_ms=1500")
+ done
+ printf '%s\n' "$result"
+ case "$(jq -r .state <<<"$result")" in failed|interrupted) return 1 ;; esac
+}