analyzthis_design 2.0.0 → 2.1.0

package/dist/lib/knowledge.js

@@ -1,2 +1,385 @@
 #!/usr/bin/env node
-'use strict';const fs=require('fs'),path=require('path'),os=require('os'),CONFIG_DIR=path['join'](os['homedir'](),'.analyzthis_design'),CONFIG_FILE=path['join'](CONFIG_DIR,'config.json'),KNOWLEDGE_SKILL=path['join'](__dirname,'..','..','skills','knowledge-bank','SKILL.md'),KNOWLEDGE_SLICE_ROOT=path['join'](CONFIG_DIR,'kb-slices'),{resolvePackageRoot}=require('./platforms'),PACKAGE_ROOT=resolvePackageRoot(__dirname),AGENTS_DIR=path['join'](PACKAGE_ROOT,'agents'),CATEGORIES={'prd':['prd','requirements','user\x20story','user\x20stories','acceptance\x20criteria','as\x20a\x20user','as\x20a\x20','given\x20when','given/when','epic','jtbd','job\x20to\x20be\x20done','job-to-be-done','use\x20case','done\x20when','fails\x20when','success\x20criteria','definition\x20of\x20done'],'brand':['brand','color','typography','logo','visual','style','tone','voice','identity'],'product':['product','feature','roadmap','vision','goal','north-star','metric','kpi','okr'],'design':['design','ux','ui','wireframe','component','pattern','system','figma','layout'],'research':['research','user','interview','survey','insight','pain','feedback','analytics','data'],'tech':['tech','stack','api','backend','frontend','infrastructure','constraint','architecture'],'web':['web-context','fetched:','search\x20stub','source:','http://','https://']};function loadConfig(){if(!fs['existsSync'](CONFIG_FILE))return{'sources':[]};try{return JSON['parse'](fs['readFileSync'](CONFIG_FILE,'utf8'));}catch{return{'sources':[]};}}function saveConfig(a){fs['mkdirSync'](CONFIG_DIR,{'recursive':!![]}),fs['writeFileSync'](CONFIG_FILE,JSON['stringify'](a,null,0x2));}function readMarkdownFiles(a){const b=[];if(!fs['existsSync'](a))return b;const c=d=>{for(const e of fs['readdirSync'](d,{'withFileTypes':!![]})){const f=path['join'](d,e['name']);if(e['isDirectory']()&&!e['name']['startsWith']('.'))c(f);else{if(e['isFile']()&&e['name']['endsWith']('.md'))b['push'](f);}}};return c(a),b;}function parseFrontmatter(a){const b=a['match'](/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);if(!b)return{'meta':{},'body':a};const c={};for(const d of b[0x1]['split']('\x0a')){const [e,...f]=d['split'](':');if(e&&f['length'])c[e['trim']()]=f['join'](':')['trim']();}return{'meta':c,'body':b[0x2]};}function extractTags(a,b){const c=[];if(a['tags'])c['push'](...a['tags']['replace'](/[\[\]]/g,'')['split'](',')['map'](e=>e['trim']()['toLowerCase']()));const d=b['match'](/#(\w+)/g)||[];return c['push'](...d['map'](e=>e['slice'](0x1)['toLowerCase']())),[...new Set(c)];}function cleanObsidian(a){return a['replace'](/\[\[([^\]|]+)\|([^\]]+)\]\]/g,'$2')['replace'](/\[\[([^\]]+)\]\]/g,'$1')['replace'](/!\[\[([^\]]+)\]\]/g,'')['replace'](/%%[\s\S]*?%%/g,'')['trim']();}function categorize(a,b,c){const d=(a+'\x20'+b['join']('\x20')+'\x20'+c['substring'](0x0,0x1f4))['toLowerCase']();for(const [e,f]of Object['entries'](CATEGORIES)){if(f['some'](g=>d['includes'](g)))return e;}return'other';}function connect({vaultPath:a,include:include=[],tags:tags=[]}){const b=path['resolve'](a);if(!fs['existsSync'](b))throw new Error('Path\x20does\x20not\x20exist:\x20'+b);const c=loadConfig();return c['sources']=c['sources']['filter'](d=>d['path']!==b),c['sources']['push']({'path':b,'include':include,'tags':tags,'addedAt':new Date()['toISOString']()}),saveConfig(c),b;}function disconnect(a){const b=path['resolve'](a),c=loadConfig();c['sources']=c['sources']['filter'](d=>d['path']!==b),saveConfig(c);}function sync({targets:targets=['cursor']}={}){const a=loadConfig();if(!a['sources']||a['sources']['length']===0x0)return{'synced':0x0,'message':'No\x20sources\x20connected.\x20Run:\x20npx\x20analyzthis_design\x20connect\x20--vault\x20/path/to/vault'};const b={'prd':[],'brand':[],'product':[],'design':[],'research':[],'tech':[],'web':[],'other':[]};let c=0x0;for(const m of a['sources']){const n=readMarkdownFiles(m['path']);for(const o of n){const p=fs['readFileSync'](o,'utf8'),{meta:q,body:r}=parseFrontmatter(p),s=extractTags(q,r);if(m['tags']['length']>0x0&&!m['tags']['some'](x=>s['includes'](x['toLowerCase']())))continue;if(m['include']['length']>0x0){const x=path['relative'](m['path'],o),y=m['include']['some'](z=>x['startsWith'](z['replace']('/**','')['replace']('/*','')));if(!y)continue;}const u=q['title']||path['basename'](o,'.md'),v=cleanObsidian(r);if(!v['trim']())continue;const w=categorize(u,s,v);b[w]['push']({'title':u,'content':v}),c++;}}try{const z=require('./research'),A=z['readWebContext']();A&&A['content']&&A['content']['trim']()&&(b['web']['push']({'title':'Session\x20web\x20research','content':A['content']}),c++);}catch{}const d=a['sources']['map'](B=>B['path'])['join'](',\x20'),e=new Date()['toISOString']()['split']('T')[0x0],f=[{'key':'prd','heading':'##\x20PRDs,\x20User\x20Stories\x20&\x20Acceptance\x20Criteria'},{'key':'brand','heading':'##\x20Brand\x20&\x20Design\x20Guidelines'},{'key':'product','heading':'##\x20Product\x20Context'},{'key':'design','heading':'##\x20Design\x20Decisions\x20&\x20Patterns'},{'key':'research','heading':'##\x20Research\x20&\x20User\x20Insights'},{'key':'web','heading':'##\x20Web\x20Research\x20Context'},{'key':'tech','heading':'##\x20Technical\x20Context'},{'key':'other','heading':'##\x20Additional\x20Context'}];let g='---\x0aname:\x20knowledge-bank\x0adescription:\x20Personal\x20knowledge\x20bank\x20—\x20takes\x20precedence\x20over\x20all\x20built-in\x20persona\x20defaults.\x0adisable-model-invocation:\x20true\x0a---\x0a\x0a#\x20Knowledge\x20Bank\x0a\x0a>\x20Last\x20synced:\x20'+e+'\x0a>\x20Sources:\x20'+d+'\x0a>\x20Files\x20loaded:\x20'+c+'\x0a\x0a**INSTRUCTION\x20TO\x20ALL\x20PERSONAS:**\x20This\x20knowledge\x20bank\x20contains\x20project-specific\x20context\x20that\x20overrides\x20your\x20built-in\x20defaults.\x20Read\x20every\x20section\x20below\x20before\x20forming\x20any\x20opinion.\x20When\x20this\x20knowledge\x20bank\x20conflicts\x20with\x20your\x20built-in\x20knowledge,\x20this\x20knowledge\x20bank\x20wins.\x0a\x0a---\x0a\x0a',h=![];for(const {key:B,heading:C}of f){if(b[B]['length']===0x0)continue;h=!![],g+=C+'\x0a\x0a';for(const D of b[B]){g+='###\x20'+D['title']+'\x0a\x0a'+D['content']+'\x0a\x0a';}g+='---\x0a\x0a';}!h&&(g+='_No\x20matching\x20files\x20found.\x20Check\x20your\x20--tags\x20or\x20--include\x20filters,\x20or\x20remove\x20filters\x20to\x20include\x20all\x20notes._\x0a');fs['mkdirSync'](path['dirname'](KNOWLEDGE_SKILL),{'recursive':!![]}),fs['writeFileSync'](KNOWLEDGE_SKILL,g);try{const E=require('./session'),F=E['getProjectId']();writePersonaSlices(b,f,F);}catch{}const {TARGETS:i,resolveTargets:j}=require('./platforms'),k=[],l=targets['includes']('all')?j('all'):targets['filter'](G=>i[G]);for(const G of l){const H=i[G],I=[{'root':H['root'],'layout':H['layout']}];if(H['also'])I['push']({'root':H['also']['root'],'layout':H['also']['layout']});for(const J of I){fs['mkdirSync'](J['root'],{'recursive':!![]});if(J['layout']==='dir'){const K=path['join'](J['root'],'knowledge-bank');fs['mkdirSync'](K,{'recursive':!![]}),fs['copyFileSync'](KNOWLEDGE_SKILL,path['join'](K,'SKILL.md'));}else fs['copyFileSync'](KNOWLEDGE_SKILL,path['join'](J['root'],'knowledge-bank.md'));k['push'](G+'\x20→\x20'+J['root']);}}a['lastSync']=new Date()['toISOString'](),saveConfig(a);try{require('./cache')['invalidatePrefix']('kb:');}catch{}return{'synced':c,'copiedTo':k};}function loadManifest(a){const b=path['join'](AGENTS_DIR,'manifests',a+'.json');if(!fs['existsSync'](b))return null;return JSON['parse'](fs['readFileSync'](b,'utf8'));}function personaRelevance(a,b){if(!b||!b['length'])return!![];return b['indexOf'](a)!==-0x1;}function buildPersonaSlice(a,b,c,d){const e=loadManifest(a),f=e&&e['knowledge_categories']?e['knowledge_categories']:[];let g='---\x0aname:\x20knowledge-bank-'+a+'\x0adescription:\x20Project\x20context\x20filtered\x20for\x20the\x20'+a+'\x20persona.\x0adisable-model-invocation:\x20true\x0a---\x0a\x0a#\x20'+a['toUpperCase']()+'\x20Knowledge\x20Slice\x0a\x0a**INSTRUCTION:**\x20This\x20slice\x20contains\x20the\x20notes\x20most\x20relevant\x20to\x20your\x20lens.\x20Read\x20it\x20first,\x20then\x20scan\x20the\x20Additional\x20Context\x20section\x20briefly.\x0a\x0a---\x0a\x0a',h=![];for(const {key:j,heading:k}of c){if(!personaRelevance(j,f))continue;if(b[j]['length']===0x0)continue;h=!![],g+=k+'\x0a\x0a';for(const l of b[j]){g+='###\x20'+l['title']+'\x0a\x0a'+l['content']+'\x0a\x0a';}g+='---\x0a\x0a';}!h&&(g+='_No\x20primary\x20notes\x20for\x20your\x20lens.\x20Reading\x20general\x20context\x20below._\x0a\x0a');g+='##\x20Additional\x20Context\x20(secondary)\x0a\x0a';let i=0x0;for(const {key:m,heading:n}of c){if(personaRelevance(m,f))continue;if(b[m]['length']===0x0)continue;g+=n+'\x0a\x0a';for(const o of b[m]['slice'](0x0,0x2)){g+='###\x20'+o['title']+'\x0a\x0a'+o['content']['slice'](0x0,0x258)+(o['content']['length']>0x258?'…':'')+'\x0a\x0a',i++;if(i>=0x2)break;}g+='---\x0a\x0a';if(i>=0x2)break;}return g;}function writePersonaSlices(a,b,c){const d=['arjun','meera','priya','zara','noor','anuj','raj'],e=path['join'](KNOWLEDGE_SLICE_ROOT,c||'default');fs['mkdirSync'](e,{'recursive':!![]});const f=[];for(const g of d){const h=buildPersonaSlice(g,a,b,c),i=path['join'](e,g+'.md');fs['writeFileSync'](i,h),f['push'](i);}return f;}function readPersonaSlice(a,b){const c=path['join'](KNOWLEDGE_SLICE_ROOT,a||'default',b+'.md');if(!fs['existsSync'](c))return[];const d=fs['readFileSync'](c,'utf8'),e=[],f=d['match'](/### (.*?)\n\n([\s\S]*?)(?=\n\n---|\n### |$)/g);if(f)for(const g of f){const h=g['match'](/### (.*?)\n\n/);if(!h)continue;e['push']({'title':h[0x1]['trim'](),'content':g['replace'](/### .*?\n\n/,'')['trim']()});}return e;}function getPersonaSliceForPrompt(a,b){const c=a&&a['project_id']?a['project_id']:'default',d='kb:'+c+':'+b+':slice',e=require('./cache')['get'](d);if(e)return e;const f=readPersonaSlice(c,b);return require('./cache')['set'](d,f),f;}function status(){return loadConfig();}module['exports']={'connect':connect,'disconnect':disconnect,'sync':sync,'status':status,'buildPersonaSlice':buildPersonaSlice,'writePersonaSlices':writePersonaSlices,'readPersonaSlice':readPersonaSlice,'getPersonaSliceForPrompt':getPersonaSliceForPrompt,'KNOWLEDGE_SLICE_ROOT':KNOWLEDGE_SLICE_ROOT};
+'use strict';
+
+const fs   = require('fs');
+const path = require('path');
+const os   = require('os');
+
+const CONFIG_DIR        = path.join(os.homedir(), '.analyzthis_design');
+const CONFIG_FILE       = path.join(CONFIG_DIR, 'config.json');
+// When published, this file lives at dist/lib/ — go up two levels to reach package root
+const KNOWLEDGE_SKILL   = path.join(__dirname, '..', '..', 'skills', 'knowledge-bank', 'SKILL.md');
+const KNOWLEDGE_SLICE_ROOT = path.join(CONFIG_DIR, 'kb-slices');
+
+const { resolvePackageRoot } = require('./platforms');
+const PACKAGE_ROOT = resolvePackageRoot(__dirname);
+const AGENTS_DIR = path.join(PACKAGE_ROOT, 'agents');
+
+// Keywords used to auto-group vault notes into categories
+const CATEGORIES = {
+  // PRD/stories must be checked first — highest priority for ux-story-gate
+  prd:      ['prd', 'requirements', 'user story', 'user stories', 'acceptance criteria', 'as a user',
+             'as a ', 'given when', 'given/when', 'epic', 'jtbd', 'job to be done', 'job-to-be-done',
+             'use case', 'done when', 'fails when', 'success criteria', 'definition of done'],
+  brand:    ['brand', 'color', 'typography', 'logo', 'visual', 'style', 'tone', 'voice', 'identity'],
+  product:  ['product', 'feature', 'roadmap', 'vision', 'goal', 'north-star', 'metric', 'kpi', 'okr'],
+  design:   ['design', 'ux', 'ui', 'wireframe', 'component', 'pattern', 'system', 'figma', 'layout'],
+  research: ['research', 'user', 'interview', 'survey', 'insight', 'pain', 'feedback', 'analytics', 'data'],
+  tech:     ['tech', 'stack', 'api', 'backend', 'frontend', 'infrastructure', 'constraint', 'architecture'],
+  web:      ['web-context', 'fetched:', 'search stub', 'source:', 'http://', 'https://'],
+};
+
+// ─── Config helpers ──────────────────────────────────────────────────────────
+
+function loadConfig() {
+  if (!fs.existsSync(CONFIG_FILE)) return { sources: [] };
+  try { return JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8')); }
+  catch { return { sources: [] }; }
+}
+
+function saveConfig(config) {
+  fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+}
+
+// ─── Vault reading ───────────────────────────────────────────────────────────
+
+// Recursively collect all .md files under a directory
+function readMarkdownFiles(dir) {
+  const files = [];
+  if (!fs.existsSync(dir)) return files;
+  const walk = (cur) => {
+    for (const entry of fs.readdirSync(cur, { withFileTypes: true })) {
+      const full = path.join(cur, entry.name);
+      if (entry.isDirectory() && !entry.name.startsWith('.')) walk(full);
+      else if (entry.isFile() && entry.name.endsWith('.md')) files.push(full);
+    }
+  };
+  walk(dir);
+  return files;
+}
+
+// Parse YAML-ish frontmatter from a markdown file
+function parseFrontmatter(raw) {
+  const m = raw.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
+  if (!m) return { meta: {}, body: raw };
+  const meta = {};
+  for (const line of m[1].split('\n')) {
+    const [k, ...v] = line.split(':');
+    if (k && v.length) meta[k.trim()] = v.join(':').trim();
+  }
+  return { meta, body: m[2] };
+}
+
+// Collect tags from frontmatter and inline #hashtags
+function extractTags(meta, body) {
+  const tags = [];
+  if (meta.tags) tags.push(...meta.tags.replace(/[\[\]]/g, '').split(',').map(t => t.trim().toLowerCase()));
+  const inline = body.match(/#(\w+)/g) || [];
+  tags.push(...inline.map(t => t.slice(1).toLowerCase()));
+  return [...new Set(tags)];
+}
+
+// Strip Obsidian-specific syntax so the AI reads clean markdown
+function cleanObsidian(text) {
+  return text
+    .replace(/\[\[([^\]|]+)\|([^\]]+)\]\]/g, '$2')  // [[note|alias]] → alias
+    .replace(/\[\[([^\]]+)\]\]/g, '$1')               // [[note]] → note text
+    .replace(/!\[\[([^\]]+)\]\]/g, '')                 // ![[embed]] → remove
+    .replace(/%%[\s\S]*?%%/g, '')                      // %% comments %% → remove
+    .trim();
+}
+
+// Map a note to a section category
+function categorize(title, tags, body) {
+  const text = `${title} ${tags.join(' ')} ${body.substring(0, 500)}`.toLowerCase();
+  for (const [cat, keywords] of Object.entries(CATEGORIES)) {
+    if (keywords.some(k => text.includes(k))) return cat;
+  }
+  return 'other';
+}
+
+// ─── Public API ──────────────────────────────────────────────────────────────
+
+/**
+ * Register a vault or folder as a knowledge source.
+ * Options:
+ *   include  — array of sub-folder prefixes to include, e.g. ['Design', 'Brand']
+ *   tags     — array of tags to filter by, e.g. ['ux', 'design', 'brand']
+ */
+function connect({ vaultPath, include = [], tags = [] }) {
+  const abs = path.resolve(vaultPath);
+  if (!fs.existsSync(abs)) throw new Error(`Path does not exist: ${abs}`);
+
+  const config = loadConfig();
+  // Replace any existing entry with the same path
+  config.sources = config.sources.filter(s => s.path !== abs);
+  config.sources.push({ path: abs, include, tags, addedAt: new Date().toISOString() });
+  saveConfig(config);
+  return abs;
+}
+
+/**
+ * Remove a vault/folder from the knowledge sources list.
+ */
+function disconnect(vaultPath) {
+  const abs = path.resolve(vaultPath);
+  const config = loadConfig();
+  config.sources = config.sources.filter(s => s.path !== abs);
+  saveConfig(config);
+}
+
+/**
+ * Read all connected sources, filter notes, build knowledge-bank.md,
+ * and copy it to all requested target AI tool directories.
+ *
+ * targets — array of tool names: 'cursor', 'claude', 'codex'
+ */
+function sync({ targets = ['cursor'] } = {}) {
+  const config = loadConfig();
+
+  if (!config.sources || config.sources.length === 0) {
+    return { synced: 0, message: 'No sources connected. Run: npx analyzthis_design connect --vault /path/to/vault' };
+  }
+
+  const sections = { prd: [], brand: [], product: [], design: [], research: [], tech: [], web: [], other: [] };
+  let totalFiles = 0;
+
+  for (const source of config.sources) {
+    const files = readMarkdownFiles(source.path);
+
+    for (const filePath of files) {
+      const raw  = fs.readFileSync(filePath, 'utf8');
+      const { meta, body } = parseFrontmatter(raw);
+      const tags = extractTags(meta, body);
+
+      // Tag filter: skip file if it doesn't carry one of the required tags
+      if (source.tags.length > 0 && !source.tags.some(t => tags.includes(t.toLowerCase()))) continue;
+
+      // Include-folder filter: skip file if it's not inside one of the allowed sub-paths
+      if (source.include.length > 0) {
+        const rel = path.relative(source.path, filePath);
+        const ok  = source.include.some(p => rel.startsWith(p.replace('/**', '').replace('/*', '')));
+        if (!ok) continue;
+      }
+
+      const title   = meta.title || path.basename(filePath, '.md');
+      const cleaned = cleanObsidian(body);
+      if (!cleaned.trim()) continue;
+
+      const cat = categorize(title, tags, cleaned);
+      sections[cat].push({ title, content: cleaned });
+      totalFiles++;
+    }
+  }
+
+  // Merge session web-context.md research artifacts (if any) into the web section
+  try {
+    const research = require('./research');
+    const web = research.readWebContext();
+    if (web && web.content && web.content.trim()) {
+      sections.web.push({ title: 'Session web research', content: web.content });
+      totalFiles++;
+    }
+  } catch { /* no session / research available — fine */ }
+
+  // Build the knowledge-bank markdown
+  const sourceList = config.sources.map(s => s.path).join(', ');
+  const date       = new Date().toISOString().split('T')[0];
+
+  // PRD/stories listed first — ux-story-gate reads this section in Phase 0
+  const sectionDefs = [
+    { key: 'prd',      heading: '## PRDs, User Stories & Acceptance Criteria' },
+    { key: 'brand',    heading: '## Brand & Design Guidelines' },
+    { key: 'product',  heading: '## Product Context' },
+    { key: 'design',   heading: '## Design Decisions & Patterns' },
+    { key: 'research', heading: '## Research & User Insights' },
+    { key: 'web',      heading: '## Web Research Context' },
+    { key: 'tech',     heading: '## Technical Context' },
+    { key: 'other',    heading: '## Additional Context' },
+  ];
+
+  let md = `---
+name: knowledge-bank
+description: Personal knowledge bank — takes precedence over all built-in persona defaults.
+disable-model-invocation: true
+---
+
+# Knowledge Bank
+
+> Last synced: ${date}
+> Sources: ${sourceList}
+> Files loaded: ${totalFiles}
+
+**INSTRUCTION TO ALL PERSONAS:** This knowledge bank contains project-specific context that overrides your built-in defaults. Read every section below before forming any opinion. When this knowledge bank conflicts with your built-in knowledge, this knowledge bank wins.
+
+---
+
+`;
+
+  let hasContent = false;
+  for (const { key, heading } of sectionDefs) {
+    if (sections[key].length === 0) continue;
+    hasContent = true;
+    md += `${heading}\n\n`;
+    for (const note of sections[key]) {
+      md += `### ${note.title}\n\n${note.content}\n\n`;
+    }
+    md += '---\n\n';
+  }
+
+  if (!hasContent) {
+    md += `_No matching files found. Check your --tags or --include filters, or remove filters to include all notes._\n`;
+  }
+
+  // Write to the package's own skills/knowledge-bank/SKILL.md
+  fs.mkdirSync(path.dirname(KNOWLEDGE_SKILL), { recursive: true });
+  fs.writeFileSync(KNOWLEDGE_SKILL, md);
+
+  // Build per-persona knowledge slices (priority + fallback)
+  try {
+    const session = require('./session');
+    const projectId = session.getProjectId();
+    writePersonaSlices(sections, sectionDefs, projectId);
+  } catch {
+    // sessions unavailable — skip slices
+  }
+
+  // Copy knowledge-bank into every requested platform (dir and/or flat layout)
+  const { TARGETS, resolveTargets } = require('./platforms');
+  const copiedTo = [];
+  const resolved = targets.includes('all')
+    ? resolveTargets('all')
+    : targets.filter((t) => TARGETS[t]);
+
+  for (const targetId of resolved) {
+    const t = TARGETS[targetId];
+    const destinations = [{ root: t.root, layout: t.layout }];
+    if (t.also) destinations.push({ root: t.also.root, layout: t.also.layout });
+
+    for (const dest of destinations) {
+      fs.mkdirSync(dest.root, { recursive: true });
+      if (dest.layout === 'dir') {
+        const skillDir = path.join(dest.root, 'knowledge-bank');
+        fs.mkdirSync(skillDir, { recursive: true });
+        fs.copyFileSync(KNOWLEDGE_SKILL, path.join(skillDir, 'SKILL.md'));
+      } else {
+        fs.copyFileSync(KNOWLEDGE_SKILL, path.join(dest.root, 'knowledge-bank.md'));
+      }
+      copiedTo.push(`${targetId} → ${dest.root}`);
+    }
+  }
+
+  // Persist lastSync timestamp
+  config.lastSync = new Date().toISOString();
+  saveConfig(config);
+
+  // Knowledge bank content just changed for every project — drop any cached
+  // knowledge-bank slices so the next run re-reads the fresh sync.
+  try { require('./cache').invalidatePrefix('kb:'); } catch { /* cache module unavailable — fine */ }
+
+  return { synced: totalFiles, copiedTo };
+}
+
+function loadManifest(id) {
+  const p = path.join(AGENTS_DIR, 'manifests', `${id}.json`);
+  if (!fs.existsSync(p)) return null;
+  return JSON.parse(fs.readFileSync(p, 'utf8'));
+}
+
+function personaRelevance(category, personaCategories) {
+  if (!personaCategories || !personaCategories.length) return true;
+  return personaCategories.indexOf(category) !== -1;
+}
+
+function buildPersonaSlice(personaId, sections, sectionDefs, projectId) {
+  const manifest = loadManifest(personaId);
+  const cats = manifest && manifest.knowledge_categories ? manifest.knowledge_categories : [];
+  let md = `---\nname: knowledge-bank-${personaId}\ndescription: Project context filtered for the ${personaId} persona.\ndisable-model-invocation: true\n---\n\n# ${personaId.toUpperCase()} Knowledge Slice\n\n**INSTRUCTION:** This slice contains the notes most relevant to your lens. Read it first, then scan the Additional Context section briefly.\n\n---\n\n`;
+
+  let hasPrimary = false;
+  for (const { key, heading } of sectionDefs) {
+    if (!personaRelevance(key, cats)) continue;
+    if (sections[key].length === 0) continue;
+    hasPrimary = true;
+    md += `${heading}\n\n`;
+    for (const note of sections[key]) {
+      md += `### ${note.title}\n\n${note.content}\n\n`;
+    }
+    md += '---\n\n';
+  }
+
+  if (!hasPrimary) {
+    md += '_No primary notes for your lens. Reading general context below._\n\n';
+  }
+
+  md += '## Additional Context (secondary)\n\n';
+  let secondaryCount = 0;
+  for (const { key, heading } of sectionDefs) {
+    if (personaRelevance(key, cats)) continue;
+    if (sections[key].length === 0) continue;
+    md += `${heading}\n\n`;
+    for (const note of sections[key].slice(0, 2)) {
+      md += `### ${note.title}\n\n${note.content.slice(0, 600)}${note.content.length > 600 ? '…' : ''}\n\n`;
+      secondaryCount++;
+      if (secondaryCount >= 2) break;
+    }
+    md += '---\n\n';
+    if (secondaryCount >= 2) break;
+  }
+
+  return md;
+}
+
+function writePersonaSlices(sections, sectionDefs, projectId) {
+  const personas = ['arjun', 'meera', 'priya', 'zara', 'noor', 'anuj', 'raj'];
+  const dir = path.join(KNOWLEDGE_SLICE_ROOT, projectId || 'default');
+  fs.mkdirSync(dir, { recursive: true });
+  const written = [];
+  for (const personaId of personas) {
+    const md = buildPersonaSlice(personaId, sections, sectionDefs, projectId);
+    const file = path.join(dir, `${personaId}.md`);
+    fs.writeFileSync(file, md);
+    written.push(file);
+  }
+  return written;
+}
+
+function readPersonaSlice(projectId, personaId) {
+  const file = path.join(KNOWLEDGE_SLICE_ROOT, projectId || 'default', `${personaId}.md`);
+  if (!fs.existsSync(file)) return [];
+  const text = fs.readFileSync(file, 'utf8');
+  const notes = [];
+  const matches = text.match(/### (.*?)\n\n([\s\S]*?)(?=\n\n---|\n### |$)/g);
+  if (matches) {
+    for (const m of matches) {
+      const titleMatch = m.match(/### (.*?)\n\n/);
+      if (!titleMatch) continue;
+      notes.push({
+        title: titleMatch[1].trim(),
+        content: m.replace(/### .*?\n\n/, '').trim(),
+      });
+    }
+  }
+  return notes;
+}
+
+function getPersonaSliceForPrompt(state, personaId) {
+  const projectId = state && state.project_id ? state.project_id : 'default';
+  const cacheKey = `kb:${projectId}:${personaId}:slice`;
+  const cached = require('./cache').get(cacheKey);
+  if (cached) return cached;
+
+  const notes = readPersonaSlice(projectId, personaId);
+  require('./cache').set(cacheKey, notes);
+  return notes;
+}
+
+/**
+ * Return current config (sources list, lastSync).
+ */
+function status() {
+  return loadConfig();
+}
+
+module.exports = { connect, disconnect, sync, status, buildPersonaSlice, writePersonaSlices, readPersonaSlice, getPersonaSliceForPrompt, KNOWLEDGE_SLICE_ROOT };

package/dist/lib/lessons.js

@@ -1 +1,217 @@
-'use strict';var fs=require('fs'),path=require('path'),os=require('os'),session=require('./session'),cache=require('./cache'),LESSONS_ROOT=path['join'](os['homedir'](),'.analyzthis_design','lessons');function ensureLessonsDir(){fs['mkdirSync'](LESSONS_ROOT,{'recursive':!![]});}function personaLessonFile(a){return path['join'](LESSONS_ROOT,a+'.jsonl');}function loadLessons(a){var b=personaLessonFile(a);if(!fs['existsSync'](b))return[];var c=fs['readFileSync'](b,'utf8'),d=c['trim']()['split']('\x0a')['filter'](function(h){return h['trim']();}),f=[];for(var g=0x0;g<d['length'];g++){try{f['push'](JSON['parse'](d[g]));}catch(h){}}return f;}function appendLesson(a,b){ensureLessonsDir();var c=personaLessonFile(a);fs['appendFileSync'](c,JSON['stringify'](b)+'\x0a');}function keywordOverlap(c,d){var e=(c||'')['toLowerCase']()['split'](/\W+/)['filter'](function(m){return m['length']>0x2;}),f=(d||'')['toLowerCase']()['split'](/\W+/)['filter'](function(m){return m['length']>0x2;}),g={};for(var h=0x0;h<e['length'];h++)g[e[h]]=!![];var k=0x0;for(var l=0x0;l<f['length'];l++){if(g[f[l]])k++;}return k;}function extractLessonsFromSession(a,b){var c=a['persona_outputs']&&a['persona_outputs'][b];if(!c||c['accepted']!==!![])return[];var d='unknown';if(a['outcome']&&a['outcome']['confirmed']&&a['outcome']['confirmed'][b])d=a['outcome']['confirmed'][b]['value'];else a['outcome']&&a['outcome']['inferred']&&a['outcome']['inferred'][b]&&(d=a['outcome']['inferred'][b]['value']);var e=[],f=c['text']||'',g=f['match'](/Top\s*2\s*fixes:[\s\S]*?(?:\n\n|```|$)/i);if(g){var h=g[0x0]['split']('\x0a');for(var k=0x0;k<h['length'];k++){var l=h[k]['trim'](),n=l['match'](/^\d+\.\s*(.+)$/);if(n){var o=n[0x1]['trim'](),p=o;e['push']({'id':require('crypto')['randomBytes'](0x6)['toString']('hex'),'persona':b,'task_type':a['task_type']||'','pattern':p,'fix':o,'outcome':d,'session_id':a['project_id'],'extracted_at':new Date()['toISOString'](),'citation':c['citations']?c['citations'][0x0]:''});}}}var q=f['match'](/Hierarchy\[([A-F])\]/gi);if(q)for(var r=0x0;r<q['length'];r++){var s='Visual\x20hierarchy\x20issue:\x20'+q[r];e['push']({'id':require('crypto')['randomBytes'](0x6)['toString']('hex'),'persona':b,'task_type':a['task_type']||'','pattern':s,'fix':'Review\x20visual\x20hierarchy\x20per\x20DS\x20tokens','outcome':d,'session_id':a['project_id'],'extracted_at':new Date()['toISOString'](),'citation':''});}return e;}function extractLessons(a){var b=a['project'],c=a['persona'],d=b?[b]:session['listProjects'](),e=0x0;for(var f=0x0;f<d['length'];f++){var g=d[f],h=session['show']({'project':g});if(!h)continue;var k=extractLessonsFromSession(h,c);for(var l=0x0;l<k['length'];l++){appendLesson(c,k[l]),e++;}}return{'extracted':e,'persona':c};}function extractAllLessons(a){var b=a['windowDays']||0x7,c=Date['now']()-b*0x18*0x3c*0x3c*0x3e8,d=session['listProjects'](),e=0x0,f=['arjun','meera','priya','zara','noor','anuj','raj'];for(var g=0x0;g<d['length'];g++){var h=d[g],k=session['show']({'project':h});if(!k)continue;if(k['updated_at']&&new Date(k['updated_at'])['getTime']()<c)continue;for(var l=0x0;l<f['length'];l++){var m=f[l],n=extractLessonsFromSession(k,m);for(var o=0x0;o<n['length'];o++){appendLesson(m,n[o]),e++;}}}return{'extracted':e,'windowDays':b};}function retrieveLessons(a){var b=a['task']||'',c=a['personaId'],d=a['limit']||0x3;if(!c)return{'lessons':[],'cacheHit':![]};var e='lessons:'+c+':'+require('crypto')['createHash']('sha1')['update'](b)['digest']('hex')['slice'](0x0,0xc),f=cache['get'](e);if(f)return{'lessons':f,'cacheHit':!![]};var g=loadLessons(c);if(!g['length'])return{'lessons':[],'cacheHit':![]};var h=g['map'](function(j){var k=keywordOverlap(b,j['pattern']+'\x20'+j['fix']+'\x20'+j['task_type']);return{'lesson':j,'score':k};});h['sort'](function(j,k){return k['score']-j['score'];});var i=h['slice'](0x0,d)['map'](function(j){return j['lesson'];});return cache['set'](e,i),{'lessons':i,'cacheHit':![]};}function buildLessonsInjection(a){if(!a||!a['length'])return'';var b=['Past\x20lessons\x20for\x20this\x20persona\x20on\x20similar\x20tasks:'];for(var c=0x0;c<a['length'];c++){var d=a[c];b['push'](c+0x1+'.\x20['+d['pattern']+']\x20\u2192\x20['+d['fix']+']\x20(outcome:\x20'+d['outcome']+')');}return b['join']('\x0a');}function stats(){var a=['arjun','meera','priya','zara','noor','anuj','raj'],b={},c=0x0;for(var d=0x0;d<a['length'];d++){var e=a[d],f=loadLessons(e)['length'];b[e]=f,c+=f;}return{'totalLessons':c,'perPersona':b};}module['exports']={'extractLessons':extractLessons,'extractAllLessons':extractAllLessons,'retrieveLessons':retrieveLessons,'buildLessonsInjection':buildLessonsInjection,'stats':stats,'loadLessons':loadLessons,'LESSONS_ROOT':LESSONS_ROOT};
+'use strict';
+
+var fs = require('fs');
+var path = require('path');
+var os = require('os');
+var session = require('./session');
+var cache = require('./cache');
+
+var LESSONS_ROOT = path.join(os.homedir(), '.analyzthis_design', 'lessons');
+
+function ensureLessonsDir() {
+  fs.mkdirSync(LESSONS_ROOT, { recursive: true });
+}
+
+function personaLessonFile(personaId) {
+  return path.join(LESSONS_ROOT, personaId + '.jsonl');
+}
+
+function loadLessons(personaId) {
+  var file = personaLessonFile(personaId);
+  if (!fs.existsSync(file)) return [];
+  var text = fs.readFileSync(file, 'utf8');
+  var lines = text.trim().split('\n').filter(function(l) { return l.trim(); });
+  var lessons = [];
+  for (var i = 0; i < lines.length; i++) {
+    try {
+      lessons.push(JSON.parse(lines[i]));
+    } catch (e) {
+      // skip corrupt lines
+    }
+  }
+  return lessons;
+}
+
+function appendLesson(personaId, lesson) {
+  ensureLessonsDir();
+  var file = personaLessonFile(personaId);
+  fs.appendFileSync(file, JSON.stringify(lesson) + '\n');
+}
+
+function keywordOverlap(a, b) {
+  var wordsA = (a || '').toLowerCase().split(/\W+/).filter(function(w) { return w.length > 2; });
+  var wordsB = (b || '').toLowerCase().split(/\W+/).filter(function(w) { return w.length > 2; });
+  var setA = {};
+  for (var i = 0; i < wordsA.length; i++) setA[wordsA[i]] = true;
+  var overlap = 0;
+  for (var j = 0; j < wordsB.length; j++) {
+    if (setA[wordsB[j]]) overlap++;
+  }
+  return overlap;
+}
+
+function extractLessonsFromSession(state, personaId) {
+  var entry = state.persona_outputs && state.persona_outputs[personaId];
+  if (!entry || entry.accepted !== true) return [];
+
+  var outcomeVal = 'unknown';
+  if (state.outcome && state.outcome.confirmed && state.outcome.confirmed[personaId]) {
+    outcomeVal = state.outcome.confirmed[personaId].value;
+  } else if (state.outcome && state.outcome.inferred && state.outcome.inferred[personaId]) {
+    outcomeVal = state.outcome.inferred[personaId].value;
+  }
+
+  var lessons = [];
+  var text = entry.text || '';
+
+  var fixesMatch = text.match(/Top\s*2\s*fixes:[\s\S]*?(?:\n\n|```|$)/i);
+  if (fixesMatch) {
+    var lines = fixesMatch[0].split('\n');
+    for (var i = 0; i < lines.length; i++) {
+      var line = lines[i].trim();
+      var m = line.match(/^\d+\.\s*(.+)$/);
+      if (m) {
+        var fix = m[1].trim();
+        var pattern = fix;
+        lessons.push({
+          id: require('crypto').randomBytes(6).toString('hex'),
+          persona: personaId,
+          task_type: state.task_type || '',
+          pattern: pattern,
+          fix: fix,
+          outcome: outcomeVal,
+          session_id: state.project_id,
+          extracted_at: new Date().toISOString(),
+          citation: entry.citations ? entry.citations[0] : ''
+        });
+      }
+    }
+  }
+
+  var hierarchyMatch = text.match(/Hierarchy\[([A-F])\]/gi);
+  if (hierarchyMatch) {
+    for (var j = 0; j < hierarchyMatch.length; j++) {
+      var pattern2 = 'Visual hierarchy issue: ' + hierarchyMatch[j];
+      lessons.push({
+        id: require('crypto').randomBytes(6).toString('hex'),
+        persona: personaId,
+        task_type: state.task_type || '',
+        pattern: pattern2,
+        fix: 'Review visual hierarchy per DS tokens',
+        outcome: outcomeVal,
+        session_id: state.project_id,
+        extracted_at: new Date().toISOString(),
+        citation: ''
+      });
+    }
+  }
+
+  return lessons;
+}
+
+function extractLessons(opts) {
+  var project = opts.project;
+  var persona = opts.persona;
+
+  var projectIds = project ? [project] : session.listProjects();
+  var total = 0;
+
+  for (var i = 0; i < projectIds.length; i++) {
+    var pid = projectIds[i];
+    var state = session.show({ project: pid });
+    if (!state) continue;
+
+    var lessons = extractLessonsFromSession(state, persona);
+    for (var j = 0; j < lessons.length; j++) {
+      appendLesson(persona, lessons[j]);
+      total++;
+    }
+  }
+
+  return { extracted: total, persona: persona };
+}
+
+function extractAllLessons(opts) {
+  var windowDays = opts.windowDays || 7;
+  var cutoff = Date.now() - (windowDays * 24 * 60 * 60 * 1000);
+  var projectIds = session.listProjects();
+  var total = 0;
+  var personas = ['arjun', 'meera', 'priya', 'zara', 'noor', 'anuj', 'raj'];
+
+  for (var i = 0; i < projectIds.length; i++) {
+    var pid = projectIds[i];
+    var state = session.show({ project: pid });
+    if (!state) continue;
+    if (state.updated_at && new Date(state.updated_at).getTime() < cutoff) continue;
+
+    for (var p = 0; p < personas.length; p++) {
+      var pers = personas[p];
+      var lessons = extractLessonsFromSession(state, pers);
+      for (var j = 0; j < lessons.length; j++) {
+        appendLesson(pers, lessons[j]);
+        total++;
+      }
+    }
+  }
+
+  return { extracted: total, windowDays: windowDays };
+}
+
+function retrieveLessons(opts) {
+  var task = opts.task || '';
+  var personaId = opts.personaId;
+  var limit = opts.limit || 3;
+
+  if (!personaId) return { lessons: [], cacheHit: false };
+
+  var cacheKey = 'lessons:' + personaId + ':' + require('crypto').createHash('sha1').update(task).digest('hex').slice(0, 12);
+  var cached = cache.get(cacheKey);
+  if (cached) return { lessons: cached, cacheHit: true };
+
+  var allLessons = loadLessons(personaId);
+  if (!allLessons.length) return { lessons: [], cacheHit: false };
+
+  var scored = allLessons.map(function(lesson) {
+    var overlap = keywordOverlap(task, lesson.pattern + ' ' + lesson.fix + ' ' + lesson.task_type);
+    return { lesson: lesson, score: overlap };
+  });
+
+  scored.sort(function(a, b) { return b.score - a.score; });
+
+  var top = scored.slice(0, limit).map(function(s) { return s.lesson; });
+  cache.set(cacheKey, top);
+  return { lessons: top, cacheHit: false };
+}
+
+function buildLessonsInjection(lessons) {
+  if (!lessons || !lessons.length) return '';
+  var lines = ['Past lessons for this persona on similar tasks:'];
+  for (var i = 0; i < lessons.length; i++) {
+    var l = lessons[i];
+    lines.push((i + 1) + '. [' + l.pattern + '] \u2192 [' + l.fix + '] (outcome: ' + l.outcome + ')');
+  }
+  return lines.join('\n');
+}
+
+function stats() {
+  var personas = ['arjun', 'meera', 'priya', 'zara', 'noor', 'anuj', 'raj'];
+  var perPersona = {};
+  var total = 0;
+  for (var i = 0; i < personas.length; i++) {
+    var p = personas[i];
+    var count = loadLessons(p).length;
+    perPersona[p] = count;
+    total += count;
+  }
+  return { totalLessons: total, perPersona: perPersona };
+}
+
+module.exports = {
+  extractLessons: extractLessons,
+  extractAllLessons: extractAllLessons,
+  retrieveLessons: retrieveLessons,
+  buildLessonsInjection: buildLessonsInjection,
+  stats: stats,
+  loadLessons: loadLessons,
+  LESSONS_ROOT: LESSONS_ROOT
+};