toga-ai 1.0.276 → 1.0.278

package/knowledge/INDEX.md

@@ -6,6 +6,7 @@ _Auto-generated by `knowledge.js index`. Do not hand-edit._
 
 - **library** (Library) _(framework core)_ — 11 doc(s) → [1.0/apps/library/INDEX.md](1.0/apps/library/INDEX.md)
 - **worker** (Worker) — 13 doc(s) → [1.0/apps/worker/INDEX.md](1.0/apps/worker/INDEX.md)
+- **worker1.5** (Worker 1.5) — 0 doc(s) → [1.0/apps/worker1.5/INDEX.md](1.0/apps/worker1.5/INDEX.md)
 - **togadesk** (TOGa Desk) — 8 doc(s) → [1.0/apps/togadesk/INDEX.md](1.0/apps/togadesk/INDEX.md)
 - **togaview** (TOGa View) — 6 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/knowledge/clients/compass-usa/INDEX.md

@@ -3,6 +3,7 @@
 | Doc | Framework | Summary | Files |
 |-----|-----------|---------|-------|
 | [Compass ASN → ItemFulfillment Auto-Creation](features/asn-to-item-fulfillment.md) | 2.0 | For Compass USA, posting an AdvanceShippingNotice (ASN) auto-creates the ItemFulfillment (IF) on the upstream SalesOrder. | _underscore/Model/Compass/AdvanceShippingNotice.php, _underscore/Model/Compass/PurchaseOrder.php, api2/Component/Api/Cxml/Cxml.php, dbchanges2/Client_Compass/2026-06-11 - AsnItemTrackingNumberAcl.sql, dbchanges2/Client_Compass/2026-06-15b - BackfillSA132781ItemFulfillmentTracking.sql, dbchanges2/Client_Compass/2026-06-16 - CleanupSA132763CrossLineTracking.sql, dbchanges2/Client_Compass/2026-06-16b - CleanupSA132743CrossLineTracking.sql, dbchanges2/Client_Compass/2026-06-16c - BackfillSA132763C40QYUCTracking.sql, dbchanges2/Client_Compass/2026-06-18a - CleanupSA132898DuplicateTracking.sql, dbchanges2/Client_Compass/2026-06-18b - CleanupSA132881DuplicateTracking.sql, dbchanges2/Client_Compass/2026-07-02a - FixSA133377TrackingSerialAndDuplicateIF.sql |
+| [Cost Centers — Unit Locations, numeric-only policy](features/cost-centers.md) | 2.0 | A Compass "cost center" — the value a user picks in commerce and that lands on an order — is **not** a `CostCenters` row. | toga2-commerce/src/pages/Cart/api/CartApi.ts, worker1.5/crons/toga2/compass/import_locations.php, _underscore/Model/Compass/SalesOrder.php, api2/Component/Api/V2/V2.php, dbchanges2/Client_Compass/2026-07-06 - RemoveNonNumericCostCenters.sql |
 | [Compass: Item-Fulfillment TableViews (for-sales-order-items & for-sales-orders, tracking via bridge)](features/item-fulfillment-tracking-tableview.md) | 2.0 | Two sibling Compass TableViews in `Client_Compass` display fulfilled items in toga2-supply, both driven by `TableViews` / `TableViewJoins` / `TableViewFields` c | dbchanges2/Client_Compass/2026-06-10 - ItemFulfillmentsForSalesOrderItemsTableView.sql, dbchanges2/Client_Compass/2026-06-11 - ItemFulfillmentsForSalesOrdersTableView.sql, dbchanges2/Client_Compass/2026-06-15a - FixItemFulfillmentTrackingNumberJoins.sql |
 | [Compass MITS PO → SO Item Linking](features/mits-po-to-so-item-linking.md) | 2.0 | MITS sends Compass inbound Purchase Orders (`POST /v2/purchase-orders`) against a Sales Order (`mitsSalesOrder`). | _underscore/Model/Compass/PurchaseOrder.php, worker/crons/toga2/compass/workflow/3a_import_office_depot_purchase_orders.php |
 | [Compass MITS PO Transmission to Vendors](features/mits-po-transmission-to-vendors.md) | 2.0 | The 1.0 worker cron `2_transmit_mits_purchase_orders_to_vendors.php` transmits Compass PurchaseOrders to their vendors (Office Depot, Strategic Systems, Compass | worker/crons/toga2/compass/workflow/2_transmit_mits_purchase_orders_to_vendors.php, library/app/client/compass.php |

package/knowledge/clients/compass-usa/features/cost-centers.md

@@ -0,0 +1,115 @@
+---
+title: Cost Centers — Unit Locations, numeric-only policy
+framework: "2.0"
+project: _Underscore
+client: compass-usa
+type: client-feature
+status: active
+updated: 2026-07-06
+owners: [bala]
+files:
+  - toga2-commerce/src/pages/Cart/api/CartApi.ts
+  - worker1.5/crons/toga2/compass/import_locations.php
+  - _underscore/Model/Compass/SalesOrder.php
+  - api2/Component/Api/V2/V2.php
+  - dbchanges2/Client_Compass/2026-07-06 - RemoveNonNumericCostCenters.sql
+related:
+  - ../profile.md
+  - ../../../2.0/apps/toga2-commerce/features/cart-page-config-architecture.md
+---
+
+## Summary
+A Compass "cost center" — the value a user picks in commerce and that lands on an order — is
+**not** a `CostCenters` row. In `Client_Compass` it is a **Unit-level Location**
+(`locationTypeId = 1`) identified by its **`c_erpSystemEntityId`** custom field. The
+`CostCenters` table (and the `Users_CostCenters` / `Locations_CostCenters` bridges,
+`SalesOrders.costCenterId`, `Users.defaultCostCenterId`) are **empty / vestigial** for Compass
+and unused. As of **2026-07-06**, Compass policy is **numeric-only cost centers**: users may only
+select cost centers whose `c_erpSystemEntityId` is all digits, all existing non-numeric ones are
+soft-deactivated, and the import will never re-create or re-activate a non-numeric one.
+
+This is US Compass only (`Client_Compass`). Compass Canada is explicitly out of scope.
+
+## How it works
+
+### What a cost center actually is
+- A cost center = a **Unit Location** in `Client_Compass.Locations` (`locationTypeId = 1`),
+  keyed by the custom field **`c_erpSystemEntityId`**.
+- `c_erpEntityId` is a **different** field on the Unit row (the unit id) — do not confuse the
+  two. At checkout the chosen cost-center value is written to **`SalesOrders.c_erpEntityId`** as a
+  **plain string, not a foreign key**. `_underscore/Model/Compass/SalesOrder.php` exposes a
+  `_costCenter` computed field.
+- The `CostCenters` table is empty for Compass; nothing reads
+  `Users_CostCenters` / `Locations_CostCenters` / `SalesOrders.costCenterId` /
+  `Users.defaultCostCenterId`.
+
+### The commerce dropdown
+- Built by **`fetchCostCenter()`** in
+  `toga2-commerce/src/pages/Cart/api/CartApi.ts`, which calls
+  `GET /locations` filtered on `c_erpSystemEntityId LIKE %search% AND isActive = 1`, and displays
+  each as `"{c_erpSystemEntityId} - {name}"`.
+- It funnels **both** the cart checkout and the New-User form, so a single filter in
+  `fetchCostCenter` covers both entry points.
+- **api2 does no cost-center validation** — the FE is the only selection gate.
+
+### Where the values come from (import)
+- `worker1.5/crons/toga2/compass/import_locations.php` reads an SFTP file and sets
+  `c_erpSystemEntityId` on Unit rows from **column 16**.
+- Repeated imports have massively **duplicated** cost-center rows (~730× per value).
+
+### Numeric-only enforcement (2026-07-06) — three layers
+1. **Front-end selection block** — in `fetchCostCenter`, on the **search path**
+   (`useSearchOptions === true`), returned locations are filtered to numeric-only cost centers
+   with `/^[0-9]+$/` on `c_erpSystemEntityId.trim()`. The non-search / display path is left
+   untouched (so an already-saved value still renders). Done client-side because api2 rejects a
+   server-side numeric filter (see gotcha) and api2 was out of scope.
+2. **Data cleanup (one-time, reversible)** —
+   `dbchanges2/Client_Compass/2026-07-06 - RemoveNonNumericCostCenters.sql` runs
+   `UPDATE Locations SET isActive = 0` for every active row whose `c_erpSystemEntityId` is
+   non-empty and does **not** match `^[0-9]+$`. **Soft delete (isActive=0), not a hard delete.**
+   ~401,719 active rows across 1,185 distinct non-numeric codes. They then drop out of the
+   commerce lookup automatically via its existing `isActive = 1` filter.
+3. **Import durability guard** — in `import_locations.php`, in **both** Unit branches
+   (new-create and existing-update), after `$isActiveValue` is computed it is forced to `0` when
+   the cost center is non-empty and not `ctype_digit`, so future imports never re-activate or
+   create active non-numeric cost centers.
+
+## Gotchas
+- **api2 cannot do a server-side numeric filter.** The V2 query-string where-parser
+  (`api2/Component/Api/V2/V2.php` → `parseOptionsWhere`) **whitelists operators and rejects
+  `regexp` with a 500**. Any numeric/regex filtering must happen client-side (or via a new
+  operator in api2, which was out of scope here).
+- **Two fields, easy to swap.** `c_erpSystemEntityId` is the cost center (what users pick);
+  `c_erpEntityId` is the unit id and the value that orders record on
+  `SalesOrders.c_erpEntityId`.
+- **Second, possibly-live copy of the import cron not yet guarded.** A second copy exists at
+  `worker/crons/toga2/compass/DOA_Scripts/import_locations.php` (appears disabled / "DOA"). It
+  did **not** receive the numeric guard — **confirm whether it is live** before trusting the
+  guard to be complete.
+- Non-numeric cost centers include both number+alphabet combos (e.g. `10007A`, `224GT`) and
+  letters-only codes (e.g. `EAGLE`, `TAMU`). All are retired in favor of numeric-only.
+
+## Safety verification (before deactivation, prod Client_Compass)
+Deactivation was proven safe against prod data:
+- **0** users (active or inactive, via `Users.locationId`), **0** sales orders / SO items /
+  purchase orders / item fulfillments / item receipts / transfer orders / inventory adjustments /
+  tickets / contacts / child locations reference these non-numeric Unit locations.
+- Only **1,180** `Locations_Addresses` links point at them (harmless, left intact).
+- Only **2** sales orders ever used a non-numeric cost-center value (stored as string on
+  `SalesOrders.c_erpEntityId`, unaffected by deactivating the Location).
+- **0** active users have a non-numeric `c_erpEntityId`, so no cost-center display goes blank.
+- Proven end-to-end in dev-sandbox: after the migration, active non-numeric rows = **0** (all
+  1,185 codes incl. the 725 number+alphabet combos) while pure-numeric stayed untouched at
+  **440,005** active rows.
+
+## Scope constraints (from the developer)
+- Do **not** change anything in `api2`.
+- Do **not** hard-delete — use `isActive = 0` (reversible).
+- **US Compass only** (`Client_Compass`); Compass Canada is out of scope.
+
+## Change history
+- 2026-07-06 — Established numeric-only cost-center policy across three layers: FE `fetchCostCenter`
+  search-path filter (`/^[0-9]+$/`), one-time `RemoveNonNumericCostCenters.sql` soft-deactivation
+  (~401,719 rows / 1,185 codes), and an `import_locations.php` guard forcing `isActive=0` on
+  non-`ctype_digit` cost centers in both Unit branches. Documented that a Compass cost center is a
+  Unit Location keyed by `c_erpSystemEntityId` (not the vestigial `CostCenters` table). (bala)

package/knowledge/clients/compass-usa/profile.md

@@ -8,16 +8,18 @@ apps:
   - toga25-supply
   - toga2-commerce
   - worker
+  - worker1.5
   - dbchanges2
 project: _Underscore
 client: compass-usa
 type: profile
 status: active
-updated: 2026-06-30
+updated: 2026-07-06
 owners: [jcardinal, bala, tcox]
 files: []
 related:
   - features/asn-to-item-fulfillment.md
+  - features/cost-centers.md
   - ../../2.0/apps/toga2-commerce/features/expedited-shipping-gating.md
   - ../../2.0/apps/_underscore/features/item-fulfillment-stage-lifecycle-and-order-status.md
 ---
@@ -34,7 +36,9 @@ separate, related client (see its own profile).
 - **2.0:** `_underscore` backend, prod schema `Client_Compass` (worker link `db_compass`).
   Client-specific model overrides live under `_underscore/Model/Compass/`.
 - **1.0:** worker crons under `worker/crons/toga2/compass/` handle email-based imports and
-  notifications.
+  notifications. A separate **`worker1.5`** repo (also App_/1.0-style) runs the SFTP location
+  import (`worker1.5/crons/toga2/compass/import_locations.php`) that seeds Unit Locations /
+  cost centers.
 - Storefront: compass.togacommerce.com / compass.togahub.com. The storefront app repo is
   **`toga2-commerce`** (2.0, consumes api2).
 
@@ -56,6 +60,9 @@ separate, related client (see its own profile).
 ## Key features (this client)
 - [Compass ASN → ItemFulfillment Auto-Creation](features/asn-to-item-fulfillment.md) — the
   `_Model_Compass_AdvanceShippingNotice::postPost` handler.
+- [Cost Centers (Unit Locations, numeric-only)](features/cost-centers.md) — what a Compass
+  "cost center" actually is (a Unit Location keyed by `c_erpSystemEntityId`), and the
+  numeric-only selection/import/data policy (2026-07-06).
 
 ## Notes
 - **Order status is shipped-only (2026-06-30).** Compass imports all IF stages

package/knowledge/registry.json

@@ -41,6 +41,15 @@
     "role": "app",
     "dependsOn": []
   },
+  {
+    "repo": "worker1.5",
+    "project": "Worker 1.5",
+    "framework": "1.0",
+    "role": "app",
+    "dependsOn": [
+      "library"
+    ]
+  },
   {
     "repo": "toga2-supply",
     "project": "TOGa Supply",

package/knowledge/sessions/2026-07-07-talos-transcripts-jcardinal.md

@@ -0,0 +1,80 @@
+---
+type: session
+slug: talos-transcripts
+title: Talos transcript ingestion — cross-account creds, KB registry, admin UI edits
+author: jcardinal
+repos: [worker2, tools, dbchanges2]
+framework: "both"
+client: shared
+status: active
+created: 2026-07-07
+updated: 2026-07-07
+---
+
+# Session: talos-transcripts
+**Date:** 2026-07-07
+**Project/Repo:** worker2 + tools + dbchanges2 (both 1.0 and 2.0)
+**Task:** Harden and extend the Talos meeting-transcript → Bedrock knowledge-base ingestion pipeline (worker2) and its Tools (1.0) "Talos Knowledge Base" admin UI — fix cross-account S3 credentials, populate the KB registry from Bedrock, add move/edit doc features, refine AI classification, and fix a MySQL timeout on long transcripts.
+
+---
+
+## What WORKED
+<!-- Include specific file paths and evidence -->
+- **Cross-account S3 credential split (worker2).** `toga-private` (raw transcripts, us-west-2) and `togaiq` (approved/archive KB bucket, us-east-1) are in DIFFERENT AWS accounts; no single key writes both. Fixed by reading per-bucket credentials: `s3Client()`/`getS3Client()` from `[teams]` (`s3_access_key_id`/`s3_secret_access_key`), `getTalosS3Client()`/`getBedrockClient()` from `[talos]`. Added those keys to `worker2/Config/production.ini`. Reprocessor then succeeded uploading to togaiq. Files: `worker2/Worker/Team/Transcripts.php`, `worker2/Config/production.ini`.
+- **Archive step get+put instead of cross-account CopyObject.** `CopyObject` cannot span accounts — was failing `AccessDenied`. Process() step 8 now reads with `rawS3` and writes with `talosS3`. Confirmed working in reprocessor output.
+- **Tools app togaiq write access.** `App_Talos_S3::client()` now prefers a `[talos]` config section (the togaiq-account key), falling back to `[aws]`, then SDK default chain. Added `[talos]` to `tools/config.production.ini` (and `config.alpha.ini`). Move/delete/edit on the KB browser now work. Files: `tools/_/app/talos/s3.php`, `tools/config.production.ini`, `tools/config.alpha.ini`.
+- **Worker-job enqueue from Tools.** Added `[worker]` (worker2 prod SQS queue url/region) and `[aws]` (main-account key for SQS SendMessage) to `tools/config.production.ini`; `[database_toga2core]` was already present. `App_Worker::enqueue` now queues `SyncKb` re-sync jobs successfully.
+- **KB registry sync from Bedrock.** New action `_Worker_Team_Transcripts::SyncKnowledgeBases(bool $apply=true)` + helper `listAllKnowledgeBases()` list all `development-team-*` Bedrock KBs and upsert into `Team.KnowledgeBases`. New CLI `worker2/bin/sync-knowledge-bases.php --dry-run`. User ran it; table went from 2 rows (general, office-depot) to the full KB set including `elite`. Confirmed via `SELECT slug FROM KnowledgeBases`.
+- **Move-document feature (Tools).** `App_Talos_S3::moveApprovedDocument` (get+put copy of .txt + sidecar, rewrites sidecar `metadataAttributes.client.value.stringValue`, deletes originals) + `copyWithinBucket`/`putObjectBody` helpers; `move` action in post.php; move icon → small centered dialog in get.php. Working end-to-end.
+- **Edit title + contents (Tools).** Pencil icon (text docs only) → edit mode: title text box, Find & Replace tool (ported from `test/team/talos/kb_processor.php`), contents textarea, Save/Cancel top-right. `update` action + `App_Talos_S3::sanitizeTitle`/`updateApprovedDocument` (rewrites body; renames to `YYYY-MM-DD - {title}.txt` preserving date; moves+updates sidecar filename attr; enqueues SyncKb). Backdrop-click disabled while editing. All four files lint clean.
+- **Classification: meeting title now passed to AI.** Process() parses date+title up front and passes `meetingTitle` into `callAICleaningAPI`, surfaced as a `MEETING TITLE:` block; instruction prioritizes it. Fixed short Elite transcripts that were falling to `general`.
+- **Sequential dual re-sync on move.** `SyncKb` now accepts comma-separated slugs and syncs each sequentially with `KB_SYNC_DELAY_SECONDS` spacing; move enqueues one `SyncKb("source,dest")` job. Fixes only-destination-synced race (Bedrock allows one in-flight ingestion per KB).
+- **Last-modified timezone.** `App_Talos_S3::listApproved` converts S3 UTC `LastModified` to `America/Chicago` before formatting `n/j/y g:i A`; sort key stays UTC ISO-8601.
+- **/capture run** published 2 UPDATE docs to `_main` (talos-transcript-ingestion.md, talos-kb-documents-admin.md). Validate OK.
+
+## What did NOT work — DO NOT RETRY THESE
+<!-- Exact failure reasons — do not vague-ify -->
+- **Setting env vars `AWS_ACCESS_KEY_ID=... php bin/reprocess-transcripts.php`** to switch credentials: NO EFFECT. The code passes credentials explicitly to the S3Client constructor from `_Config`, which overrides the SDK env-var/default chain. Error stayed `User: arn:aws:iam::502614707982:user/jcardinal ... not authorized`.
+- **Granting the `jcardinal` IAM user S3 perms + using the toga-private-account key for togaiq:** still `AccessDenied` on togaiq. That key belongs to the toga-private account; togaiq is a SEPARATE AWS account. IAM user policy alone can't grant cross-account; and this key simply is not the togaiq key.
+- **Switching move from CopyObject to get+put did NOT fix the tools AccessDenied by itself** — because the tools `[aws]` key was STILL the toga-private-account key, which can read togaiq cross-account but not write. Root cause was the credential, not the operation. (get+put is still retained and correct.)
+- **Two parallel `SyncKb` jobs (one per KB) on move:** only the destination KB actually synced. Bedrock allows one in-flight ingestion per KB and the independent workers raced with no ordering/spacing. Replaced with a single sequential job.
+- **Relying on post-AI `setStatus` writes for long transcripts:** fails with MySQL error 2006 "MySQL server has gone away" — the up-to-600s AI HTTP call leaves the DB connection idle past `wait_timeout`, so every write after it (cleaned/uploaded/archived/synced) dies. Do NOT put status writes after the AI call.
+
+## Not tried yet (candidates for next session)
+- **DB reconnect/ping after the AI call** as an alternative that would let `kbSlug`/`approvedKey`/`archiveKey` be persisted to the ledger (currently dropped). User chose the "set status before AI" route instead; reconnect remains an option if ledger detail is wanted.
+- **Rotating the pre-existing leaked credentials** (toga-private + togaiq AWS keys, aegra/talos API key) in `worker2/Config/production.ini` and the old `test/team/talos/kb_processor.ini`. Standing separate track.
+- **Moving the two already-processed Elite transcripts** (currently in `general`/`toga-technology`) into `elite` via the Tools move button, and reprocessing to confirm new classification.
+- **Wiring `[talos]` into `tools/config.production.ini` for other environments** if the browser is used outside production (only production + alpha have it).
+- **Cron already added** for KB registry sync; verify it fires after deploy.
+
+## Current file state
+| File | Status | Notes |
+|------|--------|-------|
+| worker2/Worker/Team/Transcripts.php | Modified | Per-bucket S3 creds; archive get+put; SyncKnowledgeBases+listAllKnowledgeBases; SyncKb multi-slug sequential; title→AI; customer-over-company + general-apps→general classification; status set to 'synced' BEFORE AI call, post-AI status writes removed. Lint clean. |
+| worker2/Config/production.ini | Modified | `[teams]` gained s3_access_key_id/secret (toga-private key); `[talos]` gained s3_access_key_id/secret (togaiq key). |
+| worker2/bin/sync-knowledge-bases.php | Created | CLI wrapper for SyncKnowledgeBases; `--dry-run`. |
+| tools/_/app/talos/s3.php | Modified | client() prefers [talos]; copyWithinBucket/putObjectBody; moveApprovedDocument; sanitizeTitle/updateApprovedDocument; listApproved UTC→Central; verbose AWS error messages. |
+| tools/mvc/talos/kb-documents/post.php | Modified | Added move + update actions; move enqueues single SyncKb("src,dest"). |
+| tools/mvc/talos/kb-documents/get.php | Modified | Move dialog + edit modal (title box, Find&Replace, textarea, Save/Cancel). |
+| tools/config.production.ini | Modified | Added [talos], [worker], [aws] sections. |
+| tools/config.alpha.ini | Modified | Added [talos] section. |
+| dbchanges2/Core/2026-07-02a - Teams KnowledgeBases sync cron.sql | Created | Daily 05:00 CT cron for Team/Transcripts/SyncKnowledgeBases. Depends on 2026-05-14 maxExecutionTime migration. |
+| dbchanges2/Team/2026-07-02a - TranscriptPromptTemplate exclude personal notes.sql | Created | REPLACE() adds rule to exclude personal/social content + no "Personal Notes" section. |
+
+## Decisions made
+- **Per-bucket credentials, not one shared key.** togaiq and toga-private are separate AWS accounts; `[teams]`=toga-private, `[talos]`=togaiq, `[aws]`=main/SQS. Rejected: single key (impossible cross-account), instance role (prod role lacks togaiq write).
+- **App_Talos_S3 gets its own `[talos]` credentials** rather than changing the app-wide `[aws]` key (which other tools use for us-west-2/toga-private). Precedence: [talos] → [aws] → SDK default.
+- **Bedrock is source of truth for the KB list; `Team.KnowledgeBases` is a cache/allowlist** synced by `SyncKnowledgeBases` (insert-only for new, refresh bedrockKbId for existing, never delete/deactivate) + daily cron.
+- **Single sequential `SyncKb` job for moves**, not two parallel jobs — avoids concurrent Bedrock ingestion per KB and guarantees both sync.
+- **Classification rules (in code `$slugInstruction`, not the DB cleaning prompt):** title-priority; customer-over-company (toga-technology never wins over a real customer); general application/engineering work → `general`, `toga-technology` reserved for company-itself meetings; else `general`.
+- **Prompt edits via surgical `REPLACE()` migration**, preserving `{{PLACEHOLDERS}}` and UI edits, no-op if not found. Rejected: full-text overwrite (would clobber UI edits).
+- **Set ledger status to 'synced' BEFORE the AI call** and drop all post-AI status writes. Accepted trade-off: ledger loses kbSlug/approvedKey/archiveKey detail, and a post-AI failure leaves the row 'synced' (not retried by Scan). Chosen explicitly by the developer over a DB-reconnect approach.
+
+## Blockers
+none — all changes are code/config complete and lint clean; remaining work is deploy + verify.
+
+## Exact next step
+> Deploy worker2 (Transcripts.php + production.ini) and re-run `ENVIRONMENT=production php bin/reprocess-transcripts.php --limit=1` on a LONG transcript to confirm the MySQL error 2006 ("server has gone away") is gone and the row is marked `synced`. Then apply the two new dbchanges2 migrations (Core KB-sync cron + Team prompt personal-notes exclusion) and deploy the tools changes.
+
+---
+_Saved by /session-save on 2026-07-07_

package/package.json

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