Mirror Sync — pull all remote-only workflows

Make the local repo a complete mirror of the instance's workflows. n8nac has no pull-all; this skill drives the list --json → per-id pull loop deterministically via a Workflow script (fan-out, no silent cap, verified).

Why this exists

The edit flow of /n8n-autopilot:build-workflow-v2 is local-first — it assumes every remote workflow already has a local .workflow.ts. Nothing established that invariant before (init pulled schemas, never workflows). This skill is the enforcement: it pulls the gap and the SessionStart probe keeps it honest.

How to run

Normalize the script into the scratchpad, then invoke that copy via the Workflow tool (it runs in the consumer-repo cwd, so npx n8nac still resolves the pinned project + sync folder):

sed 's/\r$//' "<plugin>/skills/mirror-sync/sync.workflow.js" > "<scratchpad>/sync.workflow.js"

Workflow({ scriptPath: "<scratchpad>/sync.workflow.js" })

The sed is not optional — and seeing LF once does not excuse skipping it. Line endings in the installed copy are sporadic: measured with file, this script was CRLF in 5.3.0 and 5.3.1 and LF in 5.3.2, while build.workflow.js was LF in all three. A version that works proves nothing about the next install, so normalize unconditionally — even though the repo blob is LF and .gitattributes pins *.js text eol=lf. Workflow({scriptPath}) then refuses it outright: "script contains control characters that would be hidden in the approval dialog". Normalizing costs one command and is content-identical to the blob (cmp against git show HEAD:<path>). Never hand-edit the plugin cache.

Then render the result:

• { status:'success', pulled, mirrorComplete:true } — report how many pulled (0 = already complete).
• { status:'partial', failed:[…], remoteOnlyRemaining } — list the failed ids + reasons; suggest a re-run or a manual npx n8nac pull <id>.

Watch live progress with /workflows.

Phases (in the script)

1. Discover — n8n-mirror runs npx n8nac list --json and returns the remote-only set (status matches /REMOTE/i — vocabulary-robust across n8nac versions — and not archived). Zero remote-only → returns early, mirror already complete.
2. Pull — fan-out: one n8n-mirror agent per missing workflow runs npx n8nac pull <id>. Failures are collected, not fatal.
3. Verify — re-discover; remoteOnlyRemaining === 0 ⇒ mirrorComplete.

Triggers

Boundaries

• Workflows only. Node schemas are a separate concern (check-schema-versions.sh → /n8n-autopilot:pull-schemas); this skill does not duplicate them.
• Pull only — never push/resolve/delete. Archived workflows are skipped (read-only).
• Large instances: fan-out is capped at ~10 concurrent by the Workflow runtime; all queued workflows still complete. The pull list is logged in full — no silent truncation.