analyzthis_design 2.0.0 → 2.1.0

package/dist/lib/source-discovery.js

@@ -1,2 +1,487 @@
 #!/usr/bin/env node
-'use strict';const fs=require('fs'),path=require('path'),os=require('os'),knowledge=require('./knowledge'),HOME=os['homedir'](),VAULT_NAME_HINTS=/\b(vault|obsidian|wiki|knowledge|docs|notes|brain|second.?brain)\b/i,REFERENCE_FILES=['README.md','AGENTS.md','CLAUDE.md','CONTRIBUTING.md','package.json','.cursorrules','cursor.md'],MIN_MD_FOR_VAULT=0x5,PATH_REF_PATTERNS=[/(?:connect\s+--vault\s+)([^\s`"']+)/gi,/(?:vault|obsidian|knowledge[-_ ]?bank|knowledge[-_ ]?graph|wiki)[:\s]+[`"']?([~/][^\s`"'\],)]+)/gi,/(?:path|folder|directory)[:\s]+[`"']?([~/][^\s`"'\],)]*(?:vault|obsidian|wiki|knowledge)[^\s`"'\],)]*)/gi];function loadConfig(){const a=path['join'](HOME,'.analyzthis_design','config.json');if(!fs['existsSync'](a))return{'sources':[]};try{return JSON['parse'](fs['readFileSync'](a,'utf8'));}catch{return{'sources':[]};}}function expandPath(a,b){if(!a||typeof a!=='string')return null;let c=a['trim']()['replace'](/^[`"']|[`"']$/g,'');if(c['startsWith']('~'))c=path['join'](HOME,c['slice'](0x1)['replace'](/^\//,''));else{if(!path['isAbsolute'](c))c=path['resolve'](b,c);}try{return c=fs['realpathSync'](c),c;}catch{return fs['existsSync'](c)?path['resolve'](c):null;}}function countMarkdown(a,b=0x1f4){let c=0x0;const d=(f,g)=>{if(g>0x6||c>=b)return;let h;try{h=fs['readdirSync'](f,{'withFileTypes':!![]});}catch{return;}for(const i of h){if(i['name']['startsWith']('.')&&i['name']!=='.obsidian')continue;const j=path['join'](f,i['name']);if(i['isDirectory']())d(j,g+0x1);else{if(i['name']['endsWith']('.md'))c+=0x1;}}};return d(a,0x0),c;}function listTopFolders(a,b=0x8){try{return fs['readdirSync'](a,{'withFileTypes':!![]})['filter'](c=>c['isDirectory']()&&!c['name']['startsWith']('.'))['map'](c=>c['name'])['slice'](0x0,b);}catch{return[];}}function isObsidianVault(a){return fs['existsSync'](path['join'](a,'.obsidian'));}function hasKnowledgeGraph(a){const b=path['join'](a,'.obsidian','graph.json');if(fs['existsSync'](b))return!![];const c=['graph.json','knowledge-graph.json','kg.json'];try{return fs['readdirSync'](a)['some'](d=>c['includes'](d['toLowerCase']()));}catch{return![];}}function statsForPath(a){const b=countMarkdown(a),c=listTopFolders(a);return{'markdown_files':b,'top_folders':c,'has_obsidian':isObsidianVault(a),'has_graph':hasKnowledgeGraph(a)};}function makeDiscovery({path:a,type:b,discoveredFrom:c,confidence:d,cwd:e}){if(!a||!fs['existsSync'](a))return null;try{const g=fs['statSync'](a);if(!g['isDirectory']())return null;}catch{return null;}const f=statsForPath(a);if(f['markdown_files']===0x0&&!f['has_obsidian'])return null;return{'path':a,'type':b,'discovered_from':c,'confidence':d,'stats':f,'slug':path['basename'](a)['toLowerCase']()['replace'](/[^a-z0-9]+/g,'-')['slice'](0x0,0x28)||'source'};}function addDiscovery(a,b){if(!b)return;const c=b['path'],d=a['get'](c);(!d||rankConfidence(b['confidence'])>rankConfidence(d['confidence']))&&a['set'](c,b);}function rankConfidence(a){return a==='high'?0x3:a==='medium'?0x2:0x1;}function findObsidianVaultsInTree(a,b=0x5,c=new Set()){const d=[],e=(f,g)=>{if(g>b)return;let h;try{h=fs['readdirSync'](f,{'withFileTypes':!![]});}catch{return;}if(h['some'](i=>i['name']==='.obsidian'&&i['isDirectory']())){d['push'](f);return;}for(const i of h){if(!i['isDirectory']())continue;if(i['name']['startsWith']('.')||c['has'](i['name']))continue;if(['node_modules','dist','build','.git','vendor']['includes'](i['name']))continue;e(path['join'](f,i['name']),g+0x1);}};return e(a,0x0),d;}function findMarkdownRichFolders(a,b=0x3){const c=[],d=(f,g)=>{if(g>b)return;let h;try{h=fs['readdirSync'](f,{'withFileTypes':!![]});}catch{return;}const i=path['basename'](f),j=h['filter'](k=>k['isFile']()&&k['name']['endsWith']('.md'))['length'];j>=MIN_MD_FOR_VAULT&&(VAULT_NAME_HINTS['test'](i)||VAULT_NAME_HINTS['test'](f))&&c['push'](f);for(const k of h){if(!k['isDirectory']()||k['name']['startsWith']('.'))continue;if(['node_modules','dist','build','.git']['includes'](k['name']))continue;d(path['join'](f,k['name']),g+0x1);}};return d(a,0x0),c;}function extractPathRefs(a,b){const c=new Set();for(const e of PATH_REF_PATTERNS){e['lastIndex']=0x0;let f;while((f=e['exec'](a))!==null){const g=expandPath(f[0x1],b);if(g)c['add'](g);}}const d=a['match'](/obsidian:\/\/[^\s"']+/gi)||[];for(const h of d)c['add'](h);return[...c];}function collectReferenceTexts(a){const b=[];for(const d of REFERENCE_FILES){const e=path['join'](a,d);if(fs['existsSync'](e))try{b['push']({'rel':d,'content':fs['readFileSync'](e,'utf8')});}catch{}}const c=['docs','.cursor','.github'];for(const f of c){const g=path['join'](a,f);if(!fs['existsSync'](g))continue;const h=(i,j)=>{if(j>0x4)return;let k;try{k=fs['readdirSync'](i,{'withFileTypes':!![]});}catch{return;}for(const l of k){const m=path['join'](i,l['name']);if(l['isDirectory']()&&!l['name']['startsWith']('.'))h(m,j+0x1);else{if(l['isFile']()&&/\.(md|json|txt)$/i['test'](l['name']))try{b['push']({'rel':path['relative'](a,m),'content':fs['readFileSync'](m,'utf8')['slice'](0x0,0xc350)});}catch{}}}};h(g,0x0);}return b;}function scanHomeVaultHints(a){const b=[];if(a['collect']?.['scan_home_vaults']!==!![])return b;const c=a['collect']?.['home_vault_paths']||[path['join'](HOME,'Documents'),path['join'](HOME,'Obsidian'),path['join'](HOME,'Vaults')];for(const d of c){if(!fs['existsSync'](d))continue;let f;try{f=fs['readdirSync'](d,{'withFileTypes':!![]});}catch{continue;}for(const g of f){if(!g['isDirectory']())continue;const h=path['join'](d,g['name']);if(isObsidianVault(h))b['push'](h);}}return b;}function discoverKnowledgeSources({cwd:a,config:b}){const c=b||loadConfig(),d=new Map();for(const e of c['sources']||[]){addDiscovery(d,makeDiscovery({'path':expandPath(e['path'],a),'type':'registered_source','discoveredFrom':'~/.analyzthis_design/config.json','confidence':'high','cwd':a}));}for(const f of c['collect']?.['source_paths']||[]){addDiscovery(d,makeDiscovery({'path':expandPath(f,a),'type':'config_path','discoveredFrom':'collect.source_paths','confidence':'high','cwd':a}));}for(const g of findObsidianVaultsInTree(a)){addDiscovery(d,makeDiscovery({'path':g,'type':'obsidian_vault','discoveredFrom':'.obsidian/\x20marker\x20in\x20repo','confidence':'high','cwd':a}));}for(const h of findMarkdownRichFolders(a)){addDiscovery(d,makeDiscovery({'path':h,'type':'markdown_vault','discoveredFrom':'markdown-rich\x20folder\x20in\x20repo','confidence':'medium','cwd':a}));}for(const {rel:i,content:j}of collectReferenceTexts(a)){for(const k of extractPathRefs(j,a)){if(k['startsWith']('obsidian://'))continue;addDiscovery(d,makeDiscovery({'path':k,'type':'referenced_path','discoveredFrom':i,'confidence':'medium','cwd':a}));}if(/\b\.obsidian\/graph\b/i['test'](j)){const l=path['dirname'](path['join'](a,i));(isObsidianVault(l)||hasKnowledgeGraph(l))&&addDiscovery(d,makeDiscovery({'path':l,'type':'knowledge_graph_ref','discoveredFrom':i+'\x20(.obsidian/graph\x20reference)','confidence':'high','cwd':a}));}}for(const m of scanHomeVaultHints(c)){addDiscovery(d,makeDiscovery({'path':m,'type':'obsidian_vault','discoveredFrom':'home\x20vault\x20scan\x20(collect.scan_home_vaults)','confidence':'medium','cwd':a}));}return[...d['values']()]['sort']((n,o)=>rankConfidence(o['confidence'])-rankConfidence(n['confidence']));}function buildSourceNote(a,b){const {path:c,type:d,discovered_from:e,confidence:f,stats:g}=a,h=d['replace'](/_/g,'\x20')+'\x20—\x20'+path['basename'](c),i=['---','title:\x20'+JSON['stringify'](h),'tags:\x20[source,\x20discovered,\x20kavi]','source_type:\x20\x22'+d+'\x22','source_path:\x20'+JSON['stringify'](c),'discovered_from:\x20'+JSON['stringify'](e),'confidence:\x20\x22'+f+'\x22','markdown_files:\x20'+g['markdown_files'],'has_obsidian:\x20'+g['has_obsidian'],'has_knowledge_graph:\x20'+g['has_graph'],'collected_at:\x20\x22'+new Date()['toISOString']()['split']('T')[0x0]+'\x22','---','']['join']('\x0a'),j=['#\x20'+h,'','##\x20Summary','Potential\x20knowledge-bank\x20source\x20discovered\x20by\x20Kavi\x20during\x20collect.','','-\x20**Absolute\x20path:**\x20`'+c+'`','-\x20**Type:**\x20'+d,'-\x20**Confidence:**\x20'+f,'-\x20**Discovered\x20from:**\x20'+e,'','##\x20Contents\x20snapshot','-\x20Markdown\x20files\x20(approx):\x20**'+g['markdown_files']+'**','-\x20Top\x20folders:\x20'+(g['top_folders']['length']?g['top_folders']['map'](k=>'`'+k+'`')['join'](',\x20'):'_(none)_'),'-\x20Obsidian\x20vault:\x20'+(g['has_obsidian']?'yes':'no'),'-\x20Knowledge\x20graph\x20data:\x20'+(g['has_graph']?'yes':'no'),'','##\x20How\x20personas\x20use\x20this','When\x20auto-connected,\x20notes\x20from\x20this\x20path\x20are\x20merged\x20into\x20the\x20**knowledge\x20bank**\x20on\x20sync.','Personas\x20read\x20PRDs,\x20brand,\x20research,\x20and\x20design\x20context\x20from\x20connected\x20sources\x20before\x20critiquing.','','##\x20Manual\x20connect','```bash','npx\x20analyzthis_design\x20connect\x20--vault\x20\x22'+c+'\x22','npx\x20analyzthis_design\x20sync\x20--target\x20all','```','','##\x20Related','-\x20[[_meta/knowledge-sources|All\x20discovered\x20sources]]','-\x20[[_meta/index|Vault\x20index]]','']['join']('\x0a');return{'vaultRel':'Sources/'+String(b)['padStart'](0x2,'0')+'-'+a['slug']+'.md','content':i+j};}function writeSourceManifestNotes({discoveries:a,vaultPath:b,dryRun:c}){if(!a['length'])return{'written':[],'indexPath':null};const e=a['map']((h,j)=>buildSourceNote(h,j+0x1)),f=['---','title:\x20\x22Discovered\x20knowledge\x20sources\x22','tags:\x20[meta,\x20sources,\x20moc]','updated_at:\x20\x22'+new Date()['toISOString']()+'\x22','---','','#\x20Discovered\x20knowledge\x20sources','','Kavi\x20found\x20these\x20potential\x20knowledge-bank\x20areas\x20during\x20collect.\x20Manifest\x20notes\x20live\x20in\x20`Sources/`.','','|\x20Source\x20|\x20Type\x20|\x20Confidence\x20|\x20Markdown\x20files\x20|','|\x20---\x20|\x20---\x20|\x20---\x20|\x20---\x20|'];for(const h of a){f['push']('|\x20`'+h['path']+'`\x20|\x20'+h['type']+'\x20|\x20'+h['confidence']+'\x20|\x20'+h['stats']['markdown_files']+'\x20|');}f['push']('','##\x20Source\x20notes','');for(const i of e){const j=i['vaultRel']['replace'](/\.md$/,'')['replace'](/\\/g,'/');f['push']('-\x20[['+j+']]');}f['push']('');if(c)return{'written':e['map'](k=>k['vaultRel']),'indexPath':'_meta/knowledge-sources.md','discoveries':a};fs['mkdirSync'](path['join'](b,'Sources'),{'recursive':!![]}),fs['mkdirSync'](path['join'](b,'_meta'),{'recursive':!![]});for(const k of e){fs['writeFileSync'](path['join'](b,k['vaultRel']),k['content']);}const g=path['join'](b,'_meta','knowledge-sources.md');return fs['writeFileSync'](g,f['join']('\x0a')),{'written':e['map'](l=>l['vaultRel']),'indexPath':'_meta/knowledge-sources.md'};}function connectDiscoveredSources({discoveries:a,kaviVaultPath:b,config:c,autoConnect:autoConnect=!![]}){const e=[],f=[];if(!autoConnect)return{'connected':e,'skipped':f};const g=c['collect']?.['auto_connect_min_confidence']==='low'?0x1:c['collect']?.['auto_connect_min_confidence']==='high'?0x3:0x2;for(const h of a){if(rankConfidence(h['confidence'])<g){f['push']({'path':h['path'],'reason':'low\x20confidence'});continue;}if(h['path']===b){f['push']({'path':h['path'],'reason':'kavi\x20output\x20vault'});continue;}try{knowledge['connect']({'vaultPath':h['path'],'tags':[],'include':[]}),e['push'](h['path']);}catch(i){f['push']({'path':h['path'],'reason':i['message']});}}return{'connected':e,'skipped':f};}module['exports']={'discoverKnowledgeSources':discoverKnowledgeSources,'writeSourceManifestNotes':writeSourceManifestNotes,'connectDiscoveredSources':connectDiscoveredSources,'expandPath':expandPath,'isObsidianVault':isObsidianVault};
+'use strict';
+
+/**
+ * Discover potential knowledge-bank sources: Obsidian vaults, markdown wikis,
+ * knowledge-graph references, and paths cited in repo docs — then write manifest
+ * notes for Kavi and optionally auto-connect them.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const knowledge = require('./knowledge');
+
+const HOME = os.homedir();
+const VAULT_NAME_HINTS = /\b(vault|obsidian|wiki|knowledge|docs|notes|brain|second.?brain)\b/i;
+const REFERENCE_FILES = [
+  'README.md', 'AGENTS.md', 'CLAUDE.md', 'CONTRIBUTING.md',
+  'package.json', '.cursorrules', 'cursor.md',
+];
+const MIN_MD_FOR_VAULT = 5;
+
+const PATH_REF_PATTERNS = [
+  /(?:connect\s+--vault\s+)([^\s`"']+)/gi,
+  /(?:vault|obsidian|knowledge[-_ ]?bank|knowledge[-_ ]?graph|wiki)[:\s]+[`"']?([~/][^\s`"'\],)]+)/gi,
+  /(?:path|folder|directory)[:\s]+[`"']?([~/][^\s`"'\],)]*(?:vault|obsidian|wiki|knowledge)[^\s`"'\],)]*)/gi,
+];
+
+function loadConfig() {
+  const configPath = path.join(HOME, '.analyzthis_design', 'config.json');
+  if (!fs.existsSync(configPath)) return { sources: [] };
+  try { return JSON.parse(fs.readFileSync(configPath, 'utf8')); }
+  catch { return { sources: [] }; }
+}
+
+function expandPath(raw, cwd) {
+  if (!raw || typeof raw !== 'string') return null;
+  let p = raw.trim().replace(/^[`"']|[`"']$/g, '');
+  if (p.startsWith('~')) p = path.join(HOME, p.slice(1).replace(/^\//, ''));
+  else if (!path.isAbsolute(p)) p = path.resolve(cwd, p);
+  try {
+    p = fs.realpathSync(p);
+    return p;
+  } catch {
+    return fs.existsSync(p) ? path.resolve(p) : null;
+  }
+}
+
+function countMarkdown(dir, max = 500) {
+  let n = 0;
+  const walk = (cur, depth) => {
+    if (depth > 6 || n >= max) return;
+    let entries;
+    try { entries = fs.readdirSync(cur, { withFileTypes: true }); }
+    catch { return; }
+    for (const e of entries) {
+      if (e.name.startsWith('.') && e.name !== '.obsidian') continue;
+      const full = path.join(cur, e.name);
+      if (e.isDirectory()) walk(full, depth + 1);
+      else if (e.name.endsWith('.md')) n += 1;
+    }
+  };
+  walk(dir, 0);
+  return n;
+}
+
+function listTopFolders(dir, limit = 8) {
+  try {
+    return fs.readdirSync(dir, { withFileTypes: true })
+      .filter((e) => e.isDirectory() && !e.name.startsWith('.'))
+      .map((e) => e.name)
+      .slice(0, limit);
+  } catch {
+    return [];
+  }
+}
+
+function isObsidianVault(dir) {
+  return fs.existsSync(path.join(dir, '.obsidian'));
+}
+
+function hasKnowledgeGraph(dir) {
+  const obsGraph = path.join(dir, '.obsidian', 'graph.json');
+  if (fs.existsSync(obsGraph)) return true;
+  const names = ['graph.json', 'knowledge-graph.json', 'kg.json'];
+  try {
+    return fs.readdirSync(dir).some((f) => names.includes(f.toLowerCase()));
+  } catch {
+    return false;
+  }
+}
+
+function statsForPath(absPath) {
+  const mdCount = countMarkdown(absPath);
+  const folders = listTopFolders(absPath);
+  return {
+    markdown_files: mdCount,
+    top_folders: folders,
+    has_obsidian: isObsidianVault(absPath),
+    has_graph: hasKnowledgeGraph(absPath),
+  };
+}
+
+function makeDiscovery({ path: absPath, type, discoveredFrom, confidence, cwd }) {
+  if (!absPath || !fs.existsSync(absPath)) return null;
+  try {
+    const stat = fs.statSync(absPath);
+    if (!stat.isDirectory()) return null;
+  } catch {
+    return null;
+  }
+  const stats = statsForPath(absPath);
+  if (stats.markdown_files === 0 && !stats.has_obsidian) return null;
+
+  return {
+    path: absPath,
+    type,
+    discovered_from: discoveredFrom,
+    confidence,
+    stats,
+    slug: path.basename(absPath).toLowerCase().replace(/[^a-z0-9]+/g, '-').slice(0, 40) || 'source',
+  };
+}
+
+function addDiscovery(map, item) {
+  if (!item) return;
+  const key = item.path;
+  const existing = map.get(key);
+  if (!existing || rankConfidence(item.confidence) > rankConfidence(existing.confidence)) {
+    map.set(key, item);
+  }
+}
+
+function rankConfidence(c) {
+  return c === 'high' ? 3 : c === 'medium' ? 2 : 1;
+}
+
+function findObsidianVaultsInTree(root, maxDepth = 5, exclude = new Set()) {
+  const found = [];
+  const walk = (dir, depth) => {
+    if (depth > maxDepth) return;
+    let entries;
+    try { entries = fs.readdirSync(dir, { withFileTypes: true }); }
+    catch { return; }
+    if (entries.some((e) => e.name === '.obsidian' && e.isDirectory())) {
+      found.push(dir);
+      return;
+    }
+    for (const e of entries) {
+      if (!e.isDirectory()) continue;
+      if (e.name.startsWith('.') || exclude.has(e.name)) continue;
+      if (['node_modules', 'dist', 'build', '.git', 'vendor'].includes(e.name)) continue;
+      walk(path.join(dir, e.name), depth + 1);
+    }
+  };
+  walk(root, 0);
+  return found;
+}
+
+function findMarkdownRichFolders(root, maxDepth = 3) {
+  const found = [];
+  const walk = (dir, depth) => {
+    if (depth > maxDepth) return;
+    let entries;
+    try { entries = fs.readdirSync(dir, { withFileTypes: true }); }
+    catch { return; }
+    const base = path.basename(dir);
+    const mdCount = entries.filter((e) => e.isFile() && e.name.endsWith('.md')).length;
+    if (mdCount >= MIN_MD_FOR_VAULT && (VAULT_NAME_HINTS.test(base) || VAULT_NAME_HINTS.test(dir))) {
+      found.push(dir);
+    }
+    for (const e of entries) {
+      if (!e.isDirectory() || e.name.startsWith('.')) continue;
+      if (['node_modules', 'dist', 'build', '.git'].includes(e.name)) continue;
+      walk(path.join(dir, e.name), depth + 1);
+    }
+  };
+  walk(root, 0);
+  return found;
+}
+
+function extractPathRefs(text, cwd) {
+  const paths = new Set();
+  for (const re of PATH_REF_PATTERNS) {
+    re.lastIndex = 0;
+    let m;
+    while ((m = re.exec(text)) !== null) {
+      const expanded = expandPath(m[1], cwd);
+      if (expanded) paths.add(expanded);
+    }
+  }
+  // Obsidian URIs: obsidian://open?vault=Name — record name only (path unknown)
+  const vaultNames = text.match(/obsidian:\/\/[^\s"']+/gi) || [];
+  for (const uri of vaultNames) paths.add(uri);
+  return [...paths];
+}
+
+function collectReferenceTexts(cwd) {
+  const texts = [];
+  for (const rel of REFERENCE_FILES) {
+    const full = path.join(cwd, rel);
+    if (fs.existsSync(full)) {
+      try { texts.push({ rel, content: fs.readFileSync(full, 'utf8') }); } catch { /* ignore */ }
+    }
+  }
+  const extraDirs = ['docs', '.cursor', '.github'];
+  for (const dir of extraDirs) {
+    const base = path.join(cwd, dir);
+    if (!fs.existsSync(base)) continue;
+    const walk = (cur, depth) => {
+      if (depth > 4) return;
+      let entries;
+      try { entries = fs.readdirSync(cur, { withFileTypes: true }); }
+      catch { return; }
+      for (const e of entries) {
+        const full = path.join(cur, e.name);
+        if (e.isDirectory() && !e.name.startsWith('.')) walk(full, depth + 1);
+        else if (e.isFile() && /\.(md|json|txt)$/i.test(e.name)) {
+          try {
+            texts.push({ rel: path.relative(cwd, full), content: fs.readFileSync(full, 'utf8').slice(0, 50000) });
+          } catch { /* ignore */ }
+        }
+      }
+    };
+    walk(base, 0);
+  }
+  return texts;
+}
+
+function scanHomeVaultHints(config) {
+  const results = [];
+  if (config.collect?.scan_home_vaults !== true) return results;
+  const searchRoots = config.collect?.home_vault_paths || [
+    path.join(HOME, 'Documents'),
+    path.join(HOME, 'Obsidian'),
+    path.join(HOME, 'Vaults'),
+  ];
+  for (const root of searchRoots) {
+    if (!fs.existsSync(root)) continue;
+    let entries;
+    try { entries = fs.readdirSync(root, { withFileTypes: true }); }
+    catch { continue; }
+    for (const e of entries) {
+      if (!e.isDirectory()) continue;
+      const full = path.join(root, e.name);
+      if (isObsidianVault(full)) results.push(full);
+    }
+  }
+  return results;
+}
+
+/**
+ * Discover knowledge sources around the project and in config.
+ */
+function discoverKnowledgeSources({ cwd, config: cfgIn }) {
+  const config = cfgIn || loadConfig();
+  const map = new Map();
+
+  // Already registered in config
+  for (const src of config.sources || []) {
+    addDiscovery(map, makeDiscovery({
+      path: expandPath(src.path, cwd),
+      type: 'registered_source',
+      discoveredFrom: '~/.analyzthis_design/config.json',
+      confidence: 'high',
+      cwd,
+    }));
+  }
+
+  // Explicit collect paths
+  for (const p of config.collect?.source_paths || []) {
+    addDiscovery(map, makeDiscovery({
+      path: expandPath(p, cwd),
+      type: 'config_path',
+      discoveredFrom: 'collect.source_paths',
+      confidence: 'high',
+      cwd,
+    }));
+  }
+
+  // Obsidian vaults in repo
+  for (const vaultRoot of findObsidianVaultsInTree(cwd)) {
+    addDiscovery(map, makeDiscovery({
+      path: vaultRoot,
+      type: 'obsidian_vault',
+      discoveredFrom: '.obsidian/ marker in repo',
+      confidence: 'high',
+      cwd,
+    }));
+  }
+
+  // Markdown-rich folders (wiki / docs vaults)
+  for (const folder of findMarkdownRichFolders(cwd)) {
+    addDiscovery(map, makeDiscovery({
+      path: folder,
+      type: 'markdown_vault',
+      discoveredFrom: 'markdown-rich folder in repo',
+      confidence: 'medium',
+      cwd,
+    }));
+  }
+
+  // Paths referenced in README, AGENTS.md, docs, etc.
+  for (const { rel, content } of collectReferenceTexts(cwd)) {
+    for (const ref of extractPathRefs(content, cwd)) {
+      if (ref.startsWith('obsidian://')) {
+        // URI-only — documented in manifest, not connectable
+        continue;
+      }
+      addDiscovery(map, makeDiscovery({
+        path: ref,
+        type: 'referenced_path',
+        discoveredFrom: rel,
+        confidence: 'medium',
+        cwd,
+      }));
+    }
+    if (/\b\.obsidian\/graph\b/i.test(content)) {
+      const candidate = path.dirname(path.join(cwd, rel));
+      if (isObsidianVault(candidate) || hasKnowledgeGraph(candidate)) {
+        addDiscovery(map, makeDiscovery({
+          path: candidate,
+          type: 'knowledge_graph_ref',
+          discoveredFrom: `${rel} (.obsidian/graph reference)`,
+          confidence: 'high',
+          cwd,
+        }));
+      }
+    }
+  }
+
+  // Optional home scan
+  for (const homeVault of scanHomeVaultHints(config)) {
+    addDiscovery(map, makeDiscovery({
+      path: homeVault,
+      type: 'obsidian_vault',
+      discoveredFrom: 'home vault scan (collect.scan_home_vaults)',
+      confidence: 'medium',
+      cwd,
+    }));
+  }
+
+  return [...map.values()].sort((a, b) => rankConfidence(b.confidence) - rankConfidence(a.confidence));
+}
+
+function buildSourceNote(discovery, index) {
+  const { path: absPath, type, discovered_from, confidence, stats } = discovery;
+  const title = `${type.replace(/_/g, ' ')} — ${path.basename(absPath)}`;
+  const fm = [
+    '---',
+    `title: ${JSON.stringify(title)}`,
+    'tags: [source, discovered, kavi]',
+    `source_type: "${type}"`,
+    `source_path: ${JSON.stringify(absPath)}`,
+    `discovered_from: ${JSON.stringify(discovered_from)}`,
+    `confidence: "${confidence}"`,
+    `markdown_files: ${stats.markdown_files}`,
+    `has_obsidian: ${stats.has_obsidian}`,
+    `has_knowledge_graph: ${stats.has_graph}`,
+    `collected_at: "${new Date().toISOString().split('T')[0]}"`,
+    '---',
+    '',
+  ].join('\n');
+
+  const body = [
+    `# ${title}`,
+    '',
+    '## Summary',
+    `Potential knowledge-bank source discovered by Kavi during collect.`,
+    '',
+    `- **Absolute path:** \`${absPath}\``,
+    `- **Type:** ${type}`,
+    `- **Confidence:** ${confidence}`,
+    `- **Discovered from:** ${discovered_from}`,
+    '',
+    '## Contents snapshot',
+    `- Markdown files (approx): **${stats.markdown_files}**`,
+    `- Top folders: ${stats.top_folders.length ? stats.top_folders.map((f) => `\`${f}\``).join(', ') : '_(none)_'}`,
+    `- Obsidian vault: ${stats.has_obsidian ? 'yes' : 'no'}`,
+    `- Knowledge graph data: ${stats.has_graph ? 'yes' : 'no'}`,
+    '',
+    '## How personas use this',
+    'When auto-connected, notes from this path are merged into the **knowledge bank** on sync.',
+    'Personas read PRDs, brand, research, and design context from connected sources before critiquing.',
+    '',
+    '## Manual connect',
+    '```bash',
+    `npx analyzthis_design connect --vault "${absPath}"`,
+    'npx analyzthis_design sync --target all',
+    '```',
+    '',
+    `## Related`,
+    `- [[_meta/knowledge-sources|All discovered sources]]`,
+    `- [[_meta/index|Vault index]]`,
+    '',
+  ].join('\n');
+
+  return { vaultRel: `Sources/${String(index).padStart(2, '0')}-${discovery.slug}.md`, content: fm + body };
+}
+
+/**
+ * Write manifest notes under vault/Sources/ and _meta/knowledge-sources.md
+ */
+function writeSourceManifestNotes({ discoveries, vaultPath, dryRun }) {
+  if (!discoveries.length) return { written: [], indexPath: null };
+
+  const notes = discoveries.map((d, i) => buildSourceNote(d, i + 1));
+  const indexLines = [
+    '---',
+    'title: "Discovered knowledge sources"',
+    'tags: [meta, sources, moc]',
+    `updated_at: "${new Date().toISOString()}"`,
+    '---',
+    '',
+    '# Discovered knowledge sources',
+    '',
+    'Kavi found these potential knowledge-bank areas during collect. Manifest notes live in `Sources/`.',
+    '',
+    '| Source | Type | Confidence | Markdown files |',
+    '| --- | --- | --- | --- |',
+  ];
+
+  for (const d of discoveries) {
+    indexLines.push(`| \`${d.path}\` | ${d.type} | ${d.confidence} | ${d.stats.markdown_files} |`);
+  }
+  indexLines.push('', '## Source notes', '');
+  for (const n of notes) {
+    const link = n.vaultRel.replace(/\.md$/, '').replace(/\\/g, '/');
+    indexLines.push(`- [[${link}]]`);
+  }
+  indexLines.push('');
+
+  if (dryRun) {
+    return {
+      written: notes.map((n) => n.vaultRel),
+      indexPath: '_meta/knowledge-sources.md',
+      discoveries,
+    };
+  }
+
+  fs.mkdirSync(path.join(vaultPath, 'Sources'), { recursive: true });
+  fs.mkdirSync(path.join(vaultPath, '_meta'), { recursive: true });
+  for (const n of notes) {
+    fs.writeFileSync(path.join(vaultPath, n.vaultRel), n.content);
+  }
+  const indexPath = path.join(vaultPath, '_meta', 'knowledge-sources.md');
+  fs.writeFileSync(indexPath, indexLines.join('\n'));
+  return { written: notes.map((n) => n.vaultRel), indexPath: '_meta/knowledge-sources.md' };
+}
+
+/**
+ * Auto-connect discovered sources (high/medium confidence) into config.sources.
+ */
+function connectDiscoveredSources({ discoveries, kaviVaultPath, config, autoConnect = true }) {
+  const connected = [];
+  const skipped = [];
+  if (!autoConnect) return { connected, skipped };
+
+  const minRank = config.collect?.auto_connect_min_confidence === 'low' ? 1
+    : config.collect?.auto_connect_min_confidence === 'high' ? 3 : 2;
+
+  for (const d of discoveries) {
+    if (rankConfidence(d.confidence) < minRank) {
+      skipped.push({ path: d.path, reason: 'low confidence' });
+      continue;
+    }
+    if (d.path === kaviVaultPath) {
+      skipped.push({ path: d.path, reason: 'kavi output vault' });
+      continue;
+    }
+    try {
+      knowledge.connect({ vaultPath: d.path, tags: [], include: [] });
+      connected.push(d.path);
+    } catch (err) {
+      skipped.push({ path: d.path, reason: err.message });
+    }
+  }
+  return { connected, skipped };
+}
+
+module.exports = {
+  discoverKnowledgeSources,
+  writeSourceManifestNotes,
+  connectDiscoveredSources,
+  expandPath,
+  isObsidianVault,
+};

package/dist/lib/synthesis.js

@@ -1 +1,155 @@
-'use strict';const deliberation=require('./deliberation'),CRITIQUE_PERSONAS=['arjun','meera','priya','zara'];function extractScore(a){if(!a)return null;const b=a['match'](/(\d+(?:\.\d+)?)\s*\/\s*5/)||a['match'](/Combined score:\s*(\d+(?:\.\d+)?)/i)||a['match'](/Score:\s*\[?(\d+(?:\.\d+)?)/i);return b?Number(b[0x1]):null;}function parseHierarchyCheck(a){if(!a)return'unknown';if(/does not match/i['test'](a))return'does\x20not\x20match';if(/hierarchy check:\s*matches/i['test'](a))return'matches';return'unknown';}function parseVisualHierarchyGrade(a){if(!a)return null;const b=a['match'](/Hierarchy\[([A-F])\]/i);return b?b[0x1]['toUpperCase']():null;}function gradeBelowC(a){if(!a)return![];return['D','E','F']['includes'](a['toUpperCase']());}function verdictFromTotal(a,b){const c=b?deliberation['parseDeliberationOutput'](b):null;if(c?.['verdict']&&['SHIP','REVISE','BLOCK']['includes'](c['verdict']))return c['verdict'];if(a>=0x10)return'SHIP';if(a>=0xa)return'REVISE';return'BLOCK';}function collectRevisions(a){const b=[];for(const [d,e]of Object['entries'](a||{})){const f=e['deliberation']?.['revisions']||[];for(const h of f){b['push']({'change':h,'assigned':d['charAt'](0x0)['toUpperCase']()+d['slice'](0x1)});}const g=(e['text']||'')['match'](/Top 2 fixes:\s*1\.\s*([^\n]+)/i);if(g)b['push']({'change':g[0x1]['trim'](),'assigned':d['charAt'](0x0)['toUpperCase']()+d['slice'](0x1)});}const c=new Set();return b['filter'](j=>{const l=j['change']['slice'](0x0,0x3c);if(c['has'](l))return![];return c['add'](l),!![];});}function buildSynthesis(a,b={}){const c={};let d=0x0,e=0x0;for(const n of CRITIQUE_PERSONAS){const o=a[n];if(!o)continue;if(n==='zara'&&/no delight needed/i['test'](o['text']||'')){c['zara']='N/A';continue;}const p=extractScore(o['text']);p!=null&&(c[n]=p,d+=p,e+=0x1);}const f=e*0x5,g=verdictFromTotal(d,a['raj']?.['text']),h=parseVisualHierarchyGrade(a['arjun']?.['text']),i=parseHierarchyCheck(a['meera']?.['text']),j=gradeBelowC(h)||i==='does\x20not\x20match',k=collectRevisions(a),l=k['slice'](0x0,0x3);if(j&&l['length']){const q='Fix\x20information\x20hierarchy\x20—\x20primary\x20task\x20action\x20must\x20be\x20rank\x20#1\x20on\x20screen';if(!l['some'](r=>/hierarchy/i['test'](r['change']))){l['unshift']({'change':q,'assigned':'Arjun','gate':!![]});if(l['length']>0x3)l['pop']();}}const m=['##\x20Composite\x20Score','Arjun\x20(UX\x20+\x20Visual):\x20'+(c['arjun']??'—'),'Meera\x20(Business):\x20\x20\x20\x20'+(c['meera']??'—'),'Priya\x20(Feasibility):\x20'+(c['priya']??'—'),'Zara\x20(Delight):\x20\x20\x20\x20\x20\x20'+(c['zara']??'—'),'Total:\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20'+d+'/'+(f||0x14),'','Verdict:\x20'+g,'','Top\x203\x20actionable\x20changes\x20(ranked\x20by\x20impact):'];l['forEach']((r,t)=>{const u=r['gate']?'\x20—\x20*Inserted\x20by\x20Information\x20Hierarchy\x20Gate*':'';m['push'](t+0x1+'.\x20'+r['change']+'\x20—\x20assigned\x20to\x20'+r['assigned']+u);}),m['push']('','##\x20Information\x20Hierarchy\x20Gate','Arjun\x27s\x20Visual\x20Hierarchy\x20grade:\x20'+(h||'unknown'),'Meera\x27s\x20Hierarchy\x20check:\x20'+i,'Gate\x20status:\x20'+(j?'FAIL':'PASS'));if(a['raj']?.['text']){const r=a['raj']['text']['split']('\x0a')['filter'](t=>!/^## Raj/i['test'](t['trim']()))['slice'](0x0,0x6);m['push']('','##\x20Raj\x20—\x20Stalemate\x20Resolution',...r);}return{'markdown':m['join']('\x0a'),'composite':{'scores':c,'total':d,'max_total':f||0x14,'verdict':g,'top3':l,'hierarchy_gate':{'arjun_visual_hierarchy':h,'meera_hierarchy_check':i,'status':j?'FAIL':'PASS'}}};}module['exports']={'buildSynthesis':buildSynthesis,'extractScore':extractScore,'CRITIQUE_PERSONAS':CRITIQUE_PERSONAS};
+'use strict';
+
+/**
+ * Phase 5 composite synthesis — design-critic output block from persona_outputs.
+ */
+
+const deliberation = require('./deliberation');
+
+const CRITIQUE_PERSONAS = ['arjun', 'meera', 'priya', 'zara'];
+
+function extractScore(text) {
+  if (!text) return null;
+  const m = text.match(/(\d+(?:\.\d+)?)\s*\/\s*5/)
+    || text.match(/Combined score:\s*(\d+(?:\.\d+)?)/i)
+    || text.match(/Score:\s*\[?(\d+(?:\.\d+)?)/i);
+  return m ? Number(m[1]) : null;
+}
+
+function parseHierarchyCheck(meeraText) {
+  if (!meeraText) return 'unknown';
+  if (/does not match/i.test(meeraText)) return 'does not match';
+  if (/hierarchy check:\s*matches/i.test(meeraText)) return 'matches';
+  return 'unknown';
+}
+
+function parseVisualHierarchyGrade(arjunText) {
+  if (!arjunText) return null;
+  const m = arjunText.match(/Hierarchy\[([A-F])\]/i);
+  return m ? m[1].toUpperCase() : null;
+}
+
+function gradeBelowC(grade) {
+  if (!grade) return false;
+  return ['D', 'E', 'F'].includes(grade.toUpperCase());
+}
+
+function verdictFromTotal(total, rajText) {
+  const rajParsed = rajText ? deliberation.parseDeliberationOutput(rajText) : null;
+  if (rajParsed?.verdict && ['SHIP', 'REVISE', 'BLOCK'].includes(rajParsed.verdict)) {
+    return rajParsed.verdict;
+  }
+  if (total >= 16) return 'SHIP';
+  if (total >= 10) return 'REVISE';
+  return 'BLOCK';
+}
+
+function collectRevisions(personaOutputs) {
+  const items = [];
+  for (const [id, out] of Object.entries(personaOutputs || {})) {
+    const revs = out.deliberation?.revisions || [];
+    for (const r of revs) {
+      items.push({ change: r, assigned: id.charAt(0).toUpperCase() + id.slice(1) });
+    }
+    const fixes = (out.text || '').match(/Top 2 fixes:\s*1\.\s*([^\n]+)/i);
+    if (fixes) items.push({ change: fixes[1].trim(), assigned: id.charAt(0).toUpperCase() + id.slice(1) });
+  }
+  const seen = new Set();
+  return items.filter((i) => {
+    const k = i.change.slice(0, 60);
+    if (seen.has(k)) return false;
+    seen.add(k);
+    return true;
+  });
+}
+
+/**
+ * Build composite synthesis markdown + structured object.
+ */
+function buildSynthesis(personaOutputs, opts = {}) {
+  const scores = {};
+  let total = 0;
+  let counted = 0;
+
+  for (const id of CRITIQUE_PERSONAS) {
+    const out = personaOutputs[id];
+    if (!out) continue;
+    if (id === 'zara' && /no delight needed/i.test(out.text || '')) {
+      scores.zara = 'N/A';
+      continue;
+    }
+    const s = extractScore(out.text);
+    if (s != null) {
+      scores[id] = s;
+      total += s;
+      counted += 1;
+    }
+  }
+
+  const maxTotal = counted * 5;
+  const verdict = verdictFromTotal(total, personaOutputs.raj?.text);
+
+  const arjunGrade = parseVisualHierarchyGrade(personaOutputs.arjun?.text);
+  const hierarchyCheck = parseHierarchyCheck(personaOutputs.meera?.text);
+  const hierarchyFail = gradeBelowC(arjunGrade) || hierarchyCheck === 'does not match';
+
+  const revisions = collectRevisions(personaOutputs);
+  const top3 = revisions.slice(0, 3);
+
+  if (hierarchyFail && top3.length) {
+    const gateFix = 'Fix information hierarchy — primary task action must be rank #1 on screen';
+    if (!top3.some((t) => /hierarchy/i.test(t.change))) {
+      top3.unshift({ change: gateFix, assigned: 'Arjun', gate: true });
+      if (top3.length > 3) top3.pop();
+    }
+  }
+
+  const lines = [
+    '## Composite Score',
+    `Arjun (UX + Visual): ${scores.arjun ?? '—'}`,
+    `Meera (Business):    ${scores.meera ?? '—'}`,
+    `Priya (Feasibility): ${scores.priya ?? '—'}`,
+    `Zara (Delight):      ${scores.zara ?? '—'}`,
+    `Total:               ${total}/${maxTotal || 20}`,
+    '',
+    `Verdict: ${verdict}`,
+    '',
+    'Top 3 actionable changes (ranked by impact):',
+  ];
+
+  top3.forEach((item, i) => {
+    const gateNote = item.gate ? ' — *Inserted by Information Hierarchy Gate*' : '';
+    lines.push(`${i + 1}. ${item.change} — assigned to ${item.assigned}${gateNote}`);
+  });
+
+  lines.push(
+    '',
+    '## Information Hierarchy Gate',
+    `Arjun's Visual Hierarchy grade: ${arjunGrade || 'unknown'}`,
+    `Meera's Hierarchy check: ${hierarchyCheck}`,
+    `Gate status: ${hierarchyFail ? 'FAIL' : 'PASS'}`,
+  );
+
+  if (personaOutputs.raj?.text) {
+    const rajLines = personaOutputs.raj.text.split('\n').filter((l) => !/^## Raj/i.test(l.trim())).slice(0, 6);
+    lines.push('', '## Raj — Stalemate Resolution', ...rajLines);
+  }
+
+  return {
+    markdown: lines.join('\n'),
+    composite: {
+      scores,
+      total,
+      max_total: maxTotal || 20,
+      verdict,
+      top3,
+      hierarchy_gate: {
+        arjun_visual_hierarchy: arjunGrade,
+        meera_hierarchy_check: hierarchyCheck,
+        status: hierarchyFail ? 'FAIL' : 'PASS',
+      },
+    },
+  };
+}
+
+module.exports = { buildSynthesis, extractScore, CRITIQUE_PERSONAS };