toga-ai 1.0.42 → 1.0.44

package/knowledge/INDEX.md

@@ -17,9 +17,9 @@ _Auto-generated by `knowledge.js index`. Do not hand-edit._
 
 ## Clients
 
-- **compass-canada** → [clients/compass-canada/INDEX.md](clients/compass-canada/INDEX.md)
-- **compass-usa** → [clients/compass-usa/INDEX.md](clients/compass-usa/INDEX.md)
-- **elite** → [clients/elite/INDEX.md](clients/elite/INDEX.md)
-- **nycdoe** → [clients/nycdoe/INDEX.md](clients/nycdoe/INDEX.md)
-- **prudential** → [clients/prudential/INDEX.md](clients/prudential/INDEX.md)
+- **Compass Canada** (`compass-canada`) → [clients/compass-canada/INDEX.md](clients/compass-canada/INDEX.md)
+- **Compass USA** (`compass-usa`) → [clients/compass-usa/INDEX.md](clients/compass-usa/INDEX.md)
+- **Elite** (`elite`) → [clients/elite/INDEX.md](clients/elite/INDEX.md)
+- **New York City Department of Education** (`nycdoe`) → [clients/nycdoe/INDEX.md](clients/nycdoe/INDEX.md)
+- **Prudential Financial** (`prudential`) → [clients/prudential/INDEX.md](clients/prudential/INDEX.md)
 

package/knowledge/clients/compass-canada/INDEX.md

@@ -1,4 +1,4 @@
-# Client: compass-canada
+# Client: Compass Canada `compass-canada`
 
 | Doc | Framework | Summary | Files |
 |-----|-----------|---------|-------|

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

@@ -1,4 +1,4 @@
-# Client: compass-usa
+# Client: Compass USA `compass-usa`
 
 | Doc | Framework | Summary | Files |
 |-----|-----------|---------|-------|

package/knowledge/clients/elite/INDEX.md

@@ -1,5 +1,5 @@
-# Client: elite
+# Client: Elite `elite`
 
 | Doc | Framework | Summary | Files |
 |-----|-----------|---------|-------|
-| [Elite Client Profile](profile.md) | 2.0 | Elite is a managed-services client that uses **Freshservice** as their helpdesk platform. | worker2/Worker/Elite.php, library/app/api/toga2.php |
+| [Elite](profile.md) | 2.0 | Elite is a managed-services client that uses **Freshservice** as their helpdesk platform. | worker2/Worker/Elite.php, library/app/api/toga2.php |

package/knowledge/clients/elite/profile.md

@@ -1,5 +1,5 @@
 ---
-title: Elite Client Profile
+title: Elite
 framework: "2.0"
 project: Worker
 client: elite

package/knowledge/clients/nycdoe/INDEX.md

@@ -1,6 +1,6 @@
-# Client: nycdoe
+# Client: New York City Department of Education `nycdoe`
 
 | Doc | Framework | Summary | Files |
 |-----|-----------|---------|-------|
 | [NYCDOE ServiceNow / ASN Integration](features/servicenow-integration.md) | 1.0 | The NYCDOE/ServiceNow integration mirrors DOE's ServiceNow tickets (Incidents + RITMs) into local tables, turns vendor shipment notices into NetSuite Sales Orde | worker/crons/sync/nycdoe/import_asn.php, worker/crons/sync/nycdoe/import_inc.php, worker/crons/sync/nycdoe/legacy_import_asn.php, worker/crons/sync/nycdoe/legacy_process_asn_queue.php, worker/crons/sync/nycdoe/process_tickets.php, worker/crons/sync/nycdoe/1_send_asn_to_netsuite.php, worker/crons/sync/nycdoe/2_send_serials_to_netsuite.php, worker/crons/sync/nycdoe/3_create_installation_ticket.php, worker/crons/sync/nycdoe/send_ticket_updates.php, worker/crons/sync/nycdoe/send_request_item_updates.php, worker/crons/sync/nycdoe/send_nycdoe_proof_of_delivery.php, worker/crons/sync/nycdoe/sync_nycdoe_locations.php, worker/crons/sync/nycdoe/receive_edi_purchase_orders.php, worker/crons/sync/nycdoe/send_edi_open_invoices.php, worker/crons/notifications/nycdoe/, worker/schedules/cron.worker.sync.json, worker/schedules/cron.worker.notification.json, library/app/api/nycdoe.php, library/app/api/nycdoev2.php, library/app/asnprocessor/manufacturer.php, library/app/edi.php |
-| [NYC DOE (New York City Department of Education)](profile.md) | 1.0 | NYC DOE (New York City Department of Education) is a TOGA client whose entire integration runs in the **1.0 worker tier** (~30 cron scripts under `worker/crons/ |  |
+| [New York City Department of Education](profile.md) | 1.0 | NYC DOE (New York City Department of Education) is a TOGA client whose entire integration runs in the **1.0 worker tier** (~30 cron scripts under `worker/crons/ |  |

package/knowledge/clients/nycdoe/profile.md

@@ -1,5 +1,5 @@
 ---
-title: NYC DOE (New York City Department of Education)
+title: New York City Department of Education
 framework: "1.0"
 project: Worker
 client: nycdoe

package/knowledge/clients/prudential/INDEX.md

@@ -1,6 +1,6 @@
-# Client: prudential
+# Client: Prudential Financial `prudential`
 
 | Doc | Framework | Summary | Files |
 |-----|-----------|---------|-------|
 | [Prudential: Dell ASN units PRE/POST interceptor (legacy key + flat tracking)](features/dell-asn-units-interceptor.md) | 2.0 | After the tracking-number bridge migration, the ASN unit route was renamed (`advance-shipping-notice-units` → `advance-shipping-notice-item-units`), so the inhe | _underscore/Model/Prudential/AdvanceShippingNotice.php, dbchanges2/Client_Prudential/2026-06-10 - AsnUnitsInterceptor.sql |
-| [Prudential](profile.md) | 2.0 | Prudential is a TOGA client whose device-fulfillment flow is driven by **Dell** via the Dell API (`Client_Prudential.Apis.id = 2`). |  |
+| [Prudential Financial](profile.md) | 2.0 | Prudential is a TOGA client whose device-fulfillment flow is driven by **Dell** via the Dell API (`Client_Prudential.Apis.id = 2`). |  |

package/knowledge/clients/prudential/profile.md

@@ -1,5 +1,5 @@
 ---
-title: Prudential
+title: Prudential Financial
 framework: "2.0"
 project: _Underscore
 client: prudential

package/knowledge.js

@@ -252,12 +252,16 @@ function cmdIndex() {
 
     // per-client INDEX.md
     const clientsDir = path.join(ROOT, 'clients');
+    const clientFormalNames = {}; // slug -> formal name (from profile.md `name:`)
     if (fs.existsSync(clientsDir)) {
         for (const client of fs.readdirSync(clientsDir, { withFileTypes: true }).filter(e => e.isDirectory()).map(e => e.name)) {
             const clientDir = path.join(clientsDir, client);
             const clientDocs = docs.filter(d => d.file.startsWith(clientDir + path.sep));
+            const profileDoc = clientDocs.find(d => path.basename(d.file) === 'profile.md');
+            const formalName = (profileDoc && profileDoc.data.title) || client;
+            clientFormalNames[client] = formalName;
             const lines = [
-                `# Client: ${client}`,
+                `# Client: ${formalName} \`${client}\``,
                 '',
                 '| Doc | Framework | Summary | Files |',
                 '|-----|-----------|---------|-------|',
@@ -284,7 +288,7 @@ function cmdIndex() {
         ? fs.readdirSync(clientsDir, { withFileTypes: true }).filter(e => e.isDirectory()).map(e => e.name) : [];
     master.push('## Clients', '');
     if (clientNames.length === 0) master.push('_No client knowledge captured yet._', '');
-    else { for (const c of clientNames) master.push(`- **${c}** → [clients/${c}/INDEX.md](clients/${c}/INDEX.md)`); master.push(''); }
+    else { for (const c of clientNames) master.push(`- **${clientFormalNames[c] || c}** (\`${c}\`) → [clients/${c}/INDEX.md](clients/${c}/INDEX.md)`); master.push(''); }
     writeIndex(path.join(ROOT, 'INDEX.md'), master);
 
     console.log('index rebuilt: ' + docs.length + ' doc(s) across ' + registry.length + ' registered repo(s).');

package/package.json

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

package/skills/capture/SKILL.md

@@ -146,6 +146,8 @@ For every doc, set/refresh frontmatter: `framework`, `repo`, `project`, `client`
 `type`, `status`, `updated` (today's date), `owners`, `files`, `related`.
 Set `owners` to `["<AUTHOR_USERNAME>"]` from Step 1b — **never leave it empty**; when a doc
 already has owners, add `AUTHOR_USERNAME` if missing rather than replacing.
+For a client `profile.md`, the `title:` **is** the client's formal name (e.g. "Compass USA") —
+there is no separate name field; `validate` requires `title`. See New-client onboarding.
 Add `related:` cross-links. Append new repos to `<TEAM_REPO>/knowledge/registry.json`.
 
 ## Step 6 — Validate, index, mirror back (mandatory)
@@ -355,6 +357,37 @@ Ask **all** — assume nothing (a heuristic may seed a default to confirm):
 
 Append the entry to `registry.json`, then continue. `validate` will confirm consistency.
 
+## New-client onboarding (client has no `knowledge/clients/<slug>/` folder yet)
+
+When this session's work is for a client with no `clients/<slug>/` folder, before writing
+any client docs:
+
+1. **Slug** — confirm the folder slug (lowercase, hyphenated, e.g. `compass-usa`). The slug
+   is used only for the folder name.
+2. **Formal name** — **ASK the developer for the client's formal name** (e.g. "Compass USA",
+   "New York City Department of Education"). **Never invent it from the slug.**
+3. Create `clients/<slug>/profile.md` using the formal name as the `title:` (the slug is only
+   the folder key — the profile's `title` carries the human-readable client name). `validate`
+   **requires** `title` on every doc — a profile missing it fails the build.
+
+```markdown
+---
+title: "<Formal Client Name>"   # the client's formal name IS the title; slug is only the folder
+framework: "<1.0|2.0>"
+project: <Project>
+client: <slug>
+type: profile
+status: active
+updated: <YYYY-MM-DD>
+owners: ["<AUTHOR_USERNAME>"]
+files: []
+related: []
+---
+
+## Summary
+Who the client is and what their integration does.
+```
+
 ---
 
 ### After Capture

package/skills/kickoff/SKILL.md

@@ -117,8 +117,10 @@ Ask these in one message. **Present the repos/projects you already know** (read
    choice;** a session often spans more than one repo/project, so always let the developer
    pick several. If they pick a repo not listed, run **New-repo onboarding** (below) for
    each new repo before continuing.
-4. **Client** — which client is this for, or "shared / internal"? **List EVERY folder under
-   `knowledge/clients/`** plus "shared / internal" and "a new client" — do not show only a
+4. **Client** — which client is this for, or "shared / internal"? **List EVERY client by its
+   formal name** — read the `title:` field from each `knowledge/clients/<slug>/profile.md`
+   and show the **formal name, not the slug** (fall back to a title-cased slug only if the
+   profile is missing). Include "shared / internal" and "a new client". Do not show only a
    subset.
 5. **What are you building or changing?** (a sentence — used to pick relevant feature docs.)
 
@@ -142,9 +144,10 @@ and naturally supports multi-select.
   N. a new repo not listed
 
 **Which client?** (one, or "shared / internal")
-  1. compass-canada
-  2. compass-usa
-  ... every folder under knowledge/clients/ ...
+  1. Compass Canada
+  2. Compass USA
+  3. Elite
+  ... every client's FORMAL name (from clients/<slug>/profile.md `title:`), not the slug ...
   S. shared / internal
   X. a new client
 ```