toga-ai 1.0.551 → 1.0.552

package/knowledge/2.0/apps/worker2/features/creating-worker-actions.md

@@ -226,6 +226,16 @@ metrics**, not the database.
 ## Gotchas
 
 - Class must be **`abstract`** and methods **`public static`** or routing fails.
+- **A JSON-object parameter arrives as `stdClass`, not `array` — type it `object|array` and
+  cast.** The dispatcher decodes `Core.CronJobs.parameters` and casts **only the top level** to
+  an array (`$parameters = (array) $message->parameters;` in `Controller/Index.php`, ~L455/692),
+  then spreads it as named args. So a **nested JSON object** value stays a PHP `stdClass`; a
+  method that declares that parameter as strict `array` throws a `TypeError`
+  (*"must be of type array, stdClass given"*) at dispatch. Declare such a parameter as
+  `object|array` and `(array)`-cast it at the top of the method. (Nested JSON **arrays** decode
+  to PHP arrays fine — only JSON **objects** become `stdClass`.) This bit
+  `_Worker_Infrastructure_CloudWatch::ElasticBeanstalkHealth`'s `environments` region-map in
+  production — see [cross-account-aws-access.md](./cross-account-aws-access.md).
 - Webhook headers are **lowercased** by API Gateway (`X-GitHub-Event` → `x-github-event`).
 - If the action needs a client DB, register it in `initialize()` — it runs before the method.
 - **Worker actions do NOT auto-register `DB_CLIENT`.** The dispatcher registers only
@@ -259,6 +269,12 @@ metrics**, not the database.
   commit-before-SQS transaction pattern that the worker relies on.
 
 ## Change history
+- 2026-08-11 — Added the **nested-JSON-object → `stdClass` dispatch gotcha**: the dispatcher casts
+  only the top level of `CronJobs.parameters` to an array before spreading as named args
+  (`Controller/Index.php` ~L455/692), so a nested JSON object stays `stdClass` and a strict
+  `array` param throws a `TypeError` at dispatch — type such params `object|array` and
+  `(array)`-cast. Surfaced fixing `ElasticBeanstalkHealth`'s `environments` region-map in
+  production. (jcardinal)
 - 2026-08-10 — Documented that **`debug_mode` changes `runTask`'s dispatch** (1 = synchronous
   `_ApiRequest` POST to `_Config::api('worker')`, running the action inside the caller's open
   transaction so any read-back fails; 0 = SQS enqueue), plus the debug-mode side effects

package/knowledge/2.0/apps/worker2/features/cross-account-aws-access.md

@@ -153,8 +153,17 @@ their only home.
 - Config keys are optional by design (in-code defaults), so a missing `[cloud]`
   `workloads_role_*` key silently uses `WorkloadsRuntime` / `worker2-workloads` — set them
   explicitly in prod ini to override.
+- **`$environments` must be typed `object|array`, not `array`.** The cron dispatcher casts only
+  the top level of `CronJobs.parameters` to an array, so this nested JSON **object** arrives as a
+  PHP `stdClass` and a strict `array` type throws a `TypeError` at dispatch. Declare it
+  `object|array` and `(array)`-cast at the top. General rule for any object-valued cron param —
+  see [creating-worker-actions.md](./creating-worker-actions.md).
 
 ## Change history
+- 2026-08-11 — Noted that `ElasticBeanstalkHealth`'s `$environments` must be typed `object|array`
+  (not `array`): the nested JSON object arrives as `stdClass` because the dispatcher casts only
+  the top level of `CronJobs.parameters`, so a strict `array` throws a `TypeError` at dispatch.
+  Cross-referenced the general rule in creating-worker-actions.md. (jcardinal)
 - 2026-08-11 — `ElasticBeanstalkHealth` signature changed to
   `(string $awsAccountId, array $environments, string $oneuptimeUrl)`: `$environments` is a
   region → env-names map, so one monitor can watch EB environments across multiple regions

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toga-ai",
-  "version": "1.0.551",
+  "version": "1.0.552",
   "description": "TOGA Technology Team Claude Knowledge System — shared AI coding harness with skills, knowledge base CLI, and project installer for Claude Code.",
   "keywords": [
     "claude",