feat(plant): support custom dedication message on plantings

Add an optional message argument to /green:plant (and the treenation.sh
plant command). The message is sent to the Tree-Nation plant endpoint and
appears on the public certificate; it is also stored in usage.json.

When no message is given, a localized default is used:
"Offsetting {co2} kg CO2 - Claude Code AI usage - {date}" (fr/en).

The request body is now built with jq -n so messages with quotes, accents
or spaces are escaped safely. Bump to 1.1.0; docs and README updated.

Author: JeremieSamson

.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "green-code",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Track your AI carbon footprint and plant trees to compensate via Tree-Nation",
   "author": {
     "name": "Jeremie Samson"

README.md

@@ -28,6 +28,7 @@ On first launch, the plugin asks for your Tree-Nation API token and preferences.
 | `/green:status` | View your carbon footprint and tree balance |
 | `/green:plant` | Plant trees to offset accumulated CO2 |
 | `/green:plant 3` | Plant a specific number of trees |
+| `/green:plant 3 "message"` | Plant trees with a custom dedication message (shown on the certificate) |
 | `/green:config` | View current configuration |
 | `/green:config mode auto` | Switch to auto-plant mode |
 
@@ -63,7 +64,7 @@ Per-model base cost in Wh per **output** token. Other token types are derived as
 
 ### Tree-Nation
 
-Trees are planted via the [Tree-Nation REST API](https://kb.tree-nation.com/knowledge/api-availability). You need a Tree-Nation account and API token.
+Trees are planted via the [Tree-Nation REST API](https://kb.tree-nation.com/knowledge/api-availability). You need a Tree-Nation account and API token. Each planting carries a dedication message shown on the public certificate: pass your own (`/green:plant 3 "message"`) or let the plugin fill in a default (`Offsetting {co2} kg CO2 - Claude Code AI usage - {date}`).
 
 ## Sources
 

scripts/i18n.sh

@@ -51,7 +51,9 @@ if [ "$GREEN_LANG" = "fr" ]; then
   T_TN_NO_FOREST="Aucun forest ID Tree-Nation configuré. Lance /green:config"
   T_TN_TREES_PLANTED="arbres plantés"
   T_TN_OFFSET="kg CO2 compensés"
-  T_TN_USAGE="Usage : treenation.sh {plant [N]|forest|species [project_id]}"
+  # %s = CO2 compensé (kg), %s = date
+  T_TN_DEFAULT_MSG="Compensation %s kg CO2 - usage IA Claude Code - %s"
+  T_TN_USAGE="Usage : treenation.sh {plant [N] [message]|forest|species [project_id]}"
 else
   # session-start.sh
   T_EMITTED="emitted"
@@ -88,5 +90,7 @@ else
   T_TN_NO_FOREST="No Tree-Nation forest ID configured. Run /green:config"
   T_TN_TREES_PLANTED="trees planted"
   T_TN_OFFSET="kg CO2 offset"
-  T_TN_USAGE="Usage: treenation.sh {plant [N]|forest|species [project_id]}"
+  # %s = CO2 offset (kg), %s = date
+  T_TN_DEFAULT_MSG="Offsetting %s kg CO2 - Claude Code AI usage - %s"
+  T_TN_USAGE="Usage: treenation.sh {plant [N] [message]|forest|species [project_id]}"
 fi

scripts/treenation.sh

@@ -21,17 +21,31 @@ BASE_URL="https://tree-nation.com/api"
 
 cmd_plant() {
   local count="${1:-1}"
+  local message="${2:-}"
   local threshold=$(jq '.threshold_co2_kg // 10' "$CONFIG_FILE")
   local co2_offset=$(echo "scale=2; $count * $threshold" | bc)
 
+  # Default dedication message (shown on the public Tree-Nation certificate)
+  # when the caller did not provide one.
+  if [ -z "$message" ]; then
+    message="$(printf "$T_TN_DEFAULT_MSG" "$co2_offset" "$(date -u +%Y-%m-%d)")"
+  fi
+
+  # Build the JSON body with jq so the message is safely escaped (quotes,
+  # accents, spaces). The Tree-Nation plant endpoint accepts an optional
+  # "message" field that is attached to each planting.
+  local payload
+  payload=$(jq -n \
+    --argjson forest_id "$FOREST_ID" \
+    --argjson quantity "$count" \
+    --arg message "$message" \
+    '{forest_id: $forest_id, quantity: $quantity, message: $message}')
+
   response=$(curl -s -w "\n%{http_code}" \
     -X POST "${BASE_URL}/plant" \
     -H "Authorization: Bearer ${API_KEY}" \
     -H "Content-Type: application/json" \
-    -d "{
-      \"forest_id\": ${FOREST_ID},
-      \"quantity\": ${count}
-    }")
+    -d "$payload")
 
   http_code=$(echo "$response" | tail -1)
   body=$(echo "$response" | sed '$d')
@@ -47,12 +61,14 @@ cmd_plant() {
       --arg date "$NOW" \
       --argjson offset "$co2_offset" \
       --arg certs "$cert_urls" \
+      --arg message "$message" \
       '
       .trees.total += $count |
       .trees.planted += [{
         "date": $date,
         "count": $count,
         "co2_offset_kg": $offset,
+        "message": $message,
         "certificates": ($certs | split("\n") | map(select(. != "")))
       }]
       ' "$USAGE_FILE" > "${USAGE_FILE}.tmp" && mv "${USAGE_FILE}.tmp" "$USAGE_FILE"
@@ -85,7 +101,7 @@ cmd_species() {
 }
 
 case "${1:-help}" in
-  plant)   cmd_plant "${2:-1}" ;;
+  plant)   cmd_plant "${2:-1}" "${3:-}" ;;
   forest)  cmd_forest ;;
   species) cmd_species "${2:-}" ;;
   *)

skills/plant/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: plant
-description: Plant trees via Tree-Nation to offset your AI carbon footprint. Use when the user wants to compensate their CO2 emissions. Accepts optional tree count argument.
+description: Plant trees via Tree-Nation to offset your AI carbon footprint. Use when the user wants to compensate their CO2 emissions. Accepts optional tree count and message arguments.
 ---
 
 # green-code: Plant Trees
@@ -21,9 +21,14 @@ Plant trees via Tree-Nation to compensate the user's AI carbon footprint.
 4. Confirm with the user before planting:
    "You're about to plant {N} tree(s) via Tree-Nation to offset {co2} kg of CO2. Proceed?"
 
-5. If confirmed, run the planting script:
+4b. Determine the dedication message (attached to each planting and shown on the public Tree-Nation certificate):
+   - If the user provided a message (e.g., `/green:plant 3 "merci pour la forêt"`), use it verbatim.
+   - If no message is provided, leave it empty: the script fills in a default
+     (`Compensation {co2} kg CO2 - usage IA Claude Code - {date}` / `Offsetting {co2} kg CO2 - Claude Code AI usage - {date}`).
+
+5. If confirmed, run the planting script (the message is optional; wrap it in quotes):
    ```bash
-   "${CLAUDE_PLUGIN_ROOT}/scripts/treenation.sh" plant {N}
+   "${CLAUDE_PLUGIN_ROOT}/scripts/treenation.sh" plant {N} "{message}"
    ```
 
 6. Parse the output:
@@ -45,5 +50,6 @@ Plant trees via Tree-Nation to compensate the user's AI carbon footprint.
 ## Important
 
 - Always confirm before planting (it costs real money via Tree-Nation credits)
-- The script handles logging the planting in usage.json automatically
+- The script handles logging the planting in usage.json automatically (including the `message`)
+- The message appears on the public certificate, so keep it clean; the default is safe when in doubt
 - If the API call fails, do NOT modify usage.json