digital-brain 0.1.7 → 1.0.3

package/README.md

@@ -46,7 +46,7 @@ npx digital-brain init --full-auto
 
 Full-auto means local repeated refreshes. It does not mean blind auto-send. WhatsApp sending still defaults to drafts or explicit confirmation, and the AI-disclosure guard stays enabled.
 
-`init` also runs a setup check. npm installs the package dependencies automatically, and Digital Brain does not require pip packages. If Python, WhatsApp for Mac, or optional Ollama setup is missing, the check prints the exact next step. See [docs/SETUP.md](docs/SETUP.md).
+`init` also runs a setup check. npm installs the package dependencies automatically, and Digital Brain does not require pip packages. If Python or a selected source is missing, the check prints the exact next step and setup link. See [docs/SETUP.md](docs/SETUP.md).
 
 For local development:
 
@@ -60,6 +60,9 @@ node ./bin/digital-brain.js init ./Digital Brain\ Vault
 - An Obsidian-friendly Markdown vault.
 - AI adapter files for Codex, Claude, and Gemini.
 - WhatsApp Mac import tools.
+- Apple iMessage import tools.
+- Slack export import tools.
+- LinkedIn data archive import tools.
 - Relationship extraction and interpretation models.
 - Optional WhatsApp Web outbound sender.
 - A refresh script based on your install-time answers.
@@ -68,10 +71,15 @@ node ./bin/digital-brain.js init ./Digital Brain\ Vault
 ## What It Can Do
 
 - Import recent WhatsApp history from the local macOS WhatsApp database.
+- Import recent iMessage history from the local macOS Messages database.
+- Import Slack workspace exports.
+- Import LinkedIn data archives for connections and messages when available.
 - Build relationship profiles from message patterns.
+- Merge confirmed-looking same-person profiles across sources into a person context index.
 - Infer provisional roles like parent, family group, work collaborator, close personal contact, or unlabeled contact.
 - Extract relationship-specific typing style: casing, message length, punctuation, emoji, and slang.
 - Generate "how to continue this relationship" notes.
+- Generate reply-ready person context that keeps WhatsApp, iMessage, Slack, and LinkedIn evidence separate under the same person.
 - Create AI-readable memory files for future prompts.
 - Draft WhatsApp sends by default, and only send with explicit `--yes`.
 - Enforce an AI-disclosure guard after repeated AI-assisted sends.
@@ -82,10 +90,15 @@ node ./bin/digital-brain.js init ./Digital Brain\ Vault
 digital-brain init
 digital-brain run
 digital-brain doctor
+digital-brain sync-imessage --days 30
+digital-brain import-slack --input ./slack-export.zip
+digital-brain import-linkedin --input ./linkedin-archive.zip
 digital-brain send-whatsapp --to "Name" --message "text"
 ```
 
-`init` remembers your vault globally, so `run` works from anywhere. `run` syncs WhatsApp, extracts relationships, and writes interpreted memory in one command.
+`init` remembers your vault globally, so `run` works from anywhere. `run` syncs the live local sources you selected, extracts relationships, and writes interpreted memory in one command.
+
+Slack and LinkedIn are import-based. Digital Brain reads official export archives; it does not scrape LinkedIn or automate private app UIs. See [docs/INTEGRATIONS.md](docs/INTEGRATIONS.md).
 
 Use `digital-brain doctor` or `digital-brain tutorial` anytime to see dependency status and next steps.
 
@@ -93,6 +106,7 @@ The lower-level commands still exist for debugging:
 
 ```bash
 digital-brain sync-whatsapp
+digital-brain sync-imessage
 digital-brain extract
 digital-brain interpret
 ```
@@ -145,6 +159,10 @@ Digital Brain is local-first. It does not upload messages or notes.
 
 WhatsApp support reads the local macOS WhatsApp database when available. This is experimental and unofficial. Outbound messaging uses WhatsApp Web through `whatsapp-web.js`.
 
+Apple iMessage support reads the local macOS Messages `chat.db` when available. If the database is missing or inaccessible and iMessage was selected, `digital-brain run` fails with a clear setup error instead of silently skipping it.
+
+Slack support reads Slack workspace export JSON. LinkedIn support reads LinkedIn data archive CSV files when LinkedIn includes the relevant files in your archive.
+
 Relationship labels are working notes, not truth. You can edit them with `relationship_overrides.json`.
 
 Always-on and outbound modes depend on local app databases, WhatsApp Web, and third-party behavior that can change. You are responsible for consent, privacy, message content, and anything sent from your machine.

package/bin/digital-brain.js

@@ -8,6 +8,7 @@ import { fileURLToPath } from "node:url";
 import { copyDir, ensureDir, packageRoot, resolveVault, writeDefaultVault } from "../lib/fs.js";
 
 const root = packageRoot(import.meta.url);
+const CONFIG_SCHEMA_VERSION = 1;
 
 main().catch((error) => {
   console.error(error.message);
@@ -23,6 +24,9 @@ async function main() {
   else if (command === "doctor") doctor();
   else if (command === "tutorial" || command === "setup-check") doctor({ tutorial: true });
   else if (command === "sync-whatsapp") runPython("digital_brain_whatsapp_mac_sync.py", argv);
+  else if (command === "sync-imessage") runPython("digital_brain_imessage_sync.py", argv);
+  else if (command === "import-slack") runPython("digital_brain_slack_export_import.py", argv);
+  else if (command === "import-linkedin") runPython("digital_brain_linkedin_export_import.py", argv);
   else if (command === "extract") runPython("digital_brain_relationship_extractor.py", argv);
   else if (command === "interpret") runPython("digital_brain_relationship_interpreter.py", argv);
   else if (command === "send-whatsapp") runNode("whatsapp-web/send.mjs", argv);
@@ -44,6 +48,9 @@ async function init(argv, args) {
   let activeWindow = args["active-window"] || "08:00-12:00";
   let timezone = args.timezone || Intl.DateTimeFormat().resolvedOptions().timeZone || "local";
   let outboundMode = args["outbound-mode"] || "draft";
+  let privacyMode = args["privacy-mode"] || "standard";
+  let sourceMarkdownMode = args["source-markdown-mode"] || "none";
+  let selectedSources = parseList(args.sources || "whatsapp");
   let responsibilityAccepted = fullAuto || schedule === "always-on";
 
   if (!args.yes) {
@@ -81,6 +88,16 @@ async function init(argv, args) {
       });
     }
     activeWindow = await ask(rl, "🪟 Active window for frequent refreshes", activeWindow);
+    selectedSources = await multiSelect(rl, "Sources to set up", [
+      ["whatsapp", "WhatsApp Mac", "Live local sync from WhatsApp for Mac database.", "💚"],
+      ["imessage", "Apple iMessage", "Live local sync from macOS Messages database.", "💬"],
+      ["slack", "Slack export", "Import official Slack workspace export ZIP/folder.", "🧵"],
+      ["linkedin", "LinkedIn archive", "Import official LinkedIn data archive ZIP/folder.", "💼"],
+    ], selectedSources);
+    privacyMode = await select(rl, "Privacy mode", [
+      ["standard", "Standard", "Keep raw JSONL locally for analysis, but do not generate raw chat Markdown.", "🔐"],
+      ["metadata-only", "Metadata only", "Store timestamps and participants, but omit message bodies.", "🧼"],
+    ], privacyMode);
     outboundMode = await select(rl, "WhatsApp outbound mode", [
       ["disabled", "Disabled", "Never prepares WhatsApp sends.", "🔒"],
       ["draft", "Draft only", "Prepares text and requires you to send it.", "✍️"],
@@ -100,6 +117,7 @@ async function init(argv, args) {
   ensureDir(vault);
   copyDir(path.join(root, "templates", "vault"), vault);
   const config = {
+    schemaVersion: CONFIG_SCHEMA_VERSION,
     selfName: selfName || "Me",
     dataWindowDays,
     focus: focus || "relationship-memory",
@@ -108,6 +126,10 @@ async function init(argv, args) {
     activeWindow,
     timezone,
     outboundMode,
+    privacyMode,
+    sourceMarkdownMode,
+    selectedSources,
+    outboundLogMode: args["outbound-log-mode"] || "metadata",
     setupMode,
     responsibilityAccepted,
     defaults: {
@@ -157,17 +179,34 @@ function runRefresh(argv, args) {
   const vault = getVaultFromArgs(argv);
   const config = readVaultConfig(vault);
   const days = String(args.days || args["data-window-days"] || config.dataWindowDays || 30);
-  const syncArgs = ["--vault", vault, "--days", days, "--markdown-mode", args["markdown-mode"] || "month"];
+  const markdownMode = args["markdown-mode"] || config.sourceMarkdownMode || "none";
+  const privacyMode = args["privacy-mode"] || config.privacyMode || "standard";
+  const selectedSources = parseList(args.sources || "").length ? parseList(args.sources) : config.selectedSources || ["whatsapp"];
+  const syncArgs = ["--vault", vault, "--days", days, "--markdown-mode", markdownMode, "--privacy-mode", privacyMode];
   const extractArgs = ["--vault", vault, "--days", days];
   const interpretArgs = ["--vault", vault, "--days", days];
   if (args["min-messages"]) extractArgs.push("--min-messages", String(args["min-messages"]));
   console.log(`Digital Brain refresh: ${vault}`);
-  for (const [label, script, stepArgs] of [
-    ["sync", "digital_brain_whatsapp_mac_sync.py", syncArgs],
-    ["extract", "digital_brain_relationship_extractor.py", extractArgs],
-    ["interpret", "digital_brain_relationship_interpreter.py", interpretArgs],
-  ]) {
-    if (toBoolean(args[`skip-${label}`])) {
+  if (toBoolean(args["dry-run"])) {
+    console.log("Dry run. Planned steps:");
+    if (selectedSources.includes("whatsapp")) console.log(`  sync WhatsApp: days=${days}, markdown=${markdownMode}, privacy=${privacyMode}`);
+    if (selectedSources.includes("imessage")) console.log(`  sync iMessage: days=${days}, markdown=${markdownMode}, privacy=${privacyMode}`);
+    if (selectedSources.includes("slack")) console.log("  Slack: import-only; run digital-brain import-slack --input <export.zip>");
+    if (selectedSources.includes("linkedin")) console.log("  LinkedIn: import-only; run digital-brain import-linkedin --input <archive.zip>");
+    console.log(`  extract relationships: days=${days}`);
+    console.log(`  interpret relationship drafts: days=${days}`);
+    return;
+  }
+  const steps = [];
+  if (selectedSources.includes("whatsapp")) steps.push(["sync WhatsApp", "sync-whatsapp", "digital_brain_whatsapp_mac_sync.py", syncArgs]);
+  if (selectedSources.includes("imessage")) steps.push(["sync iMessage", "sync-imessage", "digital_brain_imessage_sync.py", syncArgs]);
+  steps.push(
+    ["extract", "extract", "digital_brain_relationship_extractor.py", extractArgs],
+    ["interpret", "interpret", "digital_brain_relationship_interpreter.py", interpretArgs],
+  );
+  for (const [label, skipKey, script, stepArgs] of steps) {
+    const skipRequested = toBoolean(args[`skip-${skipKey}`]) || (skipKey.startsWith("sync-") && toBoolean(args["skip-sync"]));
+    if (skipRequested) {
       console.log(`\n→ ${label} skipped`);
       continue;
     }
@@ -208,10 +247,13 @@ function readVaultConfig(vault) {
 }
 
 function printSetupCheck(vault, options = {}) {
+  const config = fs.existsSync(path.join(vault, "digital-brain.config.json")) ? readVaultConfig(vault) : {};
+  const selectedSources = config.selectedSources || ["whatsapp"];
   const pythonVersion = shell("python3", ["--version"], true);
   const pythonSqlite = shell("python3", ["-c", "import sqlite3; print('ok')"], true);
   const ollamaVersion = shell("ollama", ["--version"], true);
   const macDb = path.join(os.homedir(), "Library/Group Containers/group.net.whatsapp.WhatsApp.shared/ChatStorage.sqlite");
+  const messagesDb = path.join(os.homedir(), "Library/Messages/chat.db");
   const checks = [
     {
       label: "Node",
@@ -236,12 +278,6 @@ function printSetupCheck(vault, options = {}) {
       value: pythonSqlite === "ok" ? "available" : "not found",
       hint: "Use a Python 3 build with sqlite3 support.",
     },
-    {
-      label: "WhatsApp Mac database",
-      ok: fs.existsSync(macDb),
-      value: fs.existsSync(macDb) ? "found" : "not found yet",
-      hint: "Open WhatsApp for Mac and log in. If macOS blocks access, grant Terminal Full Disk Access.",
-    },
     {
       label: "Ollama",
       ok: Boolean(ollamaVersion),
@@ -250,6 +286,38 @@ function printSetupCheck(vault, options = {}) {
       optional: true,
     },
   ];
+  if (selectedSources.includes("whatsapp")) {
+    checks.push({
+      label: "WhatsApp Mac database",
+      ok: fs.existsSync(macDb),
+      value: fs.existsSync(macDb) ? "found" : "not found yet",
+      hint: "Install/open WhatsApp for Mac, log in, then grant Terminal Full Disk Access if needed: https://faq.whatsapp.com/686469079565350",
+    });
+  }
+  if (selectedSources.includes("imessage")) {
+    checks.push({
+      label: "Apple Messages database",
+      ok: fs.existsSync(messagesDb),
+      value: fs.existsSync(messagesDb) ? "found" : "not found yet",
+      hint: "Open Messages on macOS and grant Terminal Full Disk Access if needed: https://support.apple.com/guide/messages/welcome/mac",
+    });
+  }
+  if (selectedSources.includes("slack")) {
+    checks.push({
+      label: "Slack export",
+      ok: true,
+      value: "import manually",
+      hint: "Export guide: https://slack.com/help/articles/201658943-Export-your-workspace-data",
+    });
+  }
+  if (selectedSources.includes("linkedin")) {
+    checks.push({
+      label: "LinkedIn archive",
+      ok: true,
+      value: "import manually",
+      hint: "Export guide: https://www.linkedin.com/help/linkedin/answer/a566336",
+    });
+  }
 
   console.log("");
   console.log("Setup check");
@@ -268,16 +336,28 @@ function printSetupCheck(vault, options = {}) {
   if (options.tutorial) {
     console.log("");
     console.log("How to use it");
-    console.log("  1. Open WhatsApp for Mac once and keep it logged in.");
-    console.log("  2. Run: digital-brain run");
-    console.log("  3. Ask your AI to use the generated vault notes for personal context.");
+    let step = 1;
+    if (selectedSources.includes("whatsapp")) {
+      console.log(`  ${step++}. Open WhatsApp for Mac once and keep it logged in.`);
+    }
+    if (selectedSources.includes("imessage")) {
+      console.log(`  ${step++}. Open Messages on macOS once and grant Terminal Full Disk Access if needed.`);
+    }
+    if (selectedSources.includes("slack")) {
+      console.log(`  ${step++}. Download a Slack export, then run: digital-brain import-slack --input <export.zip>`);
+    }
+    if (selectedSources.includes("linkedin")) {
+      console.log(`  ${step++}. Download a LinkedIn archive, then run: digital-brain import-linkedin --input <archive.zip>`);
+    }
+    console.log(`  ${step++}. Run: digital-brain run`);
+    console.log(`  ${step}. Ask your AI to use the generated vault notes for personal context.`);
     console.log("");
     console.log("No pip install is needed. npm installs the package dependencies.");
   }
 }
 
 function writeConfig(vault, config) {
-  fs.writeFileSync(path.join(vault, "digital-brain.config.json"), `${JSON.stringify(config, null, 2)}\n`);
+  writeFileAtomic(path.join(vault, "digital-brain.config.json"), `${JSON.stringify(config, null, 2)}\n`);
 }
 
 function writeRefreshScript(vault, config) {
@@ -290,12 +370,12 @@ set -euo pipefail
 VAULT="${vault.replace(/"/g, '\\"')}"
 DAYS="${days}"
 
-digital-brain run --vault "$VAULT" --days "$DAYS" --markdown-mode month
+digital-brain run --vault "$VAULT" --days "$DAYS"
 
 echo "Digital Brain refresh complete for $VAULT"
 `;
   const scriptPath = path.join(toolsDir, "digital-brain-refresh.sh");
-  fs.writeFileSync(scriptPath, content);
+  writeFileAtomic(scriptPath, content);
   fs.chmodSync(scriptPath, 0o755);
 }
 
@@ -318,7 +398,7 @@ while true; do
 done
 `;
   const scriptPath = path.join(toolsDir, "digital-brain-watch.sh");
-  fs.writeFileSync(scriptPath, content);
+  writeFileAtomic(scriptPath, content);
   fs.chmodSync(scriptPath, 0o755);
 }
 
@@ -339,6 +419,12 @@ Use it as local personal context when the user asks about preferences, relations
   console.log(`${label} pointer: ${file}`);
 }
 
+function writeFileAtomic(file, content) {
+  const temp = `${file}.${process.pid}.tmp`;
+  fs.writeFileSync(temp, content);
+  fs.renameSync(temp, file);
+}
+
 function printSetupHeader(defaultVault) {
   console.log("");
   console.log("╭────────────────────────────────────────╮");
@@ -386,6 +472,28 @@ async function select(rl, label, options, fallback) {
   return exact ? exact[0] : options[defaultIndex][0];
 }
 
+async function multiSelect(rl, label, options, fallbackValues) {
+  const fallback = fallbackValues.length ? fallbackValues : [options[0][0]];
+  console.log("");
+  console.log(`◇ ${label}`);
+  options.forEach(([, title, description, icon = "•"], index) => {
+    const selected = fallback.includes(options[index][0]) ? "  ← default" : "";
+    const letter = letterFor(index);
+    console.log(`  ${letter}) ${icon}  ${title}${selected}`);
+    console.log(`     ${description}`);
+  });
+  const answer = await rl.question(`Choose one or more, comma-separated [${fallback.join(",")}]: `);
+  if (!answer.trim()) return fallback;
+  const values = [];
+  for (const token of answer.split(",").map((value) => value.trim()).filter(Boolean)) {
+    const letterIndex = indexFromLetter(token);
+    const numericIndex = Number(token) - 1;
+    const option = options[letterIndex] || options[numericIndex] || options.find(([value, title]) => value === token || title.toLowerCase() === token.toLowerCase());
+    if (option && !values.includes(option[0])) values.push(option[0]);
+  }
+  return values.length ? values : fallback;
+}
+
 async function confirm(rl, label, fallback) {
   const hint = fallback ? "Y/n" : "y/N";
   const answer = (await rl.question(`${label} [${hint}]: `)).trim().toLowerCase();
@@ -443,6 +551,11 @@ function parseArgs(argv) {
   return out;
 }
 
+function parseList(value) {
+  if (!value) return [];
+  return String(value).split(",").map((item) => item.trim()).filter(Boolean);
+}
+
 function toBoolean(value) {
   if (value === undefined) return false;
   if (value === true) return true;
@@ -464,6 +577,9 @@ Usage:
   digital-brain doctor
   digital-brain tutorial
   digital-brain sync-whatsapp --days 30
+  digital-brain sync-imessage --days 30
+  digital-brain import-slack --input slack-export.zip
+  digital-brain import-linkedin --input linkedin-archive.zip
   digital-brain extract --days 30
   digital-brain interpret --days 30
   digital-brain send-whatsapp --to "Name" --message "Text" [--yes]

package/docs/INTEGRATIONS.md

@@ -0,0 +1,72 @@
+# Integrations
+
+Digital Brain prefers official exports and local files over scraping.
+
+## WhatsApp
+
+```bash
+digital-brain run
+```
+
+WhatsApp support reads the local macOS WhatsApp database when available.
+
+Dependency selected in setup:
+
+- Install/open WhatsApp for Mac and log in: https://faq.whatsapp.com/686469079565350
+- If macOS blocks access, grant Full Disk Access to the terminal app running Digital Brain.
+- If WhatsApp is selected and the database is missing, `digital-brain run` exits with an error.
+
+## Apple iMessage
+
+```bash
+digital-brain sync-imessage --days 30
+digital-brain extract
+digital-brain interpret
+```
+
+iMessage support reads the local macOS Messages database at `~/Library/Messages/chat.db`.
+
+Dependency selected in setup:
+
+- Open Messages on macOS at least once: https://support.apple.com/guide/messages/welcome/mac
+- If macOS blocks access, grant Full Disk Access to the terminal app running Digital Brain.
+- If iMessage is selected and the database is missing, `digital-brain run` exits with an error.
+
+## Slack
+
+Use Slack's official workspace export ZIP or extracted export folder.
+
+```bash
+digital-brain import-slack --input ./slack-export.zip
+digital-brain extract
+digital-brain interpret
+```
+
+Slack export access depends on workspace permissions and plan. Public-channel exports are common; private channels and DMs may require elevated workspace export permissions.
+
+Export guide: https://slack.com/help/articles/201658943-Export-your-workspace-data
+
+## LinkedIn
+
+Use LinkedIn's official data archive ZIP or extracted archive folder.
+
+```bash
+digital-brain import-linkedin --input ./linkedin-archive.zip
+digital-brain extract
+digital-brain interpret
+```
+
+Digital Brain does not scrape LinkedIn or automate the LinkedIn app. LinkedIn controls what appears in the archive, so connections/messages may vary by account and export type.
+
+Data archive guide: https://www.linkedin.com/help/linkedin/answer/a566336
+
+## Useful Next Sources
+
+- Calendar: recurring people, meetings, and relationship cadence.
+- Email export: long-form relationship and work context, but privacy risk is high.
+- GitHub: collaborators, repos, review style, and work graph.
+- Linear/Jira: active projects and operating context.
+- Contacts: canonical names, phones, companies, and relationship labels.
+- Browser bookmarks/read-later: interests and research areas.
+
+The right rule: add sources that improve memory without turning Digital Brain into spyware. Prefer explicit exports, clear consent, and source-specific privacy controls.

package/docs/PRIVACY.md

@@ -7,13 +7,15 @@ Digital Brain is designed for local use.
 - No cloud API is called by default.
 - Ollama interpretation is local when enabled.
 - WhatsApp sending uses a local WhatsApp Web session.
+- Raw source data stays under `08 Sources/`; normal AI context should use `06 AI Memory/` and human notes under `04 People/`.
+- Same-person matching across sources is provisional and file-based; keep source evidence visible when using merged person context.
 
 Things to be careful about:
 
 - Do not commit a generated vault.
 - Do not paste private message exports into GitHub issues.
 - Do not enable outbound sending without understanding the risk.
-- Treat WhatsApp database access and WhatsApp Web automation as unofficial, changeable integrations.
+- Treat WhatsApp database access, iMessage database access, and WhatsApp Web automation as local, permission-sensitive integrations that can change.
 - Always-on mode runs on your machine and inherits your local permissions.
 - You are responsible for consent, privacy, message content, and sends made from your machine.
 - Treat relationship labels as editable working notes, not truth.

package/docs/SETUP.md

@@ -16,7 +16,12 @@ After the quiz, `init` runs a setup check for:
 - npm package dependencies
 - Python 3
 - Python sqlite3 support
-- WhatsApp for Mac local database access
+- selected live source access:
+  - WhatsApp for Mac local database access
+  - Apple Messages local database access
+- selected import source instructions:
+  - Slack export link
+  - LinkedIn archive link
 - optional Ollama
 
 Run the check again anytime:
@@ -36,11 +41,38 @@ digital-brain tutorial
 Digital Brain does not silently install or configure system apps.
 
 - WhatsApp for Mac must be installed and logged in by the user.
+- Apple Messages must be opened by the user before iMessage sync can read `~/Library/Messages/chat.db`.
 - macOS may require Full Disk Access for the terminal app.
 - Ollama is optional and only needed for local LLM workflows.
 
+Useful links:
+
+- Node: https://nodejs.org
+- WhatsApp for Mac: https://faq.whatsapp.com/686469079565350
+- Apple Messages: https://support.apple.com/guide/messages/welcome/mac
+- Slack exports: https://slack.com/help/articles/201658943-Export-your-workspace-data
+- LinkedIn data archive: https://www.linkedin.com/help/linkedin/answer/a566336
+
 Once setup passes, normal use is:
 
 ```bash
 digital-brain run
 ```
+
+`run` executes the live local sources selected during setup. If a selected live source does not exist or cannot be opened, the command fails with a setup error.
+
+Optional imports:
+
+```bash
+digital-brain import-slack --input ./slack-export.zip
+digital-brain import-linkedin --input ./linkedin-archive.zip
+digital-brain extract
+digital-brain interpret
+```
+
+Useful direct sync commands:
+
+```bash
+digital-brain sync-whatsapp --days 30
+digital-brain sync-imessage --days 30
+```

package/examples/sample-vault/{04 People/Interpreted Relationships/Close Friend.md → 06 AI Memory/Generated Relationship Drafts/Close Friend (WhatsApp).md }

@@ -1,13 +1,14 @@
-# Close Friend
+# Close Friend (WhatsApp)
 
-Generated: 2026-06-09T22:26:26.131803+00:00
+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
 
-These are private working notes. Edit them where wrong.
+Generated draft, not truth. These are private working notes. Edit them where wrong.
 
 ## Role / Relationship Label
 - operational contact (low confidence).

package/examples/sample-vault/{04 People/Interpreted Relationships/Mom.md → 06 AI Memory/Generated Relationship Drafts/Mom (WhatsApp).md }

@@ -1,13 +1,14 @@
-# Mom
+# Mom (WhatsApp)
 
-Generated: 2026-06-09T22:26:26.131148+00:00
+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
 
-These are private working notes. Edit them where wrong.
+Generated draft, not truth. These are private working notes. Edit them where wrong.
 
 ## Role / Relationship Label
 - mother (high confidence).

package/examples/sample-vault/{08 Sources/WhatsApp/Analysis/Interpreted/Project Team.md → 06 AI Memory/Generated Relationship Drafts/Project Team (WhatsApp).md }

@@ -1,13 +1,14 @@
-# Project Team
+# Project Team (WhatsApp)
 
-Generated: 2026-06-09T22:26:26.131626+00:00
+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
 
-These are private working notes. Edit them where wrong.
+Generated draft, not truth. These are private working notes. Edit them where wrong.
 
 ## Role / Relationship Label
 - work collaborator (medium confidence).

package/examples/sample-vault/06 AI Memory/Interpreted Relationship Memory.md

@@ -2,6 +2,6 @@
 
 Generated working notes. Treat as editable, not truth.
 
-- [[Mom]]: mother (high), closeness medium, difficulty low, style very short
-- [[Project Team]]: work collaborator (medium), closeness low/unclear, difficulty practical/low-emotional, style short
-- [[Close Friend]]: operational contact (low), closeness medium, difficulty low, style short
+- [[Mom (WhatsApp)]]: mother (high), closeness medium, difficulty low, style very short
+- [[Project Team (WhatsApp)]]: work collaborator (medium), closeness low/unclear, difficulty practical/low-emotional, style short
+- [[Close Friend (WhatsApp)]]: operational contact (low), closeness medium, difficulty low, style short

package/examples/sample-vault/06 AI Memory/Person Context Index.md

@@ -0,0 +1,26 @@
+# Person Context Index
+
+Window: last 365 days
+
+Canonical people matched across sources. Treat matches as provisional unless manually confirmed.
+
+## Mom
+
+- Canonical key: `person::mom`
+- Aliases: Mom
+- Sources: WhatsApp
+- Messages: 2
+- Dates: 2026-01-01 to 2026-01-01
+- Source-specific context:
+  - WhatsApp / Mom: warm personal relationship; 2 messages; style very short; avg 4.0 words; lowercase 0.0; emoji 0.0; slang none
+
+## Close Friend
+
+- Canonical key: `person::close friend`
+- Aliases: Close Friend
+- Sources: WhatsApp
+- Messages: 2
+- Dates: 2026-01-01 to 2026-01-01
+- Source-specific context:
+  - WhatsApp / Close Friend: warm personal relationship; 2 messages; style short; avg 5.0 words; lowercase 0.0; emoji 0.0; slang none
+

package/examples/sample-vault/06 AI Memory/Person Reply Context.md

@@ -0,0 +1,26 @@
+# Person Reply Context
+
+Use this first when responding to a specific person. It merges confirmed-looking matches across sources while keeping each source visible.
+
+## Mom
+
+- Canonical key: `person::mom`
+- Aliases: Mom
+- Sources: WhatsApp
+- Total messages: 2
+- Source-specific guidance:
+  - WhatsApp / Mom: mother (high), closeness medium, difficulty low.
+    Style: very short.
+    Reply: Keep replies very short unless context demands detail. Match style without exaggerating or parodying the person.
+
+## Close Friend
+
+- Canonical key: `person::close friend`
+- Aliases: Close Friend
+- Sources: WhatsApp
+- Total messages: 2
+- Source-specific guidance:
+  - WhatsApp / Close Friend: operational contact (low), closeness medium, difficulty low.
+    Style: short.
+    Reply: Keep replies very short unless context demands detail. Match style without exaggerating or parodying the person.
+

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

@@ -1,13 +1,14 @@
-# Close Friend
+# Close Friend (WhatsApp)
 
-Generated: 2026-06-09T22:26:26.131803+00:00
+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
 
-These are private working notes. Edit them where wrong.
+Generated draft, not truth. These are private working notes. Edit them where wrong.
 
 ## Role / Relationship Label
 - operational contact (low confidence).

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

@@ -1,13 +1,14 @@
-# Mom
+# Mom (WhatsApp)
 
-Generated: 2026-06-09T22:26:26.131148+00:00
+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
 
-These are private working notes. Edit them where wrong.
+Generated draft, not truth. These are private working notes. Edit them where wrong.
 
 ## Role / Relationship Label
 - mother (high confidence).