monomind 2.7.4 → 2.7.6

package/packages/@monomind/cli/dist/src/ui/server.mjs

@@ -1874,22 +1874,6 @@ export async function startServer({ port = 4242, projectDir, openBrowser = true
       return;
     }
 
-    // GET /api/adr-file?file=<name>&dir=<dir> — read a single ADR markdown file
-    if (req.method === 'GET' && url === '/api/adr-file') {
-      try {
-        const qs = new URL(req.url, 'http://localhost').searchParams;
-        const dir = qs.get('dir') || projectDir || process.cwd();
-        const fname = (qs.get('file') || '').replace(/[/\\]/g, '');
-        if (!fname || !fname.endsWith('.md')) { res.writeHead(400); res.end('{"error":"invalid file"}'); return; }
-        const fpath = path.join(path.resolve(dir), 'docs', 'adrs', fname);
-        if (!fs.existsSync(fpath)) { res.writeHead(404); res.end('{"error":"not found"}'); return; }
-        const content = fs.readFileSync(fpath, 'utf8');
-        res.writeHead(200, { 'Content-Type': 'application/json', ...(corsOrigin ? { 'Access-Control-Allow-Origin': corsOrigin } : {}) });
-        res.end(JSON.stringify({ file: fname, content }));
-      } catch (err) { res.writeHead(500); res.end(JSON.stringify({ error: err.message })); }
-      return;
-    }
-
     // ------------------------------------------------------- GET /api/memory-files
     if (req.method === 'GET' && url === '/api/memory-files') {
       try {
@@ -6331,265 +6315,6 @@ new Sigma(g,document.getElementById('g'),{renderEdgeLabels:false,labelColor:{col
       return;
     }
 
-    // GET /api/second-brain-metrics — aggregated injection analytics from second-brain.jsonl
-    if (req.method === 'GET' && url === '/api/second-brain-metrics') {
-      try {
-        const metricsFile = path.join(projectDir || process.cwd(), '.monomind', 'metrics', 'second-brain.jsonl');
-        if (!fs.existsSync(metricsFile)) {
-          res.writeHead(200, { 'Content-Type': 'application/json', ...(corsOrigin ? { 'Access-Control-Allow-Origin': corsOrigin } : {}) });
-          res.end(JSON.stringify({ total: 0, injected: 0, hitRate: 0, methods: {}, avgScore: 0, sparkline: [], scores: [] }));
-          return;
-        }
-        const raw = fs.readFileSync(metricsFile, 'utf8');
-        const entries = raw.split('\n').filter(Boolean).map(l => { try { return JSON.parse(l); } catch { return null; } }).filter(Boolean);
-        const total = entries.length;
-        const injectedCount = entries.filter(e => e.injected).length;
-        const hitRate = total > 0 ? injectedCount / total : 0;
-        // Method distribution
-        const methods = {};
-        for (const e of entries) { const m = e.method || 'unknown'; methods[m] = (methods[m] || 0) + 1; }
-        // Average top score (only for entries with hits)
-        const withScores = entries.filter(e => typeof e.topScore === 'number' && e.topScore !== null);
-        const avgScore = withScores.length > 0 ? withScores.reduce((s, e) => s + e.topScore, 0) / withScores.length : 0;
-        // Score distribution buckets
-        const scoreBuckets = [0, 0, 0, 0, 0]; // <0.3, 0.3-0.5, 0.5-0.7, 0.7-0.9, 0.9+
-        for (const e of withScores) {
-          const s = e.topScore;
-          if (s < 0.3) scoreBuckets[0]++;
-          else if (s < 0.5) scoreBuckets[1]++;
-          else if (s < 0.7) scoreBuckets[2]++;
-          else if (s < 0.9) scoreBuckets[3]++;
-          else scoreBuckets[4]++;
-        }
-        // Sparkline: group by hour for last 24h, then by day for older
-        const now = Date.now();
-        const h24 = now - 86400000;
-        const sparkline = [];
-        // Last 24 hours in 2h buckets
-        for (let t = h24; t < now; t += 7200000) {
-          const bucket = entries.filter(e => e.ts >= t && e.ts < t + 7200000);
-          const inj = bucket.filter(e => e.injected).length;
-          sparkline.push({ t, total: bucket.length, injected: inj });
-        }
-        // Top sources from recent entries (last 200)
-        const recentSlice = entries.slice(-200);
-        const misses = recentSlice.filter(e => !e.injected).length;
-        // Route overrides (misroute counts)
-        let routeOverrides = {};
-        try {
-          const overridesFile = path.join(projectDir || process.cwd(), '.monomind', 'metrics', 'route-overrides.json');
-          if (fs.existsSync(overridesFile)) routeOverrides = JSON.parse(fs.readFileSync(overridesFile, 'utf8'));
-        } catch {}
-        res.writeHead(200, { 'Content-Type': 'application/json', ...(corsOrigin ? { 'Access-Control-Allow-Origin': corsOrigin } : {}) });
-        res.end(JSON.stringify({ total, injected: injectedCount, hitRate: +hitRate.toFixed(3), methods, avgScore: +avgScore.toFixed(3), sparkline, scoreBuckets, recentMisses: misses, recentTotal: recentSlice.length, routeOverrides }));
-      } catch (err) {
-        res.writeHead(500, { 'Content-Type': 'application/json' });
-        res.end(JSON.stringify({ error: err.message }));
-      }
-      return;
-    }
-
-    // POST /api/second-brain-route — show query router decision for a given query
-    if (req.method === 'POST' && url === '/api/second-brain-route') {
-      let body = '';
-      req.on('data', c => { body += c; if (body.length > 65536) { req.destroy(); return; } });
-      req.on('end', async () => {
-        try {
-          const { query } = JSON.parse(body || '{}');
-          if (!query) { res.writeHead(400, { 'Content-Type': 'application/json' }); res.end('{"error":"query required"}'); return; }
-          const routerMod = await import('../memory/query-router.js');
-          const route = routerMod.routeQuery(String(query).slice(0, 2000));
-          const overrides = routerMod.getRouteOverrides(true);
-          res.writeHead(200, { 'Content-Type': 'application/json', ...(corsOrigin ? { 'Access-Control-Allow-Origin': corsOrigin } : {}) });
-          res.end(JSON.stringify({ route, overrides }));
-        } catch (err) {
-          res.writeHead(500, { 'Content-Type': 'application/json' });
-          res.end(JSON.stringify({ error: err.message }));
-        }
-      });
-      return;
-    }
-
-    // GET/PUT /api/second-brain-config — read/write Second Brain config (.monomind/second-brain.json)
-    if ((req.method === 'GET' || req.method === 'PUT') && url === '/api/second-brain-config') {
-      const configFile = path.join(projectDir || process.cwd(), '.monomind', 'second-brain.json');
-      if (req.method === 'GET') {
-        try {
-          let config = { relevanceFloor: 0.35, injectionLimit: 5 };
-          try { config = { ...config, ...JSON.parse(fs.readFileSync(configFile, 'utf8')) }; } catch {}
-          // Auto-tune suggestion: analyze telemetry to suggest optimal floor
-          let suggestion = null;
-          try {
-            const metricsFile = path.join(projectDir || process.cwd(), '.monomind', 'metrics', 'second-brain.jsonl');
-            if (fs.existsSync(metricsFile)) {
-              const entries = fs.readFileSync(metricsFile, 'utf8').split('\n').filter(Boolean)
-                .map(l => { try { return JSON.parse(l); } catch { return null; } }).filter(Boolean);
-              const withScores = entries.filter(e => typeof e.topScore === 'number' && e.topScore !== null);
-              if (withScores.length >= 20) {
-                const scores = withScores.map(e => e.topScore).sort((a, b) => a - b);
-                const p25 = scores[Math.floor(scores.length * 0.25)];
-                const hitRate = entries.filter(e => e.injected).length / entries.length;
-                // If hit rate is very low (<30%), suggest lowering floor
-                // If hit rate is very high (>80%) with low avg scores, suggest raising
-                if (hitRate < 0.3 && p25 > 0.2) suggestion = { floor: +(p25 - 0.05).toFixed(2), reason: 'Low hit rate (' + (hitRate * 100).toFixed(0) + '%) — lowering floor may surface more relevant results' };
-                else if (hitRate > 0.8 && scores[Math.floor(scores.length * 0.1)] < 0.35) suggestion = { floor: 0.4, reason: 'High hit rate with low-quality matches — raising floor filters noise' };
-              }
-            }
-          } catch {}
-          res.writeHead(200, { 'Content-Type': 'application/json', ...(corsOrigin ? { 'Access-Control-Allow-Origin': corsOrigin } : {}) });
-          res.end(JSON.stringify({ config, suggestion }));
-        } catch (err) {
-          res.writeHead(500, { 'Content-Type': 'application/json' });
-          res.end(JSON.stringify({ error: err.message }));
-        }
-        return;
-      }
-      if (req.method === 'PUT') {
-        let body = '';
-        req.on('data', c => { body += c; if (body.length > 4096) { req.destroy(); return; } });
-        req.on('end', () => {
-          try {
-            const raw = JSON.parse(body || '{}');
-            const updates = {};
-            if (typeof raw.relevanceFloor === 'number' && raw.relevanceFloor >= 0 && raw.relevanceFloor <= 1) updates.relevanceFloor = raw.relevanceFloor;
-            if (typeof raw.injectionLimit === 'number' && raw.injectionLimit >= 1 && raw.injectionLimit <= 50) updates.injectionLimit = Math.floor(raw.injectionLimit);
-            if (Object.keys(updates).length === 0) { res.writeHead(400, { 'Content-Type': 'application/json' }); res.end('{"error":"no valid fields to update"}'); return; }
-            let config = {};
-            try { config = JSON.parse(fs.readFileSync(configFile, 'utf8')); } catch {}
-            config = { ...config, ...updates };
-            fs.mkdirSync(path.dirname(configFile), { recursive: true });
-            fs.writeFileSync(configFile, JSON.stringify(config, null, 2));
-            res.writeHead(200, { 'Content-Type': 'application/json', ...(corsOrigin ? { 'Access-Control-Allow-Origin': corsOrigin } : {}) });
-            res.end(JSON.stringify({ ok: true, config }));
-          } catch (err) {
-            res.writeHead(500, { 'Content-Type': 'application/json' });
-            res.end(JSON.stringify({ error: err.message }));
-          }
-        });
-        return;
-      }
-    }
-
-    // GET /api/second-brain-docs — document-level view from doc-metadata.jsonl
-    if (req.method === 'GET' && url === '/api/second-brain-docs') {
-      try {
-        const d = path.resolve(projectDir || process.cwd());
-        const metaFile = path.join(d, '.monomind', 'knowledge', 'doc-metadata.jsonl');
-        // Also check global brain
-        const globalDir = process.env.MONOMIND_GLOBAL_BRAIN_DIR || path.join(os.homedir(), '.monomind', 'global-brain');
-        const globalMetaFile = path.join(globalDir, '.monomind', 'knowledge', 'doc-metadata.jsonl');
-        const docs = [];
-        let totalSize = 0, totalChunks = 0;
-        for (const [file, scope] of [[metaFile, 'project'], [globalMetaFile, 'global']]) {
-          if (!fs.existsSync(file)) continue;
-          const latest = new Map();
-          for (const l of fs.readFileSync(file, 'utf8').split('\n')) {
-            if (!l.trim()) continue;
-            try {
-              const m = JSON.parse(l);
-              latest.set(m.filePath + ' ' + m.scope, m);
-            } catch {}
-          }
-          for (const m of latest.values()) {
-            if (m.chunkCount < 0) continue;
-            const exists = fs.existsSync(m.filePath);
-            docs.push({ ...m, brainScope: scope, exists, name: path.basename(m.filePath) });
-            totalSize += m.size || 0;
-            totalChunks += m.chunkCount || 0;
-          }
-        }
-        docs.sort((a, b) => (b.indexedAt || '').localeCompare(a.indexedAt || ''));
-        const globalCount = docs.filter(d => d.brainScope === 'global').length;
-        res.writeHead(200, { 'Content-Type': 'application/json', ...(corsOrigin ? { 'Access-Control-Allow-Origin': corsOrigin } : {}) });
-        res.end(JSON.stringify({ docs, totalDocs: docs.length, totalSize, totalChunks, globalCount, projectCount: docs.length - globalCount }));
-      } catch (err) {
-        res.writeHead(500, { 'Content-Type': 'application/json' });
-        res.end(JSON.stringify({ error: err.message }));
-      }
-      return;
-    }
-
-    // GET /api/second-brain-ingest-stream — SSE stream tailing doc-metadata.jsonl for live ingest events
-    if (req.method === 'GET' && url === '/api/second-brain-ingest-stream') {
-      res.writeHead(200, {
-        'Content-Type': 'text/event-stream', 'Cache-Control': 'no-cache', 'Connection': 'keep-alive',
-        ...(corsOrigin ? { 'Access-Control-Allow-Origin': corsOrigin } : {})
-      });
-      res.write('data: {"type":"connected"}\n\n');
-      const metaFile = path.join(projectDir || process.cwd(), '.monomind', 'knowledge', 'doc-metadata.jsonl');
-      let lastSize = 0;
-      try { lastSize = fs.statSync(metaFile).size; } catch {}
-      function _sseTailFile(filePath, lastSizeRef, eventType, transform) {
-        try {
-          const stat = fs.statSync(filePath);
-          if (stat.size < lastSizeRef.v) { lastSizeRef.v = 0; }
-          if (stat.size > lastSizeRef.v) {
-            let fd;
-            try {
-              fd = fs.openSync(filePath, 'r');
-              const buf = Buffer.alloc(stat.size - lastSizeRef.v);
-              fs.readSync(fd, buf, 0, buf.length, lastSizeRef.v);
-              lastSizeRef.v = stat.size;
-              const lines = buf.toString('utf8').split('\n').filter(Boolean);
-              for (const l of lines) {
-                try { const parsed = JSON.parse(l); res.write('data: ' + JSON.stringify(transform(parsed)) + '\n\n'); } catch {}
-              }
-            } finally { if (fd !== undefined) fs.closeSync(fd); }
-          }
-        } catch {}
-      }
-      const metaSize = { v: lastSize };
-      const interval = setInterval(() => _sseTailFile(metaFile, metaSize, 'ingest', m => ({ type: 'ingest', doc: { ...m, name: path.basename(m.filePath || '') } })), 2000);
-      const metricsFile = path.join(projectDir || process.cwd(), '.monomind', 'metrics', 'second-brain.jsonl');
-      const metricsSize = { v: 0 };
-      try { metricsSize.v = fs.statSync(metricsFile).size; } catch {}
-      const metricsInterval = setInterval(() => _sseTailFile(metricsFile, metricsSize, 'injection', e => ({ type: 'injection', event: e })), 3000);
-      req.on('close', () => { clearInterval(interval); clearInterval(metricsInterval); });
-      return;
-    }
-
-    // GET /api/second-brain-kg — knowledge graph triplets + stats for the KG explorer
-    if (req.method === 'GET' && url === '/api/second-brain-kg') {
-      try {
-        const qs = new URL(req.url, 'http://localhost').searchParams;
-        const query = (qs.get('q') || '').slice(0, 200);
-        const limit = Math.min(parseInt(qs.get('limit') || '50', 10), 200);
-        const monoDir = path.join(projectDir || process.cwd(), '.monomind');
-        const dbPath = path.join(monoDir, 'memory');
-        let stats = { nodes: 0, edges: 0 }, triplets = [], glossary = [];
-        try {
-          const kg = await import('../memory/memory-kg.js');
-          stats = await kg.kgStats({ dbPath });
-          glossary = await kg.kgGlossary({ dbPath, limit: 30 });
-          if (query) {
-            const searchResult = await kg.kgSearch({ query, limit, dbPath });
-            triplets = searchResult.triplets || searchResult || [];
-          } else {
-            const searchResult = await kg.kgSearch({ query: '*', limit, dbPath }).catch(() => null);
-            triplets = searchResult ? (searchResult.triplets || searchResult) : [];
-          }
-        } catch {}
-        // Also check palace kg.json as fallback
-        if (triplets.length === 0) {
-          try {
-            const palaceDir = path.join(monoDir, 'palace');
-            const kgData = JSON.parse(fs.readFileSync(path.join(palaceDir, 'kg.json'), 'utf8'));
-            if (Array.isArray(kgData)) {
-              triplets = kgData.slice(0, limit);
-              stats.nodes = new Set(kgData.flatMap(t => [t.subject || t.s, t.object || t.o])).size;
-              stats.edges = kgData.length;
-            }
-          } catch {}
-        }
-        res.writeHead(200, { 'Content-Type': 'application/json', ...(corsOrigin ? { 'Access-Control-Allow-Origin': corsOrigin } : {}) });
-        res.end(JSON.stringify({ stats, triplets, glossary }));
-      } catch (err) {
-        res.writeHead(500, { 'Content-Type': 'application/json' });
-        res.end(JSON.stringify({ error: err.message }));
-      }
-      return;
-    }
-
     // GET /api/mastermind/metrics — aggregate system metrics from token-summary and swarm-activity
     if (req.method === 'GET' && url === '/api/mastermind/metrics') {
       try {

package/packages/@monomind/cli/dist/src/utils/cosine-similarity.d.ts

@@ -5,8 +5,8 @@
  *   - memory/intelligence.ts (ReasoningBank.cosineSim)
  *   - mcp-tools/neural-tools.ts (cosineSimilarity)
  *   - mcp-tools/embeddings-tools.ts (cosineSimilarity)
- *   - mcp-tools/coherence/types.ts (cosineSimilarity)
- *   - mcp-tools/coherence/coherence-check.ts (cosineSimilarity)
+ *   - mcp-tools/coherence/types.ts + coherence-check.ts (both since deleted
+ *     along with the rest of the uncalled coherence_* family)
  *
  * This is the single canonical implementation. Accepts number[] or
  * Float32Array. Handles dimension mismatches gracefully (uses the shorter

package/packages/@monomind/cli/dist/src/utils/cosine-similarity.js

@@ -5,8 +5,8 @@
  *   - memory/intelligence.ts (ReasoningBank.cosineSim)
  *   - mcp-tools/neural-tools.ts (cosineSimilarity)
  *   - mcp-tools/embeddings-tools.ts (cosineSimilarity)
- *   - mcp-tools/coherence/types.ts (cosineSimilarity)
- *   - mcp-tools/coherence/coherence-check.ts (cosineSimilarity)
+ *   - mcp-tools/coherence/types.ts + coherence-check.ts (both since deleted
+ *     along with the rest of the uncalled coherence_* family)
  *
  * This is the single canonical implementation. Accepts number[] or
  * Float32Array. Handles dimension mismatches gracefully (uses the shorter

package/packages/@monomind/cli/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@monoes/monomindcli",
-  "version": "2.7.4",
+  "version": "2.7.6",
   "type": "module",
-  "description": "CLI engine for Monomind — an open-source MCP server that extends Claude Code with a codebase knowledge graph (tree-sitter + SQLite), persistent memory, multi-agent task coordination, and session hooks. MIT licensed, fully local.",
+  "description": "CLI engine for Monomind \u2014 an open-source MCP server that extends Claude Code with a codebase knowledge graph (tree-sitter + SQLite), persistent memory, multi-agent task coordination, and session hooks. MIT licensed, fully local.",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",
   "sideEffects": false,
@@ -81,9 +81,11 @@
     "README.md"
   ],
   "scripts": {
+    "prebuild": "rm -rf dist",
     "build": "tsc && mkdir -p dist/src/browser/dashboard && cp src/browser/dashboard/ui.html dist/src/browser/dashboard/ui.html && mkdir -p dist/src/ui && cp src/ui/dashboard.html src/ui/server.mjs src/ui/collector.mjs src/ui/orgs.html src/ui/orgs-files.js src/ui/sse-manager.mjs src/ui/mastermind-diagram-fallback.html dist/src/ui/ && rm -rf dist/src/ui/data && cp -r src/ui/data dist/src/ui/data",
     "build:loose": "tsc --noEmitOnError false || true && mkdir -p dist/src/browser/dashboard && cp src/browser/dashboard/ui.html dist/src/browser/dashboard/ui.html && mkdir -p dist/src/ui && cp src/ui/dashboard.html src/ui/server.mjs src/ui/collector.mjs src/ui/orgs.html src/ui/orgs-files.js src/ui/sse-manager.mjs src/ui/mastermind-diagram-fallback.html dist/src/ui/ && rm -rf dist/src/ui/data && cp -r src/ui/data dist/src/ui/data",
     "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
     "test:pattern-store": "npx tsx src/transfer/store/tests/standalone-test.ts",
     "prepublishOnly": "node ../../@monoes/monodesign/scripts/sync-skill.mjs && cp ../../../README.md ./README.md",
     "release": "npm version prerelease --preid=alpha && npm run publish:all",
@@ -97,7 +99,7 @@
     "@anthropic-ai/claude-agent-sdk": "^0.3.207",
     "@monoes/monobrowse": "^1.0.6",
     "@monoes/monodesign": "^1.2.0",
-    "@monoes/monograph": "^1.5.3",
+    "@monoes/monograph": "^1.5.4",
     "@noble/ed25519": "^2.1.0",
     "mammoth": "^1.12.0",
     "pdf-parse": "^2.4.5",

package/scripts/generate-channel-profile-assets.sh

@@ -0,0 +1,67 @@
+#!/bin/bash
+# Generates the shared "monoes" monkey mascot avatar + one channel-appropriate
+# banner per platform (each referencing the avatar so the character stays
+# visually consistent), via monoagentcli's Gemini browser crawl.
+set -uo pipefail
+
+OUT="/Volumes/media/projects/monoes/monomind/.monomind/orgs/monomind-growth/workspace/reports/channel-profiles"
+mkdir -p "$OUT"
+
+log() { echo "[$(date '+%H:%M:%S')] $*" >&2; }
+
+gen() {
+  local name="$1" prompt="$2" ref="${3:-}"
+  if [ -s "$OUT/$name.png" ]; then
+    log "Skipping $name, already exists"
+    echo "$OUT/$name.png"
+    return 0
+  fi
+  local cfg
+  if [ -n "$ref" ]; then
+    cfg=$(printf '{"prompt":"%s","referenceImagePath":"%s","maxWaitSeconds":150,"downloadDir":"%s"}' "$prompt" "$ref" "$OUT")
+  else
+    cfg=$(printf '{"prompt":"%s","maxWaitSeconds":150,"downloadDir":"%s"}' "$prompt" "$OUT")
+  fi
+  log "Generating $name: $prompt"
+  local out errfile
+  errfile=$(mktemp)
+  out=$(monoagentcli --profile monoes node run gemini.generate_image --headless --output json --config "$cfg" 2>"$errfile")
+  if [ -s "$errfile" ]; then log "  (stderr: $(cat "$errfile"))"; fi
+  rm -f "$errfile"
+  local path
+  path=$(echo "$out" | node -e "let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{try{const j=JSON.parse(d);const img=j.main?.[0]?.json?.images?.[0];console.log(img?img.path:'');}catch(e){console.log('');}})")
+  if [ -z "$path" ]; then
+    log "FAILED: $name — raw output: $out"
+    echo "FAIL:$name" >> "$OUT/.gen-status"
+    return 1
+  fi
+  local final="$OUT/$name.png"
+  mv "$path" "$final"
+  log "OK: $name -> $final"
+  echo "OK:$name:$final" >> "$OUT/.gen-status"
+  echo "$final"
+}
+
+# Reference is the REAL existing monomind logo (assets/logo.png) — a soft
+# 3D-rendered meditating monkey with a glowing brain, blue "M" neckerchief,
+# white background. Every banner below must keep that exact character,
+# rendering style, and white/clean background — only the pose/prop changes.
+AVATAR="$OUT/avatar-monoes.png"
+if [ ! -s "$AVATAR" ]; then log "Avatar missing at $AVATAR, aborting"; exit 1; fi
+log "Using real logo as reference: $AVATAR"
+
+# Prompt template proven to preserve the character (tested live 2026-07-24):
+# "same cute 3D cartoon monkey mascot with blue M neckerchief, <action>"
+log "=== Banners (same character/render style as reference, no added text) ==="
+gen "banner-x-twitter"  "same cute 3D cartoon monkey mascot with blue M neckerchief, sitting at laptop" "$AVATAR"
+gen "banner-linkedin"   "same cute 3D cartoon monkey mascot with blue M neckerchief, wearing a tiny tie" "$AVATAR"
+gen "banner-reddit"     "same cute 3D cartoon monkey mascot with blue M neckerchief, reading a book" "$AVATAR"
+gen "banner-discord"    "same cute 3D cartoon monkey mascot with blue M neckerchief, wearing headphones" "$AVATAR"
+gen "banner-bluesky"    "same cute 3D cartoon monkey mascot with blue M neckerchief, holding paper airplane" "$AVATAR"
+gen "banner-mastodon"   "same cute 3D cartoon monkey mascot with blue M neckerchief, watering a small plant" "$AVATAR"
+gen "banner-youtube"    "same cute 3D cartoon monkey mascot with blue M neckerchief, holding small camera" "$AVATAR"
+gen "banner-devto"      "same cute 3D cartoon monkey mascot with blue M neckerchief, writing in notebook" "$AVATAR"
+gen "banner-newsletter" "same cute 3D cartoon monkey mascot with blue M neckerchief, holding an envelope" "$AVATAR"
+
+log "=== Done ==="
+cat "$OUT/.gen-status" 2>/dev/null

package/scripts/growth-content-calendar.mjs

@@ -30,17 +30,20 @@ function parseArticles(text, org) {
     const [, slug, title] = m;
     let heroImage = null;
     let supportingImages = [];
+    let diagrams = [];
     const bodyLines = [];
     for (const line of lines.slice(1)) {
       const heroMatch = line.match(/^HeroImage:\s*(.+?)\s*$/i);
       const suppMatch = line.match(/^SupportingImages:\s*(.+?)\s*$/i);
+      const diagMatch = line.match(/^Diagrams:\s*(.+?)\s*$/i);
       if (heroMatch) { heroImage = heroMatch[1]; continue; }
       if (suppMatch) { supportingImages = suppMatch[1].split(',').map((s) => s.trim()).filter(Boolean); continue; }
+      if (diagMatch) { diagrams = diagMatch[1].split(',').map((s) => s.trim()).filter(Boolean); continue; }
       bodyLines.push(line);
     }
     const body = bodyLines.join('\n').trim();
     if (!body) continue;
-    articles.push({ org, slug: slug.trim(), title: title.trim(), heroImage, supportingImages, body });
+    articles.push({ org, slug: slug.trim(), title: title.trim(), heroImage, supportingImages, diagrams, body });
   }
   return articles;
 }
@@ -80,15 +83,25 @@ function escapeHtml(s) {
   return String(s).replace(/[&<>"']/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' }[c]));
 }
 
-function mdToHtml(md) {
-  // Minimal renderer: paragraphs, headings, code fences, bold/italic, links, tables.
-  return escapeHtml(md)
+function mdToHtml(md, copiedSet) {
+  // Minimal renderer: paragraphs, headings, code fences, bold/italic, inline images, tables.
+  const figures = [];
+  const placeholder = (i) => `[[[FIGURE-${i}]]]`;
+  const withPlaceholders = md.replace(/!\[(.*?)\]\((?:\.\/)?(.*?)\)/g, (_, alt, src) => {
+    const idx = figures.length;
+    const visible = copiedSet.has(src);
+    figures.push(visible ? `<figure class="inline-diagram"><img src="./${escapeHtml(src)}" alt="${escapeHtml(alt)}"><figcaption>${escapeHtml(alt)}</figcaption></figure>` : '');
+    return placeholder(idx);
+  });
+  let html = escapeHtml(withPlaceholders)
     .replace(/^### (.+)$/gm, '<h4>$1</h4>')
     .replace(/^## (.+)$/gm, '<h3>$1</h3>')
     .replace(/^# (.+)$/gm, '<h2>$1</h2>')
     .replace(/```([\s\S]*?)```/g, (_, code) => `<pre><code>${code}</code></pre>`)
     .replace(/\*\*(.+?)\*\*/g, '<strong>$1</strong>')
     .replace(/\n\n/g, '</p><p>');
+  figures.forEach((fig, i) => { html = html.replace(placeholder(i), fig); });
+  return html;
 }
 
 function render() {
@@ -121,7 +134,7 @@ function render() {
   // copy every referenced image (article hero/supporting + post images) alongside html/md
   const copied = new Set();
   const allImageNames = new Set([
-    ...articles.flatMap((a) => [a.heroImage, ...a.supportingImages].filter(Boolean)),
+    ...articles.flatMap((a) => [a.heroImage, ...a.supportingImages, ...a.diagrams].filter(Boolean)),
     ...posts.map((p) => p.image).filter(Boolean),
   ]);
   for (const name of allImageNames) {
@@ -172,12 +185,14 @@ function render() {
   function articleCard(a) {
     const img = a.heroImage && copied.has(a.heroImage) ? `<img class="hero" src="./${escapeHtml(a.heroImage)}" alt="">` : '';
     const supp = a.supportingImages.filter((n) => copied.has(n)).map((n) => `<img class="supporting" src="./${escapeHtml(n)}" alt="">`).join('');
+    const missingDiagrams = a.diagrams.filter((n) => !copied.has(n));
     return `<div class="article">
       <div class="article-slug">${escapeHtml(a.slug)}</div>
       <h3 class="article-title">${escapeHtml(a.title)}</h3>
       ${img}
       ${supp ? `<div class="supporting-row">${supp}</div>` : ''}
-      <div class="article-body"><p>${mdToHtml(a.body)}</p></div>
+      <div class="article-body"><p>${mdToHtml(a.body, copied)}</p></div>
+      ${missingDiagrams.length ? `<div class="missing-note">Missing diagram file(s) referenced but not found: ${missingDiagrams.map(escapeHtml).join(', ')}</div>` : ''}
     </div>`;
   }
 
@@ -211,6 +226,11 @@ main { max-width:860px; margin:0 auto; padding:0 1.5rem 4rem; }
 .supporting-row img { width:100%; border-radius:8px; }
 .article-body { font-size:.92rem; color:var(--text); }
 .article-body p { white-space:pre-wrap; }
+.article-body h2, .article-body h3, .article-body h4 { white-space:normal; }
+.inline-diagram { margin:1.2rem 0; }
+.inline-diagram img { width:100%; border-radius:8px; background:var(--espresso); }
+.inline-diagram figcaption { font-size:.78rem; color:var(--muted); margin-top:.3rem; text-align:center; }
+.missing-note { margin-top:1rem; padding:.6rem .8rem; border:1px dashed var(--border); border-radius:8px; font-size:.78rem; color:var(--muted); }
 .card { background:var(--card); border:1px solid var(--border); border-radius:12px; padding:1.1rem 1.3rem; margin-bottom:1rem; }
 .channel { font-size:.72rem; font-weight:700; text-transform:uppercase; letter-spacing:.04em; color:var(--accent); margin-bottom:.6rem; }
 .based-on { font-weight:400; text-transform:none; letter-spacing:0; color:var(--muted); font-style:italic; }
@@ -231,7 +251,10 @@ ${!articles.length && !posts.length ? '<div class="empty">Nothing finalized yet
 </body></html>`;
   fs.writeFileSync(path.join(OUT_DIR, 'content-calendar.html'), html);
 
-  console.log(`Wrote ${articles.length} article(s), ${posts.length} post(s), ${copied.size} image(s) -> ${path.relative(ROOT, OUT_DIR)}`);
+  const totalDiagrams = articles.reduce((n, a) => n + a.diagrams.length, 0);
+  const underDiagrammed = articles.filter((a) => a.diagrams.length < 2).map((a) => a.slug);
+  console.log(`Wrote ${articles.length} article(s), ${posts.length} post(s), ${copied.size} image(s) (incl. ${totalDiagrams} diagram(s)) -> ${path.relative(ROOT, OUT_DIR)}`);
+  if (underDiagrammed.length) console.log(`Note: fewer than 2 diagrams on: ${underDiagrammed.join(', ')}`);
 }
 
 render();