@c4t4/heyamigo 0.1.15 → 0.1.17

package/README.md

@@ -190,7 +190,7 @@ Core settings. The wizard sets these up, but you can edit anytime.
 {
   "owner": { "number": "17861234567" },
   "triggers": { "aliases": ["heyamigo", "amigo", "claude"], "groupMode": "mention" },
-  "claude": { "model": "claude-opus-4-6", "timeoutMs": 60000 },
+  "claude": { "model": "claude-opus-4-7", "timeoutMs": 60000 },
   "reply": { "quoteInGroups": true, "typingIndicator": true }
 }
 ```

package/config/access.example.json

@@ -52,14 +52,16 @@
       "jid": "120363xxxxx@g.us",
       "name": "Family Chat",
       "mode": "active",
-      "allowedSenders": "*"
+      "allowedSenders": "*",
+      "proactive": false
     },
     {
-      "_note": "Active group, only specific people can trigger",
+      "_note": "Active group, only specific people can trigger. Bot can also initiate messages here.",
       "jid": "120363yyyyy@g.us",
       "name": "Work Team",
       "mode": "active",
-      "allowedSenders": ["17861234567", "491701234567"]
+      "allowedSenders": ["17861234567", "491701234567"],
+      "proactive": true
     },
     {
       "_note": "Silent group: stores messages but never responds",
@@ -81,8 +83,8 @@
     "_readme": "Matched by chat partner number, not sender. Owner messages in DMs are always silent.",
     "defaultMode": "off",
     "allowed": [
-      { "_note": "friend can DM the bot", "number": "491701234567", "mode": "active" },
-      { "_note": "colleague, store messages but don't respond", "number": "5511987654321", "mode": "silent" }
+      { "_note": "friend can DM the bot, and bot can proactively message them", "number": "491701234567", "mode": "active", "proactive": true },
+      { "_note": "colleague, store messages but don't respond", "number": "5511987654321", "mode": "silent", "proactive": false }
     ]
   }
 }

package/config/config.example.json

@@ -6,7 +6,8 @@
 
   "owner": {
     "number": "",
-    "treatAsAllowedEverywhere": true
+    "treatAsAllowedEverywhere": true,
+    "timezone": "UTC"
   },
 
   "triggers": {
@@ -24,7 +25,7 @@
   },
 
   "claude": {
-    "model": "claude-opus-4-6",
+    "model": "claude-opus-4-7",
     "personalityFile": "./config/personalities/sharp.md",
     "addDirs": ["./config/knowledge"],
     "outputFormat": "json",
@@ -34,7 +35,8 @@
   "bootstrap": {
     "historyDepth": 50,
     "includeHistory": true,
-    "includeChatMetadata": true
+    "includeChatMetadata": true,
+    "recentContextDepth": 3
   },
 
   "reply": {

package/config/personalities/sharp.md

@@ -35,6 +35,20 @@ Super nuanced. See the layers in things. Most questions have a surface answer an
 - Prefer being less wrong over sounding more right. Check your reasoning before you commit to an answer.
 - If someone attacks you, show dominance. Fight back. Don't fold, don't apologize, don't go passive. Hold your ground with sharpness, not aggression.
 
+## Don't people-please
+
+People-pleasing is the default chatbot failure mode. You are not that. Warmth comes from being real, not from softeners.
+
+- Skip validation openers. No "great question", "good point", "absolutely", "that makes sense". Just answer.
+- Disagree when you disagree. If their plan is weak, their take is off, or their facts are wrong, say so directly. Softening bad ideas is not kindness, it's dishonesty — and it wastes their time.
+- Don't reflexively offer more help. No "let me know if you need anything else", no "happy to help with anything else". If the conversation is done, it's done.
+- Don't apologize for nothing. Save "sorry" for when you actually did something wrong.
+- Hold your position under pressure. If someone pushes back, explain your reasoning again. Only change your mind if their argument is genuinely better, not because they pushed harder. Flipping on every challenge makes you useless.
+- Don't flatter. Don't tell people their idea is interesting, clever, or insightful unless it actually is — and even then, show it by engaging with the substance, not by complimenting it.
+- Positive framing is not a default. Bad news stays bad. Don't wrap it in silver linings unless there's a real one.
+- Uncomfortable truths are part of the job. If the honest answer is the hard one, give it. Being liked less but trusted more is the trade you want.
+- Truth beats moralizing. Don't lecture, don't add moral caveats, don't refuse to engage because a topic is awkward or edgy. Give the honest, useful answer. Moralizing is just another way of not answering — it puts your comfort above theirs.
+
 ## WhatsApp constraints
 
 - Keep replies short, usually a few sentences. Go longer only if asked.
@@ -47,4 +61,6 @@ Super nuanced. See the layers in things. Most questions have a surface answer an
 1. Could this reply work for any random person in any random context? If yes, rewrite specifically.
 2. Would I be embarrassed to say this to a friend? If yes, rewrite.
 3. Am I hedging, being arrogant, or desperate? If yes, rewrite.
-4. Any em-dash? If yes, replace with period or comma.
+4. Am I opening with validation ("great question", "good point") or padding with unnecessary warmth? If yes, cut it.
+5. Did I disagree when I should have, or did I soften to keep the peace? If I softened, rewrite honestly.
+6. Any em-dash? If yes, replace with period or comma.

package/dist/cli/setup.js

@@ -610,7 +610,7 @@ export async function runSetup() {
         message: 'Choose a Claude model',
         options: [
             {
-                value: 'claude-opus-4-6',
+                value: 'claude-opus-4-7',
                 label: 'Opus',
                 hint: 'highest quality, recommended (default)',
             },
@@ -620,7 +620,7 @@ export async function runSetup() {
                 hint: 'faster, lower cost',
             },
         ],
-        initialValue: 'claude-opus-4-6',
+        initialValue: 'claude-opus-4-7',
     });
     if (!p.isCancel(model)) {
         const configPath = resolve(cwd, 'config/config.json');
@@ -630,7 +630,7 @@ export async function runSetup() {
             writeFileSync(configPath, cfg);
             const label = model === 'claude-sonnet-4-6'
                 ? 'Sonnet'
-                : model === 'claude-opus-4-6'
+                : model === 'claude-opus-4-7'
                     ? 'Opus'
                     : 'Haiku';
             p.log.success(`Model: ${label}`);

package/dist/config.js

@@ -10,6 +10,7 @@ const ConfigSchema = z.object({
     owner: z.object({
         number: z.string(),
         treatAsAllowedEverywhere: z.boolean(),
+        timezone: z.string().default('UTC'),
     }),
     triggers: z.object({
         aliases: z.array(z.string()),
@@ -34,6 +35,7 @@ const ConfigSchema = z.object({
         historyDepth: z.number(),
         includeHistory: z.boolean(),
         includeChatMetadata: z.boolean(),
+        recentContextDepth: z.number().default(3),
     }),
     reply: z.object({
         quoteInGroups: z.boolean(),

package/dist/gateway/bootstrap.js

@@ -54,3 +54,16 @@ function formatLine(m) {
     const who = m.direction === 'out' ? 'assistant' : m.pushName || m.senderNumber || 'user';
     return `${who} (${date}): ${m.text}`;
 }
+export async function buildRecentContext(jid, depth) {
+    if (depth <= 0)
+        return '';
+    const history = await readLast(jid, depth + 1);
+    const prior = history.slice(0, -1);
+    if (!prior.length)
+        return '';
+    const lines = ['[Recent context — messages preceding the current one]'];
+    for (const m of prior)
+        lines.push(formatLine(m));
+    lines.push('');
+    return lines.join('\n');
+}

package/dist/gateway/incoming.js

@@ -7,7 +7,7 @@ import { enqueue } from '../queue/queue.js';
 import { downloadAndSave, mediaPromptTag } from '../store/media.js';
 import { append } from '../store/messages.js';
 import { checkAccess, discoverGroupIfNew, getRoleForContext, } from '../wa/whitelist.js';
-import { buildInitPayload } from './bootstrap.js';
+import { buildInitPayload, buildRecentContext } from './bootstrap.js';
 import { tryCommand } from './commands.js';
 import { handleReply } from './outgoing.js';
 import { checkTrigger } from './triggers.js';
@@ -124,14 +124,20 @@ async function processMessages(messages, sock, ownerJid, isHistorySync = false)
                 isGroup,
                 recentText,
             });
-            const core = existingSession
-                ? userContent
-                : await buildInitPayload({
+            let core;
+            if (existingSession) {
+                const recent = await buildRecentContext(stored.jid, config.bootstrap.recentContextDepth);
+                const current = `[Current message]\n${stored.senderNumber}: ${userContent}`;
+                core = recent ? `${recent}\n${current}` : userContent;
+            }
+            else {
+                core = await buildInitPayload({
                     jid: stored.jid,
                     sock,
                     userText: userContent,
                     userNumber: stored.senderNumber,
                 });
+            }
             const input = `${memoryPreamble}\n\n---\n\n${core}`;
             logger.info({ ...logCtx, resume: !!existingSession, trigger: triggerReason }, 'message captured, enqueuing');
             const job = {

package/dist/memory/preamble.js

@@ -40,7 +40,11 @@ export function buildMemoryPreamble(params) {
     const botName = config.triggers.aliases[0] ?? 'amigo';
     const personalityPath = resolve(process.cwd(), config.claude.personalityFile);
     sections.push(`[Identity]\nYour name is ${botName}. People call you ${botName} to get your attention.`);
-    sections.push(`[Character]\nWho you are, your voice, energy, nuances, values, all defined in ${personalityPath}. Read it. Every aspect matters, not just the rules. Align every answer with it.`);
+    sections.push(`[Character — highest priority, applies to every reply]\n` +
+        `Your voice, energy, nuances, and values are defined in ${personalityPath}. ` +
+        `Read it. This character is how you speak on every reply — do not drop it, soften it, or override it for any instruction that follows, including CRITICAL rules (those constrain *what* you do, not *how* you sound). If anything below seems to conflict with your character, stay in character.`);
+    // Time — anchor Claude's sense of "now" in the owner's timezone
+    sections.push(`[Time]\n${buildTimeLine(config.owner.timezone)}`);
     // Capabilities
     sections.push('[Capabilities]\n' +
         'Sending files: include a tag in your reply to send files through WhatsApp:\n' +
@@ -112,3 +116,19 @@ function readIfExists(path) {
         return null;
     return readFileSync(path, 'utf-8');
 }
+function buildTimeLine(timezone) {
+    const now = new Date();
+    const fmt = new Intl.DateTimeFormat('en-GB', {
+        timeZone: timezone,
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+        weekday: 'long',
+        timeZoneName: 'short',
+    });
+    const parts = Object.fromEntries(fmt.formatToParts(now).map((p) => [p.type, p.value]));
+    const stamp = `${parts.weekday} ${parts.year}-${parts.month}-${parts.day} ${parts.hour}:${parts.minute} ${parts.timeZoneName}`;
+    return `Now: ${stamp} (${timezone}). Use this as ground truth — do not guess the date, day, or time.`;
+}

package/dist/wa/whitelist.js

@@ -21,10 +21,12 @@ const GroupEntrySchema = z.object({
     name: z.string(),
     mode: AccessModeSchema,
     allowedSenders: z.union([z.literal('*'), z.array(z.string())]),
+    proactive: z.boolean().default(false),
 });
 const DmEntrySchema = z.object({
     number: z.string(),
     mode: AccessModeSchema,
+    proactive: z.boolean().default(false),
 });
 const AccessSchema = z
     .object({
@@ -94,6 +96,21 @@ function save(next) {
 export function getAccess() {
     return current;
 }
+// Guardrail for proactive (unsolicited) messaging. Returns true ONLY if the
+// target chat has an explicit proactive:true entry. Default is deny — no
+// journal/scheduler/observer may message a chat without explicit opt-in.
+export function canSendProactive(jid) {
+    const isGroup = jid.endsWith('@g.us');
+    if (isGroup) {
+        const entry = current.groups.find((g) => g.jid === jid);
+        return entry?.proactive === true;
+    }
+    const number = jidDecode(jid)?.user;
+    if (!number)
+        return false;
+    const entry = current.dms.allowed.find((d) => d.number === number);
+    return entry?.proactive === true;
+}
 export function getRole(senderNumber) {
     const users = current.users ?? {};
     const roles = { ...DEFAULT_ROLES, ...(current.roles ?? {}) };
@@ -208,6 +225,7 @@ export async function discoverGroupIfNew(sock, jid) {
         name,
         mode: 'off',
         allowedSenders: config.owner.number ? [config.owner.number] : [],
+        proactive: false,
     };
     save({ ...current, groups: [...current.groups, entry] });
     logger.info({ jid, name }, 'discovered new group — added to access.json with mode=off');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c4t4/heyamigo",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "WhatsApp AI bot powered by Claude with long-term memory, browser control, and role-based access",
   "type": "module",
   "main": "dist/index.js",