feat(cli): nodes path --emit-ops (round-trips through apply_specs)

[skishore23]

Linear: BE-7152 (V1-019) · Layer 3/4 of the V1 hop-killer stack, stacks on #708.

The gap it closes

nodes path reports a plan (a routed node sequence); agents then hand-build the apply batch from it. --emit-ops emits the plan as the batch: each returned path gains paths[].ops — a ready-to-apply spec batch in the frozen edit vocabulary, feedable straight into comfy workflow apply --ops.

Semantics

• One add_node spec per step with a deterministic dedup-suffixed as: alias (tinysampler, tinysampler_2, … — the same slugging capture_recipe uses, so both surfaces mint identical alias vocabulary).
• One connect spec per step whose consumed type is produced earlier in the path: from the nearest prior producer's matching output (resolved against the schema, since in --exact mode a step's recorded output_type is only one of possibly several) to the consumer's first link input accepting that type (required inputs first).
• The path's seed FROM type is produced by nothing in the path, so the first step's input deliberately stays unbound — never a phantom connect.
• Works in both --exact and --loose modes. Without the flag the payload is byte-identical.

THE CONTRACT IS THE ROUND-TRIP: the emitted specs must pass workflow_ops.apply_specs unchanged. The test feeds them to apply_specs on an empty workflow and asserts the nodes and links exist (including that the minted link's source is the alias-minted node).

$-form note

The vocabulary-freeze PR #704 adds $-sugar for alias references; this base branch predates it, so connect specs reference aliases as bare names — the freeze doc's valid form. Migrating emission to the $-canonical form is a small follow-up once #704 lands.

Test evidence

tests/comfy_cli/command/test_nodes_path_emit_ops.py — TDD: red first (4 fail: unknown option/helper; the byte-identical baseline trivially passes pre-change and pins the invariant after), then green.

• round-trip through apply_specs on an empty workflow: 2 nodes + 1 link materialize, link source = aliased node
• alias uniqueness deterministic (tinydecode, tinydecode_2; same input → same output)
• loose mode emits too; no phantom producers (every connect endpoint is a minted alias)
• neighbors: test_nodes_introspect.py, test_nodes_search_expand.py, test_workflow_edit.py (150 total) green; ruff clean

Sibling-PR notes

• docs+ops: freeze the op vocabulary (op-vocabulary-v1.md) + $-alias sugar + batch-clear hint #704 rebase: when the freeze lands, only the emission site (_emit_path_ops) needs the $-form switch; the round-trip test is the guard.

🤖 Generated with Claude Code

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 9f52580b-09c0-4e0c-83ce-df54b207dcad

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

_{Comment @coderabbitai help to get the list of available commands.}