[karhu]

The Stack

This stack covers refactoring the internal logic of how releases are resolved during read, download & build, in particular also in the context of parent releases / parent datasets. On top of that it refactors the public TimeNet APIs and CLI interfaces around these actions, to streamline the behavior across them.

This PR

timenet list, search, info and download take --local-registry, --remote-registry and --auto-build/--no-auto-build. They replace --registry.

Details

The consumer CLI had one flag for the list of sources: --registry named the registry after the store. The store and the installed connectors came only from the environment, so a command cannot move the store or leave out the connectors.

• Each flag matches one variable of the default list and overrides it. If a flag is not given, the variable applies.
• The commands make the list with default_sources(). An empty value raises TimeFValidationError and never means the current directory. The error names the variable. If the variable has a flag, the error names the flag too.
• timenet local info and timenet local clear take only --local-registry, because they work on the store and the cache alone. timenet local cache info and timenet local cache clear take no flag.
• The flags live in the new module timenet.cli.options, so that the build CLI can take the same flags with the same help.
• Size: about 250 changed lines.

Design decisions

• The flags sit in a shared module, because the build CLI must take the same flags with the same help. A second copy can drift.
• The commands use default_sources() and not their own parsing, so a flag and its variable follow the same checks.
• local info and local clear take no other flags, because they never read a registry after the store.

Breaking changes

• timenet list, search, info and download take --local-registry, --remote-registry and --auto-build/--no-auto-build instead of --registry.
• timenet local info and timenet local clear take --local-registry.

Stack

• docs: update the docs for the build coordinator #683
• feat(hints)!: give every error one hint for the SDK and one for the CLI #698
• feat(cache)!: record where each release in the local registry comes from #674
• feat(client)!: list and search every source #673
• feat(client)!: replace get() with get_manifest() and get_card() #672
• feat(build)!: build into the local registry, publish with --publish-to #671
• feat!: add timenet.build() and publish() #670
• 👉 feat(cli)!: take --local-registry, --remote-registry and --auto-build #669
• feat(config)!: make the default list of sources from three variables #668
• test: isolate every test from the real home and guard it #667
• feat(client)!: download releases into the local registry #662
• feat(client)!: take an ordered list of sources #661
• feat(client)!: read releases through the coordinator #660
• feat(coordinator)!: plan and run reads through the list of sources #659
• feat(coordinator)!: plan parents through an ordered list of sources #658
• feat(sources)!: resolve a release through an ordered list of sources #657
• feat(build)!: run every build through the coordinator #655
• feat(build)!: move the build CLI and build() onto the coordinator #654
• feat(build)!: build one prepared release in the built-in backend #653
• feat(coordinator)!: plan and run builds through build_release #652
• refactor(coordinator)!: name the plan step type Step #651
• feat(registry)!: copy a release between registries #649
• feat(registry)!: publish a local release with put_release #648
• refactor(build)!: let the connector choose the values backend #646

Changes later in the stack:

• docs: update the docs for the build coordinator #683 holds the doc changes of this PR.
• timenet-build build still takes --out, --fetch-from and --build-parents. The PR on timenet-build --publish-to replaces them with these flags.

Merge message

feat(cli)!: take --local-registry, --remote-registry and --auto-build

timenet list, search, info and download take --local-registry,
--remote-registry and --auto-build/--no-auto-build, so that one
command can move the local registry or leave out the installed
connectors.

- Each flag overrides one variable of the default list. If a flag is
  not given, its variable applies.
- The commands make the list with default_sources(), so a flag and its
  variable follow the same checks. An empty value is an error that
  names the flag and the variable.
- timenet local info and timenet local clear take only
  --local-registry.
- The flags live in timenet.cli.options, so that the build CLI can
  share them.

BREAKING CHANGE: timenet list, search, info and download lose
--registry and -r. Use --remote-registry.

[claude]

Nothing blocking. The comments below are optional suggestions. There is no need to push a fix for them before merging.

[claude]

Code review found no issues

No high-confidence issues detected in this change.

[claude]

⚠️ Code review skipped: your organization has reached its API usage limit, so Code Review can't run right now.

An organization admin can review the limit in your organization's usage and billing settings.

Once the limit resets or is raised, someone with write access to this repository can comment @claude review on this pull request to trigger a review.