docs: use generic example names in specs, plans, and tests

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: Skiipy11

README.md

@@ -37,7 +37,7 @@ Born from a production setup where [OpenClaw](https://github.com/openclaw/opencl
 ### What Was New in v2.2
 
 - **Noise-Free Entity Extraction** — v2.2 filters out CSS properties, code identifiers, shell commands, sentence fragments, French prose, and generic phrases. Pattern-based filtering with 50+ generic noun/adjective blocklists. Includes a retroactive cleanup script (`scripts/cleanup-garbage-entities.js`) to purge existing noise.
-- **Per-Client Knowledge Base** — Fingerprint-based client identification with accent normalization. One tool call (`brain_client`) returns everything known about a client: brand, strategy, meetings, content, technical details, relationships. Fuzzy name resolution ("JL" resolves to "jetloans").
+- **Per-Client Knowledge Base** — Fingerprint-based client identification with accent normalization. One tool call (`brain_client`) returns everything known about a client: brand, strategy, meetings, content, technical details, relationships. Fuzzy name resolution ("AL" resolves to "acme-loans").
 - **Gemini Embedding 2** — Task-type-aware embeddings at 3072 dimensions. Uses `RETRIEVAL_DOCUMENT` for storage, `RETRIEVAL_QUERY` for search. Matryoshka support for flexible dimensionality (3072/1536/768).
 - **Import/Export** — Full backup and migration support. Export all memories as JSON, import with automatic deduplication. Never lose data when switching embedding providers again.
 - **Webhook Notifications** — Real-time dispatch when memories are stored, superseded, or deleted. Fire-and-forget to any HTTP endpoint.

api/tests/client-resolver.test.js

@@ -8,40 +8,40 @@ describe('ClientResolver', () => {
   before(() => {
     resolver = new ClientResolver();
     resolver.loadFingerprints([
-      { client_id: 'jetloans', fingerprints: { aliases: ['JL', 'Jet Loans'], people: ['Brandon'], domains: ['jetloans.ca'], keywords: ['Granby'] } },
-      { client_id: 'credit-instant', fingerprints: { aliases: ['Credit Instant', 'CI'], people: ['Brandon'], domains: ['creditinstant.com'], keywords: ['Quebec City'] } },
-      { client_id: 'biolistix', fingerprints: { aliases: ['Bio'], people: ['Dominique'], domains: ['biolistix.ca'], keywords: [] } },
+      { client_id: 'acme-loans', fingerprints: { aliases: ['AL', 'Acme Loans'], people: ['Alex'], domains: ['acme-loans.ca'], keywords: ['Springfield'] } },
+      { client_id: 'quickcredit', fingerprints: { aliases: ['QuickCredit', 'QC'], people: ['Alex'], domains: ['quickcredit.com'], keywords: ['Riverside'] } },
+      { client_id: 'greenlife', fingerprints: { aliases: ['GL'], people: ['Jordan'], domains: ['greenlife.ca'], keywords: [] } },
     ]);
   });
 
   it('should resolve by alias', () => {
-    assert.strictEqual(resolver.resolve('Talked to JL about their SEO strategy'), 'jetloans');
+    assert.strictEqual(resolver.resolve('Talked to AL about their SEO strategy'), 'acme-loans');
   });
 
   it('should resolve by domain', () => {
-    assert.strictEqual(resolver.resolve('Updated jetloans.ca homepage'), 'jetloans');
+    assert.strictEqual(resolver.resolve('Updated acme-loans.ca homepage'), 'acme-loans');
   });
 
   it('should resolve by person + context', () => {
-    assert.strictEqual(resolver.resolve('Brandon called about Granby store'), 'jetloans');
+    assert.strictEqual(resolver.resolve('Alex called about Springfield store'), 'acme-loans');
   });
 
   it('should return null when below threshold', () => {
     assert.strictEqual(resolver.resolve('Had a meeting today about loans'), null);
   });
 
   it('should return array for multi-client content', () => {
-    const result = resolver.resolve('Discussed jetloans.ca redesign and Biolistix supplement strategy');
+    const result = resolver.resolve('Discussed acme-loans.ca redesign and GreenLife supplement strategy');
     assert.ok(Array.isArray(result));
-    assert.ok(result.includes('jetloans'));
-    assert.ok(result.includes('biolistix'));
+    assert.ok(result.includes('acme-loans'));
+    assert.ok(result.includes('greenlife'));
   });
 
   it('should be case-insensitive', () => {
-    assert.strictEqual(resolver.resolve('JETLOANS website is down'), 'jetloans');
+    assert.strictEqual(resolver.resolve('ACME-LOANS website is down'), 'acme-loans');
   });
 
   it('should handle accented characters', () => {
-    assert.strictEqual(resolver.resolve('Crédit Instant needs new landing page for Québec City'), 'credit-instant');
+    assert.strictEqual(resolver.resolve('QuickCrédit needs new landing page for Riverside'), 'quickcredit');
   });
 });

api/tests/entities.test.js

@@ -80,11 +80,11 @@ describe('extractEntities — domains', () => {
   });
 
   it('extracts domain names', () => {
-    const text = 'Deployed to expertlocal.ca and checked acme-corp.com';
+    const text = 'Deployed to localagency.ca and checked acme-corp.com';
     const entities = extractEntities(text, 'global', 'test');
     const domains = entities.filter(e => e.type === 'domain');
     const names = domains.map(e => e.name);
-    assert.ok(names.includes('expertlocal.ca'));
+    assert.ok(names.includes('localagency.ca'));
     assert.ok(names.includes('acme-corp.com'));
   });
 
@@ -169,8 +169,8 @@ describe('extractEntities — alias cache', () => {
   });
 
   it('addToAliasCache makes new aliases resolvable', () => {
-    addToAliasCache('morpheus', 99, 'Morpheus Server', 'system');
-    const text = 'Deployed update to Morpheus overnight';
+    addToAliasCache('test-server', 99, 'Test Server', 'system');
+    const text = 'Deployed update to Test Server overnight';
     const entities = extractEntities(text, 'global', 'test');
     // Morpheus should resolve — check alias cache was used
     // (It'll match as technology "Morpheus" since it's not in KNOWN_TECH,

api/tests/notifications.test.js

@@ -5,15 +5,15 @@ import { buildNotificationPayload } from '../src/services/notifications.js';
 describe('notifications', () => {
   it('should build memory_stored payload with correct structure', () => {
     const payload = buildNotificationPayload('memory_stored', {
-      id: 'test-id', type: 'fact', client_id: 'jetloans',
+      id: 'test-id', type: 'fact', client_id: 'acme-loans',
       knowledge_category: 'strategy', content: 'x'.repeat(300),
       source_agent: 'claude-code', importance: 'high', created_at: '2026-03-20T00:00:00Z',
     });
     assert.strictEqual(payload.event, 'memory_stored');
     assert.strictEqual(payload.memory.id, 'test-id');
     assert.strictEqual(payload.memory.type, 'fact');
     assert.ok(payload.memory.content_preview.length <= 200);
-    assert.strictEqual(payload.memory.client_id, 'jetloans');
+    assert.strictEqual(payload.memory.client_id, 'acme-loans');
   });
 
   it('should default missing fields', () => {

docs/superpowers/plans/2026-03-20-shared-brain-v2.md

@@ -86,42 +86,42 @@ describe('ClientResolver', () => {
   before(() => {
     resolver = new ClientResolver();
     resolver.loadFingerprints([
-      { client_id: 'jetloans', fingerprints: { aliases: ['JL', 'Jet Loans'], people: ['Brandon'], domains: ['jetloans.ca'], keywords: ['Granby'] } },
-      { client_id: 'credit-instant', fingerprints: { aliases: ['Credit Instant', 'CI'], people: ['Brandon'], domains: ['creditinstant.com'], keywords: ['Quebec City'] } },
-      { client_id: 'biolistix', fingerprints: { aliases: ['Bio'], people: ['Dominique'], domains: ['biolistix.ca'], keywords: [] } },
+      { client_id: 'acme-loans', fingerprints: { aliases: ['AL', 'Acme Loans'], people: ['Alex'], domains: ['acme-loans.ca'], keywords: ['Springfield'] } },
+      { client_id: 'quickcredit', fingerprints: { aliases: ['QuickCredit', 'QC'], people: ['Alex'], domains: ['quickcredit.com'], keywords: ['Riverside'] } },
+      { client_id: 'greenlife', fingerprints: { aliases: ['GL'], people: ['Jordan'], domains: ['greenlife.ca'], keywords: [] } },
     ]);
   });
 
   it('should resolve by alias', () => {
-    assert.strictEqual(resolver.resolve('Talked to JL about their SEO strategy'), 'jetloans');
+    assert.strictEqual(resolver.resolve('Talked to AL about their SEO strategy'), 'acme-loans');
   });
 
   it('should resolve by domain', () => {
-    assert.strictEqual(resolver.resolve('Updated jetloans.ca homepage'), 'jetloans');
+    assert.strictEqual(resolver.resolve('Updated acme-loans.ca homepage'), 'acme-loans');
   });
 
   it('should resolve by person + context', () => {
-    // Brandon alone is ambiguous (both jetloans + credit-instant), needs 2nd signal
-    assert.strictEqual(resolver.resolve('Brandon called about Granby store'), 'jetloans');
+    // Alex alone is ambiguous (both acme-loans + quickcredit), needs 2nd signal
+    assert.strictEqual(resolver.resolve('Alex called about Springfield store'), 'acme-loans');
   });
 
   it('should return null when below threshold', () => {
     assert.strictEqual(resolver.resolve('Had a meeting today about loans'), null);
   });
 
   it('should return array for multi-client content', () => {
-    const result = resolver.resolve('Discussed jetloans.ca redesign and Biolistix supplement strategy');
+    const result = resolver.resolve('Discussed acme-loans.ca redesign and GreenLife supplement strategy');
     assert.ok(Array.isArray(result));
-    assert.ok(result.includes('jetloans'));
-    assert.ok(result.includes('biolistix'));
+    assert.ok(result.includes('acme-loans'));
+    assert.ok(result.includes('greenlife'));
   });
 
   it('should be case-insensitive', () => {
-    assert.strictEqual(resolver.resolve('JETLOANS website is down'), 'jetloans');
+    assert.strictEqual(resolver.resolve('ACME-LOANS website is down'), 'acme-loans');
   });
 
   it('should handle accented characters', () => {
-    assert.strictEqual(resolver.resolve('Crédit Instant needs new landing page for Québec City'), 'credit-instant');
+    assert.strictEqual(resolver.resolve('QuickCrédit needs new landing page for Riverside'), 'quickcredit');
   });
 });
 ```
@@ -320,8 +320,8 @@ import assert from 'node:assert';
 describe('client route response format', () => {
   it('should structure briefing with profile and knowledge sections', () => {
     const response = {
-      client_id: 'jetloans',
-      profile: { name: 'Jetloans', industry: 'loans' },
+      client_id: 'acme-loans',
+      profile: { name: 'Acme Loans', industry: 'loans' },
       knowledge: {
         brand: [], strategy: [], meeting: [],
         content: [], technical: [], relationship: [],
@@ -472,7 +472,7 @@ In `mcp-server/src/index.js`, add to the tools array:
 ```javascript
 {
   name: 'brain_client',
-  description: 'Get everything known about a client — profile, brand, strategy, meetings, content, technical details, relationships. Can also do semantic search within a client\'s memories. Accepts fuzzy names (e.g. "JL" resolves to "jetloans").',
+  description: 'Get everything known about a client — profile, brand, strategy, meetings, content, technical details, relationships. Can also do semantic search within a client\'s memories. Accepts fuzzy names (e.g. "AL" resolves to "acme-loans").',
   inputSchema: {
     type: 'object',
     properties: {
@@ -668,7 +668,7 @@ import { buildNotificationPayload } from '../src/services/notifications.js';
 describe('notifications', () => {
   it('should build memory_stored payload', () => {
     const payload = buildNotificationPayload('memory_stored', {
-      id: 'test-id', type: 'fact', client_id: 'jetloans',
+      id: 'test-id', type: 'fact', client_id: 'acme-loans',
       knowledge_category: 'strategy', content: 'Long content here that should be truncated...',
       source_agent: 'claude-code', importance: 'high', created_at: '2026-03-20T00:00:00Z',
     });
@@ -769,8 +769,8 @@ import assert from 'node:assert';
 describe('entity relationships', () => {
   it('should detect co-occurring entities', () => {
     const entities = [
-      { name: 'Jetloans', type: 'client' },
-      { name: 'Brandon', type: 'person' },
+      { name: 'Acme Loans', type: 'client' },
+      { name: 'Alex', type: 'person' },
       { name: 'SEMrush', type: 'technology' },
     ];
     // Each pair should create a relationship
@@ -902,7 +902,7 @@ graphRouter.get('/:entity/html', async (req, res) => {
 
 - [ ] **Step 3: Test manually**
 
-Open `http://192.168.18.40:8084/graph/Jetloans/html` in browser and verify the visualization renders.
+Open `http://localhost:8084/graph/Acme Loans/html` in browser and verify the visualization renders.
 
 - [ ] **Step 4: Commit**
 
@@ -936,7 +936,7 @@ Import `getClientResolver` from `'../services/client-resolver.js'`.
 
 - [ ] **Step 2: Test by storing a memory without client_id that mentions a client**
 
-Use curl or MCP to store a fact with content "Updated Jetloans homepage meta tags for Granby SEO" without providing client_id. Verify it auto-resolves to `jetloans`.
+Use curl or MCP to store a fact with content "Updated Acme Loans homepage meta tags for Springfield SEO" without providing client_id. Verify it auto-resolves to `acme-loans`.
 
 - [ ] **Step 3: Commit**
 
@@ -1045,13 +1045,13 @@ BASEROW_CLIENTS_TABLE_ID=734
 - [ ] **Step 3: Rebuild and restart container**
 
 ```bash
-ssh beelink "cd ~/shared-brain && docker compose build memory-api && docker compose up -d memory-api"
+ssh server "cd ~/shared-brain && docker compose build memory-api && docker compose up -d memory-api"
 ```
 
 - [ ] **Step 4: Verify startup logs**
 
 ```bash
-ssh beelink "docker logs shared-brain-api --tail 20"
+ssh server "docker logs shared-brain-api --tail 20"
 ```
 Expected: client resolver loaded, all routes registered, no errors.
 
@@ -1061,9 +1061,9 @@ Add `client_fingerprints` field (long text) to table 734 via Baserow UI. Populat
 
 - [ ] **Step 6: Test brain_client via MCP**
 
-Call `brain_client("jetloans")` — should return a briefing (initially empty knowledge sections until memories are stored with knowledge_category).
+Call `brain_client("acme-loans")` — should return a briefing (initially empty knowledge sections until memories are stored with knowledge_category).
 
-Call `brain_client("JL")` — should resolve to jetloans via fingerprints.
+Call `brain_client("AL")` — should resolve to acme-loans via fingerprints.
 
 - [ ] **Step 7: Test export/import round-trip**
 
@@ -1072,7 +1072,7 @@ Save output, then call `brain_import(data)` — should report all skipped (dupli
 
 - [ ] **Step 8: Test graph visualization**
 
-Open `http://192.168.18.40:8084/graph/claude-code/html` in browser — should render interactive graph.
+Open `http://localhost:8084/graph/claude-code/html` in browser — should render interactive graph.
 
 - [ ] **Step 9: Update local MCP server**
 

docs/superpowers/specs/2026-03-20-shared-brain-v2-design.md

@@ -22,20 +22,20 @@ Each client gets a fingerprint dictionary stored in Baserow table 734 (clients)
 **Fingerprint format**:
 ```json
 {
-  "aliases": ["jetloans", "jet loans", "JL"],
-  "people": ["Brandon"],
-  "domains": ["jetloans.ca"],
-  "keywords": ["Granby", "micro-prets"],
-  "related_clients": ["credit-instant"]
+  "aliases": ["acme-loans", "acme loans", "AL"],
+  "people": ["Alex"],
+  "domains": ["acme-loans.ca"],
+  "keywords": ["Springfield", "small-loans"],
+  "related_clients": ["quickcredit"]
 }
 ```
 
 **Known fingerprints at launch**:
-- `jetloans`: aliases [JL, Jet Loans], people [Brandon], domains [jetloans.ca], keywords [Granby]
-- `credit-instant`: aliases [Credit Instant, CI], people [Brandon], domains [creditinstant.com], keywords [Quebec City]
-- `biolistix`: aliases [Bio], people [Dominique], domains [biolistix.ca]
-- `la-canardiere`: aliases [La Canardiere, Canardiere], domains [lacanardiere.com]
-- `expert-local`: aliases [EL, Expert Local], people [Steven], domains [expertlocal.ca]
+- `acme-loans`: aliases [AL, Acme Loans], people [Alex], domains [acme-loans.ca], keywords [Springfield]
+- `quickcredit`: aliases [QuickCredit, QC], people [Alex], domains [quickcredit.com], keywords [Riverside]
+- `greenlife`: aliases [GL], people [Jordan], domains [greenlife.ca]
+- `riverside-inn`: aliases [Riverside Inn, Riverside], domains [riverside-inn.com]
+- `localagency`: aliases [LA, Local Agency], people [Sam], domains [localagency.ca]
 
 **API-side resolver** — `resolveClientId(text)`:
 1. On startup, fetches all fingerprints from Baserow 734 and caches them
@@ -92,8 +92,8 @@ One-call access to everything known about a client.
 4. Return structured response:
 ```json
 {
-  "client_id": "jetloans",
-  "profile": { "name": "Jetloans", "industry": "loans", "brand_voice_tone": "helpful", ... },
+  "client_id": "acme-loans",
+  "profile": { "name": "Acme Loans", "industry": "loans", "brand_voice_tone": "helpful", ... },
   "knowledge": {
     "brand": [...],
     "strategy": [...],
@@ -119,9 +119,9 @@ The existing Fireflies daily processor workflow (`E:\dev\n8n\fireflies-daily-pro
 **A. Fingerprint injection**: Before the LLM extraction node, add a step that fetches fingerprints from the Shared Brain API (new endpoint: `GET /clients/fingerprints`) and formats them into the extraction prompt:
 ```
 Active clients and identifiers:
-- jetloans (aliases: JL, Jet Loans | people: Brandon | domains: jetloans.ca)
-- credit-instant (aliases: Credit Instant | people: Brandon | domains: creditinstant.com)
-- biolistix (aliases: Bio | people: Dominique | domains: biolistix.ca)
+- acme-loans (aliases: AL, Acme Loans | people: Alex | domains: acme-loans.ca)
+- quickcredit (aliases: QuickCredit | people: Alex | domains: quickcredit.com)
+- greenlife (aliases: GL | people: Jordan | domains: greenlife.ca)
 ...
 
 For each topic/action item, identify which client_id it belongs to.
@@ -148,9 +148,9 @@ If a segment doesn't match any client, use "internal".
     "id": "uuid",
     "content": "...",
     "type": "fact",
-    "key": "seo-strategy-jetloans",
+    "key": "seo-strategy-acme-loans",
     "subject": null,
-    "client_id": "jetloans",
+    "client_id": "acme-loans",
     "knowledge_category": "strategy",
     "category": "semantic",
     "source_agent": "claude-code",
@@ -159,7 +159,7 @@ If a segment doesn't match any client, use "internal".
     "access_count": 3,
     "active": true,
     "superseded_by": null,
-    "entities": [{"name": "Jetloans", "type": "client"}],
+    "entities": [{"name": "Acme Loans", "type": "client"}],
     "created_at": "2026-03-20T...",
     "last_accessed_at": "2026-03-20T..."
   }
@@ -213,7 +213,7 @@ WEBHOOK_NOTIFY_URLS=http://n8n.local:5678/webhook/brain-event
   "memory": {
     "id": "uuid",
     "type": "fact",
-    "client_id": "jetloans",
+    "client_id": "acme-loans",
     "knowledge_category": "strategy",
     "content_preview": "First 200 chars...",
     "source_agent": "claude-code",

mcp-server/src/index.js

@@ -286,7 +286,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
     },
     {
       name: 'brain_client',
-      description: 'Get everything known about a client — brand, strategy, meetings, content, technical details, relationships. Can also do semantic search within a client\'s memories. Accepts fuzzy names (e.g. "JL" resolves to "jetloans").',
+      description: 'Get everything known about a client — brand, strategy, meetings, content, technical details, relationships. Can also do semantic search within a client\'s memories. Accepts fuzzy names (e.g. "AL" resolves to "acme-loans").',
       inputSchema: {
         type: 'object',
         properties: {