Manifest Reference

Weld manifests are plain Elixir keyword lists.

Top-Level Keys

workspace

• root Path from the manifest file to the repo root.
• project_globs Optional authoritative project globs. If omitted, weld will try blitz_workspace and then filesystem fallback.

classify

• tooling
• proofs
• ignored

Each value is a list of project ids.

publication

• internal_only
• separate
• optional

optional is a keyword list mapping feature ids to project-id lists.

dependencies

Manifest-owned canonical external dependency declarations.

Use this when a selected project depends on an external package through local workspace transport such as :path, :git, or :github, but the welded artifact must publish a canonical dependency instead.

Each key is the dependency app name. Each value contains:

• requirement — version requirement string. Optional when opts includes :git or :github.
• opts — additional Mix dependency opts. :path is rejected. :git and :github are permitted.

weld raises if neither a requirement nor a git/github opt is present.

artifacts

One manifest can define more than one publishable artifact. Each artifact entry contains:

• mode — :package_projection (default) or :monolith. The alias :components is accepted as a synonym for :package_projection.
• monolith_opts — keyword list of monolith-specific options (see below). Ignored in package-projection mode.
• roots
• include
• optional_features
• package
• output
• verify

Monolith Options (monolith_opts)

• shared_test_configs — list of project ids (atoms or strings) whose config/test.exs files are imported into the generated root config/test.exs. Other packages' test configs are omitted and a warning is emitted for each.
• extra_test_deps — list of app name atoms referencing manifest-declared dependencies that should be forced into test-only deps in the generated mix.exs, even if they would not otherwise appear in the test closure.
• test_support_projects — list of non-selected project ids (atoms or strings) that are allowed to appear in the monolith :test view. When present, weld fails closed if the discovered non-selected test support set does not match the manifest.

Package Keys

• name
• otp_app
• version
• elixir
• description
• licenses
• maintainers
• links
• docs_main

Output Keys

• dist_root
• docs
• assets

Verify Keys

• artifact_tests
• hex_build
• hex_publish
• smoke.enabled
• smoke.entry_file

Smoke verification is not run in monolith mode. Set hex_build: false for internal artifacts that intentionally depend on non-Hex git dependencies. Set hex_publish: false when package-projection verification should skip mix hex.publish --dry-run --yes.

hex_build: false does not disable weld.release.prepare, weld.release.track, or weld.release.archive. It only omits the tarball from the prepared bundle.

Example — Package Projection

[
  workspace: [
    root: "../..",
    project_globs: ["apps/*", "core/*", "tooling/*"]
  ],
  dependencies: [
    external_lib: [
      requirement: "~> 1.2",
      opts: []
    ],
    private_tool: [
      opts: [git: "https://example.com/private_tool.git", branch: "main"]
    ]
  ],
  classify: [
    tooling: [".", "tooling/test_support"],
    proofs: ["apps/demo"]
  ],
  publication: [
    internal_only: ["tooling/test_support"],
    optional: [
      demo: ["apps/demo"]
    ]
  ],
  artifacts: [
    web_bundle: [
      roots: ["apps/web"],
      package: [
        name: "web_bundle",
        otp_app: :web_bundle,
        version: "0.1.0"
      ],
      output: [
        docs: ["README.md", "guides/architecture.md"]
      ],
      verify: [
        artifact_tests: ["packaging/weld/web_bundle/test"],
        hex_build: true,
        hex_publish: true
      ]
    ]
  ]
]

Example — Monolith

[
  workspace: [
    root: "../..",
    project_globs: ["core/*", "runtime/*"]
  ],
  artifacts: [
    my_monolith: [
      mode: :monolith,
      roots: ["runtime/api"],
      monolith_opts: [
        shared_test_configs: ["core/contracts"],
        extra_test_deps: [:bypass],
        test_support_projects: ["tooling/test_support"]
      ],
      package: [
        name: "my_monolith",
        otp_app: :my_monolith,
        version: "0.1.0",
        description: "My welded monolith"
      ],
      output: [
        docs: ["README.md"]
      ],
      verify: [
        hex_build: false
      ]
    ]
  ]
]