toga-ai 1.0.161 → 1.0.162

package/knowledge/1.0/apps/library/INDEX.md

@@ -3,6 +3,7 @@
 | Doc | Summary | Files |
 |-----|---------|-------|
 | [Library (1.0 Framework) Architecture](architecture.md) | `library` is the shared library repository for **all 1.0 (legacy) applications** — the `App_` framework. | library/_.php, library/app/, library/browser/ |
+| [Diagnostic Dialog — View Recommended Services Routing](features/diagnostic-dialog-view-recommended-services.md) | `App_Model_Toga_Diagnostic::initializeDiagnosticDialog()` renders the device modal used across all TOGa service request views. | library/app/model/toga/diagnostic.php |
 | [Elite Freshservice Sync (library)](features/elite-freshservice-sync.md) | `App_Api_Toga2` in `library/app/api/toga2.php` orchestrates bidirectional sync between TOGA 2 and TOGaDesk. | library/app/api/toga2.php |
 | [Branded HTML Email Templates (App_Email_Template)](features/email-templates.md) | `App_Email_Template` (`app/email/template.php`) is the base class for branded HTML emails in the 1.0 (`App_`) framework. | library/app/email/template.php, library/app/email/agilant.php |
 | [NetSuite SuiteQL/REST API Reference](features/netsuite-suiteql-api-reference.md) | General working reference for the Agilant NetSuite integration: how to authenticate, how SuiteQL behaves, and the confirmed schema of the tables/columns/codes w | library/app/api/netsuite/rest.php, library/ssl/netsuite_ec_key.pem |

package/knowledge/1.0/apps/library/features/diagnostic-dialog-view-recommended-services.md

@@ -0,0 +1,49 @@
+---
+title: Diagnostic Dialog — View Recommended Services Routing
+framework: "1.0"
+repo: library
+project: Library
+client: shared
+type: feature
+status: active
+updated: 2026-06-23
+owners: [snaredla]
+files:
+  - library/app/model/toga/diagnostic.php
+related:
+  - ../../../clients/office-depot/features/togarefresh2026-linkbuilder-routing.md
+---
+
+## Summary
+`App_Model_Toga_Diagnostic::initializeDiagnosticDialog()` renders the device modal
+used across all TOGa service request views. It includes a "View Recommended Services"
+button whose URL depends on whether the store is a TOGaRefresh 2026 store and whether
+the diagnostic passed or failed.
+
+## How it works
+1. Checks `$_SESSION['isTogaRefresh2023']` or `$_SESSION['isTogaRefresh2026']` to
+   determine if this is a refresh store.
+2. For refresh stores, casts `$serviceRequestId` to `(int)` then queries `Diagnostics`
+   for the latest `pass` value for the service request.
+3. Routes:
+   - **Diagnostic pass** (`pass >= 1`) → `?content=togarefresh2026_servicerequests_techsupport&serviceRequestId=...`
+   - **Diagnostic fail / no diagnostic** (`pass < 1`) → `?content=togarefresh2026_servicerequests_serviceselection&jobJacketId=1&showServices=195,101899&serviceRequestId=...`
+4. For non-refresh stores, falls back to `App_Model_ServiceRequest::linkBuilder()`.
+
+## Data model
+- Table: `Diagnostics` (db_toga)
+- Field read: `pass` (TINYINT boolean — 1 = passed, 0 = failed)
+- Query: latest record by `id DESC LIMIT 1` for the given `serviceRequestId`
+
+## Gotchas / known issues
+- `$serviceRequestId` is cast to `(int)` before SQL interpolation — do not remove this cast (SQL injection prevention).
+- If no diagnostic record exists, `$diagnosticPass` defaults to `0` (fail path) — shows service selection with `showServices=195,101899`.
+- The same pass/fail routing logic exists in `toga/app/togarefresh2026/servicerequests/view.php` (lines 2358–2381) — keep both in sync.
+- `isTogaRefresh2023` is kept alongside `isTogaRefresh2026` for backward compatibility — do not remove it.
+- `$_SESSION['isTogaRefresh2026']` is set in `toga/_/app/frameworkindex.php` and `toga/app/home/action.php` at login time.
+
+## Related docs
+- `clients/office-depot/features/togarefresh2026-linkbuilder-routing.md`
+
+## Change history
+- 2026-06-23 — Initial doc. Diagnostic modal now routes pass→techsupport, fail→serviceselection with showServices=195,101899. (snaredla)

package/knowledge/1.0/apps/toga/INDEX.md

@@ -0,0 +1,4 @@
+# toga (TOGa) — 1.0 knowledge
+
+| Doc | Summary | Files |
+|-----|---------|-------|

package/knowledge/INDEX.md

@@ -4,13 +4,14 @@ _Auto-generated by `knowledge.js index`. Do not hand-edit._
 
 ## 1.0 framework
 
-- **library** (Library) _(framework core)_ — 6 doc(s) → [1.0/apps/library/INDEX.md](1.0/apps/library/INDEX.md)
+- **library** (Library) _(framework core)_ — 7 doc(s) → [1.0/apps/library/INDEX.md](1.0/apps/library/INDEX.md)
 - **worker** (Worker) — 10 doc(s) → [1.0/apps/worker/INDEX.md](1.0/apps/worker/INDEX.md)
 - **togadesk** (TOGa Desk) — 7 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)
 - **walmarttechservices** (Walmart Tech Services) — 1 doc(s) → [1.0/apps/walmarttechservices/INDEX.md](1.0/apps/walmarttechservices/INDEX.md)
 - **test** (Test) — 11 doc(s) → [1.0/apps/test/INDEX.md](1.0/apps/test/INDEX.md)
+- **toga** (TOGa) — 1 doc(s) → [1.0/apps/toga/INDEX.md](1.0/apps/toga/INDEX.md)
 
 ## 2.0 framework
 

package/knowledge/clients/office-depot/INDEX.md

@@ -3,4 +3,5 @@
 | Doc | Framework | Summary | Files |
 |-----|-----------|---------|-------|
 | [ODP Tech Support Agent (Office Depot variant)](features/odp-tech-support.md) | 2.0 | ODP-specific customization of the shared TOGa Voice agent. | voice-to-voice/clients/odp/agent.py, voice-to-voice/clients/odp/agents/tech_support.py, voice-to-voice/clients/odp/prompts.py, voice-to-voice/clients/odp/config.yaml, voice-to-voice/clients/odp/.env.example |
+| [TOGaRefresh 2026 — linkBuilderRefresh URL Routing (ODP)](features/togarefresh2026-linkbuilder-routing.md) | 1.0 | In the TOGaRefresh 2026 UI, any button that navigates to the service builder must use `App_Model_ServiceRequest::linkBuilderRefresh()` (→ `togarefresh2026_servi | toga/app/togarefresh2026/servicerequests/review.php, toga/app/togarefresh2026/customers/view.php, library/app/model/toga/diagnostic.php |
 | [Office Depot](profile.md) | 2.0 | Office Depot is the first deployed tenant of the **TOGa Voice** (`voice-to-voice`) platform. |  |

package/knowledge/clients/office-depot/features/togarefresh2026-linkbuilder-routing.md

@@ -0,0 +1,49 @@
+---
+title: TOGaRefresh 2026 — linkBuilderRefresh URL Routing (ODP)
+framework: "1.0"
+repo: toga
+project: TOGa
+client: office-depot
+type: client-feature
+status: active
+updated: 2026-06-23
+owners: [snaredla]
+files:
+  - toga/app/togarefresh2026/servicerequests/review.php
+  - toga/app/togarefresh2026/customers/view.php
+  - library/app/model/toga/diagnostic.php
+related:
+  - ../profile.md
+  - ../../../1.0/apps/library/features/diagnostic-dialog-view-recommended-services.md
+---
+
+## Summary
+In the TOGaRefresh 2026 UI, any button that navigates to the service builder must use
+`App_Model_ServiceRequest::linkBuilderRefresh()` (→ `togarefresh2026_servicerequests_serviceselection`)
+instead of the legacy `linkBuilder()` (→ `servicerequests_builder`).
+
+## Key files / entry points
+- `App_Model_ServiceRequest::BUILDER` = `'servicerequests_builder'` (legacy)
+- `App_Model_ServiceRequest::BUILDERREFRESH` = `'togarefresh2026_servicerequests_serviceselection&jobJacketId=1'`
+- Both constants defined in `library/app/model/servicerequest.php` lines 11–12.
+
+## How it works
+Files updated to use `linkBuilderRefresh`:
+
+| File | Location | Context |
+|------|----------|---------|
+| `togarefresh2026/servicerequests/review.php` | line 217 | Quote submission POST URL for non-EXISTING job jackets |
+| `togarefresh2026/customers/view.php` | line 64 | "Create Work Order For This Customer" button |
+| `library/app/model/toga/diagnostic.php` | `initializeDiagnosticDialog()` | Device modal button — routes by diagnostic pass/fail (see library doc) |
+
+## Gotchas / known issues
+- The old `servicerequests/view.php` (legacy non-refresh view) intentionally keeps `linkBuilder()` — 2026 stores do not route through it.
+- Do not change `App_Model_ServiceRequest::BUILDER` — legacy stores still depend on it.
+- The diagnostic modal routing is pass/fail conditional — see `1.0/apps/library/features/diagnostic-dialog-view-recommended-services.md` for full details.
+- `toga` app repo was not in registry.json before this session — it has been added (framework 1.0, role app, dependsOn library).
+
+## Related docs
+- `1.0/apps/library/features/diagnostic-dialog-view-recommended-services.md`
+
+## Change history
+- 2026-06-23 — Initial doc. All 2026 builder buttons now use linkBuilderRefresh; diagnostic modal uses pass/fail routing. toga added to registry.json. (snaredla)

package/knowledge/registry.json

@@ -158,6 +158,17 @@
     "project": "TOGa Commerce",
     "framework": "2.0",
     "role": "app",
-    "dependsOn": ["api2"]
+    "dependsOn": [
+      "api2"
+    ]
+  },
+  {
+    "repo": "toga",
+    "project": "TOGa",
+    "framework": "1.0",
+    "role": "app",
+    "dependsOn": [
+      "library"
+    ]
   }
-]
+]

package/package.json

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