analyzthis_design 2.0.1 → 2.1.0

package/dist/lib/moodboard.js

@@ -1 +1,563 @@
-'use strict';var fs=require('fs'),path=require('path'),os=require('os'),crypto=require('crypto'),session=require('./session'),research=require('./research'),retrieve=require('./retrieve'),knowledge=require('./knowledge'),deliberation=require('./deliberation'),{run:orchestratorRun}=require('./orchestrator/run'),{resolvePackageRoot}=require('./platforms'),CONFIG_FILE=path['join'](os['homedir'](),'.analyzthis_design','config.json'),PACKAGE_ROOT=resolvePackageRoot(__dirname),DESIGN_REFERENCE_DIR=path['join'](PACKAGE_ROOT,'skills','design-reference');function loadConfig(){if(!fs['existsSync'](CONFIG_FILE))return{};try{return JSON['parse'](fs['readFileSync'](CONFIG_FILE,'utf8'));}catch(a){return{};}}function generateBoardId(){return crypto['randomBytes'](0x6)['toString']('hex');}function boardDir(a,b){return path['join'](session['sessionDir'](a),'moodboard',b);}function defaultWorkspaceDir(){return path['join'](process['cwd'](),'moodboard');}function ensureDir(a){fs['mkdirSync'](a,{'recursive':!![]});}function loadJson(a){if(!fs['existsSync'](a))return null;try{return JSON['parse'](fs['readFileSync'](a,'utf8'));}catch(b){return null;}}function writeJson(a,b){ensureDir(path['dirname'](a)),fs['writeFileSync'](a,JSON['stringify'](b,null,0x2));}var MOOD_REFERENCE_HOSTS=['dribbble.com','mobbin.com','behance.net','www.behance.net','awwwards.com','www.awwwards.com','screenlane.com','www.screenlane.com','ui-patterns.com','www.ui-patterns.com','pttrns.com','www.pttrns.com','land-book.com','www.land-book.com','onepagelove.com','www.onepagelove.com'];function isVisualReferenceUrl(a){try{var b=new URL(a),c=b['hostname']['toLowerCase'](),d=path['extname'](b['pathname'])['toLowerCase']();if(['.png','.jpg','.jpeg','.gif','.webp','.svg','.avif']['indexOf'](d)!==-0x1)return!![];return MOOD_REFERENCE_HOSTS['some'](function(f){return c===f||c['endsWith']('.'+f);});}catch(f){return![];}}function extractUrlsFromText(a){var b=/https?:\/\/[^\s)'">\]`]+/gi,c=String(a)['match'](b)||[];return c['map'](function(d){return d['replace'](/^[`'"]+|[`'"]+$/g,'')['replace'](/[.,;:!?)]+$/g,'');})['filter'](function(d){return d['length']>=0xc&&!/[{}]/['test'](d);});}function discoverReferenceUrls({task:a,urls:b,config:c}){var d=c['moodboard']||{},e=(d['urls']||[])['concat'](b||[]),f=[],g={};for(var h=0x0;h<e['length'];h++){var k=e[h];if(g[k])continue;g[k]=!![],f['push']({'url':k,'source':'config','type':isVisualReferenceUrl(k)?'visual':'article'});}var l=d['queries']||[],m=String(a)['slice'](0x0,0x50);if(l['indexOf'](m)===-0x1)l['push'](m);for(var n=0x0;n<l['length'];n++){var o=l[n],p='https://www.google.com/search?q='+encodeURIComponent(o+'\x20design\x20inspiration');!g[p]&&(g[p]=!![],f['push']({'url':p,'source':'query_stub','type':'search_stub','query':o}));}return f['slice'](0x0,d['limit']||0xc);}async function fetchReference(a){var b={'id':generateBoardId(),'url':a['url'],'source':a['source'],'type':a['type']||'article','query':a['query']||'','title':'','description':'','tags':[],'fetched_at':new Date()['toISOString'](),'error':null};if(a['type']==='search_stub')return b['title']='Search\x20stub:\x20'+a['query'],b['description']='Host\x20IDE:\x20perform\x20web\x20search\x20for\x20\x22'+a['query']+'\x22\x20and\x20add\x20the\x20resulting\x20references\x20to\x20the\x20board.',b['tags']=['search_stub'],b;if(a['type']==='visual')return b['title']='Visual\x20reference:\x20'+path['basename'](new URL(a['url'])['pathname']||'image'),b['description']='Image\x20URL.\x20Add\x20alt-text\x20or\x20a\x20local\x20caption\x20after\x20review.',b['tags']=['visual'],b;try{var c=await research['researchUrl']({'url':a['url'],'maxChars':0x7d0}),d=research['readWebContext']()||{'content':''},f=d['content']['split'](/^## /m),g=f[f['length']-0x1]||'',h=g['split']('\x0a')['filter'](function(m){return m['trim']();}),j=[];for(var k=0x0;k<h['length'];k++){var l=h[k];if(l['indexOf']('Source:')===0x0)continue;if(l['indexOf']('Fetched:')===0x0)continue;j['push'](l);}b['title']='Fetched:\x20'+a['url'],b['description']=j['join']('\x20')['slice'](0x0,0x258),b['tags']=['article'];}catch(m){b['error']=m['message'],b['description']='Could\x20not\x20fetch\x20this\x20URL.';}return b;}function tagHeuristics(a,b){var c=[]['concat'](a['tags']||[]),d=(a['description']+'\x20'+a['title'])['toLowerCase'](),e=String(b)['toLowerCase'](),f=[['minimal','minimalism'],['modern','modern'],['dark','dark\x20mode'],['light','light'],['b2b','b2b'],['saas','saas'],['dashboard','dashboard'],['fintech','fintech'],['healthcare','healthcare'],['ecommerce','e-commerce'],['luxury','luxury'],['playful','playful'],['trust','trust'],['data-dense','data-dense'],['card','cards'],['table','tables'],['glassmorphism','glassmorphism'],['neumorphism','neumorphism'],['brutalism','brutalism'],['typography','typography'],['color','color']];for(var g=0x0;g<f['length'];g++){var h=f[g][0x0],k=f[g][0x1];if(d['indexOf'](k)!==-0x1&&c['indexOf'](h)===-0x1)c['push'](h);}var l=['dashboard','landing','onboarding','settings','checkout','profile','invoice','analytics','calendar','form','wizard','modal'];for(var m=0x0;m<l['length'];m++){var n=l[m];if(e['indexOf'](n)!==-0x1&&c['indexOf'](n)===-0x1)c['push'](n);}return c;}async function tagReference(a,b,c){var d=tagHeuristics(a,b);if(!c)return a['tags']=d,a;var f=['You\x20are\x20a\x20design-librarian.\x20Tag\x20this\x20reference\x20for\x20a\x20mood\x20board.','Return\x20ONLY\x20a\x20JSON\x20object\x20with\x20keys:\x20\x22tags\x22\x20(array\x20of\x203-7\x20short\x20slugs),\x20\x22mood\x22\x20(one\x20word),\x20\x22surface\x22\x20(what\x20UI\x20surface\x20it\x20shows,\x20e.g.\x20dashboard,\x20landing,\x20settings),\x20\x22style\x22\x20(one\x20of:\x20minimal,\x20dense,\x20playful,\x20premium,\x20brutalist,\x20glassmorphism,\x20neumorphism,\x20corporate,\x20editorial).','','Task\x20context:\x20'+String(b)['slice'](0x0,0xc8),'','Reference\x20title:\x20'+(a['title']||'')['slice'](0x0,0xc8),'Description:\x20'+(a['description']||'')['slice'](0x0,0x1f4),'Existing\x20heuristic\x20tags:\x20'+d['join'](',\x20')]['join']('\x0a');try{var g=await c({'system':'','user':f,'maxTokens':0x190,'personaId':'mood-tagger'}),h=null,j=g['match'](/```json\s*([\s\S]*?)```/i);if(j)h=JSON['parse'](j[0x1]['trim']());else h=JSON['parse'](g['trim']());if(h&&Array['isArray'](h['tags']))for(var k=0x0;k<h['tags']['length'];k++){var l=h['tags'][k];if(d['indexOf'](l)===-0x1)d['push'](l);}if(h&&h['mood']&&d['indexOf'](h['mood'])===-0x1)d['push'](h['mood']);if(h&&h['surface']&&d['indexOf'](h['surface'])===-0x1)d['push'](h['surface']);if(h&&h['style']&&d['indexOf'](h['style'])===-0x1)d['push'](h['style']);}catch(m){}return a['tags']=d,a;}function getDsReferencePack(a,b){var c=[],d=[],f=String(a)['toLowerCase'](),g=[['saas','saas'],['b2b','b2b'],['dashboard','dashboard'],['fintech','fintech'],['healthcare','healthcare'],['ecommerce','e-commerce'],['luxury','luxury'],['landing','landing'],['mobile','mobile'],['analytics','analytics'],['productivity','productivity'],['social','social']];for(var h=0x0;h<g['length'];h++){if(f['indexOf'](g[h][0x0])!==-0x1)d['push'](g[h][0x1]);}if(!d['length'])d['push']('general');var j=[{'file':'ui-reasoning.csv','column':'UI_Category','limit':0x3},{'file':'colors.csv','column':'Product\x20Type','limit':0x3},{'file':'styles.csv','column':'Best\x20For','limit':0x3},{'file':'typography.csv','column':'Mood','limit':0x2},{'file':'ux-guidelines.csv','column':'Category','limit':0x3}];if(b){var k=path['join']('stacks',b+'.csv'),l=path['join'](DESIGN_REFERENCE_DIR,k);fs['existsSync'](l)&&j['unshift']({'file':k,'column':'Category','limit':0x3});}for(var m=0x0;m<j['length'];m++){var n=j[m];try{var o=retrieve['retrieve']({'file':n['file'],'filters':[{'column':n['column'],'anyOf':d}],'limit':n['limit']});o['rows']['length']&&c['push']({'file':n['file'],'rows':o['rows']});}catch(p){}}return c;}function formatDsPack(a){var b=['Design-system\x20reference\x20patterns:'];for(var c=0x0;c<a['length'];c++){var d=a[c];b['push']('\x0a['+d['file']+']');for(var e=0x0;e<d['rows']['length'];e++){var f=d['rows'][e],g=Object['keys'](f)['map'](function(h){return h+'='+f[h];})['join']('\x20|\x20');b['push']('\x20\x20•\x20'+g['slice'](0x0,0x12c));}}return b['join']('\x0a');}async function buildMoodBoard(a){a=a||{};var b=a['project']||session['getProjectId'](),c=a['task']||'',d=loadConfig(),f=a['workspaceDir']||d['moodboard']?.['workspace_dir']||defaultWorkspaceDir(),g=a['boardId']||generateBoardId(),h=boardDir(b,g);ensureDir(h);var j=[],k=a['userReferences']||[],l=a['discover']!==![];if(l){var m=discoverReferenceUrls({'task':c,'urls':a['urls']||[],'config':d});for(var n=0x0;n<m['length'];n++){var o=await fetchReference(m[n]),p=await tagReference(o,c,a['callLlmFn']||null);j['push'](p);}}for(var q=0x0;q<k['length'];q++){var r=k[q],s={'id':generateBoardId(),'url':r['url']||'','title':r['title']||(r['url']?path['basename'](new URL(r['url'])['pathname']||'user-ref'):'User\x20note'),'description':r['description']||'','source':'user','type':r['type']||'note','tags':r['tags']||[],'user_note':r['note']||'','fetched_at':new Date()['toISOString']()};if(!s['tags']['length'])s['tags']=tagHeuristics(s,c);j['push'](s);}var t=session['show']({'project':b})||session['init']({'project':b}),v=detectStack(t['vault_path']),w=getDsReferencePack(c,v),x={'board_id':g,'project_id':b,'task':c,'created_at':new Date()['toISOString'](),'updated_at':new Date()['toISOString'](),'references':j,'design_system_pack':w,'deliberation':null,'synthesis':null,'user_contributions':k['length']};writeJson(path['join'](h,'board.json'),x),ensureDir(f);var y=path['join'](f,g+'.json');try{fs['writeFileSync'](y,JSON['stringify'](x,null,0x2));}catch(z){}return{'board':x,'boardDir':h,'workspacePath':y};}function detectStack(a){if(!a||!fs['existsSync'](path['join'](a,'Tech')))return null;var b=fs['readdirSync'](path['join'](a,'Tech'))['map'](function(e){return e['toLowerCase']();}),c=['nextjs','react','shadcn','vue','angular','svelte','nuxtjs','astro'];for(var d=0x0;d<c['length'];d++){if(b['some'](function(e){return e['indexOf'](c[d])!==-0x1;}))return c[d];}return null;}async function critiqueMoodBoard(a){a=a||{};var b=a['project']||session['getProjectId'](),c=a['boardId'];if(!c)throw new Error('--board\x20is\x20required');var d=boardDir(b,c),f=path['join'](d,'board.json'),g=loadJson(f);if(!g)throw new Error('Board\x20not\x20found:\x20'+c);var h=a['experts']||['arjun','meera','priya','zara','noor'],i=a['task']||g['task'],j=g['references']['map'](function(p,q){return'['+(q+0x1)+']\x20'+p['title']+'\x20('+p['type']+')\x20tags='+p['tags']['join'](',')+'\x20—\x20'+(p['url']||p['description'])['slice'](0x0,0x78);})['join']('\x0a'),k=formatDsPack(g['design_system_pack']),l=['Mood-board\x20critique\x20for:\x20'+i,'','References:\x0a'+j,'',k,'','Each\x20persona\x20must\x20use\x20the\x20Honeycomb\x20rigor\x20matrix\x20to\x20evaluate\x20which\x20references\x20are\x20appropriate\x20for\x20the\x20user\x20and\x20why.\x20Output\x20scores,\x20top\x20concerns,\x20and\x20a\x20ranked\x20shortlist\x20of\x20the\x20best\x202-3\x20references.\x20Then\x20participate\x20in\x20adversarial\x20deliberation\x20until\x20consensus.']['join']('\x0a'),m=await orchestratorRun({'task':l,'experts':h,'project':b,'provider':a['provider']||'host','model':a['model'],'dryRun':!!a['dryRun'],'deliberate':a['noDeliberate']?![]:!![],'maxRounds':a['maxRounds']||0x3,'satisfaction':a['satisfaction']||0.4,'hostResponder':a['hostResponder']||null});g['deliberation']=m['deliberation'],g['synthesis']=m['synthesis'],g['updated_at']=new Date()['toISOString'](),g['critique_task']=l,writeJson(f,g);var n=a['workspaceDir']||defaultWorkspaceDir();ensureDir(n);var o=path['join'](n,c+'.json');try{fs['writeFileSync'](o,JSON['stringify'](g,null,0x2));}catch(p){}return{'board':g,'orchestratorResult':m};}async function addUserReferenceAndRerun(a){a=a||{};var b=a['project']||session['getProjectId'](),c=a['boardId'],d=a['reference'];if(!c||!d)throw new Error('--board\x20and\x20--reference\x20are\x20required');var e=boardDir(b,c),f=path['join'](e,'board.json'),g=loadJson(f);if(!g)throw new Error('Board\x20not\x20found:\x20'+c);var h={'id':generateBoardId(),'url':d['url']||'','title':d['title']||(d['url']?path['basename'](new URL(d['url'])['pathname']||'user-ref'):'User\x20note'),'description':d['description']||'','source':'user','type':d['type']||'note','tags':d['tags']||[],'user_note':d['note']||'','fetched_at':new Date()['toISOString']()};if(!h['tags']['length'])h['tags']=tagHeuristics(h,g['task']);g['references']['push'](h),g['user_contributions']=(g['user_contributions']||0x0)+0x1,g['updated_at']=new Date()['toISOString'](),writeJson(f,g);var i=await critiqueMoodBoard({'project':b,'boardId':c,'task':a['task']||g['task'],'experts':a['experts'],'provider':a['provider'],'model':a['model'],'dryRun':!!a['dryRun'],'noDeliberate':a['noDeliberate'],'maxRounds':a['maxRounds'],'satisfaction':a['satisfaction'],'hostResponder':a['hostResponder']});return{'board':i['board'],'added':h};}function listBoards(a){a=a||session['getProjectId']();var b=path['join'](session['sessionDir'](a),'moodboard');if(!fs['existsSync'](b))return[];return fs['readdirSync'](b,{'withFileTypes':!![]})['filter'](function(c){return c['isDirectory']();})['map'](function(c){return c['name'];});}module['exports']={'buildMoodBoard':buildMoodBoard,'critiqueMoodBoard':critiqueMoodBoard,'addUserReferenceAndRerun':addUserReferenceAndRerun,'listBoards':listBoards,'boardDir':boardDir,'formatDsPack':formatDsPack,'tagHeuristics':tagHeuristics};
+'use strict';
+
+/**
+ * MoodBoard engine (v1.22).
+ *
+ * Collects visual + textual references from the web and design-system data,
+ * tags them, lets the user contribute references, then runs the persona team
+ * through an adversarial deliberation loop to converge on a direction.
+ *
+ * Artifacts are written to:
+ *   ~/.analyzthis_design/sessions/{projectId}/moodboard/{boardId}/
+ * and symlinked/copied into the project workspace at:
+ *   ./moodboard/ (unless the user changes the output path in config).
+ *
+ * All new files use CommonJS, 'use strict', no optional chaining, var, and
+ * try/catch around JSON/fs to stay compatible with the Llama 30B safety
+ * settings used elsewhere in this repo.
+ */
+
+var fs = require('fs');
+var path = require('path');
+var os = require('os');
+var crypto = require('crypto');
+var session = require('./session');
+var research = require('./research');
+var retrieve = require('./retrieve');
+var knowledge = require('./knowledge');
+var deliberation = require('./deliberation');
+var { run: orchestratorRun } = require('./orchestrator/run');
+var { resolvePackageRoot } = require('./platforms');
+
+var CONFIG_FILE = path.join(os.homedir(), '.analyzthis_design', 'config.json');
+var PACKAGE_ROOT = resolvePackageRoot(__dirname);
+var DESIGN_REFERENCE_DIR = path.join(PACKAGE_ROOT, 'skills', 'design-reference');
+
+function loadConfig() {
+  if (!fs.existsSync(CONFIG_FILE)) return {};
+  try { return JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8')); }
+  catch (e) { return {}; }
+}
+
+function generateBoardId() {
+  return crypto.randomBytes(6).toString('hex');
+}
+
+function boardDir(projectId, boardId) {
+  return path.join(session.sessionDir(projectId), 'moodboard', boardId);
+}
+
+function defaultWorkspaceDir() {
+  return path.join(process.cwd(), 'moodboard');
+}
+
+function ensureDir(p) {
+  fs.mkdirSync(p, { recursive: true });
+}
+
+function loadJson(filePath) {
+  if (!fs.existsSync(filePath)) return null;
+  try { return JSON.parse(fs.readFileSync(filePath, 'utf8')); }
+  catch (e) { return null; }
+}
+
+function writeJson(filePath, obj) {
+  ensureDir(path.dirname(filePath));
+  fs.writeFileSync(filePath, JSON.stringify(obj, null, 2));
+}
+
+// ─── Source discovery for mood references ───────────────────────────────────
+
+// Known hosts that expose an image or a design article we can fetch as text.
+var MOOD_REFERENCE_HOSTS = [
+  'dribbble.com',
+  'mobbin.com',
+  'behance.net',
+  'www.behance.net',
+  'awwwards.com',
+  'www.awwwards.com',
+  'screenlane.com',
+  'www.screenlane.com',
+  'ui-patterns.com',
+  'www.ui-patterns.com',
+  'pttrns.com',
+  'www.pttrns.com',
+  'land-book.com',
+  'www.land-book.com',
+  'onepagelove.com',
+  'www.onepagelove.com',
+];
+
+function isVisualReferenceUrl(url) {
+  try {
+    var u = new URL(url);
+    var host = u.hostname.toLowerCase();
+    var ext = path.extname(u.pathname).toLowerCase();
+    if (['.png', '.jpg', '.jpeg', '.gif', '.webp', '.svg', '.avif'].indexOf(ext) !== -1) return true;
+    return MOOD_REFERENCE_HOSTS.some(function(h) { return host === h || host.endsWith('.' + h); });
+  } catch (e) {
+    return false;
+  }
+}
+
+function extractUrlsFromText(text) {
+  var re = /https?:\/\/[^\s)'">\]`]+/gi;
+  var found = String(text).match(re) || [];
+  return found.map(function(u) {
+    return u.replace(/^[`'"]+|[`'"]+$/g, '').replace(/[.,;:!?)]+$/g, '');
+  }).filter(function(u) { return u.length >= 12 && !/[{}]/.test(u); });
+}
+
+function discoverReferenceUrls({ task, urls, config }) {
+  var cfg = config.moodboard || {};
+  var explicit = (cfg.urls || []).concat(urls || []);
+  var discovered = [];
+  var seen = {};
+
+  for (var i = 0; i < explicit.length; i++) {
+    var u = explicit[i];
+    if (seen[u]) continue;
+    seen[u] = true;
+    discovered.push({ url: u, source: 'config', type: isVisualReferenceUrl(u) ? 'visual' : 'article' });
+  }
+
+  // Add a small number of curated search stubs the host IDE can fill in.
+  var queries = cfg.queries || [];
+  var taskQuery = String(task).slice(0, 80);
+  if (queries.indexOf(taskQuery) === -1) queries.push(taskQuery);
+  for (var j = 0; j < queries.length; j++) {
+    var q = queries[j];
+    var stubUrl = 'https://www.google.com/search?q=' + encodeURIComponent(q + ' design inspiration');
+    if (!seen[stubUrl]) {
+      seen[stubUrl] = true;
+      discovered.push({ url: stubUrl, source: 'query_stub', type: 'search_stub', query: q });
+    }
+  }
+
+  return discovered.slice(0, cfg.limit || 12);
+}
+
+// ─── Fetch references (text + image metadata) ────────────────────────────────
+
+async function fetchReference(ref) {
+  var result = {
+    id: generateBoardId(),
+    url: ref.url,
+    source: ref.source,
+    type: ref.type || 'article',
+    query: ref.query || '',
+    title: '',
+    description: '',
+    tags: [],
+    fetched_at: new Date().toISOString(),
+    error: null,
+  };
+
+  if (ref.type === 'search_stub') {
+    result.title = 'Search stub: ' + ref.query;
+    result.description = 'Host IDE: perform web search for "' + ref.query + '" and add the resulting references to the board.';
+    result.tags = ['search_stub'];
+    return result;
+  }
+
+  if (ref.type === 'visual') {
+    result.title = 'Visual reference: ' + path.basename(new URL(ref.url).pathname || 'image');
+    result.description = 'Image URL. Add alt-text or a local caption after review.';
+    result.tags = ['visual'];
+    return result;
+  }
+
+  try {
+    var fetched = await research.researchUrl({ url: ref.url, maxChars: 2000 });
+    var web = research.readWebContext() || { content: '' };
+    var blocks = web.content.split(/^## /m);
+    var lastBlock = blocks[blocks.length - 1] || '';
+    var lines = lastBlock.split('\n').filter(function(l) { return l.trim(); });
+    var bodyLines = [];
+    for (var i = 0; i < lines.length; i++) {
+      var line = lines[i];
+      if (line.indexOf('Source:') === 0) continue;
+      if (line.indexOf('Fetched:') === 0) continue;
+      bodyLines.push(line);
+    }
+    result.title = 'Fetched: ' + ref.url;
+    result.description = bodyLines.join(' ').slice(0, 600);
+    result.tags = ['article'];
+  } catch (e) {
+    result.error = e.message;
+    result.description = 'Could not fetch this URL.';
+  }
+
+  return result;
+}
+
+// ─── Tag references with an LLM or fallback heuristics ───────────────────────
+
+function tagHeuristics(ref, task) {
+  var tags = [].concat(ref.tags || []);
+  var lowerDesc = (ref.description + ' ' + ref.title).toLowerCase();
+  var taskLower = String(task).toLowerCase();
+
+  var keywordMap = [
+    ['minimal', 'minimalism'],
+    ['modern', 'modern'],
+    ['dark', 'dark mode'],
+    ['light', 'light'],
+    ['b2b', 'b2b'],
+    ['saas', 'saas'],
+    ['dashboard', 'dashboard'],
+    ['fintech', 'fintech'],
+    ['healthcare', 'healthcare'],
+    ['ecommerce', 'e-commerce'],
+    ['luxury', 'luxury'],
+    ['playful', 'playful'],
+    ['trust', 'trust'],
+    ['data-dense', 'data-dense'],
+    ['card', 'cards'],
+    ['table', 'tables'],
+    ['glassmorphism', 'glassmorphism'],
+    ['neumorphism', 'neumorphism'],
+    ['brutalism', 'brutalism'],
+    ['typography', 'typography'],
+    ['color', 'color'],
+  ];
+
+  for (var i = 0; i < keywordMap.length; i++) {
+    var tag = keywordMap[i][0];
+    var needle = keywordMap[i][1];
+    if (lowerDesc.indexOf(needle) !== -1 && tags.indexOf(tag) === -1) tags.push(tag);
+  }
+
+  var taskKeywords = [
+    'dashboard', 'landing', 'onboarding', 'settings', 'checkout', 'profile',
+    'invoice', 'analytics', 'calendar', 'form', 'wizard', 'modal'
+  ];
+  for (var j = 0; j < taskKeywords.length; j++) {
+    var kw = taskKeywords[j];
+    if (taskLower.indexOf(kw) !== -1 && tags.indexOf(kw) === -1) tags.push(kw);
+  }
+
+  return tags;
+}
+
+async function tagReference(ref, task, callLlmFn) {
+  var tags = tagHeuristics(ref, task);
+  if (!callLlmFn) {
+    ref.tags = tags;
+    return ref;
+  }
+
+  var prompt = [
+    'You are a design-librarian. Tag this reference for a mood board.',
+    'Return ONLY a JSON object with keys: "tags" (array of 3-7 short slugs), "mood" (one word), "surface" (what UI surface it shows, e.g. dashboard, landing, settings), "style" (one of: minimal, dense, playful, premium, brutalist, glassmorphism, neumorphism, corporate, editorial).',
+    '',
+    'Task context: ' + String(task).slice(0, 200),
+    '',
+    'Reference title: ' + (ref.title || '').slice(0, 200),
+    'Description: ' + (ref.description || '').slice(0, 500),
+    'Existing heuristic tags: ' + tags.join(', '),
+  ].join('\n');
+
+  try {
+    var raw = await callLlmFn({ system: '', user: prompt, maxTokens: 400, personaId: 'mood-tagger' });
+    var parsed = null;
+    var fence = raw.match(/```json\s*([\s\S]*?)```/i);
+    if (fence) parsed = JSON.parse(fence[1].trim());
+    else parsed = JSON.parse(raw.trim());
+
+    if (parsed && Array.isArray(parsed.tags)) {
+      for (var i = 0; i < parsed.tags.length; i++) {
+        var t = parsed.tags[i];
+        if (tags.indexOf(t) === -1) tags.push(t);
+      }
+    }
+    if (parsed && parsed.mood && tags.indexOf(parsed.mood) === -1) tags.push(parsed.mood);
+    if (parsed && parsed.surface && tags.indexOf(parsed.surface) === -1) tags.push(parsed.surface);
+    if (parsed && parsed.style && tags.indexOf(parsed.style) === -1) tags.push(parsed.style);
+  } catch (e) {
+    // keep heuristic tags
+  }
+
+  ref.tags = tags;
+  return ref;
+}
+
+// ─── Design-system reference retrieval ────────────────────────────────────────
+
+function getDsReferencePack(task, stack) {
+  var packs = [];
+  var keywords = [];
+  var taskLower = String(task).toLowerCase();
+  var keywordMap = [
+    ['saas', 'saas'], ['b2b', 'b2b'], ['dashboard', 'dashboard'],
+    ['fintech', 'fintech'], ['healthcare', 'healthcare'], ['ecommerce', 'e-commerce'],
+    ['luxury', 'luxury'], ['landing', 'landing'], ['mobile', 'mobile'],
+    ['analytics', 'analytics'], ['productivity', 'productivity'], ['social', 'social']
+  ];
+  for (var i = 0; i < keywordMap.length; i++) {
+    if (taskLower.indexOf(keywordMap[i][0]) !== -1) keywords.push(keywordMap[i][1]);
+  }
+  if (!keywords.length) keywords.push('general');
+
+  var specs = [
+    { file: 'ui-reasoning.csv', column: 'UI_Category', limit: 3 },
+    { file: 'colors.csv', column: 'Product Type', limit: 3 },
+    { file: 'styles.csv', column: 'Best For', limit: 3 },
+    { file: 'typography.csv', column: 'Mood', limit: 2 },
+    { file: 'ux-guidelines.csv', column: 'Category', limit: 3 },
+  ];
+
+  if (stack) {
+    var stackFile = path.join('stacks', stack + '.csv');
+    var stackPath = path.join(DESIGN_REFERENCE_DIR, stackFile);
+    if (fs.existsSync(stackPath)) {
+      specs.unshift({ file: stackFile, column: 'Category', limit: 3 });
+    }
+  }
+
+  for (var s = 0; s < specs.length; s++) {
+    var spec = specs[s];
+    try {
+      var result = retrieve.retrieve({
+        file: spec.file,
+        filters: [{ column: spec.column, anyOf: keywords }],
+        limit: spec.limit,
+      });
+      if (result.rows.length) {
+        packs.push({ file: spec.file, rows: result.rows });
+      }
+    } catch (e) {
+      // skip missing files
+    }
+  }
+
+  return packs;
+}
+
+function formatDsPack(packs) {
+  var lines = ['Design-system reference patterns:'];
+  for (var i = 0; i < packs.length; i++) {
+    var p = packs[i];
+    lines.push('\n[' + p.file + ']');
+    for (var r = 0; r < p.rows.length; r++) {
+      var row = p.rows[r];
+      var values = Object.keys(row).map(function(k) { return k + '=' + row[k]; }).join(' | ');
+      lines.push('  • ' + values.slice(0, 300));
+    }
+  }
+  return lines.join('\n');
+}
+
+// ─── Build the mood board ─────────────────────────────────────────────────────
+
+async function buildMoodBoard(opts) {
+  opts = opts || {};
+  var projectId = opts.project || session.getProjectId();
+  var task = opts.task || '';
+  var config = loadConfig();
+  var workspaceDir = opts.workspaceDir || config.moodboard?.workspace_dir || defaultWorkspaceDir();
+  var boardId = opts.boardId || generateBoardId();
+  var bDir = boardDir(projectId, boardId);
+  ensureDir(bDir);
+
+  var refs = [];
+  var userRefs = opts.userReferences || [];
+  var discover = opts.discover !== false;
+
+  if (discover) {
+    var plan = discoverReferenceUrls({ task: task, urls: opts.urls || [], config: config });
+    for (var i = 0; i < plan.length; i++) {
+      var fetched = await fetchReference(plan[i]);
+      var tagged = await tagReference(fetched, task, opts.callLlmFn || null);
+      refs.push(tagged);
+    }
+  }
+
+  for (var u = 0; u < userRefs.length; u++) {
+    var ur = userRefs[u];
+    var ref = {
+      id: generateBoardId(),
+      url: ur.url || '',
+      title: ur.title || (ur.url ? path.basename(new URL(ur.url).pathname || 'user-ref') : 'User note'),
+      description: ur.description || '',
+      source: 'user',
+      type: ur.type || 'note',
+      tags: ur.tags || [],
+      user_note: ur.note || '',
+      fetched_at: new Date().toISOString(),
+    };
+    if (!ref.tags.length) ref.tags = tagHeuristics(ref, task);
+    refs.push(ref);
+  }
+
+  var state = session.show({ project: projectId }) || session.init({ project: projectId });
+  var stack = detectStack(state.vault_path);
+  var dsPack = getDsReferencePack(task, stack);
+
+  var board = {
+    board_id: boardId,
+    project_id: projectId,
+    task: task,
+    created_at: new Date().toISOString(),
+    updated_at: new Date().toISOString(),
+    references: refs,
+    design_system_pack: dsPack,
+    deliberation: null,
+    synthesis: null,
+    user_contributions: userRefs.length,
+  };
+
+  writeJson(path.join(bDir, 'board.json'), board);
+
+  // Copy/symlink to workspace so the user can open it directly.
+  ensureDir(workspaceDir);
+  var workspacePath = path.join(workspaceDir, boardId + '.json');
+  try {
+    fs.writeFileSync(workspacePath, JSON.stringify(board, null, 2));
+  } catch (e) {
+    // workspace write is best-effort (e.g. read-only cwd)
+  }
+
+  return { board: board, boardDir: bDir, workspacePath: workspacePath };
+}
+
+function detectStack(vaultPath) {
+  if (!vaultPath || !fs.existsSync(path.join(vaultPath, 'Tech'))) return null;
+  var techNotes = fs.readdirSync(path.join(vaultPath, 'Tech')).map(function(f) { return f.toLowerCase(); });
+  var stacks = ['nextjs', 'react', 'shadcn', 'vue', 'angular', 'svelte', 'nuxtjs', 'astro'];
+  for (var i = 0; i < stacks.length; i++) {
+    if (techNotes.some(function(n) { return n.indexOf(stacks[i]) !== -1; })) return stacks[i];
+  }
+  return null;
+}
+
+// ─── Persona critique over a mood board ───────────────────────────────────────
+
+async function critiqueMoodBoard(opts) {
+  opts = opts || {};
+  var projectId = opts.project || session.getProjectId();
+  var boardId = opts.boardId;
+  if (!boardId) throw new Error('--board is required');
+  var bDir = boardDir(projectId, boardId);
+  var boardPath = path.join(bDir, 'board.json');
+  var board = loadJson(boardPath);
+  if (!board) throw new Error('Board not found: ' + boardId);
+
+  var experts = opts.experts || ['arjun', 'meera', 'priya', 'zara', 'noor'];
+  var task = opts.task || board.task;
+
+  // Build a synthetic critique task that includes the board and DS pack.
+  var refsSummary = board.references.map(function(r, idx) {
+    return '[' + (idx + 1) + '] ' + r.title + ' (' + r.type + ') tags=' + r.tags.join(',') + ' — ' + (r.url || r.description).slice(0, 120);
+  }).join('\n');
+
+  var dsText = formatDsPack(board.design_system_pack);
+
+  var critiqueTask = [
+    'Mood-board critique for: ' + task,
+    '',
+    'References:\n' + refsSummary,
+    '',
+    dsText,
+    '',
+    'Each persona must use the Honeycomb rigor matrix to evaluate which references are appropriate for the user and why. Output scores, top concerns, and a ranked shortlist of the best 2-3 references. Then participate in adversarial deliberation until consensus.'
+  ].join('\n');
+
+  // Use the orchestrator directly, but force the experts to the mood-board set.
+  var result = await orchestratorRun({
+    task: critiqueTask,
+    experts: experts,
+    project: projectId,
+    provider: opts.provider || 'host',
+    model: opts.model,
+    dryRun: !!opts.dryRun,
+    deliberate: opts.noDeliberate ? false : true,
+    maxRounds: opts.maxRounds || 3,
+    satisfaction: opts.satisfaction || 0.4,
+    hostResponder: opts.hostResponder || null,
+  });
+
+  board.deliberation = result.deliberation;
+  board.synthesis = result.synthesis;
+  board.updated_at = new Date().toISOString();
+  board.critique_task = critiqueTask;
+
+  writeJson(boardPath, board);
+  var workspaceDir = opts.workspaceDir || defaultWorkspaceDir();
+  ensureDir(workspaceDir);
+  var workspacePath = path.join(workspaceDir, boardId + '.json');
+  try { fs.writeFileSync(workspacePath, JSON.stringify(board, null, 2)); }
+  catch (e) { /* best effort */ }
+
+  return { board: board, orchestratorResult: result };
+}
+
+// ─── Add user reference and rerun ─────────────────────────────────────────────
+
+async function addUserReferenceAndRerun(opts) {
+  opts = opts || {};
+  var projectId = opts.project || session.getProjectId();
+  var boardId = opts.boardId;
+  var userRef = opts.reference;
+  if (!boardId || !userRef) throw new Error('--board and --reference are required');
+
+  var bDir = boardDir(projectId, boardId);
+  var boardPath = path.join(bDir, 'board.json');
+  var board = loadJson(boardPath);
+  if (!board) throw new Error('Board not found: ' + boardId);
+
+  var ref = {
+    id: generateBoardId(),
+    url: userRef.url || '',
+    title: userRef.title || (userRef.url ? path.basename(new URL(userRef.url).pathname || 'user-ref') : 'User note'),
+    description: userRef.description || '',
+    source: 'user',
+    type: userRef.type || 'note',
+    tags: userRef.tags || [],
+    user_note: userRef.note || '',
+    fetched_at: new Date().toISOString(),
+  };
+  if (!ref.tags.length) ref.tags = tagHeuristics(ref, board.task);
+  board.references.push(ref);
+  board.user_contributions = (board.user_contributions || 0) + 1;
+  board.updated_at = new Date().toISOString();
+  writeJson(boardPath, board);
+
+  // Rerun critique with updated board.
+  var critique = await critiqueMoodBoard({
+    project: projectId,
+    boardId: boardId,
+    task: opts.task || board.task,
+    experts: opts.experts,
+    provider: opts.provider,
+    model: opts.model,
+    dryRun: !!opts.dryRun,
+    noDeliberate: opts.noDeliberate,
+    maxRounds: opts.maxRounds,
+    satisfaction: opts.satisfaction,
+    hostResponder: opts.hostResponder,
+  });
+
+  return { board: critique.board, added: ref };
+}
+
+// ─── List boards ──────────────────────────────────────────────────────────────
+
+function listBoards(projectId) {
+  projectId = projectId || session.getProjectId();
+  var bRoot = path.join(session.sessionDir(projectId), 'moodboard');
+  if (!fs.existsSync(bRoot)) return [];
+  return fs.readdirSync(bRoot, { withFileTypes: true })
+    .filter(function(d) { return d.isDirectory(); })
+    .map(function(d) { return d.name; });
+}
+
+module.exports = {
+  buildMoodBoard: buildMoodBoard,
+  critiqueMoodBoard: critiqueMoodBoard,
+  addUserReferenceAndRerun: addUserReferenceAndRerun,
+  listBoards: listBoards,
+  boardDir: boardDir,
+  formatDsPack: formatDsPack,
+  tagHeuristics: tagHeuristics,
+};