analyzthis_design 2.0.0 → 2.1.0

package/dist/lib/host-llm.js

@@ -1 +1,251 @@
-'use strict';const fs=require('fs'),path=require('path'),os=require('os'),crypto=require('crypto'),{enforceOutputCap}=require('./token-gate'),RUNS_ROOT=path['join'](os['homedir'](),'.analyzthis_design','runs');class HostLlmPendingError extends Error{constructor({runDir:a,runId:b,stepId:c,personaId:d,pendingPath:e,completedSteps:f,totalSteps:g}){super('Host\x20LLM\x20pending:\x20'+d+'\x20('+c+')'),this['name']='HostLlmPendingError',this['runDir']=a,this['runId']=b,this['stepId']=c,this['personaId']=d,this['pendingPath']=e,this['completedSteps']=f,this['totalSteps']=g;}}function ensureDir(a){fs['mkdirSync'](a,{'recursive':!![]});}function createRun({projectId:a,task:b}){const c=Date['now']()+'-'+crypto['randomBytes'](0x3)['toString']('hex'),d=path['join'](RUNS_ROOT,a,c);ensureDir(path['join'](d,'pending')),ensureDir(path['join'](d,'responses'));const e={'run_id':c,'project_id':a,'task':b||'','created_at':new Date()['toISOString'](),'step_counter':0x0,'completed_steps':[]};return fs['writeFileSync'](path['join'](d,'manifest.json'),JSON['stringify'](e,null,0x2)),{'runId':c,'runDir':d,'manifest':e};}function loadManifest(a){const b=path['join'](a,'manifest.json');if(!fs['existsSync'](b))return null;return JSON['parse'](fs['readFileSync'](b,'utf8'));}function saveManifest(a,b){fs['writeFileSync'](path['join'](a,'manifest.json'),JSON['stringify'](b,null,0x2));}function nextStepId(a){return a['step_counter']=(a['step_counter']||0x0)+0x1,String(a['step_counter'])['padStart'](0x3,'0')+('-'+(a['pending_persona']||'step'));}function pendingPath(a,b){return path['join'](a,'pending',b+'.json');}function responsePath(a,b){return path['join'](a,'responses',b+'.md');}function writePending(a,b,{personaId:c,system:d,user:e,meta:meta={}}){b['pending_persona']=c;const f=String(b['step_counter']+0x1)['padStart'](0x3,'0')+'-'+c,g={'step_id':f,'persona_id':c,'system':d,'user':e,'max_tokens':meta['max_tokens']??meta['maxTokens']??null,'output_char_cap':meta['output_char_cap']??null,'created_at':new Date()['toISOString'](),...meta};return fs['writeFileSync'](pendingPath(a,f),JSON['stringify'](g,null,0x2)),f;}function readResponse(a,b){const c=responsePath(a,b);if(!fs['existsSync'](c))return null;return fs['readFileSync'](c,'utf8');}function submitResponse(a,b,c,{maxTokens:d}={}){ensureDir(path['join'](a,'responses'));let e=c;const f=pendingPath(a,b);if(fs['existsSync'](f))try{const h=JSON['parse'](fs['readFileSync'](f,'utf8')),i=d??h['max_tokens'];if(i)e=enforceOutputCap(c,i);}catch{}else d&&(e=enforceOutputCap(c,d));fs['writeFileSync'](responsePath(a,b),e);const g=loadManifest(a);g&&!g['completed_steps']['includes'](b)&&(g['completed_steps']['push'](b),saveManifest(a,g));}function listPending(a){const b=path['join'](a,'pending');if(!fs['existsSync'](b))return[];return fs['readdirSync'](b)['filter'](c=>c['endsWith']('.json'))['map'](c=>{const d=c['replace'](/\.json$/,''),e=JSON['parse'](fs['readFileSync'](path['join'](b,c),'utf8'));return{'stepId':d,'personaId':e['persona_id'],'hasResponse':fs['existsSync'](responsePath(a,d)),'pendingPath':path['join'](b,c)};})['sort']((c,d)=>c['stepId']['localeCompare'](d['stepId']));}function findLatestRun(a){const b=path['join'](RUNS_ROOT,a);if(!fs['existsSync'](b))return null;const c=fs['readdirSync'](b)['sort']()['reverse']();for(const d of c){const e=path['join'](b,d);if(fs['existsSync'](path['join'](e,'manifest.json')))return{'runId':d,'runDir':e};}return null;}async function callHostLlm({personaId:a,system:b,user:c,maxTokens:d,runContext:e}){const {runDir:f,manifest:g,hostResponder:h}=e;if(!f||!g)throw new Error('host\x20run\x20context\x20missing\x20—\x20call\x20createRun\x20first');const i=writePending(f,g,{'personaId':a,'system':b,'user':c,'meta':{'provider':'host','agent':'devi','max_tokens':d}});g['step_counter']+=0x1,saveManifest(f,g);const j=n=>d?enforceOutputCap(n,d):n;if(typeof h==='function'){const n=await h({'personaId':a,'system':b,'user':c,'stepId':i,'runDir':f,'maxTokens':d});if(n){const o=j(n);return submitResponse(f,i,o,{'maxTokens':d}),o;}}let k=readResponse(f,i);if(k)return k=j(k),g['completed_steps']=g['completed_steps']||[],!g['completed_steps']['includes'](i)&&(g['completed_steps']['push'](i),saveManifest(f,g)),k;const l=Number(process.env.HOST_LLM_POLL_MS||0x0);if(l>0x0){const p=Date['now']()+l;while(Date['now']()<p){k=readResponse(f,i);if(k){const q=j(k);return submitResponse(f,i,q,{'maxTokens':d}),q;}await new Promise(s=>setTimeout(s,0xc8));}}const m=listPending(f);throw new HostLlmPendingError({'runDir':f,'runId':g['run_id'],'stepId':i,'personaId':a,'pendingPath':pendingPath(f,i),'completedSteps':g['completed_steps']?.['length']||0x0,'totalSteps':m['length']});}function printDeviInstructions(a){console['log']('\x0a╔══════════════════════════════════════════════════════════════════════╗'),console['log']('║\x20\x20DEVI\x20—\x20Host\x20LLM\x20pending\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20║'),console['log']('╚══════════════════════════════════════════════════════════════════════╝\x0a'),console['log']('\x20\x20Persona\x20waiting:\x20\x20'+a['personaId']),console['log']('\x20\x20Step:\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20'+a['stepId']),console['log']('\x20\x20Prompt\x20file:\x20\x20\x20\x20\x20\x20'+a['pendingPath']),console['log']('\x20\x20Run\x20directory:\x20\x20\x20\x20'+a['runDir']),console['log']('\x0a\x20\x20In\x20Cursor,\x20invoke:\x20\x20/devi'),console['log']('\x20\x20Or\x20submit\x20response:'),console['log']('\x20\x20\x20\x20npx\x20analyzthis_design\x20devi\x20respond\x20--run\x20'+a['runDir']+'\x20--step\x20'+a['stepId']+'\x20--file\x20response.md'),console['log']('\x20\x20Then\x20continue:'),console['log']('\x20\x20\x20\x20npx\x20analyzthis_design\x20run\x20--continue\x20--task\x20\x22...\x22\x20--project\x20'+path['basename'](path['dirname'](a['runDir']))+'\x0a');}module['exports']={'HostLlmPendingError':HostLlmPendingError,'RUNS_ROOT':RUNS_ROOT,'createRun':createRun,'loadManifest':loadManifest,'saveManifest':saveManifest,'writePending':writePending,'readResponse':readResponse,'submitResponse':submitResponse,'listPending':listPending,'findLatestRun':findLatestRun,'callHostLlm':callHostLlm,'printDeviInstructions':printDeviInstructions,'pendingPath':pendingPath,'responsePath':responsePath};
+'use strict';
+
+/**
+ * Host LLM bridge — orchestrator writes persona prompts; Devi (host IDE agent) writes responses.
+ * No external API keys required.
+ *
+ * Run dir: ~/.analyzthis_design/runs/{projectId}/{runId}/
+ *   pending/001-arjun.json
+ *   responses/001-arjun.md
+ *   manifest.json
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const crypto = require('crypto');
+const { enforceOutputCap } = require('./token-gate');
+
+const RUNS_ROOT = path.join(os.homedir(), '.analyzthis_design', 'runs');
+
+class HostLlmPendingError extends Error {
+  constructor({ runDir, runId, stepId, personaId, pendingPath, completedSteps, totalSteps }) {
+    super(`Host LLM pending: ${personaId} (${stepId})`);
+    this.name = 'HostLlmPendingError';
+    this.runDir = runDir;
+    this.runId = runId;
+    this.stepId = stepId;
+    this.personaId = personaId;
+    this.pendingPath = pendingPath;
+    this.completedSteps = completedSteps;
+    this.totalSteps = totalSteps;
+  }
+}
+
+function ensureDir(p) {
+  fs.mkdirSync(p, { recursive: true });
+}
+
+function createRun({ projectId, task }) {
+  const runId = `${Date.now()}-${crypto.randomBytes(3).toString('hex')}`;
+  const runDir = path.join(RUNS_ROOT, projectId, runId);
+  ensureDir(path.join(runDir, 'pending'));
+  ensureDir(path.join(runDir, 'responses'));
+  const manifest = {
+    run_id: runId,
+    project_id: projectId,
+    task: task || '',
+    created_at: new Date().toISOString(),
+    step_counter: 0,
+    completed_steps: [],
+  };
+  fs.writeFileSync(path.join(runDir, 'manifest.json'), JSON.stringify(manifest, null, 2));
+  return { runId, runDir, manifest };
+}
+
+function loadManifest(runDir) {
+  const p = path.join(runDir, 'manifest.json');
+  if (!fs.existsSync(p)) return null;
+  return JSON.parse(fs.readFileSync(p, 'utf8'));
+}
+
+function saveManifest(runDir, manifest) {
+  fs.writeFileSync(path.join(runDir, 'manifest.json'), JSON.stringify(manifest, null, 2));
+}
+
+function nextStepId(manifest) {
+  manifest.step_counter = (manifest.step_counter || 0) + 1;
+  return String(manifest.step_counter).padStart(3, '0') + `-${manifest.pending_persona || 'step'}`;
+}
+
+function pendingPath(runDir, stepId) {
+  return path.join(runDir, 'pending', `${stepId}.json`);
+}
+
+function responsePath(runDir, stepId) {
+  return path.join(runDir, 'responses', `${stepId}.md`);
+}
+
+function writePending(runDir, manifest, { personaId, system, user, meta = {} }) {
+  manifest.pending_persona = personaId;
+  const stepId = `${String(manifest.step_counter + 1).padStart(3, '0')}-${personaId}`;
+  const payload = {
+    step_id: stepId,
+    persona_id: personaId,
+    system,
+    user,
+    max_tokens: meta.max_tokens ?? meta.maxTokens ?? null,
+    output_char_cap: meta.output_char_cap ?? null,
+    created_at: new Date().toISOString(),
+    ...meta,
+  };
+  fs.writeFileSync(pendingPath(runDir, stepId), JSON.stringify(payload, null, 2));
+  return stepId;
+}
+
+function readResponse(runDir, stepId) {
+  const p = responsePath(runDir, stepId);
+  if (!fs.existsSync(p)) return null;
+  return fs.readFileSync(p, 'utf8');
+}
+
+function submitResponse(runDir, stepId, text, { maxTokens } = {}) {
+  ensureDir(path.join(runDir, 'responses'));
+  let capped = text;
+  const pendingFile = pendingPath(runDir, stepId);
+  if (fs.existsSync(pendingFile)) {
+    try {
+      const pending = JSON.parse(fs.readFileSync(pendingFile, 'utf8'));
+      const cap = maxTokens ?? pending.max_tokens;
+      if (cap) capped = enforceOutputCap(text, cap);
+    } catch { /* use raw text */ }
+  } else if (maxTokens) {
+    capped = enforceOutputCap(text, maxTokens);
+  }
+  fs.writeFileSync(responsePath(runDir, stepId), capped);
+  const manifest = loadManifest(runDir);
+  if (manifest && !manifest.completed_steps.includes(stepId)) {
+    manifest.completed_steps.push(stepId);
+    saveManifest(runDir, manifest);
+  }
+}
+
+function listPending(runDir) {
+  const pendingDir = path.join(runDir, 'pending');
+  if (!fs.existsSync(pendingDir)) return [];
+  return fs.readdirSync(pendingDir)
+    .filter((f) => f.endsWith('.json'))
+    .map((f) => {
+      const stepId = f.replace(/\.json$/, '');
+      const data = JSON.parse(fs.readFileSync(path.join(pendingDir, f), 'utf8'));
+      return {
+        stepId,
+        personaId: data.persona_id,
+        hasResponse: fs.existsSync(responsePath(runDir, stepId)),
+        pendingPath: path.join(pendingDir, f),
+      };
+    })
+    .sort((a, b) => a.stepId.localeCompare(b.stepId));
+}
+
+function findLatestRun(projectId) {
+  const dir = path.join(RUNS_ROOT, projectId);
+  if (!fs.existsSync(dir)) return null;
+  const runs = fs.readdirSync(dir).sort().reverse();
+  for (const runId of runs) {
+    const runDir = path.join(dir, runId);
+    if (fs.existsSync(path.join(runDir, 'manifest.json'))) return { runId, runDir };
+  }
+  return null;
+}
+
+/**
+ * Host provider call — write pending, return response if exists, else throw HostLlmPendingError.
+ * @param {object} opts
+ * @param {object} opts.runContext — { runDir, manifest, hostResponder }
+ */
+async function callHostLlm({ personaId, system, user, maxTokens, runContext }) {
+  const { runDir, manifest, hostResponder } = runContext;
+  if (!runDir || !manifest) throw new Error('host run context missing — call createRun first');
+
+  const stepId = writePending(runDir, manifest, {
+    personaId,
+    system,
+    user,
+    meta: { provider: 'host', agent: 'devi', max_tokens: maxTokens },
+  });
+  manifest.step_counter += 1;
+  saveManifest(runDir, manifest);
+
+  const applyCap = (raw) => (maxTokens ? enforceOutputCap(raw, maxTokens) : raw);
+
+  // Inline responder (tests / scripted fixtures)
+  if (typeof hostResponder === 'function') {
+    const text = await hostResponder({ personaId, system, user, stepId, runDir, maxTokens });
+    if (text) {
+      const capped = applyCap(text);
+      submitResponse(runDir, stepId, capped, { maxTokens });
+      return capped;
+    }
+  }
+
+  // Pre-written response file
+  let text = readResponse(runDir, stepId);
+  if (text) {
+    text = applyCap(text);
+    manifest.completed_steps = manifest.completed_steps || [];
+    if (!manifest.completed_steps.includes(stepId)) {
+      manifest.completed_steps.push(stepId);
+      saveManifest(runDir, manifest);
+    }
+    return text;
+  }
+
+  // Optional short poll (HOST_LLM_POLL_MS)
+  const pollMs = Number(process.env.HOST_LLM_POLL_MS || 0);
+  if (pollMs > 0) {
+    const deadline = Date.now() + pollMs;
+    while (Date.now() < deadline) {
+      text = readResponse(runDir, stepId);
+      if (text) {
+        const capped = applyCap(text);
+        submitResponse(runDir, stepId, capped, { maxTokens });
+        return capped;
+      }
+      await new Promise((r) => setTimeout(r, 200));
+    }
+  }
+
+  const pending = listPending(runDir);
+  throw new HostLlmPendingError({
+    runDir,
+    runId: manifest.run_id,
+    stepId,
+    personaId,
+    pendingPath: pendingPath(runDir, stepId),
+    completedSteps: manifest.completed_steps?.length || 0,
+    totalSteps: pending.length,
+  });
+}
+
+function printDeviInstructions(err) {
+  console.log('\n╔══════════════════════════════════════════════════════════════════════╗');
+  console.log('║  DEVI — Host LLM pending                                             ║');
+  console.log('╚══════════════════════════════════════════════════════════════════════╝\n');
+  console.log(`  Persona waiting:  ${err.personaId}`);
+  console.log(`  Step:             ${err.stepId}`);
+  console.log(`  Prompt file:      ${err.pendingPath}`);
+  console.log(`  Run directory:    ${err.runDir}`);
+  console.log('\n  In Cursor, invoke:  /devi');
+  console.log('  Or submit response:');
+  console.log(`    npx analyzthis_design devi respond --run ${err.runDir} --step ${err.stepId} --file response.md`);
+  console.log('  Then continue:');
+  console.log(`    npx analyzthis_design run --continue --task "..." --project ${path.basename(path.dirname(err.runDir))}\n`);
+}
+
+module.exports = {
+  HostLlmPendingError,
+  RUNS_ROOT,
+  createRun,
+  loadManifest,
+  saveManifest,
+  writePending,
+  readResponse,
+  submitResponse,
+  listPending,
+  findLatestRun,
+  callHostLlm,
+  printDeviInstructions,
+  pendingPath,
+  responsePath,
+};

package/dist/lib/install.js

@@ -1,2 +1,302 @@
 #!/usr/bin/env node
-'use strict';const fs=require('fs'),path=require('path'),os=require('os'),{TARGETS,TARGET_DIRS,ALL_TARGET_IDS,resolveTargets,resolvePackageRoot,listInstalledTargets}=require('./platforms'),PACKAGE_ROOT=resolvePackageRoot(__dirname),PACKAGE_SKILLS_DIR=path['join'](PACKAGE_ROOT,'skills'),WELCOME_MARKER=path['join'](os['homedir'](),'.analyzthis_design','.welcome-shown'),SKILLS=['getting-started','arjun','meera','priya','zara','noor','anuj','raj','kavi','collect-knowledge','design-critic','ux-ideator','ux-story-gate','persona-orchestrator','deliberation-protocol','devi','design-director','design-spec','design-personas','design-reference','knowledge-bank'];function getPackageVersion(){try{return JSON['parse'](fs['readFileSync'](path['join'](PACKAGE_ROOT,'package.json'),'utf8'))['version'];}catch{return'unknown';}}function shouldShowWelcome(){try{return!fs['existsSync'](WELCOME_MARKER);}catch{return!![];}}function markWelcomeShown(){fs['mkdirSync'](path['dirname'](WELCOME_MARKER),{'recursive':!![]}),fs['writeFileSync'](WELCOME_MARKER,new Date()['toISOString']());}function printWelcomeBanner(a,b=console['log']){const c=TARGETS[a];if(!c)return;const d=c['invokePrefix']||'/',e=getPackageVersion(),f=d+'getting-started';b('\x0a✅\x20Analyzthis\x20Design\x20installed\x20(v'+e+')'),b(''),b('\x20\x20Structured\x20UX\x20critiques,\x20ideation,\x20and\x20task-grounded\x20screen\x20reviews\x20—\x20in\x20your\x20AI\x20chat.'),b('\x20\x20No\x20external\x20LLM\x20API\x20keys\x20required\x20for\x20CLI\x20runs:\x20'+(d+'devi\x20voices\x20each\x20persona\x20from\x20your\x20IDE.')),b(''),b('Start\x20here\x20in\x20'+c['label']+':');if(a==='windsurf')b('\x20\x20@getting-started\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20←\x20read\x20this\x20first');else a==='codex'?(b('\x20\x20Add\x20to\x20AGENTS.md:\x20getting-started,\x20kavi,\x20devi,\x20ux-ideator,\x20persona-orchestrator'),b('\x20\x20Skills\x20live\x20in\x20~/.codex/skills/<name>/SKILL.md')):b('\x20\x20'+f+'\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20←\x20read\x20this\x20first');b(''),b('\x20\x20Design\x20—\x20wireframes\x20(new\x20screens):'),b('\x20\x20\x20\x20'+d+'ux-ideator\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20two\x20competing\x20text\x20wireframes\x20+\x20deliberation'),b('\x20\x20\x20\x20'+d+'design-director\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20wireframe\x20→\x20DesignSpec\x20→\x20spec\x20gates\x20→\x20build'),b('\x20\x20\x20\x20'+d+'noor\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20quick\x20minimalist\x20wireframe\x20(Concept\x20A)'),b('\x20\x20\x20\x20'+d+'anuj\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20power-user\x20wireframe\x20(Concept\x20B)'),b(''),b('\x20\x20Evaluate\x20—\x20critique\x20(existing\x20designs):'),b('\x20\x20\x20\x20'+d+'kavi\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20scan\x20repo\x20→\x20knowledge\x20bank\x20(once\x20per\x20project)'),b('\x20\x20\x20\x20'+d+'persona-orchestrator\x20\x20\x20\x20\x20MoE\x20router\x20+\x20gates\x20→\x20SHIP\x20/\x20REVISE\x20/\x20BLOCK'),b('\x20\x20\x20\x20'+d+'design-critic\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x204-persona\x20critique\x20+\x20composite\x20score'),b('\x20\x20\x20\x20'+d+'deliberation-protocol\x20\x20\x20\x20adversarial\x20review\x20rules\x20(objections,\x20Raj)'),b('\x20\x20\x20\x20'+d+'devi\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20\x20host\x20LLM:\x20voice\x20personas\x20when\x20CLI\x20has\x20no\x20API\x20keys'),b(''),b('\x20\x20CLI\x20(host\x20mode\x20—\x20no\x20API\x20keys):'),b('\x20\x20\x20\x20npx\x20analyzthis_design\x20collect'),b('\x20\x20\x20\x20npx\x20analyzthis_design\x20run\x20--task\x20\x22Review\x20screen\x22\x20--full'),b('\x20\x20\x20\x20npx\x20analyzthis_design\x20devi\x20status'),b('\x20\x20\x20\x20npx\x20analyzthis_design\x20run\x20--continue\x20--task\x20\x22...\x22\x20--full'),b(''),b('\x20\x20Re-print\x20anytime:\x20npx\x20analyzthis_design\x20welcome\x20--target\x20'+a),b('\x20\x20Docs:\x20https://www.npmjs.com/package/analyzthis_design'),b('\x20\x20Repo:\x20https://github.com/joshirishi/analyzthis_design\x0a');}function copyDir(a,b){fs['mkdirSync'](b,{'recursive':!![]});for(const c of fs['readdirSync'](a,{'withFileTypes':!![]})){const d=path['join'](a,c['name']),e=path['join'](b,c['name']);if(c['isDirectory']())copyDir(d,e);else fs['copyFileSync'](d,e);}}function installFlat(a,b,c){const d=path['join'](PACKAGE_SKILLS_DIR,a,'SKILL.md'),e=path['join'](b,a+'.md');if(!fs['existsSync'](d))return'missing';if(fs['existsSync'](e)&&!c)return'skipped';try{return fs['mkdirSync'](b,{'recursive':!![]}),fs['copyFileSync'](d,e),'installed';}catch{return'error';}}function installDir(a,b,c){const d=path['join'](PACKAGE_SKILLS_DIR,a),e=path['join'](b,a);if(!fs['existsSync'](d))return'missing';if(fs['existsSync'](e)&&!c)return'skipped';try{return copyDir(d,e),'installed';}catch{return'error';}}function skillInstalledAt(a,b,c){if(b==='dir')return fs['existsSync'](path['join'](a,c,'SKILL.md'))||fs['existsSync'](path['join'](a,c));return fs['existsSync'](path['join'](a,c+'.md'));}function installOne(a,b,c,d){if(a==='design-reference'||c==='dir')return installDir(a,b,d);return installFlat(a,b,d);}function installMissing(a,b,c){let d='skipped';for(const e of b){if(!c&&skillInstalledAt(e['root'],e['layout'],a))continue;const f=installOne(a,e['root'],e['layout'],c);if(f==='installed')d='installed';else{if(f==='error')return'error';else{if(f==='missing')return'missing';}}}return d;}function install({silent:silent=![],force:force=![],target:target='cursor',showBanner:showBanner=!![]}={}){const a=silent?()=>{}:console['log'],b=silent?()=>{}:console['warn'],c=resolveTargets(target);if(!c){b('\x20\x20⚠\x20\x20Unknown\x20target\x20\x22'+target+'\x22.\x20Choose:\x20'+ALL_TARGET_IDS['join'](',\x20')+',\x20all');return;}for(const d of c){const e=TARGETS[d],f=[{'root':e['root'],'layout':e['layout']}];if(e['also'])f['push']({'root':e['also']['root'],'layout':e['also']['layout']});const g=[],h=[],i=[];for(const j of SKILLS){const k=installMissing(j,f,force);if(k==='installed')g['push'](j);else{if(k==='skipped')h['push'](j);else k==='missing'?(b('\x20\x20⚠\x20\x20Skill\x20source\x20not\x20found:\x20'+j),i['push'](j)):(b('\x20\x20✗\x20\x20Failed\x20to\x20install\x20'+j),i['push'](j));}}if(g['length']>0x0){a('\x0a✅\x20['+e['label']+']\x20Installed\x20'+g['length']+'\x20skill(s)\x20→\x20'+e['root']);if(e['also'])a('\x20\x20\x20(+\x20legacy\x20copy\x20→\x20'+e['also']['root']+')');for(const l of g)a('\x20\x20\x20•\x20'+l);}if(h['length']>0x0){a('\x0a⏭\x20\x20['+e['label']+']\x20Skipped\x20'+h['length']+'\x20existing\x20skill(s)\x20(use\x20--force\x20to\x20overwrite):');for(const m of h)a('\x20\x20\x20•\x20'+m);}i['length']>0x0&&a('\x0a✗\x20\x20['+e['label']+']\x20'+i['length']+'\x20skill(s)\x20failed.'),showBanner&&!silent&&(g['length']>0x0||h['length']>0x0)&&printWelcomeBanner(d,a);}}function remove({silent:silent=![],target:target='cursor'}={}){const a=silent?()=>{}:console['log'],b=resolveTargets(target);if(!b)return;for(const c of b){const d=TARGETS[c],e=[d['root']];if(d['also'])e['push'](d['also']['root']);const f=[],g=[];for(const h of SKILLS){let i=![];for(const j of e){const k=path['join'](j,h),l=path['join'](j,h+'.md');fs['existsSync'](k)&&(fs['rmSync'](k,{'recursive':!![],'force':!![]}),i=!![]),fs['existsSync'](l)&&(fs['rmSync'](l,{'force':!![]}),i=!![]);}if(i)f['push'](h);else g['push'](h);}if(f['length']>0x0){a('\x0a🗑\x20\x20['+d['label']+']\x20Removed\x20'+f['length']+'\x20skill(s):');for(const m of f)a('\x20\x20\x20•\x20'+m);}g['length']>0x0&&a('\x0a\x20\x20\x20['+d['label']+']\x20'+g['length']+'\x20skill(s)\x20were\x20not\x20installed.');}a('');}module['exports']={'install':install,'remove':remove,'SKILLS':SKILLS,'TARGET_DIRS':TARGET_DIRS,'TARGETS':TARGETS,'ALL_TARGET_IDS':ALL_TARGET_IDS,'printWelcomeBanner':printWelcomeBanner,'markWelcomeShown':markWelcomeShown,'shouldShowWelcome':shouldShowWelcome};if(require['main']===module){const silent=process['argv']['includes']('--silent'),forceWelcome=process['argv']['includes']('--welcome'),postTargets=listInstalledTargets(),targets=postTargets['length']?postTargets:['cursor'];for(const tId of targets){install({'silent':silent,'target':tId,'showBanner':!silent&&tId==='cursor'});}(forceWelcome||shouldShowWelcome())&&(silent&&(printWelcomeBanner('cursor'),printWelcomeBanner('claude')),markWelcomeShown());}
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const {
+  TARGETS,
+  TARGET_DIRS,
+  ALL_TARGET_IDS,
+  resolveTargets,
+  resolvePackageRoot,
+  listInstalledTargets,
+} = require('./platforms');
+
+const PACKAGE_ROOT = resolvePackageRoot(__dirname);
+const PACKAGE_SKILLS_DIR = path.join(PACKAGE_ROOT, 'skills');
+const WELCOME_MARKER = path.join(os.homedir(), '.analyzthis_design', '.welcome-shown');
+
+const SKILLS = [
+  'getting-started',
+  'arjun',
+  'meera',
+  'priya',
+  'zara',
+  'noor',
+  'anuj',
+  'raj',
+  'kavi',
+  'collect-knowledge',
+  'design-critic',
+  'ux-ideator',
+  'ux-story-gate',
+  'persona-orchestrator',
+  'deliberation-protocol',
+  'chunk-planner',
+  'run-unchunked',
+  'evolve-check',
+  'devi',
+  'design-director',
+  'design-spec',
+  'design-personas',
+  'design-reference',
+  'knowledge-bank',
+];
+
+function getPackageVersion() {
+  try {
+    return JSON.parse(fs.readFileSync(path.join(PACKAGE_ROOT, 'package.json'), 'utf8')).version;
+  } catch {
+    return 'unknown';
+  }
+}
+
+function shouldShowWelcome() {
+  try {
+    return !fs.existsSync(WELCOME_MARKER);
+  } catch {
+    return true;
+  }
+}
+
+function markWelcomeShown() {
+  fs.mkdirSync(path.dirname(WELCOME_MARKER), { recursive: true });
+  fs.writeFileSync(WELCOME_MARKER, new Date().toISOString());
+}
+
+function printWelcomeBanner(targetId, log = console.log) {
+  const t = TARGETS[targetId];
+  if (!t) return;
+  const p = t.invokePrefix || '/';
+  const version = getPackageVersion();
+  const gs = `${p}getting-started`;
+
+  log(`\n✅ Analyzthis Design installed (v${version})`);
+  log('');
+  log('  Structured UX critiques, ideation, and task-grounded screen reviews — in your AI chat.');
+  log('  No external LLM API keys required for CLI runs: ' +
+    `${p}devi voices each persona from your IDE.`);
+  log('');
+  log(`Start here in ${t.label}:`);
+  if (targetId === 'windsurf') {
+    log(`  @getting-started          ← read this first`);
+  } else if (targetId === 'codex') {
+    log('  Add to AGENTS.md: getting-started, kavi, devi, ux-ideator, persona-orchestrator');
+    log('  Skills live in ~/.codex/skills/<name>/SKILL.md');
+  } else {
+    log(`  ${gs}          ← read this first`);
+  }
+
+  log('');
+  log('  Design — wireframes (new screens):');
+  log(`    ${p}ux-ideator               two competing text wireframes + deliberation`);
+  log(`    ${p}design-director          wireframe → DesignSpec → spec gates → build`);
+  log(`    ${p}noor                     quick minimalist wireframe (Concept A)`);
+  log(`    ${p}anuj                     power-user wireframe (Concept B)`);
+
+  log('');
+  log('  Evaluate — critique (existing designs):');
+  log(`    ${p}kavi                     scan repo → knowledge bank (once per project)`);
+  log(`    ${p}persona-orchestrator     MoE router + gates → SHIP / REVISE / BLOCK`);
+  log(`    ${p}design-critic            4-persona critique + composite score`);
+  log(`    ${p}deliberation-protocol    adversarial review rules (objections, Raj)`);
+  log(`    ${p}devi                     host LLM: voice personas when CLI has no API keys`);
+
+  log('');
+  log('  CLI (host mode — no API keys):');
+  log('    npx analyzthis_design collect');
+  log('    npx analyzthis_design run --task "Review screen" --full');
+  log('    npx analyzthis_design devi status');
+  log('    npx analyzthis_design run --continue --task "..." --full');
+
+  log('');
+  log(`  Re-print anytime: npx analyzthis_design welcome --target ${targetId}`);
+  log('  Docs: https://www.npmjs.com/package/analyzthis_design');
+  log('  Repo: https://github.com/joshirishi/analyzthis_design\n');
+}
+
+function copyDir(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    if (entry.isDirectory()) copyDir(srcPath, destPath);
+    else fs.copyFileSync(srcPath, destPath);
+  }
+}
+
+function installFlat(skill, skillsDir, force) {
+  const src = path.join(PACKAGE_SKILLS_DIR, skill, 'SKILL.md');
+  const dest = path.join(skillsDir, `${skill}.md`);
+  if (!fs.existsSync(src)) return 'missing';
+  if (fs.existsSync(dest) && !force) return 'skipped';
+  try {
+    fs.mkdirSync(skillsDir, { recursive: true });
+    fs.copyFileSync(src, dest);
+    return 'installed';
+  } catch {
+    return 'error';
+  }
+}
+
+function installDir(skill, skillsDir, force) {
+  const src = path.join(PACKAGE_SKILLS_DIR, skill);
+  const dest = path.join(skillsDir, skill);
+  if (!fs.existsSync(src)) return 'missing';
+  if (fs.existsSync(dest) && !force) return 'skipped';
+  try {
+    copyDir(src, dest);
+    return 'installed';
+  } catch {
+    return 'error';
+  }
+}
+
+function skillInstalledAt(root, layout, skill) {
+  if (layout === 'dir') {
+    return fs.existsSync(path.join(root, skill, 'SKILL.md')) || fs.existsSync(path.join(root, skill));
+  }
+  return fs.existsSync(path.join(root, `${skill}.md`));
+}
+
+function installOne(skill, root, layout, force) {
+  if (skill === 'design-reference' || layout === 'dir') {
+    return installDir(skill, root, force);
+  }
+  return installFlat(skill, root, force);
+}
+
+/** Install skills missing from any destination (safe upgrade path without --force). */
+function installMissing(skill, destinations, force) {
+  let status = 'skipped';
+  for (const dest of destinations) {
+    if (!force && skillInstalledAt(dest.root, dest.layout, skill)) continue;
+    const result = installOne(skill, dest.root, dest.layout, force);
+    if (result === 'installed') status = 'installed';
+    else if (result === 'error') return 'error';
+    else if (result === 'missing') return 'missing';
+  }
+  return status;
+}
+
+function install({ silent = false, force = false, target = 'cursor', showBanner = true } = {}) {
+  const log = silent ? () => {} : console.log;
+  const warn = silent ? () => {} : console.warn;
+
+  const targets = resolveTargets(target);
+  if (!targets) {
+    warn(`  ⚠  Unknown target "${target}". Choose: ${ALL_TARGET_IDS.join(', ')}, all`);
+    return;
+  }
+
+  for (const tId of targets) {
+    const t = TARGETS[tId];
+    const destinations = [{ root: t.root, layout: t.layout }];
+    if (t.also) destinations.push({ root: t.also.root, layout: t.also.layout });
+
+    const installed = [], skipped = [], errors = [];
+
+    for (const skill of SKILLS) {
+      const result = installMissing(skill, destinations, force);
+      if (result === 'installed') {
+        installed.push(skill);
+      } else if (result === 'skipped') {
+        skipped.push(skill);
+      } else if (result === 'missing') {
+        warn(`  ⚠  Skill source not found: ${skill}`);
+        errors.push(skill);
+      } else {
+        warn(`  ✗  Failed to install ${skill}`);
+        errors.push(skill);
+      }
+    }
+
+    if (installed.length > 0) {
+      log(`\n✅ [${t.label}] Installed ${installed.length} skill(s) → ${t.root}`);
+      if (t.also) log(`   (+ legacy copy → ${t.also.root})`);
+      for (const s of installed) log(`   • ${s}`);
+    }
+    if (skipped.length > 0) {
+      log(`\n⏭  [${t.label}] Skipped ${skipped.length} existing skill(s) (use --force to overwrite):`);
+      for (const s of skipped) log(`   • ${s}`);
+    }
+    if (errors.length > 0) {
+      log(`\n✗  [${t.label}] ${errors.length} skill(s) failed.`);
+    }
+    if (showBanner && !silent && (installed.length > 0 || skipped.length > 0)) {
+      printWelcomeBanner(tId, log);
+    }
+  }
+}
+
+function remove({ silent = false, target = 'cursor' } = {}) {
+  const log = silent ? () => {} : console.log;
+
+  const targets = resolveTargets(target);
+  if (!targets) return;
+
+  for (const tId of targets) {
+    const t = TARGETS[tId];
+    const roots = [t.root];
+    if (t.also) roots.push(t.also.root);
+
+    const removed = [], missing = [];
+
+    for (const skill of SKILLS) {
+      let found = false;
+      for (const root of roots) {
+        const asDir  = path.join(root, skill);
+        const asFile = path.join(root, `${skill}.md`);
+        if (fs.existsSync(asDir)) {
+          fs.rmSync(asDir, { recursive: true, force: true });
+          found = true;
+        }
+        if (fs.existsSync(asFile)) {
+          fs.rmSync(asFile, { force: true });
+          found = true;
+        }
+      }
+      if (found) removed.push(skill);
+      else missing.push(skill);
+    }
+
+    if (removed.length > 0) {
+      log(`\n🗑  [${t.label}] Removed ${removed.length} skill(s):`);
+      for (const s of removed) log(`   • ${s}`);
+    }
+    if (missing.length > 0) {
+      log(`\n   [${t.label}] ${missing.length} skill(s) were not installed.`);
+    }
+  }
+  log('');
+}
+
+module.exports = {
+  install,
+  remove,
+  SKILLS,
+  TARGET_DIRS,
+  TARGETS,
+  ALL_TARGET_IDS,
+  printWelcomeBanner,
+  markWelcomeShown,
+  shouldShowWelcome,
+};
+
+if (require.main === module) {
+  const silent = process.argv.includes('--silent');
+  const forceWelcome = process.argv.includes('--welcome');
+  const postTargets = listInstalledTargets();
+  const targets = postTargets.length ? postTargets : ['cursor'];
+  for (const tId of targets) {
+    install({ silent, target: tId, showBanner: !silent && tId === 'cursor' });
+  }
+  if (forceWelcome || shouldShowWelcome()) {
+    if (silent) {
+      printWelcomeBanner('cursor');
+      printWelcomeBanner('claude');
+    }
+    markWelcomeShown();
+  }
+}