digital-brain 0.1.0 → 0.1.3

package/README.md

@@ -24,7 +24,27 @@ Digital Brain gives them a structured, local map of:
 npx digital-brain init
 ```
 
-The installer asks a short setup quiz: history window, primary focus, refresh cadence, active time window, outbound mode, and AI adapter setup.
+The installer asks a short setup quiz: history window, primary focus, refresh cadence, always-on interval, active time window, outbound mode, and AI adapter setup.
+
+The quiz is mostly multiple choice. Pick with `A/B/C`, `1/2/3`, the exact value, or press Enter to accept the default. If you skip the vault path, Digital Brain creates a new folder in the current directory:
+
+```text
+./Digital Brain Vault
+```
+
+For a non-interactive setup:
+
+```bash
+npx digital-brain init --yes
+```
+
+For local always-on setup:
+
+```bash
+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.
 
 For local development:
 
@@ -41,12 +61,14 @@ node ./bin/digital-brain.js init ./Digital Brain\ Vault
 - Relationship extraction and interpretation models.
 - Optional WhatsApp Web outbound sender.
 - A refresh script based on your install-time answers.
+- An optional always-on watch script that can pull every N minutes.
 
 ## What It Can Do
 
 - Import recent WhatsApp history from the local macOS WhatsApp database.
 - Build relationship profiles from message patterns.
 - 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.
 - Create AI-readable memory files for future prompts.
 - Draft WhatsApp sends by default, and only send with explicit `--yes`.
@@ -74,7 +96,13 @@ Each vault gets:
 Tools/digital-brain-refresh.sh
 ```
 
-Use it with Codex automations, local cron, launchd, or another scheduler. See [docs/AUTOMATIONS.md](docs/AUTOMATIONS.md).
+For 24/7 local polling:
+
+```bash
+Tools/digital-brain-watch.sh
+```
+
+Use these with Codex automations, local cron, launchd, or another scheduler. See [docs/AUTOMATIONS.md](docs/AUTOMATIONS.md).
 
 ## Example
 
@@ -106,6 +134,8 @@ WhatsApp support reads the local macOS WhatsApp database when available. This is
 
 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.
+
 ## Status
 
 Alpha. Expect rough edges.

package/bin/digital-brain.js

@@ -30,26 +30,56 @@ async function main() {
 async function init(argv, args) {
   const positional = argv.filter((arg) => !arg.startsWith("--"));
   const defaultVault = path.resolve(process.cwd(), "Digital Brain Vault");
+  const fullAuto = toBoolean(args["full-auto"]);
   let vault = positional[0] ? path.resolve(positional[0]) : args.yes ? defaultVault : "";
   let selfName = args["self-name"] || "";
   let connectAi = toBoolean(args["connect-ai"]);
   let dataWindowDays = Number(args["data-window-days"] || 30);
   let focus = args.focus || "";
-  let schedule = args.schedule || "manual";
+  let schedule = args.schedule || (fullAuto ? "always-on" : "manual");
+  let refreshIntervalMinutes = clampInterval(args["refresh-interval-minutes"] || 5);
   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 responsibilityAccepted = fullAuto || schedule === "always-on";
 
   if (!args.yes) {
     const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-    vault ||= path.resolve(await ask(rl, "Vault path", defaultVault));
-    selfName ||= await ask(rl, "Your name", "Me");
-    dataWindowDays = Number(await ask(rl, "How much history should Digital Brain import by default? Days", String(dataWindowDays)));
-    focus ||= await ask(rl, "What should it optimize for? relationship-memory / reply-help / work-context", "relationship-memory");
-    schedule = await ask(rl, "How often should refresh guidance run? manual / hourly / every-30-min / daily", schedule);
-    activeWindow = await ask(rl, "Active window for frequent refreshes", activeWindow);
-    outboundMode = await ask(rl, "WhatsApp outbound mode? disabled / draft / send-with-confirmation", outboundMode);
-    connectAi = /^y/i.test(await ask(rl, "Add global AI pointers for Codex/Claude/Gemini?", "y"));
+    printSetupHeader(defaultVault);
+    vault ||= path.resolve(await ask(rl, "📁 Vault path", defaultVault, "Enter creates this folder if it does not exist."));
+    selfName ||= await ask(rl, "👤 Your name", "Me");
+    dataWindowDays = await askNumber(rl, "🕰️  History to import", dataWindowDays, { suffix: "days", min: 1 });
+    focus ||= await select(rl, "Primary focus", [
+      ["relationship-memory", "Relationship memory", "Map people, tone, and recurring patterns.", "🧠"],
+      ["reply-help", "Reply help", "Prioritize drafting guidance and typing-style matching.", "💬"],
+      ["work-context", "Work context", "Prioritize collaborators, projects, and operational notes.", "💼"],
+    ], "relationship-memory");
+    schedule = await select(rl, "Refresh cadence", [
+      ["manual", "Manual", "Only runs when you run a command.", "🖐️"],
+      ["daily", "Daily", "Good for a low-maintenance personal vault.", "🌅"],
+      ["hourly", "Hourly", "Keeps memory warm without running constantly.", "⏱️"],
+      ["every-30-min", "Every 30 minutes", "Useful for morning or work-window guidance.", "🔁"],
+      ["always-on", "Always-on local loop", "Runs repeatedly while your computer is awake.", "⚡"],
+    ], schedule);
+    if (schedule === "always-on") {
+      refreshIntervalMinutes = await askNumber(rl, "⏳ Always-on pull interval", refreshIntervalMinutes, {
+        suffix: "minutes",
+        min: 1,
+      });
+    }
+    activeWindow = await ask(rl, "🪟 Active window for frequent refreshes", activeWindow);
+    outboundMode = await select(rl, "WhatsApp outbound mode", [
+      ["disabled", "Disabled", "Never prepares WhatsApp sends.", "🔒"],
+      ["draft", "Draft only", "Prepares text and requires you to send it.", "✍️"],
+      ["send-with-confirmation", "Send with confirmation", "Can send only after explicit command confirmation.", "✅"],
+    ], outboundMode);
+    connectAi = await confirm(rl, "🔗 Add global AI pointers for Codex/Claude/Gemini?", true);
+    responsibilityAccepted = await responsibilityGate(rl, { schedule, outboundMode });
+    if (!responsibilityAccepted && (schedule === "always-on" || outboundMode === "send-with-confirmation")) {
+      console.log("Full-auto/outbound confirmation was not accepted. Using manual refresh and draft-only outbound.");
+      schedule = "manual";
+      outboundMode = "draft";
+    }
     rl.close();
   }
 
@@ -60,9 +90,18 @@ async function init(argv, args) {
     dataWindowDays,
     focus: focus || "relationship-memory",
     schedule,
+    refreshIntervalMinutes,
     activeWindow,
     timezone,
     outboundMode,
+    setupMode: fullAuto ? "full-auto" : "guided",
+    responsibilityAccepted,
+    defaults: {
+      enterUsesDefault: true,
+      defaultVault,
+      skippedVaultCreates: defaultVault,
+      minimumRefreshIntervalMinutes: 1,
+    },
     disclosureRule: {
       enabled: true,
       discloseAfterAiAssistedSends: 2,
@@ -71,6 +110,7 @@ async function init(argv, args) {
   };
   writeConfig(vault, config);
   writeRefreshScript(vault, config);
+  writeWatchScript(vault, config);
 
   if (connectAi) {
     addGlobalPointer(path.join(os.homedir(), ".codex", "AGENTS.md"), vault, "Codex");
@@ -81,10 +121,12 @@ async function init(argv, args) {
   console.log(`Digital Brain vault created: ${vault}`);
   console.log(`Config: ${path.join(vault, "digital-brain.config.json")}`);
   console.log(`Refresh script: ${path.join(vault, "Tools", "digital-brain-refresh.sh")}`);
+  console.log(`Always-on script: ${path.join(vault, "Tools", "digital-brain-watch.sh")}`);
   console.log("Next:");
   console.log(`  digital-brain sync-whatsapp --vault "${vault}" --days ${dataWindowDays}`);
   console.log(`  digital-brain extract --vault "${vault}" --days ${dataWindowDays}`);
   console.log(`  digital-brain interpret --vault "${vault}" --days ${dataWindowDays}`);
+  if (schedule === "always-on") console.log(`  "${path.join(vault, "Tools", "digital-brain-watch.sh")}"`);
 }
 
 function doctor() {
@@ -142,6 +184,29 @@ echo "Digital Brain refresh complete for $VAULT"
   fs.chmodSync(scriptPath, 0o755);
 }
 
+function writeWatchScript(vault, config) {
+  const toolsDir = path.join(vault, "Tools");
+  ensureDir(toolsDir);
+  const interval = clampInterval(config.refreshIntervalMinutes || 5);
+  const content = `#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+INTERVAL_MINUTES="${interval}"
+
+echo "Digital Brain watch loop started. Interval: $INTERVAL_MINUTES minute(s)."
+echo "Press Ctrl+C to stop."
+
+while true; do
+  "$SCRIPT_DIR/digital-brain-refresh.sh"
+  sleep "$((INTERVAL_MINUTES * 60))"
+done
+`;
+  const scriptPath = path.join(toolsDir, "digital-brain-watch.sh");
+  fs.writeFileSync(scriptPath, content);
+  fs.chmodSync(scriptPath, 0o755);
+}
+
 function addGlobalPointer(file, vault, label) {
   ensureDir(path.dirname(file));
   const block = `
@@ -159,11 +224,81 @@ Use it as local personal context when the user asks about preferences, relations
   console.log(`${label} pointer: ${file}`);
 }
 
-async function ask(rl, label, fallback) {
-  const answer = await rl.question(`${label} (${fallback}): `);
+function printSetupHeader(defaultVault) {
+  console.log("");
+  console.log("╭────────────────────────────────────────╮");
+  console.log("│ 🧠 Digital Brain setup                 │");
+  console.log("╰────────────────────────────────────────╯");
+  console.log("Pick with A/B/C, 1/2/3, exact value, or press Enter for the default.");
+  console.log(`Skipping the vault path creates: ${defaultVault}`);
+  console.log("");
+}
+
+async function ask(rl, label, fallback, helpText = "") {
+  if (helpText) console.log(`  ${helpText}`);
+  const answer = await rl.question(`${label} [${fallback}]: `);
   return answer.trim() || fallback;
 }
 
+async function askNumber(rl, label, fallback, options = {}) {
+  const suffix = options.suffix ? ` ${options.suffix}` : "";
+  const answer = await ask(rl, `${label}${suffix}`, String(fallback));
+  const parsed = Number(answer);
+  if (!Number.isFinite(parsed)) return Number(fallback);
+  if (Number.isFinite(options.min) && parsed < options.min) return options.min;
+  return Math.floor(parsed);
+}
+
+async function select(rl, label, options, fallback) {
+  const defaultIndex = Math.max(0, options.findIndex(([value]) => value === fallback));
+  console.log("");
+  console.log(`◇ ${label}`);
+  options.forEach(([, title, description, icon = "•"], index) => {
+    const marker = index === defaultIndex ? "  ← default" : "";
+    const letter = letterFor(index);
+    console.log(`  ${letter}) ${icon}  ${title}${marker}`);
+    console.log(`     ${description}`);
+  });
+  const answer = await rl.question(`Choose ${letterFor(defaultIndex)}/${defaultIndex + 1} [${letterFor(defaultIndex)}]: `);
+  const trimmed = answer.trim();
+  if (!trimmed) return options[defaultIndex][0];
+  const letterIndex = indexFromLetter(trimmed);
+  if (letterIndex >= 0 && letterIndex < options.length) return options[letterIndex][0];
+  const selected = Number(trimmed);
+  if (Number.isInteger(selected) && selected >= 1 && selected <= options.length) return options[selected - 1][0];
+  const lower = trimmed.toLowerCase();
+  const exact = options.find(([value, title]) => value.toLowerCase() === lower || title.toLowerCase() === lower);
+  return exact ? exact[0] : options[defaultIndex][0];
+}
+
+async function confirm(rl, label, fallback) {
+  const hint = fallback ? "Y/n" : "y/N";
+  const answer = (await rl.question(`${label} [${hint}]: `)).trim().toLowerCase();
+  if (!answer) return fallback;
+  return ["y", "yes", "true", "1"].includes(answer);
+}
+
+async function responsibilityGate(rl, { schedule, outboundMode }) {
+  const needsGate = schedule === "always-on" || outboundMode === "send-with-confirmation";
+  if (!needsGate) return true;
+  console.log("");
+  console.log("⚠️  Responsibility check:");
+  console.log("  Digital Brain may use local databases, WhatsApp Web, and black-box third-party app behavior.");
+  console.log("  You are responsible for consent, privacy, message content, and any sends triggered from this machine.");
+  console.log("  Enter does not approve this mode.");
+  return confirm(rl, "I understand and want this mode enabled", false);
+}
+
+function letterFor(index) {
+  return String.fromCharCode(65 + index);
+}
+
+function indexFromLetter(value) {
+  const normalized = value.trim().toUpperCase();
+  if (!/^[A-Z]$/.test(normalized)) return -1;
+  return normalized.charCodeAt(0) - 65;
+}
+
 function shell(command, args, optional = false) {
   const result = spawnSync(command, args, { encoding: "utf8" });
   if (result.error && optional) return "";
@@ -195,6 +330,12 @@ function toBoolean(value) {
   return !["false", "0", "no", "off"].includes(String(value).toLowerCase());
 }
 
+function clampInterval(value) {
+  const parsed = Number(value);
+  if (!Number.isFinite(parsed) || parsed < 1) return 1;
+  return Math.floor(parsed);
+}
+
 function help() {
   console.log(`Digital Brain
 

package/docs/AUTOMATIONS.md

@@ -18,17 +18,44 @@ That script runs sync, extract, and interpret using the install-time config.
 - your name
 - history window in days
 - primary focus: relationship memory, reply help, work context
-- refresh cadence
+- refresh cadence: manual, daily, hourly, every 30 minutes, or always-on
+- refresh interval in minutes for always-on mode, clamped to a minimum of 1
 - active time window
 - WhatsApp outbound mode
 - whether to add AI adapter pointers
 
+Most questions are multiple choice. Pick with `A/B/C`, `1/2/3`, the exact value, or press Enter to use the displayed default.
+
+Important defaults:
+
+- skipped vault path creates `./Digital Brain Vault` in the current directory
+- skipped name uses `Me`
+- skipped history window uses 30 days
+- skipped focus uses relationship memory
+- skipped schedule uses manual refresh
+- skipped always-on interval uses 5 minutes, with a hard minimum of 1 minute
+- skipped active window uses `08:00-12:00`
+- skipped outbound mode uses draft-only
+- skipped AI pointers are added during the guided quiz
+
 The answers are saved in:
 
 ```bash
 digital-brain.config.json
 ```
 
+## Full Auto
+
+Use:
+
+```bash
+digital-brain init --full-auto
+```
+
+Full-auto configures local always-on refreshes with a 5 minute default interval. It still uses the local watch script, so it only runs while the machine and runner are awake.
+
+During the guided quiz, always-on and send-with-confirmation require an explicit responsibility check. Pressing Enter does not approve that check. If it is skipped, Digital Brain falls back to manual refresh and draft-only outbound.
+
 ## Codex App
 
 Use a Codex cron automation pointed at the generated vault.
@@ -45,6 +72,18 @@ Example schedule ideas:
 - Every 30 minutes from 8-12: `FREQ=DAILY;BYHOUR=8,9,10,11;BYMINUTE=0,30;BYSECOND=0`
 - Weekly: `FREQ=WEEKLY;BYDAY=MO;BYHOUR=9;BYMINUTE=0;BYSECOND=0`
 
+If Codex supports minute-based schedules in your environment, point it at `Tools/digital-brain-refresh.sh`. Otherwise, use the generated local watch script below.
+
+## Always-On Local Watch
+
+For 24/7 local polling, run:
+
+```bash
+/path/to/vault/Tools/digital-brain-watch.sh
+```
+
+The generated script loops forever and sleeps for `refreshIntervalMinutes`. The minimum supported interval is 1 minute. A practical default is 5 minutes.
+
 ## Local Cron
 
 Run every 30 minutes from 8-12:
@@ -53,6 +92,12 @@ Run every 30 minutes from 8-12:
 0,30 8-11 * * * /path/to/vault/Tools/digital-brain-refresh.sh >> /path/to/vault/08\ Sources/WhatsApp/.sync-state/cron.log 2>&1
 ```
 
+Run every 5 minutes all day:
+
+```cron
+*/5 * * * * /path/to/vault/Tools/digital-brain-refresh.sh >> /path/to/vault/08\ Sources/WhatsApp/.sync-state/cron.log 2>&1
+```
+
 ## macOS launchd
 
 Use launchd if you want a native background job. Be aware macOS privacy permissions may block background access to app databases unless Terminal or the runner has Full Disk Access.

package/docs/PRIVACY.md

@@ -13,5 +13,7 @@ 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.
+- 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/examples/sample-vault/04 People/Interpreted Relationships/Close Friend.md

@@ -1,10 +1,11 @@
 # Close Friend
 
-Generated: 2026-06-09T22:06:49.488719+00:00
+Generated: 2026-06-09T22:26:26.131803+00:00
 Role: operational contact
 Role confidence: low
 Closeness: medium
 Conversation difficulty: low
+Typing style: short
 
 These are private working notes. Edit them where wrong.
 
@@ -21,9 +22,22 @@ These are private working notes. Edit them where wrong.
 - 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/04 People/Interpreted Relationships/Mom.md

@@ -1,10 +1,11 @@
 # Mom
 
-Generated: 2026-06-09T22:06:49.488023+00:00
+Generated: 2026-06-09T22:26:26.131148+00:00
 Role: mother
 Role confidence: high
 Closeness: medium
 Conversation difficulty: low
+Typing style: very short
 
 These are private working notes. Edit them where wrong.
 
@@ -21,10 +22,23 @@ These are private working notes. Edit them where wrong.
 - 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/04 People/Interpreted Relationships/Project Team.md

@@ -1,10 +1,11 @@
 # Project Team
 
-Generated: 2026-06-09T22:06:49.488560+00:00
+Generated: 2026-06-09T22:26:26.131626+00:00
 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.
 
@@ -21,10 +22,23 @@ These are private working notes. Edit them where wrong.
 - 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/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
-- [[Project Team]]: work collaborator (medium), closeness low/unclear, difficulty practical/low-emotional
-- [[Close Friend]]: operational contact (low), closeness medium, difficulty low
+- [[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

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

@@ -1,10 +1,11 @@
 # Close Friend
 
-Generated: 2026-06-09T22:06:49.488719+00:00
+Generated: 2026-06-09T22:26:26.131803+00:00
 Role: operational contact
 Role confidence: low
 Closeness: medium
 Conversation difficulty: low
+Typing style: short
 
 These are private working notes. Edit them where wrong.
 
@@ -21,9 +22,22 @@ These are private working notes. Edit them where wrong.
 - 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.md

@@ -1,10 +1,11 @@
 # Mom
 
-Generated: 2026-06-09T22:06:49.488023+00:00
+Generated: 2026-06-09T22:26:26.131148+00:00
 Role: mother
 Role confidence: high
 Closeness: medium
 Conversation difficulty: low
+Typing style: very short
 
 These are private working notes. Edit them where wrong.
 
@@ -21,10 +22,23 @@ These are private working notes. Edit them where wrong.
 - 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.md

@@ -1,10 +1,11 @@
 # Project Team
 
-Generated: 2026-06-09T22:06:49.488560+00:00
+Generated: 2026-06-09T22:26:26.131626+00:00
 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.
 
@@ -21,10 +22,23 @@ These are private working notes. Edit them where wrong.
 - 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

@@ -11,6 +11,7 @@ Generated signals. Treat as editable working notes.
 - Dates: 2026-01-01 to 2026-01-01
 - Scores: sentiment 0.159, warmth 0.5, friction 0.0, operational 1.5
 - 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
 
@@ -19,6 +20,7 @@ Generated signals. Treat as editable working notes.
 - Dates: 2026-01-01 to 2026-01-01
 - Scores: sentiment 0, warmth 0.0, friction 0.0, operational 3.0
 - 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
 
@@ -27,3 +29,4 @@ Generated signals. Treat as editable working notes.
 - Dates: 2026-01-01 to 2026-01-01
 - Scores: sentiment 0.159, warmth 1.0, friction 0.0, operational 0.5
 - Tags: direct-chat, light, warm, logistics-heavy
+- Typing style: short; avg 5.0 words; lowercase 0.0; emoji 0.0; slang none

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

@@ -20,6 +20,18 @@
       "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"
+    },
     "role": "mother",
     "roleConfidence": "high",
     "roleReason": "manual override",
@@ -33,6 +45,10 @@
     ],
     "boundaries": [
       "Do not expose private summaries unless asked."
+    ],
+    "replyStyle": [
+      "Keep replies very short unless context demands detail.",
+      "Match style without exaggerating or parodying the person."
     ]
   },
   {
@@ -56,6 +72,18 @@
       "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"
+    },
     "role": "work collaborator",
     "roleConfidence": "medium",
     "roleReason": "matched chat name",
@@ -69,6 +97,10 @@
     ],
     "boundaries": [
       "Do not expose private summaries unless asked."
+    ],
+    "replyStyle": [
+      "Use concise replies with one clear point.",
+      "Match style without exaggerating or parodying the person."
     ]
   },
   {
@@ -92,6 +124,18 @@
       "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"
+    },
     "role": "operational contact",
     "roleConfidence": "low",
     "roleReason": "logistics-heavy communication",
@@ -104,6 +148,10 @@
     ],
     "boundaries": [
       "Do not expose private summaries unless asked."
+    ],
+    "replyStyle": [
+      "Keep replies very short unless context demands detail.",
+      "Match style without exaggerating or parodying the person."
     ]
   }
 ]

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

@@ -19,7 +19,19 @@
       "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",
@@ -41,7 +53,19 @@
       "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",
@@ -63,6 +87,18 @@
       "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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "digital-brain",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "description": "Your private digital imprint for AI assistants.",
   "type": "module",
   "bin": {
@@ -19,6 +19,7 @@
   ],
   "scripts": {
     "test:sample": "node ./bin/digital-brain.js extract --vault ./examples/sample-vault --days 365 --min-messages 1 && node ./bin/digital-brain.js interpret --vault ./examples/sample-vault --days 365",
+    "test": "node --test tests/*.test.mjs",
     "check": "node --check bin/digital-brain.js && node --check lib/*.js && node --check whatsapp-web/*.mjs && python3 -m py_compile scripts/*.py",
     "start": "node ./bin/digital-brain.js"
   },

package/scripts/digital_brain_relationship_extractor.py

@@ -11,6 +11,7 @@ POSITIVE = {"love", "thanks", "thank", "amazing", "great", "good", "nice", "perf
 NEGATIVE = {"angry", "annoyed", "upset", "sad", "bad", "hate", "sorry", "fight", "problem", "issue", "wrong", "stress", "fuck", "shit", "worried", "pain", "hurt", "confused"}
 LOGISTICS = {"when", "where", "time", "today", "tomorrow", "meeting", "call", "send", "sent", "come", "coming", "reach", "book", "plan", "schedule"}
 WORK = {"pr", "repo", "client", "customer", "meeting", "deck", "code", "ship", "product", "founder", "startup", "work", "office", "investor", "sales", "demo", "launch"}
+SLANG = {"lol", "lmao", "haha", "hahaha", "bro", "bruh", "wtf", "omg", "ngl", "idk", "rn", "btw", "bc", "pls", "plz", "ya", "yeah", "yep", "nah", "fuck", "shit"}
 
 
 def main():
@@ -59,6 +60,7 @@ def profile_chat(chat_name, messages):
     inbound = count - outbound
     dates = [m["_dt"] for m in messages]
     text = "\n".join(m.get("body") or "" for m in messages)
+    outbound_messages = [m for m in messages if m.get("fromMe") and (m.get("body") or "").strip()]
     words = Counter(re.findall(r"[a-zA-Z']+", text.lower()))
     positive = score(words, POSITIVE)
     negative = score(words, NEGATIVE)
@@ -86,6 +88,7 @@ def profile_chat(chat_name, messages):
         "questionCount": text.count("?"),
         "relationshipGuess": guess,
         "tags": tags,
+        "typingStyle": typing_style(outbound_messages),
     }
 
 
@@ -138,6 +141,7 @@ def write_markdown(path, profiles, days):
             f"- Dates: {profile['firstSeen']} to {profile['lastSeen']}",
             f"- Scores: sentiment {profile['sentimentScore']}, warmth {profile['warmthScore']}, friction {profile['frictionScore']}, operational {profile['operationalScore']}",
             f"- Tags: {', '.join(profile['tags'])}",
+            f"- Typing style: {typing_style_summary(profile['typingStyle'])}",
             "",
         ])
     path.write_text("\n".join(lines), encoding="utf-8")
@@ -147,6 +151,83 @@ def score(words, lexicon):
     return sum(words[word] for word in lexicon)
 
 
+def typing_style(messages):
+    bodies = [(m.get("body") or "").strip() for m in messages if (m.get("body") or "").strip()]
+    count = len(bodies)
+    if not count:
+        return {
+            "sampleSize": 0,
+            "avgChars": 0,
+            "avgWords": 0,
+            "lowercaseShare": 0,
+            "uppercaseShare": 0,
+            "questionShare": 0,
+            "exclamationShare": 0,
+            "emojiShare": 0,
+            "slang": [],
+            "signature": "no outbound sample",
+        }
+    word_lists = [re.findall(r"[A-Za-z']+", body) for body in bodies]
+    all_words = [word.lower() for words in word_lists for word in words]
+    slang = Counter(word for word in all_words if word in SLANG)
+    avg_chars = sum(len(body) for body in bodies) / count
+    avg_words = sum(len(words) for words in word_lists) / count
+    lowercase = sum(1 for body in bodies if has_letters(body) and body == body.lower()) / count
+    uppercase = sum(1 for body in bodies if has_letters(body) and body == body.upper()) / count
+    questions = sum(1 for body in bodies if "?" in body) / count
+    exclaims = sum(1 for body in bodies if "!" in body) / count
+    emojis = sum(1 for body in bodies if has_emoji(body)) / count
+    return {
+        "sampleSize": count,
+        "avgChars": round(avg_chars, 1),
+        "avgWords": round(avg_words, 1),
+        "lowercaseShare": round(lowercase, 2),
+        "uppercaseShare": round(uppercase, 2),
+        "questionShare": round(questions, 2),
+        "exclamationShare": round(exclaims, 2),
+        "emojiShare": round(emojis, 2),
+        "slang": [word for word, _ in slang.most_common(8)],
+        "signature": infer_typing_signature(avg_words, lowercase, questions, exclaims, emojis, slang),
+    }
+
+
+def typing_style_summary(style):
+    slang = ", ".join(style.get("slang", [])) or "none"
+    return (
+        f"{style.get('signature', 'unknown')}; avg {style.get('avgWords', 0)} words; "
+        f"lowercase {style.get('lowercaseShare', 0)}; emoji {style.get('emojiShare', 0)}; slang {slang}"
+    )
+
+
+def infer_typing_signature(avg_words, lowercase, questions, exclaims, emojis, slang):
+    parts = []
+    if avg_words <= 4:
+        parts.append("very short")
+    elif avg_words <= 10:
+        parts.append("short")
+    else:
+        parts.append("longer-form")
+    if lowercase > 0.55:
+        parts.append("lowercase-heavy")
+    if questions > 0.25:
+        parts.append("question-heavy")
+    if exclaims > 0.2:
+        parts.append("expressive")
+    if emojis > 0.2:
+        parts.append("emoji-friendly")
+    if slang:
+        parts.append("slangy")
+    return ", ".join(parts)
+
+
+def has_letters(text):
+    return any(char.isalpha() for char in text)
+
+
+def has_emoji(text):
+    return any(ord(char) > 10000 for char in text)
+
+
 def normalized_sentiment(positive, negative, count):
     if positive + negative == 0:
         return 0

package/scripts/digital_brain_relationship_interpreter.py

@@ -54,6 +54,7 @@ def build_model(profile, override):
         "reciprocity": infer_reciprocity(profile),
         "howToContinue": infer_continuity(profile, role),
         "boundaries": infer_boundaries(role, infer_difficulty(profile)),
+        "replyStyle": infer_reply_style(profile),
     }
 
 
@@ -136,6 +137,7 @@ Role: {model['role']}
 Role confidence: {model['roleConfidence']}
 Closeness: {model['closeness']}
 Conversation difficulty: {model['conversationDifficulty']}
+Typing style: {model['typingStyle'].get('signature', 'unknown')}
 
 These are private working notes. Edit them where wrong.
 
@@ -152,9 +154,15 @@ These are private working notes. Edit them where wrong.
 - Messages: {model['messageCount']} ({model['inbound']} inbound, {model['outbound']} outbound).
 - Tags: {', '.join(model['tags'])}.
 
+## Typing Style To Match
+{render_typing_style(model)}
+
 ## How To Continue This Relationship
 {bullets(model['howToContinue'])}
 
+## Reply Guidance
+{bullets(model['replyStyle'])}
+
 ## What Not To Assume
 {bullets(model['boundaries'])}
 """
@@ -164,7 +172,8 @@ def write_index(path, models):
     path.parent.mkdir(parents=True, exist_ok=True)
     lines = ["# Interpreted Relationship Memory", "", "Generated working notes. Treat as editable, not truth.", ""]
     for model in models:
-        lines.append(f"- [[{safe_filename(model['chatName'])}]]: {model['role']} ({model['roleConfidence']}), closeness {model['closeness']}, difficulty {model['conversationDifficulty']}")
+        style = model.get("typingStyle", {}).get("signature", "unknown style")
+        lines.append(f"- [[{safe_filename(model['chatName'])}]]: {model['role']} ({model['roleConfidence']}), closeness {model['closeness']}, difficulty {model['conversationDifficulty']}, style {style}")
     path.write_text("\n".join(lines) + "\n", encoding="utf-8")
 
 
@@ -172,6 +181,43 @@ def bullets(items):
     return "\n".join(f"- {item}" for item in items)
 
 
+def render_typing_style(model):
+    style = model.get("typingStyle", {})
+    slang = ", ".join(style.get("slang", [])) or "none detected"
+    lines = [
+        f"- Signature: {style.get('signature', 'unknown')}.",
+        f"- Average length: {style.get('avgWords', 0)} words / {style.get('avgChars', 0)} chars.",
+        f"- Lowercase share: {style.get('lowercaseShare', 0)}.",
+        f"- Question share: {style.get('questionShare', 0)}.",
+        f"- Exclamation share: {style.get('exclamationShare', 0)}.",
+        f"- Emoji share: {style.get('emojiShare', 0)}.",
+        f"- Slang: {slang}.",
+    ]
+    return "\n".join(lines)
+
+
+def infer_reply_style(profile):
+    style = profile.get("typingStyle", {})
+    guidance = []
+    avg_words = style.get("avgWords", 0)
+    if avg_words and avg_words <= 5:
+        guidance.append("Keep replies very short unless context demands detail.")
+    elif avg_words <= 12:
+        guidance.append("Use concise replies with one clear point.")
+    else:
+        guidance.append("Longer replies are acceptable in this relationship.")
+    if style.get("lowercaseShare", 0) > 0.55:
+        guidance.append("Lowercase is acceptable; avoid making it too formal.")
+    if style.get("emojiShare", 0) > 0.2:
+        guidance.append("A light emoji can fit this relationship.")
+    if style.get("questionShare", 0) > 0.25:
+        guidance.append("Asking a direct question fits the existing rhythm.")
+    if style.get("slang"):
+        guidance.append(f"Some familiar slang appears here: {', '.join(style['slang'][:4])}.")
+    guidance.append("Match style without exaggerating or parodying the person.")
+    return guidance
+
+
 def safe_filename(value):
     cleaned = "".join("-" if char in '/:\\?%*"<>|' else char for char in value)
     return (" ".join(cleaned.split()).strip() or "Unknown Chat")[:120]