feat(motoko): add useIcp canary option for icp-cli deployment

Adds a new `useIcp` boolean generator option (default: false) as a
canary for the icp-cli tool that replaces dfx:

- When useIcp=true, generates an icp.yaml scaffold configured with the
  @dfinity/motoko recipe pointing at the consumer canister's main.mo
- README cycles section switches to icp-cli commands (local network
  auto-seeds cycles; mainnet via icp deploy -e ic)
- api.mustache: remove dfx-specific wording from PUT/DELETE TODO comment
  (both dfx and icp-cli use moc for ic:aaaaa-aa resolution)
- useDfx flag and behaviour unchanged

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

Author: ggreif

modules/openapi-generator/src/main/java/org/openapitools/codegen/languages/MotokoClientCodegen.java

@@ -32,9 +32,11 @@
 public class MotokoClientCodegen extends DefaultCodegen implements CodegenConfig {
     public static final String PROJECT_NAME = "projectName";
     public static final String USE_DFX = "useDfx";
+    public static final String USE_ICP = "useIcp";
 
     protected String projectName = "OpenAPI";
     protected boolean useDfx = false;
+    protected boolean useIcp = false;
 
     @Override
     public CodegenType getTag() {
@@ -146,6 +148,7 @@ public MotokoClientCodegen() {
 
         cliOptions.add(CliOption.newString(PROJECT_NAME, "Project name for generated code"));
         cliOptions.add(CliOption.newBoolean(USE_DFX, "Generate code for dfx with ic:aaaaa-aa imports", useDfx));
+        cliOptions.add(CliOption.newBoolean(USE_ICP, "Generate icp.yaml for deployment with icp-cli (canary; replaces dfx)", useIcp));
 
         // Enable inline enum resolution to create model files for inline enum parameters
         // This ensures type-safe enum variants instead of raw Text types
@@ -164,6 +167,14 @@ public void processOpts() {
             setUseDfx(convertPropertyToBooleanAndWriteBack(USE_DFX));
         }
         additionalProperties.put(USE_DFX, useDfx);
+
+        if (additionalProperties.containsKey(USE_ICP)) {
+            setUseIcp(convertPropertyToBooleanAndWriteBack(USE_ICP));
+        }
+        additionalProperties.put(USE_ICP, useIcp);
+        if (useIcp) {
+            supportingFiles.add(new SupportingFile("icp.yaml.mustache", "", "icp.yaml"));
+        }
     }
 
     @Override
@@ -228,6 +239,14 @@ public boolean getUseDfx() {
         return useDfx;
     }
 
+    public void setUseIcp(boolean useIcp) {
+        this.useIcp = useIcp;
+    }
+
+    public boolean getUseIcp() {
+        return useIcp;
+    }
+
     @Override
     public String toModelImport(String name) {
         // For Motoko, imports are relative to the current Models directory

modules/openapi-generator/src/main/resources/motoko/README.mustache

@@ -74,6 +74,20 @@ The generated API client makes HTTP outcalls using the Internet Computer's manag
 
 **Important:** Before calling any API endpoints, ensure your canister has sufficient cycles:
 
+{{#useIcp}}
+For local development with icp-cli:
+```bash
+icp network start -d    # local replica auto-seeds cycles — no fabrication needed
+icp deploy              # build + deploy
+```
+
+For mainnet:
+```bash
+icp cycles balance -n ic   # check balance
+icp deploy -e ic           # deploy to mainnet
+```
+{{/useIcp}}
+{{^useIcp}}
 For local development:
 ```bash
 # Get your canister ID
@@ -84,5 +98,6 @@ dfx ledger fabricate-cycles --canister "$CANISTER_ID" --amount 100000000000000
 ```
 
 For production deployment, you'll need to fund your canister with cycles through the NNS or cycles wallet.
+{{/useIcp}}
 
 Each HTTP outcall typically costs around 20-50 million cycles depending on the request/response size.

modules/openapi-generator/src/main/resources/motoko/api.mustache

@@ -29,9 +29,8 @@ module {
         #get;
         #head;
         #post;
-        // TODO: PUT and DELETE are now supported by the management canister in
-        //   non-replicated mode, but dfx doesn't expose these methods yet.
-        //   Uncomment once dfx support lands:
+        // TODO: PUT and DELETE are supported in non-replicated mode but not yet
+        //   exposed via ic:aaaaa-aa imports. Uncomment once the interface is updated:
         // #put;
         // #delete;
     };

modules/openapi-generator/src/main/resources/motoko/icp.yaml.mustache

@@ -0,0 +1,20 @@
+# icp.yaml — generated by OpenAPI Generator (motoko)
+#
+# This file configures icp-cli (https://cli.internetcomputer.org) for a canister
+# that imports the {{artifactId}} generated client library.
+#
+# Usage:
+#   icp network start -d    # start local replica
+#   icp deploy              # build + deploy + sync
+#   icp network stop        # stop when done
+#
+# For mainnet: icp deploy -e ic
+
+canisters:
+  - name: {{#projectName}}{{projectName}}{{/projectName}}{{^projectName}}my_canister{{/projectName}}
+    recipe:
+      type: "@dfinity/motoko@v4.1.0"
+      configuration:
+        main: src/main.mo
+        # Declare the candid interface once generated:
+        # candid: {{#projectName}}{{projectName}}{{/projectName}}{{^projectName}}my_canister{{/projectName}}.did