toga-ai 1.0.42 → 1.0.43

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-canada/profile.md

@@ -1,5 +1,6 @@
 ---
 title: Compass Canada
+name: "Compass Canada"
 framework: "2.0"
 project: _Underscore
 client: compass-canada

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/compass-usa/profile.md

@@ -1,5 +1,6 @@
 ---
 title: Compass USA
+name: "Compass USA"
 framework: "2.0"
 project: _Underscore
 client: compass-usa

package/knowledge/clients/elite/INDEX.md

@@ -1,4 +1,4 @@
-# Client: elite
+# Client: Elite `elite`
 
 | Doc | Framework | Summary | Files |
 |-----|-----------|---------|-------|

package/knowledge/clients/elite/profile.md

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

package/knowledge/clients/nycdoe/INDEX.md

@@ -1,4 +1,4 @@
-# Client: nycdoe
+# Client: New York City Department of Education `nycdoe`
 
 | Doc | Framework | Summary | Files |
 |-----|-----------|---------|-------|

package/knowledge/clients/nycdoe/profile.md

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

package/knowledge/clients/prudential/INDEX.md

@@ -1,4 +1,4 @@
-# Client: prudential
+# Client: Prudential Financial `prudential`
 
 | Doc | Framework | Summary | Files |
 |-----|-----------|---------|-------|

package/knowledge/clients/prudential/profile.md

@@ -1,5 +1,6 @@
 ---
 title: Prudential
+name: "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.name) || 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).');
@@ -340,6 +344,7 @@ function cmdValidate() {
         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; }
+            if (path.basename(d.rel) === 'profile.md' && !d.data.name) { fail(`${d.rel}: client profile must set a formal "name" (e.g. name: "Compass USA")`); ok = false; }
         } else {
             // framework/apps doc: framework + repo must match the path
             const parts = d.rel.split('/'); // <fw>/apps/<repo>/...  OR <fw>/standards/...

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toga-ai",
-  "version": "1.0.42",
+  "version": "1.0.43",
   "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`, set the dedicated `name:` field to the client's **formal name**
+(distinct from `title`, the doc title) — `validate` requires it; 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,38 @@ 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` with the formal name in the dedicated `name:` field
+   (distinct from `title`). `validate` **requires** `name:` on every client profile — a
+   profile missing it fails the build.
+
+```markdown
+---
+title: <Client> Profile
+name: "<Formal Client Name>"   # formal name; the 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 `name:` 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
+   `name:` 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 `name:`), not the slug ...
   S. shared / internal
   X. a new client
 ```