toga-ai 1.0.1121 → 1.0.1122

package/knowledge/1.0/apps/worker/architecture.md

@@ -6,7 +6,7 @@ project: Worker
 client: shared
 type: architecture
 status: active
-updated: 2026-10-19
+updated: 2026-10-23
 owners: [jcardinal, sking, bala]
 files:
   - worker/index.php
@@ -23,10 +23,13 @@ related:
   - ./features/oneuptime-worker-uptime-monitoring.md
   - ../../2.0/apps/worker2/features/worker-fleet-role-assignment-monitor.md
   - ../togadesk/features/email-to-ticket-intake.md
+  - ../worker1.5/architecture.md
 ---
 
 The 1.0 `App_` background-job tier (~550 CRON scripts); open for how crons are scheduled, how the 7-worker role election works, and its silent-death failure modes.
 
+> **Moved:** the worker 1.0 jobs now run on one worker1.5 server on PHP 8.5 (TRUE-83078, commit 58dab19). For how crons run now, see [../worker1.5/architecture.md](../worker1.5/architecture.md).
+
 ## Summary
 
 `worker` is the legacy (**1.0** `App_` framework) **background-job tier**: ~550 standalone PHP CRON scripts under `crons/` for everything web apps must not do inline — notifications/reports, DB backups, third-party syncs (NetSuite, EDI partners, NYC DOE, ManageEngine, Syncro…), cloud-infrastructure maintenance, and TOGa / TOGaDesk / TOGa-2 client integrations.

package/knowledge/1.0/apps/worker1.5/INDEX.md

@@ -0,0 +1,5 @@
+# worker1.5 (Worker 1.5) — 1.0 knowledge
+
+| Doc | Summary |
+|-----|---------|
+| [Worker 1.5 (1.0 Framework) Architecture](architecture.md) | The single-server 1.0 cron tier that replaced worker's 7-role fleet; open for how the crontab is built from schedules/*.json, the overlap check, and what the cr |

package/knowledge/1.0/apps/worker1.5/architecture.md

@@ -0,0 +1,49 @@
+---
+title: Worker 1.5 (1.0 Framework) Architecture
+framework: "1.0"
+repo: worker1.5
+project: Worker 1.5
+client: shared
+type: architecture
+status: active
+updated: 2026-10-23
+owners: [bala]
+files:
+  - worker1.5/ebs/cron.worker.php
+  - worker1.5/.platform/hooks/postdeploy/020_cron.sh
+  - worker1.5/schedules/
+  - worker1.5/crons/
+  - worker1.5/mvc/get.php
+related:
+  - ../worker/architecture.md
+  - ../library/architecture.md
+  - ../../standards/backend-php.md
+---
+
+The single-server 1.0 cron tier that replaced worker's 7-role fleet; open for how the crontab is built from schedules/*.json, the overlap check, and what the cron list page is (display only).
+
+## Summary
+
+`worker1.5` is the 1.0 `App_` background-job tier on **one Elastic Beanstalk server, PHP 8.5, AL2023** (TRUE-83078). It is a copy of the legacy `worker` repo with the same folder layout (`crons/<area>/...`, `crons/toga2/<client>/`). The 7 role schedules were merged into one file. Role election, heartbeat, stale-worker termination and per-role Elastic IPs are gone: one server runs every active job. Builds on `library`.
+
+**Critical rules:** the schedule `schedules/cron.<ENVIRONMENT>.json` is the source of truth. Production is `cron.worker.json`. A script not in it never runs. A bad `schedule` (not 5 fields) or a `%` in a command aborts the whole crontab install on deploy. Keep cron's default `/bin/sh`: `App_Framework::isProcessRunning()` only ignores `/bin/sh` parent rows, so another shell breaks the already-running check (TRUE-83121). Any PHP warning exits the request or cron (see the backend-php standard, *Any PHP warning terminates the request*).
+
+## How a job becomes a cron
+
+1. On deploy, `.platform/hooks/postdeploy/020_cron.sh` links `/var/www/html` to `/var/app/current`, reads `ENVIRONMENT` from EB config, and runs `php ebs/cron.worker.php`.
+2. `cron.worker.php` reads `schedules/cron.<ENVIRONMENT>.json` and writes root's crontab:
+   - `cron` → `php /var/www/html/crons/<cron>`; `url` → `wget -q -O /dev/null http://localhost<url>`; `command` → used as is.
+   - `active: 0` rows are skipped.
+   - Every job appends to the one log file `/var/log/worker-cron.log` (logrotate `/etc/logrotate.d/worker-cron`).
+   - It refuses to install if the file is missing, the JSON is bad, a row has no cron/url/command, or there are 0 active jobs.
+3. Timezone for the installer is `America/Chicago`.
+
+Schedule files: `cron.alpha/beta/demo/hotfix/sprint/stage/ui/worker.json`. Only `worker` (production) carries the real list. The others hold 1 to 2 rows.
+
+## Cron list page (`mvc/get.php`)
+
+`/` renders the schedule files as a list plus a sidebar. **Display only.** Crons never go through it, so a page error does not stop crons. It reads and sorts the schedule files once into `$scheduleSections`. `cron.worker.json` (empty category) shows as section `misc`.
+
+## Gotchas
+- **Do not read files that are not in this repo on a 1.0 page.** The page read `schedules/cron.worker.catalog.json` (old worker only). The warning became `exit` and the page died about 474 times an hour (9,387 total), probably from a health check on `/`. Fixed in TRUE-83107 (c903b20).
+- **`App_Misc::getFileList` uses `readdir` and does not sort.** Any loop that keeps state per file must set that state on every file. The old loop set `$jsonContents` only for a non-empty category, so `cron.worker.json` reused the previous file's rows, or warned (and exited) if it came first.

package/knowledge/INDEX.md

@@ -7,7 +7,7 @@ _Auto-generated by `knowledge.js index`. Do not hand-edit._
 - **library** (Library) _(framework core)_ — 41 doc(s) → [1.0/apps/library/INDEX.md](1.0/apps/library/INDEX.md)
 - **worker** (Worker) — 43 doc(s) → [1.0/apps/worker/INDEX.md](1.0/apps/worker/INDEX.md)
 - **dbchanges** (Database Changes) _(framework core)_ — 1 doc(s) → [1.0/apps/dbchanges/INDEX.md](1.0/apps/dbchanges/INDEX.md)
-- **worker1.5** (Worker 1.5) — 0 doc(s) → [1.0/apps/worker1.5/INDEX.md](1.0/apps/worker1.5/INDEX.md)
+- **worker1.5** (Worker 1.5) — 1 doc(s) → [1.0/apps/worker1.5/INDEX.md](1.0/apps/worker1.5/INDEX.md)
 - **togadesk** (TOGa Desk) — 18 doc(s) → [1.0/apps/togadesk/INDEX.md](1.0/apps/togadesk/INDEX.md)
 - **togaview** (TOGa View) — 9 doc(s) → [1.0/apps/togaview/INDEX.md](1.0/apps/togaview/INDEX.md)
 - **webhook** (Webhook) — 1 doc(s) → [1.0/apps/webhook/INDEX.md](1.0/apps/webhook/INDEX.md)

package/package.json

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