toga-ai 1.0.74 → 1.0.75

package/knowledge/1.0/apps/library/features/elite-freshservice-sync.md

@@ -164,3 +164,6 @@ Pass `true` for the dedup GET — errors must not silently empty the dedup array
 
 Each ticket sync is wrapped in `try/catch` — exceptions are sent to Sentry and the run
 continues with the next ticket. A single bad ticket does not abort the whole sync.
+
+## Change history
+- 2026-06-10 — Documented `App_Api_Toga2::syncWithTogadesk` orchestration (bidirectional TOGA 2 ↔ TOGaDesk ticket/note/file sync, watermarks, `ticketNoteFiles` gotcha).

package/knowledge/2.0/apps/_underscore/features/carrier-shipping-labels.md

@@ -105,6 +105,9 @@ attempted.
 - `createNetsuiteItemFulfillment` doesn't set carrier/method on the NS IF — it defaults
   (can show FedEx for a UPS shipment). Open item.
 
+## Change history
+- 2026-06-10 — Documented carrier shipping label mechanics (UPS/FedEx) + the authoritative GIF label-storage decision and NetSuite IF attachment. (mhammontree)
+
 ## Related docs
 
 - [Fulfill & Ship (toga2-supply)](../../toga2-supply/features/fulfill-and-ship.md) —

package/knowledge/2.0/apps/_underscore/features/recursive-item-fulfillments.md

@@ -106,6 +106,9 @@ inheritance. Verified against prod `Client_Compass` chains (≥3 levels deep).
 - **Performance:** every child write re-runs a full upstream walk (read-heavy, but each
   upstream record is written at most once — idempotent). Fine for normal fulfillment sizes.
 
+## Change history
+- 2026-06-08 — Documented the Recursive Item Fulfillments engine (interceptor-driven upstream fulfillment mirroring, bundle scaling, reconcile loop). (jcardinal)
+
 ## Related docs
 - `_underscore` architecture (interceptors, `internalApiRequest`, `_Model` layer).
 - `api2` architecture (V2 metadata engine that fires these interceptors; the

package/knowledge/2.0/apps/_underscore/features/tracking-number-bridges.md

@@ -117,6 +117,9 @@ returnTrackingNumber: {...} }]`, and an IFIU's as `itemFulfillmentItemUnitTracki
   `_underscore` + `api2` + `worker` + `library` together. Run the additions/migrations DB file first;
   run the companion `..._DROPS.sql` (and the Core deletes) only after the bridges + app are confirmed.
 
+## Change history
+- 2026-06-10 — Documented the tracking-number bridge migration: scalar FK columns → `*_TrackingNumbers` bridge tables across ASN/IF/IR, ASN unit table rename, packages-table consolidation. (jcardinal)
+
 ## Related docs
 - Recursive Item Fulfillment feature (the upstream-sync engine this migration reworked).
 - compass-usa: ASN→Item Fulfillment, and the Item Fulfillment tracking TableView.

package/knowledge/2.0/apps/toga2-supply/features/fulfill-and-ship.md

@@ -110,3 +110,6 @@ None in the flow itself — but the NetSuite trait is composed into **client-spe
 model subclasses (e.g. `_Model_Growrk_ItemFulfillment uses _Trait_Netsuite_ItemFulfillment`),
 not the base `_Model_Client_ItemFulfillment`. Tested with GroWrk; UPS support was built
 for Compass and is not yet in prod.
+
+## Change history
+- 2026-06-10 — Documented the Fulfill & Ship flow (SO sync, label purchase, NetSuite IF creation, success gating, reprint). Driven green on beta for UPS/GroWrk; FedEx + prod verification pending. (mhammontree)

package/knowledge/2.0/apps/worker2/features/clickup-project-routing.md

@@ -117,6 +117,9 @@ Read-only actions (no writes), invoked via `curl -X POST https://worker.togahub.
 `DiagnoseOpportunity`, `DiagnoseAmTask` (routing verdicts), `DiscoverIds`, `DiscoverAmIds`
 (print constant declarations), `RegisterOpportunityWebhook` (one-time setup).
 
+## Change history
+- 2026-06-09 — Documented ClickUp secondary multi-list routing (hybrid native-automation + worker design, three space handlers, self-trigger guard). (jcardinal)
+
 ## Related docs
 
 - [Worker (worker2) Architecture](../architecture.md) — always-HTTP-200, commit-before-SQS.

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

@@ -133,3 +133,6 @@ Use realistic placeholder values, not empty strings/nulls.
 - If the action needs a client DB, register it in `initialize()` — it runs before the method.
 - See [architecture.md](../architecture.md) for the always-HTTP-200 rule and the
   commit-before-SQS transaction pattern that the worker relies on.
+
+## Change history
+- 2026-06-08 — Documented the worker-action contract (path→class/method convention, parameter typing, webhook/cron templates); replaces the former `/worker2-action` skill. (jcardinal)

package/knowledge/2.0/apps/worker2/features/elite-freshservice-sync.md

@@ -141,3 +141,7 @@ To test worker2 Elite code locally against production TOGA 2 and Freshservice:
 
 4. **PHP version** — worker2 vendor targets PHP >= 8.5. Local PHP 8.1 requires a
    temporary bypass in `vendor/composer/platform_check.php` — revert before committing.
+
+## Change history
+- 2026-06-11 — Redacted Elite credential constants from the doc; secret scanner added to `validate`.
+- 2026-06-10 — Documented `_Worker_Elite` Freshservice → TOGA 2 webhook sync (conversation/attachment handling, TOGA 2 API gotchas, local dev setup).

package/knowledge/2.0/apps/worker2/features/monitoring-framework.md

@@ -176,6 +176,9 @@ clients' data flows (Compass, Prudential, AIG, …) but live as separate child c
 - Slack / SMS / PagerDuty (email-only today) · `MonitorRuns` history table ·
   HTML email + dashboard deep-links · anti-flap on the alarm side.
 
+## Change history
+- 2026-06-10 — Documented the v1.0 monitoring framework (orchestrator, `Core.Monitors` table, recovery-side anti-flap state machine, child contract). First child monitor + staging/prod migration still pending. (mhammontree)
+
 ## Related docs
 
 - [worker2 architecture](../architecture.md) — cron/WorkerJobs pipeline the orchestrator rides on

package/knowledge/CONVENTIONS.md

@@ -113,6 +113,22 @@ standalone doc. Only a recurring/systemic failure class warrants its own record,
 _Elevated_ docs (architecture, standard) are senior-owned; `capture` flags any change
 to them with ⚠ so the developer knows what they're approving.
 
+## Required sections
+
+Every **feature**, **client-feature**, and **workflow** doc must include a
+**`## Change history`** section: newest-first, dated one-line entries recording notable
+behavior changes only (not a git log). Format:
+
+```markdown
+## Change history
+- YYYY-MM-DD — <what changed and why> (<author>)
+```
+
+`node knowledge.js validate` enforces this — a missing `## Change history` section in any of
+those three doc types fails the build (and therefore blocks `capture`'s publish). `profile`,
+`architecture`, and `standard` docs are exempt. Keep the list terse and cap it at ~10 entries,
+folding older ones away.
+
 ## INDEX.md files
 
 Never hand-edited. `node knowledge.js index` regenerates the master `INDEX.md`, each

package/knowledge/clients/nycdoe/features/servicenow-integration.md

@@ -186,6 +186,9 @@ Vendor SFTP ───(legacy_import_asn.php, ser+non-ser)─┘      [UNIQUE ded
 5. With no staging environment, verify with a standalone arithmetic simulation plus a read
    of the consumer query; `php -l` every touched file.
 
+## Change history
+- 2026-06-10 — Documented the NYC DOE ServiceNow/ASN integration (ticket mirror, dual ASN ingestion, NetSuite freeze pipeline, EDI surface, dedupeKey gotchas). (mhammontree)
+
 ## Related docs
 
 - [NYC DOE client profile](../profile.md)

package/knowledge.js

@@ -612,6 +612,14 @@ function cmdValidate() {
             if (!d.data[f]) { fail(`${d.rel}: missing frontmatter "${f}"`); ok = false; }
         }
         if (d.data.type && !DOC_TYPES.includes(d.data.type)) { fail(`${d.rel}: invalid type "${d.data.type}"`); ok = false; }
+        // feature/client-feature/workflow docs must carry a "## Change history" section so the
+        // doc records its own notable behavior changes over time (newest-first dated one-liners).
+        if (['feature', 'client-feature', 'workflow'].includes(d.data.type)) {
+            if (!/^##\s+Change history\s*$/m.test(fs.readFileSync(d.file, 'utf8'))) {
+                fail(`${d.rel}: missing required "## Change history" section`);
+                ok = false;
+            }
+        }
         const isClientDoc = d.rel.startsWith('clients/');
         if (isClientDoc) {
             if (!d.data.client || d.data.client === 'shared') { fail(`${d.rel}: client doc must set a real "client"`); ok = false; }

package/package.json

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