digital-brain 0.1.3 → 1.0.3

package/examples/sample-vault/08 Sources/Analysis/relationship_profiles.json

@@ -0,0 +1,122 @@
+[
+  {
+    "chatName": "Mom",
+    "sourceSystem": "WhatsApp",
+    "displayName": "Mom (WhatsApp)",
+    "identityName": "Mom",
+    "canonicalPersonKey": "person::mom",
+    "identityConfidence": "medium",
+    "identityEvidence": "WhatsApp direct chat identity",
+    "messageCount": 2,
+    "inbound": 1,
+    "outbound": 1,
+    "outboundShare": 0.5,
+    "firstSeen": "2026-01-01",
+    "lastSeen": "2026-01-01",
+    "isGroup": false,
+    "sentimentScore": 0.159,
+    "warmthScore": 0.5,
+    "frictionScore": 0.0,
+    "operationalScore": 1.5,
+    "questionCount": 0,
+    "relationshipGuess": "warm personal relationship",
+    "tags": [
+      "direct-chat",
+      "light",
+      "warm",
+      "logistics-heavy"
+    ],
+    "typingStyle": {
+      "sampleSize": 1,
+      "avgChars": 24.0,
+      "avgWords": 4.0,
+      "lowercaseShare": 0.0,
+      "uppercaseShare": 0.0,
+      "questionShare": 0.0,
+      "exclamationShare": 0.0,
+      "emojiShare": 0.0,
+      "slang": [],
+      "signature": "very short"
+    }
+  },
+  {
+    "chatName": "Project Team",
+    "sourceSystem": "WhatsApp",
+    "displayName": "Project Team (WhatsApp)",
+    "identityName": "Project Team",
+    "canonicalPersonKey": "group::whatsapp::project team",
+    "identityConfidence": "medium",
+    "identityEvidence": "group chat kept source-specific",
+    "messageCount": 2,
+    "inbound": 1,
+    "outbound": 1,
+    "outboundShare": 0.5,
+    "firstSeen": "2026-01-01",
+    "lastSeen": "2026-01-01",
+    "isGroup": true,
+    "sentimentScore": 0,
+    "warmthScore": 0.0,
+    "frictionScore": 0.0,
+    "operationalScore": 3.0,
+    "questionCount": 1,
+    "relationshipGuess": "group, likely social or mixed context",
+    "tags": [
+      "group-chat",
+      "light",
+      "logistics-heavy",
+      "question-heavy"
+    ],
+    "typingStyle": {
+      "sampleSize": 1,
+      "avgChars": 33.0,
+      "avgWords": 6.0,
+      "lowercaseShare": 0.0,
+      "uppercaseShare": 0.0,
+      "questionShare": 0.0,
+      "exclamationShare": 0.0,
+      "emojiShare": 0.0,
+      "slang": [],
+      "signature": "short"
+    }
+  },
+  {
+    "chatName": "Close Friend",
+    "sourceSystem": "WhatsApp",
+    "displayName": "Close Friend (WhatsApp)",
+    "identityName": "Close Friend",
+    "canonicalPersonKey": "person::close friend",
+    "identityConfidence": "medium",
+    "identityEvidence": "WhatsApp direct chat identity",
+    "messageCount": 2,
+    "inbound": 1,
+    "outbound": 1,
+    "outboundShare": 0.5,
+    "firstSeen": "2026-01-01",
+    "lastSeen": "2026-01-01",
+    "isGroup": false,
+    "sentimentScore": 0.159,
+    "warmthScore": 1.0,
+    "frictionScore": 0.0,
+    "operationalScore": 0.5,
+    "questionCount": 0,
+    "relationshipGuess": "warm personal relationship",
+    "tags": [
+      "direct-chat",
+      "light",
+      "warm",
+      "logistics-heavy"
+    ],
+    "typingStyle": {
+      "sampleSize": 1,
+      "avgChars": 30.0,
+      "avgWords": 5.0,
+      "lowercaseShare": 0.0,
+      "uppercaseShare": 0.0,
+      "questionShare": 0.0,
+      "exclamationShare": 0.0,
+      "emojiShare": 0.0,
+      "slang": [],
+      "signature": "short"
+    }
+  }
+]

package/examples/sample-vault/08 Sources/WhatsApp/Analysis/Interpreted/Close Friend (WhatsApp).md

@@ -0,0 +1,44 @@
+# Close Friend (WhatsApp)
+
+Generated: 2026-06-09T23:15:09.589124+00:00
+Source: WhatsApp
+Role: operational contact
+Role confidence: low
+Closeness: medium
+Conversation difficulty: low
+Typing style: short
+
+Generated draft, not truth. These are private working notes. Edit them where wrong.
+
+## Role / Relationship Label
+- operational contact (low confidence).
+- Reason: logistics-heavy communication.
+
+## Closeness And Importance
+- Closeness: medium.
+- Reciprocity: balanced.
+- Conversation difficulty: low.
+
+## Communication Pattern
+- Messages: 2 (1 inbound, 1 outbound).
+- Tags: direct-chat, light, warm, logistics-heavy.
+
+## Typing Style To Match
+- Signature: short.
+- Average length: 5.0 words / 30.0 chars.
+- Lowercase share: 0.0.
+- Question share: 0.0.
+- Exclamation share: 0.0.
+- Emoji share: 0.0.
+- Slang: none detected.
+
+## How To Continue This Relationship
+- Keep tone neutral until the user labels this relationship.
+- Track open loops, plans, dates, and commitments.
+
+## Reply Guidance
+- Keep replies very short unless context demands detail.
+- Match style without exaggerating or parodying the person.
+
+## What Not To Assume
+- Do not expose private summaries unless asked.

package/examples/sample-vault/08 Sources/WhatsApp/Analysis/Interpreted/Mom (WhatsApp).md

@@ -0,0 +1,45 @@
+# Mom (WhatsApp)
+
+Generated: 2026-06-09T23:15:09.587707+00:00
+Source: WhatsApp
+Role: mother
+Role confidence: high
+Closeness: medium
+Conversation difficulty: low
+Typing style: very short
+
+Generated draft, not truth. These are private working notes. Edit them where wrong.
+
+## Role / Relationship Label
+- mother (high confidence).
+- Reason: manual override.
+
+## Closeness And Importance
+- Closeness: medium.
+- Reciprocity: balanced.
+- Conversation difficulty: low.
+
+## Communication Pattern
+- Messages: 2 (1 inbound, 1 outbound).
+- Tags: direct-chat, light, warm, logistics-heavy.
+
+## Typing Style To Match
+- Signature: very short.
+- Average length: 4.0 words / 24.0 chars.
+- Lowercase share: 0.0.
+- Question share: 0.0.
+- Exclamation share: 0.0.
+- Emoji share: 0.0.
+- Slang: none detected.
+
+## How To Continue This Relationship
+- Use warmer language than a work chat.
+- Do not make the interaction purely transactional.
+- Track open loops, plans, dates, and commitments.
+
+## Reply Guidance
+- Keep replies very short unless context demands detail.
+- Match style without exaggerating or parodying the person.
+
+## What Not To Assume
+- Do not expose private summaries unless asked.

package/examples/sample-vault/08 Sources/WhatsApp/Analysis/Interpreted/Project Team (WhatsApp).md

@@ -0,0 +1,45 @@
+# Project Team (WhatsApp)
+
+Generated: 2026-06-09T23:15:09.588601+00:00
+Source: WhatsApp
+Role: work collaborator
+Role confidence: medium
+Closeness: low/unclear
+Conversation difficulty: practical/low-emotional
+Typing style: short
+
+Generated draft, not truth. These are private working notes. Edit them where wrong.
+
+## Role / Relationship Label
+- work collaborator (medium confidence).
+- Reason: matched chat name.
+
+## Closeness And Importance
+- Closeness: low/unclear.
+- Reciprocity: balanced.
+- Conversation difficulty: practical/low-emotional.
+
+## Communication Pattern
+- Messages: 2 (1 inbound, 1 outbound).
+- Tags: group-chat, light, logistics-heavy, question-heavy.
+
+## Typing Style To Match
+- Signature: short.
+- Average length: 6.0 words / 33.0 chars.
+- Lowercase share: 0.0.
+- Question share: 0.0.
+- Exclamation share: 0.0.
+- Emoji share: 0.0.
+- Slang: none detected.
+
+## How To Continue This Relationship
+- Lead with context, next steps, and clear asks.
+- Keep emotional interpretation light.
+- Track open loops, plans, dates, and commitments.
+
+## Reply Guidance
+- Use concise replies with one clear point.
+- Match style without exaggerating or parodying the person.
+
+## What Not To Assume
+- Do not expose private summaries unless asked.

package/examples/sample-vault/08 Sources/WhatsApp/Analysis/Relationship Map.md

@@ -4,8 +4,10 @@ Window: last 365 days
 
 Generated signals. Treat as editable working notes.
 
-## Mom
+## Mom (WhatsApp)
 
+- Source: WhatsApp
+- Canonical person: Mom (person::mom)
 - Guess: warm personal relationship
 - Messages: 2 (1 inbound, 1 outbound)
 - Dates: 2026-01-01 to 2026-01-01
@@ -13,8 +15,10 @@ Generated signals. Treat as editable working notes.
 - Tags: direct-chat, light, warm, logistics-heavy
 - Typing style: very short; avg 4.0 words; lowercase 0.0; emoji 0.0; slang none
 
-## Project Team
+## Project Team (WhatsApp)
 
+- Source: WhatsApp
+- Canonical person: Project Team (group::whatsapp::project team)
 - Guess: group, likely social or mixed context
 - Messages: 2 (1 inbound, 1 outbound)
 - Dates: 2026-01-01 to 2026-01-01
@@ -22,8 +26,10 @@ Generated signals. Treat as editable working notes.
 - Tags: group-chat, light, logistics-heavy, question-heavy
 - Typing style: short; avg 6.0 words; lowercase 0.0; emoji 0.0; slang none
 
-## Close Friend
+## Close Friend (WhatsApp)
 
+- Source: WhatsApp
+- Canonical person: Close Friend (person::close friend)
 - Guess: warm personal relationship
 - Messages: 2 (1 inbound, 1 outbound)
 - Dates: 2026-01-01 to 2026-01-01

package/examples/sample-vault/08 Sources/WhatsApp/Analysis/interpreted_relationship_models.json

@@ -1,6 +1,12 @@
 [
   {
     "chatName": "Mom",
+    "sourceSystem": "WhatsApp",
+    "displayName": "Mom (WhatsApp)",
+    "identityName": "Mom",
+    "canonicalPersonKey": "person::mom",
+    "identityConfidence": "medium",
+    "identityEvidence": "WhatsApp direct chat identity",
     "messageCount": 2,
     "inbound": 1,
     "outbound": 1,
@@ -53,6 +59,12 @@
   },
   {
     "chatName": "Project Team",
+    "sourceSystem": "WhatsApp",
+    "displayName": "Project Team (WhatsApp)",
+    "identityName": "Project Team",
+    "canonicalPersonKey": "group::whatsapp::project team",
+    "identityConfidence": "medium",
+    "identityEvidence": "group chat kept source-specific",
     "messageCount": 2,
     "inbound": 1,
     "outbound": 1,
@@ -105,6 +117,12 @@
   },
   {
     "chatName": "Close Friend",
+    "sourceSystem": "WhatsApp",
+    "displayName": "Close Friend (WhatsApp)",
+    "identityName": "Close Friend",
+    "canonicalPersonKey": "person::close friend",
+    "identityConfidence": "medium",
+    "identityEvidence": "WhatsApp direct chat identity",
     "messageCount": 2,
     "inbound": 1,
     "outbound": 1,

package/examples/sample-vault/08 Sources/WhatsApp/Analysis/person_identity_map.json

@@ -0,0 +1,78 @@
+[
+  {
+    "canonicalPersonKey": "person::mom",
+    "displayName": "Mom",
+    "aliases": [
+      "Mom"
+    ],
+    "sources": [
+      "WhatsApp"
+    ],
+    "sourceProfiles": [
+      {
+        "sourceSystem": "WhatsApp",
+        "chatName": "Mom",
+        "displayName": "Mom (WhatsApp)",
+        "messageCount": 2,
+        "firstSeen": "2026-01-01",
+        "lastSeen": "2026-01-01",
+        "relationshipGuess": "warm personal relationship",
+        "typingStyle": {
+          "sampleSize": 1,
+          "avgChars": 24.0,
+          "avgWords": 4.0,
+          "lowercaseShare": 0.0,
+          "uppercaseShare": 0.0,
+          "questionShare": 0.0,
+          "exclamationShare": 0.0,
+          "emojiShare": 0.0,
+          "slang": [],
+          "signature": "very short"
+        },
+        "identityConfidence": "medium",
+        "identityEvidence": "WhatsApp direct chat identity"
+      }
+    ],
+    "totalMessages": 2,
+    "firstSeen": "2026-01-01",
+    "lastSeen": "2026-01-01"
+  },
+  {
+    "canonicalPersonKey": "person::close friend",
+    "displayName": "Close Friend",
+    "aliases": [
+      "Close Friend"
+    ],
+    "sources": [
+      "WhatsApp"
+    ],
+    "sourceProfiles": [
+      {
+        "sourceSystem": "WhatsApp",
+        "chatName": "Close Friend",
+        "displayName": "Close Friend (WhatsApp)",
+        "messageCount": 2,
+        "firstSeen": "2026-01-01",
+        "lastSeen": "2026-01-01",
+        "relationshipGuess": "warm personal relationship",
+        "typingStyle": {
+          "sampleSize": 1,
+          "avgChars": 30.0,
+          "avgWords": 5.0,
+          "lowercaseShare": 0.0,
+          "uppercaseShare": 0.0,
+          "questionShare": 0.0,
+          "exclamationShare": 0.0,
+          "emojiShare": 0.0,
+          "slang": [],
+          "signature": "short"
+        },
+        "identityConfidence": "medium",
+        "identityEvidence": "WhatsApp direct chat identity"
+      }
+    ],
+    "totalMessages": 2,
+    "firstSeen": "2026-01-01",
+    "lastSeen": "2026-01-01"
+  }
+]

package/examples/sample-vault/08 Sources/WhatsApp/Analysis/relationship_profiles.json

@@ -1,6 +1,12 @@
 [
   {
     "chatName": "Mom",
+    "sourceSystem": "WhatsApp",
+    "displayName": "Mom (WhatsApp)",
+    "identityName": "Mom",
+    "canonicalPersonKey": "person::mom",
+    "identityConfidence": "medium",
+    "identityEvidence": "WhatsApp direct chat identity",
     "messageCount": 2,
     "inbound": 1,
     "outbound": 1,
@@ -35,6 +41,12 @@
   },
   {
     "chatName": "Project Team",
+    "sourceSystem": "WhatsApp",
+    "displayName": "Project Team (WhatsApp)",
+    "identityName": "Project Team",
+    "canonicalPersonKey": "group::whatsapp::project team",
+    "identityConfidence": "medium",
+    "identityEvidence": "group chat kept source-specific",
     "messageCount": 2,
     "inbound": 1,
     "outbound": 1,
@@ -69,6 +81,12 @@
   },
   {
     "chatName": "Close Friend",
+    "sourceSystem": "WhatsApp",
+    "displayName": "Close Friend (WhatsApp)",
+    "identityName": "Close Friend",
+    "canonicalPersonKey": "person::close friend",
+    "identityConfidence": "medium",
+    "identityEvidence": "WhatsApp direct chat identity",
     "messageCount": 2,
     "inbound": 1,
     "outbound": 1,

package/examples/sample-vault/08 Sources/WhatsApp/Raw/2026-01-01.jsonl

@@ -1,6 +1,6 @@
-{"id":"sample-1","source":"sample","timestamp":"2026-01-01T10:00:00+00:00","chatName":"Mom","isGroup":false,"fromMe":false,"author":"Mom","body":"Good morning, call me when you wake up"}
-{"id":"sample-2","source":"sample","timestamp":"2026-01-01T10:05:00+00:00","chatName":"Mom","isGroup":false,"fromMe":true,"author":"Me","body":"Morning, will call in 10"}
-{"id":"sample-3","source":"sample","timestamp":"2026-01-01T11:00:00+00:00","chatName":"Project Team","isGroup":true,"fromMe":false,"author":"Alex","body":"Can you send the deck before the client meeting?"}
-{"id":"sample-4","source":"sample","timestamp":"2026-01-01T11:03:00+00:00","chatName":"Project Team","isGroup":true,"fromMe":true,"author":"Me","body":"Yes, sending the updated deck now"}
-{"id":"sample-5","source":"sample","timestamp":"2026-01-01T20:00:00+00:00","chatName":"Close Friend","isGroup":false,"fromMe":false,"author":"Friend","body":"That was fun haha, let's plan another trip"}
-{"id":"sample-6","source":"sample","timestamp":"2026-01-01T20:02:00+00:00","chatName":"Close Friend","isGroup":false,"fromMe":true,"author":"Me","body":"Yes absolutely, that was great"}
+{"id":"sample-1","source":"sample","sourceSystem":"WhatsApp","timestamp":"2026-01-01T10:00:00+00:00","chatName":"Mom","isGroup":false,"fromMe":false,"author":"Mom","body":"Good morning, call me when you wake up"}
+{"id":"sample-2","source":"sample","sourceSystem":"WhatsApp","timestamp":"2026-01-01T10:05:00+00:00","chatName":"Mom","isGroup":false,"fromMe":true,"author":"Me","body":"Morning, will call in 10"}
+{"id":"sample-3","source":"sample","sourceSystem":"WhatsApp","timestamp":"2026-01-01T11:00:00+00:00","chatName":"Project Team","isGroup":true,"fromMe":false,"author":"Alex","body":"Can you send the deck before the client meeting?"}
+{"id":"sample-4","source":"sample","sourceSystem":"WhatsApp","timestamp":"2026-01-01T11:03:00+00:00","chatName":"Project Team","isGroup":true,"fromMe":true,"author":"Me","body":"Yes, sending the updated deck now"}
+{"id":"sample-5","source":"sample","sourceSystem":"WhatsApp","timestamp":"2026-01-01T20:00:00+00:00","chatName":"Close Friend","isGroup":false,"fromMe":false,"author":"Friend","body":"That was fun haha, let's plan another trip"}
+{"id":"sample-6","source":"sample","sourceSystem":"WhatsApp","timestamp":"2026-01-01T20:02:00+00:00","chatName":"Close Friend","isGroup":false,"fromMe":true,"author":"Me","body":"Yes absolutely, that was great"}

package/lib/fs.js

@@ -1,4 +1,5 @@
 import fs from "node:fs";
+import os from "node:os";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 
@@ -28,5 +29,37 @@ export function resolveVault(cwd) {
     if (parent === current) break;
     current = parent;
   }
+  const configured = readDefaultVault();
+  if (configured) return configured;
   return path.resolve(cwd);
 }
+
+export function globalConfigPath() {
+  return path.join(os.homedir(), ".digital-brain", "config.json");
+}
+
+export function readDefaultVault() {
+  const file = globalConfigPath();
+  if (!fs.existsSync(file)) return "";
+  try {
+    const config = JSON.parse(fs.readFileSync(file, "utf8"));
+    if (config.defaultVault && fs.existsSync(path.join(config.defaultVault, "digital-brain.config.json"))) {
+      return config.defaultVault;
+    }
+  } catch {
+    return "";
+  }
+  return "";
+}
+
+export function writeDefaultVault(vault) {
+  const file = globalConfigPath();
+  ensureDir(path.dirname(file));
+  writeFileAtomic(file, `${JSON.stringify({ defaultVault: vault }, null, 2)}\n`);
+}
+
+function writeFileAtomic(file, content) {
+  const temp = `${file}.${process.pid}.tmp`;
+  fs.writeFileSync(temp, content);
+  fs.renameSync(temp, file);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "digital-brain",
-  "version": "0.1.3",
+  "version": "1.0.3",
   "description": "Your private digital imprint for AI assistants.",
   "type": "module",
   "bin": {
@@ -29,6 +29,7 @@
     "personal-ai",
     "obsidian",
     "whatsapp",
+    "imessage",
     "local-first",
     "context"
   ],