feat(experimental): Customizations files

[adamspofford-dfinity]

A project can ship an icp_customize.yaml next to its manifest declaring what whoever deploys it should be asked for, and icp deploy --customize asks every question up front and then installs with the answers. An option either substitutes a Candid value into a field of the canister's init_args — addressed by arg index and field path, asked for at the declared type — or sets one of its environment variables, which needs no placeholder in the manifest. Options name canisters by store key, so a workspace declares its customizations once in the root project's file and can still reach a member's canister, and one option may name several canisters to be asked once and answered for all of them. icp project bundle packages the file and validates its references, so a bundled app prompts the same way wherever it is extracted. Without the flag the file is inert; --args/--args-file still outrank it, and init-arg options are skipped when they are given. The flag is hidden while the format settles.

# icp_customize.yaml
options:
  - canister: backend
    field_path: ".supply"
    candid_type: "nat64"
    description: "Initial token supply"

  - canister: [frontend, "services/open-crm:backend"]
    env: API_ENDPOINT
    description: "Upstream API base URL"

🤖 Generated with Claude Code

[Copilot]

Pull request overview

Adds support for project-level customization prompts driven by an icp_customize.yaml file, and ensures this customization manifest is preserved when projects are bundled so deployments can keep the same interactive customization behavior.

Changes:

• Introduces operations::customize to load icp_customize.yaml, prompt for values, and substitute them into Candid init args.
• Updates deploy to apply customization-derived init args with defined precedence relative to CLI --args/--args-file and manifest init_args.
• Updates bundle to include icp_customize.yaml at the archive root and adds a regression test for this behavior.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
crates/icp-cli/tests/bundle_tests.rs	Adds test asserting icp_customize.yaml is bundled verbatim at archive root.
crates/icp-cli/src/operations/mod.rs	Registers the new customize operations module.
crates/icp-cli/src/operations/customize.rs	Implements customize manifest parsing, interactive prompting, and init-args field substitution with unit tests.
crates/icp-cli/src/operations/bundle.rs	Reads and appends icp_customize.yaml into the bundle archive and adds an error variant.
crates/icp-cli/src/commands/deploy.rs	Collects customization overrides pre-build and applies them between CLI args and manifest init args.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.