Skip to content

Describe deferred configurations, cross-child references and single outputs named for their output - #89

Merged
clhodapp merged 3 commits into
mainfrom
docs/single-outputs-and-cross-child
Oct 29, 2026
Merged

clhodapp merged 3 commits into
mainfrom
docs/single-outputs-and-cross-child

Conversation

@clhodapp

Copy link
Copy Markdown
Contributor

Documents nix-caisson/caisson-core#57 and nix-caisson/caisson#141.

  • docs/reference/lib.md gets a section on deferred configurations, after finalizeTop: mkDeferredConfiguration, deferChild, finalizeDeferredChild, finalizeDeferredTop, mkArg, argsNeededFor, argNamesOf and standInsFor. The manifest section describes crossChildLevel and the precedence of the three containers.
  • A configuration of an integration with a single output is named for that output, so the examples and the publication rule now say colmenaHive, formatter and topology where they said default.
  • The upstream-compatible colmena section says how nodes is built now: the nodes of the full colmena configuration, through unsafeCrossChildReferences.
  • docs/reference/options.md adds caisson.forChildren.unsafeCrossChildReferences and the options of caisson.forNearestChildren and caisson.forDirectChildren. The site had no entry for forNearestChildren before.

The NixOps4 pages follow in #88, which is reworked for nix-caisson/caisson#142.

🤖 Generated with Claude Code

…ngle outputs named for their output

lib.md describes caisson-core's deferred configurations (mkDeferredConfiguration, deferChild, finalizeDeferredChild, finalizeDeferredTop, mkArg and the stand-ins) and the crossChildLevel a manifest records. A configuration of an integration with a single output is now named for that output: colmenaHive, formatter, topology. The colmena integration's nodes are the nodes of the full colmena configuration.

options.md adds caisson.forChildren.unsafeCrossChildReferences and the options of caisson.forNearestChildren and caisson.forDirectChildren.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@clhodapp clhodapp self-assigned this Oct 26, 2026
clhodapp and others added 2 commits October 26, 2026 17:39
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… their args

A deferred configuration is made by mkDeferredConfiguration with a
record, and its entry's finalize { args, argsSource } fills the args
from the manifest's own argsNeeded. Every manifest carries argsNeeded
and discoverArgs, a function of { system }. The integrations builder
publishes an entry from the exportsTo of its record and takes children
an evaluation finalizes itself. The cross-child text names
crossChildFull.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@clhodapp
clhodapp merged commit 9ee2a37 into main Oct 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant