Skip to content

Next CLI Release - #1580

Draft
josephjclark wants to merge 2 commits into
mainfrom
release/next
Draft

josephjclark wants to merge 2 commits into
mainfrom
release/next

Conversation

@josephjclark

Copy link
Copy Markdown
Collaborator
  • Split up openfn.yaml
  • Introduce untracked .openfn folder
  • Fix silly id conflicts

josephjclark and others added 2 commits October 8, 2026 11:59
* lexicon: remove trigger.enabled from spec

* update handling of trigger.enabled

* update version hash

* changeset

* remove log

* update version util and fix tests

* add notes to docs

* remove .only

* fix test

* update test

* fix integration test

* first swing at refactor to split up openfn.yaml

* order keys

* fix ropey merge issues

* add logic to checkout on git without tracking

* Update tests for checkout file and flat openfn.yaml

Project metadata now lives in .openfn/checkout.yaml, openfn.yaml holds
workspace config (plus collections) as flat, sorted keys. Integration
tests pin OPENFN_BRANCH=false so they don't pick up the kit repo's branch.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* format

* move collections to resources.yaml

* Add prompt to reworked openfn yaml (#1577)

* add util for checking if there's a valid checkout

* add helpers for writing checkout metadata

* refactoring

* use new helpers in deploy

* prompt user for checkout

* add user prompt

* simplify

* fix tests

* better fix

* ignore checkout meta (#1578)

* changeset

* changesets and docs

---------

Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>
* project: tell local copies of the same project apart by alias

A workspace can hold several local copies of one project, each from its
own state file (main@app.openfn.org.yaml, backup@app.openfn.org.yaml).
They share a UUID and id, so anything keyed on those mixed them up.
Copies overwrote each other's entries in the path map, the checkout had
no way to say which copy was checked out, and get() threw even when
given an exact alias.

matchProject now returns the exact alias match when all the other
matches share its UUID. Real ambiguity still throws, and the error
lists each clash as alias@host and suggests using one.

Workspace keeps project paths by Project rather than by id, so each
copy keeps its own file. getProjectPath() now takes a Project.
extractCheckout writes the active project's alias to the checkout file, and
getTrackedProject() looks that alias and host up first. The alias is
left out of project.openfn so the metadata doesn't store it twice.

merge used getProjectPath(id) to find where to write. With --base it
only got the right file because the id-keyed map happened to point
there. It now writes back to the --base file directly.

* cli: don't fail fetch on duplicate local projects when the target is explicit

`openfn project fetch <uuid> --endpoint X -o file.yaml` threw
MultipleMatchingProjectsError if two local project files shared the
UUID. With a full UUID, an endpoint and an output path, the command has
everything it needs, so the local copies don't matter.

Skip the local workspace lookup in that case. Also stop searching the
workspace for an output target once -o is given, because the path is the
target. Duplicates still throw when the UUID, endpoint or output path is
missing.

* cli: use the checked-out copy for pull and deploy without a target

When no project was given, pull and deploy fell back to the active
project's UUID. That throws if another local copy shares the UUID,
even though the checkout file says which one is checked out.

If the checkout file records an alias, pull now defaults to the tracked
project's alias@host and deploy uses the tracked project. Without an
alias, both fall back to the UUID as before.

* add changeset

* address review feedback

getTrackedProject now tries alias, uuid then id in plain steps, and
matches the alias on the full endpoint origin, so copies on different
ports of the same host (localhost:4000, localhost:5000) are told apart.

deploy picks its sync target in one place: an explicit target, the
local copy of a deployed file, or the tracked project. The ambiguity
error now suggests alias@domain or a path. Adds a test for fetching
by alias when local copies share a UUID.

* little tidy

---------

Co-authored-by: Joe Clark <jclark@openfn.org>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: New Issues

Development

Successfully merging this pull request may close these issues.

2 participants