analyzthis_design 1.1.0 → 1.2.0

package/bin/cli.js

@@ -2,80 +2,97 @@
 'use strict';
 
 const path = require('path');
-const os = require('os');
-const fs = require('fs');
+const os   = require('os');
+const fs   = require('fs');
 const { install, remove, SKILLS, TARGET_DIRS } = require('../lib/install');
+const { connect, disconnect, sync, status }     = require('../lib/knowledge');
 
 const HELP = `
-Analyzthis_Design — 7 AI design personas for Cursor, Claude, and Codex
+Analyzthis_Design — 7 AI design personas with a personal knowledge bank
 
 Usage:
   npx analyzthis_design [command] [options]
 
-Commands:
-  install    Copy all skills to the target AI tool's skills directory  (default)
+── Skill commands ───────────────────────────────────────────
+  install    Copy all skills to the target AI tool's directory  (default)
   remove     Delete installed skills from the target AI tool's directory
   list       Show installed skills for a target
 
-Options:
-  --target   AI tool to install into: cursor | claude | codex | all  (default: cursor)
+── Knowledge bank commands ──────────────────────────────────
+  connect    Register a vault or knowledge folder as a source
+  sync       Read all sources and build the knowledge-bank skill
+  disconnect Remove a source from the registry
+  status     Show connected sources and last sync time
+
+── Options ──────────────────────────────────────────────────
+  --target   AI tool: cursor | claude | codex | all  (default: cursor)
   --force    Overwrite existing skills on install
+  --vault    Path to Obsidian vault or markdown folder (connect command)
+  --tags     Comma-separated tags to filter by, e.g. design,brand,ux
+  --include  Comma-separated sub-folder names to include, e.g. Design,Brand
   --help     Show this help message
 
-Examples:
-  npx analyzthis_design                          # install for Cursor
-  npx analyzthis_design --target claude          # install for Claude Code
-  npx analyzthis_design --target codex           # install for Codex CLI
-  npx analyzthis_design --target all             # install for all tools
-  npx analyzthis_design remove --target all      # remove from all tools
+── Examples ─────────────────────────────────────────────────
+  npx analyzthis_design                                    # install for Cursor
+  npx analyzthis_design --target all                       # install for all tools
+
+  npx analyzthis_design connect --vault ~/Documents/MyVault
+  npx analyzthis_design connect --vault ~/docs --tags design,brand,product
+  npx analyzthis_design connect --vault ~/vault --include Design,Research
+  npx analyzthis_design sync                               # sync to Cursor
+  npx analyzthis_design sync --target all                  # sync to all tools
+  npx analyzthis_design status                             # show sources
+  npx analyzthis_design disconnect --vault ~/Documents/MyVault
 
-Install paths:
+── Install paths ────────────────────────────────────────────
   Cursor  → ~/.cursor/skills/
   Claude  → ~/.claude/commands/
   Codex   → ~/.codex/skills/
 
-Personas installed:
-  Arjun      UX Agent (UX Honeycomb critique)
-  Meera      Business Agent (retention, ARR, GTM)
-  Priya      Feasibility Agent (effort sizing, risks)
-  Zara       Delight Agent (Peak-End, one moment)
-  Noor       IA Architect (Concept A, minimalist)
-  Anuj       Power-User Advocate (Concept B, dense)
-  Raj        Arbitrator (stalemate only)
-
-Orchestrating skills:
-  design-critic    4-persona critique → SHIP/REVISE/BLOCK
-  ux-ideator       6-phase ideation workflow
-  design-personas  Session context template
+── Knowledge bank config ────────────────────────────────────
+  Config  → ~/.analyzthis_design/config.json
 
 Docs: https://github.com/rishikeshjoshi/analyzthis_design
 `;
 
+// ─── Parse args ──────────────────────────────────────────────────────────────
+
 const [,, cmd, ...flags] = process.argv;
-const force  = flags.includes('--force');
-const targetFlag = flags.find(f => f.startsWith('--target=')) || flags[flags.indexOf('--target') + 1];
-const target = (typeof targetFlag === 'string' && !targetFlag.startsWith('--'))
-  ? targetFlag
-  : 'cursor';
+
+function getFlag(name) {
+  // Supports both --flag=value and --flag value
+  const eq = flags.find(f => f.startsWith(`--${name}=`));
+  if (eq) return eq.split('=').slice(1).join('=');
+  const idx = flags.indexOf(`--${name}`);
+  if (idx !== -1 && flags[idx + 1] && !flags[idx + 1].startsWith('--')) return flags[idx + 1];
+  return null;
+}
+
+const force      = flags.includes('--force');
+const targetVal  = getFlag('target') || 'cursor';
+const vaultVal   = getFlag('vault');
+const tagsVal    = getFlag('tags');
+const includeVal = getFlag('include');
+
+// ─── Commands ────────────────────────────────────────────────────────────────
 
 switch (cmd) {
   case undefined:
   case 'install':
-    install({ force, target });
+    install({ force, target: targetVal });
     break;
 
   case 'remove':
   case 'uninstall':
-    remove({ target });
+    remove({ target: targetVal });
     break;
 
   case 'list': {
-    const targets = target === 'all' ? Object.keys(TARGET_DIRS) : [target];
+    const targets = targetVal === 'all' ? Object.keys(TARGET_DIRS) : [targetVal];
     for (const t of targets) {
       const dir = TARGET_DIRS[t];
       console.log(`\nInstalled Analyzthis_Design skills [${t}] (${dir}):\n`);
       for (const skill of SKILLS) {
-        // Check both directory and flat .md forms
         const asDir  = path.join(dir, skill);
         const asFile = path.join(dir, `${skill}.md`);
         const exists = fs.existsSync(asDir) || fs.existsSync(asFile);
@@ -86,6 +103,75 @@ switch (cmd) {
     break;
   }
 
+  // ── Knowledge bank ──────────────────────────────────────────────────────
+
+  case 'connect': {
+    if (!vaultVal) {
+      console.error('\n  ✗  --vault is required.  Example: npx analyzthis_design connect --vault ~/Documents/MyVault\n');
+      process.exit(1);
+    }
+    try {
+      const tags    = tagsVal    ? tagsVal.split(',').map(t => t.trim())    : [];
+      const include = includeVal ? includeVal.split(',').map(t => t.trim()) : [];
+      const abs = connect({ vaultPath: vaultVal, tags, include });
+      console.log(`\n✅ Connected: ${abs}`);
+      if (tags.length)    console.log(`   Tags filter:    ${tags.join(', ')}`);
+      if (include.length) console.log(`   Folder filter:  ${include.join(', ')}`);
+      console.log(`\n   Run "npx analyzthis_design sync" to build the knowledge bank.\n`);
+    } catch (err) {
+      console.error(`\n  ✗  ${err.message}\n`);
+      process.exit(1);
+    }
+    break;
+  }
+
+  case 'disconnect': {
+    if (!vaultVal) {
+      console.error('\n  ✗  --vault is required.  Example: npx analyzthis_design disconnect --vault ~/Documents/MyVault\n');
+      process.exit(1);
+    }
+    disconnect(vaultVal);
+    console.log(`\n🗑  Disconnected: ${path.resolve(vaultVal)}\n`);
+    break;
+  }
+
+  case 'sync': {
+    const targets = targetVal === 'all' ? Object.keys(TARGET_DIRS) : [targetVal];
+    console.log('\n⏳ Syncing knowledge bank...\n');
+    try {
+      const result = sync({ targets });
+      if (result.message) {
+        console.log(`  ⚠  ${result.message}\n`);
+      } else {
+        console.log(`✅ Synced ${result.synced} note(s) into the knowledge bank.`);
+        for (const t of result.copiedTo) console.log(`   • ${t}`);
+        console.log(`\n💡 The knowledge bank is now active. All personas will read it first.\n`);
+      }
+    } catch (err) {
+      console.error(`\n  ✗  Sync failed: ${err.message}\n`);
+      process.exit(1);
+    }
+    break;
+  }
+
+  case 'status': {
+    const cfg = status();
+    if (!cfg.sources || cfg.sources.length === 0) {
+      console.log('\n  No knowledge sources connected.\n  Run: npx analyzthis_design connect --vault /path/to/vault\n');
+    } else {
+      console.log(`\n📚 Knowledge bank sources (${cfg.sources.length}):\n`);
+      for (const s of cfg.sources) {
+        console.log(`  • ${s.path}`);
+        if (s.tags.length)    console.log(`    Tags:    ${s.tags.join(', ')}`);
+        if (s.include.length) console.log(`    Folders: ${s.include.join(', ')}`);
+        console.log(`    Added:   ${s.addedAt}`);
+      }
+      if (cfg.lastSync) console.log(`\n  Last sync: ${cfg.lastSync}`);
+      console.log('');
+    }
+    break;
+  }
+
   case '--help':
   case 'help':
   case '-h':

package/lib/install.js

@@ -26,6 +26,7 @@ const SKILLS = [
   'ux-ideator',
   'design-personas',
   'design-reference',
+  'knowledge-bank',
 ];
 
 // Copies a directory recursively

package/lib/knowledge.js

@@ -0,0 +1,250 @@
+#!/usr/bin/env node
+'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');
+const KNOWLEDGE_SKILL   = path.join(__dirname, '..', 'skills', 'knowledge-bank', 'SKILL.md');
+
+// Keywords used to auto-group vault notes into categories
+const CATEGORIES = {
+  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'],
+};
+
+// ─── 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 = { brand: [], product: [], design: [], research: [], tech: [], 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++;
+    }
+  }
+
+  // Build the knowledge-bank markdown
+  const sourceList = config.sources.map(s => s.path).join(', ');
+  const date       = new Date().toISOString().split('T')[0];
+
+  const sectionDefs = [
+    { key: 'brand',    heading: '## Brand & Design Guidelines' },
+    { key: 'product',  heading: '## Product Context' },
+    { key: 'design',   heading: '## Design Decisions & Patterns' },
+    { key: 'research', heading: '## Research & User Insights' },
+    { 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);
+
+  // Copy to each target AI tool's skills directory
+  const { TARGET_DIRS } = require('./install');
+  const copiedTo = [];
+
+  for (const target of targets) {
+    const dir = TARGET_DIRS[target];
+    if (!dir) continue;
+    fs.mkdirSync(dir, { recursive: true });
+
+    if (target === 'cursor') {
+      // Cursor expects a sub-directory with SKILL.md inside
+      const dest = path.join(dir, 'knowledge-bank');
+      fs.mkdirSync(dest, { recursive: true });
+      fs.copyFileSync(KNOWLEDGE_SKILL, path.join(dest, 'SKILL.md'));
+    } else {
+      // Claude/Codex: flat .md file
+      fs.copyFileSync(KNOWLEDGE_SKILL, path.join(dir, 'knowledge-bank.md'));
+    }
+    copiedTo.push(`${target} → ${dir}`);
+  }
+
+  // Persist lastSync timestamp
+  config.lastSync = new Date().toISOString();
+  saveConfig(config);
+
+  return { synced: totalFiles, copiedTo };
+}
+
+/**
+ * Return current config (sources list, lastSync).
+ */
+function status() {
+  return loadConfig();
+}
+
+module.exports = { connect, disconnect, sync, status };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "analyzthis_design",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "7 AI design personas for Cursor — run structured UX critiques and ideation sessions with Arjun (UX), Meera (Business), Priya (Feasibility), Zara (Delight), Noor (IA), Anuj (Power-User), and Raj (Arbitrator).",
   "keywords": [
     "cursor",

package/skills/design-critic/SKILL.md

@@ -9,6 +9,19 @@ Four specialist personas evaluate a design independently across UX, business, fe
 
 ---
 
+## Step -1: Load knowledge bank (highest priority)
+
+Before anything else, read `~/.cursor/skills/knowledge-bank/SKILL.md` (or `~/.claude/commands/knowledge-bank.md` / `~/.codex/skills/knowledge-bank.md` depending on your tool).
+
+If the knowledge bank has content (i.e. it is not the "No knowledge bank connected yet" placeholder):
+- Treat every section in the knowledge bank as **ground truth** for this project
+- Brand guidelines, design decisions, product context, and research insights override your built-in defaults
+- Reference specific knowledge bank entries when scoring or critiquing — quote them directly when relevant
+
+If the knowledge bank is empty or missing, proceed without it.
+
+---
+
 ## Step 0: Gather session context
 
 Before starting, ask the user for (or read from `_session-context` if available):

package/skills/knowledge-bank/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: knowledge-bank
+description: Personal knowledge bank. Takes precedence over all built-in persona defaults. Connect your Obsidian vault or any markdown folder, then sync. All 7 personas read this first.
+disable-model-invocation: true
+---
+
+# Knowledge Bank
+
+> No knowledge bank connected yet.
+
+To populate this with your own project knowledge, run:
+
+```bash
+# Connect an Obsidian vault (all notes)
+npx analyzthis_design connect --vault /path/to/your/obsidian
+
+# Connect a folder, filtering to only notes tagged #design or #brand
+npx analyzthis_design connect --vault /path/to/docs --tags design,brand,product
+
+# Connect a vault but only include specific sub-folders
+npx analyzthis_design connect --vault /path/to/vault --include Design,Brand,Research
+
+# After connecting, sync to generate the knowledge bank
+npx analyzthis_design sync
+
+# Sync to all AI tools at once
+npx analyzthis_design sync --target all
+```
+
+Once synced, this file is replaced with your actual vault content, grouped into:
+- Brand & Design Guidelines
+- Product Context
+- Design Decisions & Patterns
+- Research & User Insights
+- Technical Context
+
+**All 7 personas (Arjun, Meera, Priya, Zara, Noor, Anuj, Raj) will read this knowledge bank before any critique or ideation begins. Your project-specific knowledge takes full precedence over their built-in defaults.**

package/skills/ux-ideator/SKILL.md

@@ -9,6 +9,19 @@ Seven personas collaborate across 6 phases to produce a single, deliberated, imp
 
 ---
 
+## Step -1: Load knowledge bank (highest priority)
+
+Before anything else, read `~/.cursor/skills/knowledge-bank/SKILL.md` (or `~/.claude/commands/knowledge-bank.md` / `~/.codex/skills/knowledge-bank.md` depending on your tool).
+
+If the knowledge bank has content (i.e. it is not the "No knowledge bank connected yet" placeholder):
+- Treat every section as **ground truth** — brand guidelines, product decisions, research insights, and technical constraints override built-in persona defaults
+- All 7 personas must reference applicable knowledge bank entries during their respective phases
+- Design decisions already made in the knowledge bank are non-negotiable constraints — do not re-debate them
+
+If the knowledge bank is empty or missing, proceed without it.
+
+---
+
 ## Step 0: Load session context
 
 Read session context from the user or from `_session-context`: