Comfy-Org / Comfy-Org/comfy-cli

No way to read a workflow without creating a build

Open
#787 1 comment 0 reactions 0 assignees View on GitHub
enhancement
Dominant language
Python
Stars
968
Forks
151
Avg merge
1d 9h
Merged PRs (30d)
77

Description

`comfy build from-workflow` is the only verb that reads a workflow file, and it creates a build as a side effect. There is no way to ask what a workflow contains first.

The builder already serves the read-only door. `POST /v1/workflows/resolve` returns the same `definition` and `report` and creates nothing; its own description says it is "for a caller that wants to show a person what the workflow means first". The CLI exposes only the create door.

**Why it matters:** an agent handed an unfamiliar workflow is told to describe what will be created before creating it, and cannot. It has to write a build to find out whether the build is worth writing. On a graph carrying a class nobody publishes, that record is pure litter: the definition comes back `{}` and the right answer is not to build at all.

**Observed**, staging, a workflow with one unpublishable class:

```
$ comfy build from-workflow --from sdxl-with-unknown.json --name probe
{"ok": true, "data": {"build": {"id": "b0fed96c-...", "definition": {},
"workflowImportReport": {"unresolvedClasses": ["TotallyMadeUpNodeXYZ42"], ...}}}}
```

A build now exists that should never have been created, and the only way to have known that was to create it.

**Suggested:** a `comfy build resolve-workflow --from ` (or `--dry-run` on `from-workflow`) that posts to `/v1/workflows/resolve` and prints the report without writing anything.

Found while testing the comfy-build skill's workflow path end to end.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.