analyzthis_design 2.0.0 → 2.1.0

package/dist/lib/deliberation.js

@@ -1 +1,721 @@
-'use strict';const fs=require('fs'),path=require('path'),os=require('os'),dedup=require('./dedup'),CONFIG_FILE=path['join'](os['homedir'](),'.analyzthis_design','config.json'),DEFAULTS={'satisfaction_threshold':0.4,'max_rounds':0x3,'parallel_pairs':[['noor','anuj'],['meera','priya']],'objection_token_cap':0x258,'prior_output_chars_first':0x320,'prior_output_chars_rebuttal':0x190,'prior_output_chars_produce':0x4b0,'context_pack_chars_objection':0x5dc,'context_pack_chars_produce':0xbb8,'escalate_to_raj_after_round':0x2,'default_mode':'adversarial'},DELIBERATION_JSON_HINT='\x0aEnd\x20your\x20response\x20with\x20a\x20fenced\x20JSON\x20block:\x0a```json\x20deliberation\x0a{\x0a\x20\x20\x22grounding\x22:\x20[{\x22type\x22:\x20\x22task_map\x22,\x20\x22ref\x22:\x20\x22task_map[0]\x22,\x20\x22note\x22:\x20\x22...\x22}],\x0a\x20\x20\x22satisfaction_with_prior\x22:\x200.3,\x0a\x20\x20\x22accepts_prior\x22:\x20false,\x0a\x20\x20\x22objections\x22:\x20[{\x22target_persona\x22:\x20\x22arjun\x22,\x20\x22claim\x22:\x20\x22...\x22,\x20\x22evidence_required\x22:\x20\x22...\x22,\x20\x22blocking\x22:\x20true,\x20\x22grounded_in\x22:\x20\x22...\x22}],\x0a\x20\x20\x22questions\x22:\x20[\x22...\x22],\x0a\x20\x20\x22revisions\x22:\x20[\x22...\x22],\x0a\x20\x20\x22verdict\x22:\x20\x22CONTEST\x22\x0a}\x0a```';function loadDeliberationConfig(a){let b=a;if(!b)try{b=fs['existsSync'](CONFIG_FILE)?JSON['parse'](fs['readFileSync'](CONFIG_FILE,'utf8')):{};}catch{b={};}const c=b['deliberation']||{};return{'satisfaction_threshold':c['satisfaction_threshold']??DEFAULTS['satisfaction_threshold'],'max_rounds':c['max_rounds']??DEFAULTS['max_rounds'],'parallel_pairs':c['parallel_pairs']??DEFAULTS['parallel_pairs'],'objection_token_cap':c['objection_token_cap']??DEFAULTS['objection_token_cap'],'prior_output_chars_first':c['prior_output_chars_first']??DEFAULTS['prior_output_chars_first'],'prior_output_chars_rebuttal':c['prior_output_chars_rebuttal']??DEFAULTS['prior_output_chars_rebuttal'],'prior_output_chars_produce':c['prior_output_chars_produce']??DEFAULTS['prior_output_chars_produce'],'context_pack_chars_objection':c['context_pack_chars_objection']??DEFAULTS['context_pack_chars_objection'],'context_pack_chars_produce':c['context_pack_chars_produce']??DEFAULTS['context_pack_chars_produce'],'escalate_to_raj_after_round':c['escalate_to_raj_after_round']??DEFAULTS['escalate_to_raj_after_round'],'default_mode':c['default_mode']??DEFAULTS['default_mode']};}function readVaultExcerpt(a,b=0x7d0){if(!a||!fs['existsSync'](a))return'';const c=[],d=['PRDs','Brand','Components','Product'];for(const e of d){const g=path['join'](a,e);if(!fs['existsSync'](g))continue;try{for(const h of fs['readdirSync'](g)['filter'](i=>i['endsWith']('.md'))['slice'](0x0,0x2)){const i=fs['readFileSync'](path['join'](g,h),'utf8');c['push']('---\x20'+e+'/'+h+'\x20---\x0a'+i['slice'](0x0,0x1f4));}}catch{}if(c['join']('')['length']>b)break;}return c['join']('\x0a\x0a')['slice'](0x0,b);}function buildContextPack(a,b,c=''){const d=(a['task_map']||[])['slice'](0x0,0x8)['map']((e,f)=>({'id':f,'task':e['task'],'frequency':e['frequency'],'priority':e['priority']}));return{'task':b,'figma':c||a['figma_node']?.['url']||'','task_map':d,'task_map_summary':a['digest']?.['task_map_summary']||b['slice'](0x0,0xf0),'hierarchy_top3':a['digest']?.['hierarchy_top3']||a['information_hierarchy']?.['ranking']?.['slice'](0x0,0x3)||[],'ds_checklist':a['ds_checklist']||{},'ds_at_risk':a['digest']?.['ds_at_risk']||[],'design_spec_status':a['digest']?.['design_spec_status']||a['design_spec']?.['status']||'','vault_excerpt':readVaultExcerpt(a['vault_path']),'mode':a['mode']||'assess_only'};}function parseDeliberationOutput(a){const b={'grounding':[],'satisfaction_with_prior':0x0,'accepts_prior':![],'objections':[],'questions':[],'revisions':[],'verdict':'CONTEST','synthesis':''};if(!a||typeof a!=='string')return{...b,'parse_error':'empty'};const c=a['match'](/```json\s*deliberation\s*([\s\S]*?)```/i)||a['match'](/```json\s*([\s\S]*?)```/);if(c)try{const g=JSON['parse'](c[0x1]['trim']());return{'grounding':g['grounding']||[],'satisfaction_with_prior':Number(g['satisfaction_with_prior'])||0x0,'accepts_prior':!!g['accepts_prior'],'objections':Array['isArray'](g['objections'])?g['objections']:[],'questions':Array['isArray'](g['questions'])?g['questions']:[],'revisions':Array['isArray'](g['revisions'])?g['revisions']:[],'verdict':g['verdict']||'CONTEST','synthesis':g['synthesis']||''};}catch(h){return{...b,'parse_error':h['message']};}const d=a['toLowerCase'](),f=/objection|contest|disagree|not satisfied|blocking|evidence required/['test'](d);return{...b,'satisfaction_with_prior':f?0.2:0.5,'accepts_prior':!f,'verdict':f?'CONTEST':'ACCEPT','synthesis':a['slice'](0x0,0x1f4),'parse_error':'no_json_fence'};}function objectionKey(a){return((a['target_persona']||'')+':'+(a['claim']||'')['slice'](0x0,0x50))['toLowerCase']();}function computeRoundStatus(a,b,c=[]){const d=[...c],e=new Set();let f=0x0,g=0x0;const h=new Set();for(const n of a){const p=n['parsed']||{};if(p['objections']?.['length'])for(const q of p['objections']){f+=0x1;const r=objectionKey(q);if(q['blocking']&&!p['accepts_prior']){!e['has'](r)&&(e['add'](r),d['push']({...q,'raised_by':n['persona'],'round':n['round']}));if(q['target_persona'])h['add'](q['target_persona']);}}if(p['accepts_prior']&&p['satisfaction_with_prior']>=b)g+=p['objections']?.['filter'](s=>!s['blocking'])['length']||0x0;else n['persona']&&h['add'](n['persona']);}const i=d['filter'](s=>{const t=a['some'](u=>u['persona']===s['target_persona']&&u['parsed']?.['accepts_prior']&&(u['parsed']?.['satisfaction_with_prior']||0x0)>=b);if(t)g+=0x1;return!t;}),j=i['filter'](s=>s['blocking'])['length'],l=new Set(),m={};for(const s of i){const t=objectionKey(s);m[t]=(m[t]||0x0)+0x1;if(m[t]>=0x2)l['add'](t);}return{'open_objections':i,'blocking_count':j,'repeat_claims':[...l],'personas_must_rerun':[...h],'consensus_reached':j===0x0&&a['length']>0x0&&a['every'](u=>(u['parsed']?.['satisfaction_with_prior']||0x0)>=b||u['parsed']?.['accepts_prior']),'objections_raised':f,'objections_resolved':g};}function shouldEscalateToRaj(a,b,c){if(a['blocking_count']>=0x2)return!![];if(a['repeat_claims']['length']>=0x1)return!![];if(c>=(b['escalate_to_raj_after_round']||0x2)&&a['blocking_count']>=0x1)return!![];return![];}function getDeliberationGroups(a,{full_chain:b,ideation_chain:c,experts:d,mode:e}){const f=a['deliberation_groups']||{};if(c)return f['ideation']||[['meera'],['noor','anuj'],['arjun'],['zara','priya']];if(b)return f['critique']||[['arjun'],['meera','priya'],['zara']];if(e==='lite'){const h=f['lite']||[['arjun'],['meera']],i=new Set(d||[]);return h['map'](j=>j['filter'](k=>i['has'](k)))['filter'](j=>j['length']);}const g=[];for(const j of d||[])g['push']([j]);return g;}function summarizePriorOutputs(a,b,{round:round=0x0,isProduceRound:isProduceRound=![],limits:limits={}}={}){const c=isProduceRound?limits['produce']??0x4b0:round>0x0?limits['rebuttal']??0x190:limits['first']??0x320,e=[];for(const f of b){const g=a[f];if(!g?.['text'])continue;if(round>0x0&&!isProduceRound&&g['deliberation']){const h=g['deliberation'],i={'verdict':h['verdict'],'satisfaction':h['satisfaction_with_prior'],'objections':(h['objections']||[])['slice'](0x0,0x3)['map'](k=>({'target':k['target_persona'],'claim':(k['claim']||'')['slice'](0x0,0x78),'grounded_in':k['grounded_in']})),'revisions':(h['revisions']||[])['slice'](0x0,0x2)},j=g['text']['replace'](/```json\s*deliberation[\s\S]*?```/i,'')['trim']()['slice'](0x0,0xb4);e['push']('###\x20'+f+'\x0a'+JSON['stringify'](i)+'\x0a'+j+(g['text']['length']>0xb4?'…':''));continue;}e['push']('###\x20'+f+'\x0a'+g['text']['slice'](0x0,c)+(g['text']['length']>c?'…':''));}return e['join']('\x0a\x0a');}function buildObjectionPrompt({persona:a,contextPack:b,priorOutputs:c,openObjections:d,round:e,maxRounds:f,threshold:g,isProduceRound:h,task:i,routingLine:j,referenceCitations:k,coveredPointsSummary:l,limits:limits={}}){const m=Object['keys'](c||{})['filter'](r=>r!==a),n=summarizePriorOutputs(c,m,{'round':e,'isProduceRound':h,'limits':{'first':limits['prior_output_chars_first'],'rebuttal':limits['prior_output_chars_rebuttal'],'produce':limits['prior_output_chars_produce']}}),o=h?limits['context_pack_chars_produce']??0xbb8:limits['context_pack_chars_objection']??0x5dc,p=h?'PRODUCE\x20MODE\x20(final\x20round):\x20synthesize\x20your\x20full\x20output\x20after\x20deliberation.':'REVIEW\x20MODE\x20(round\x20'+e+'/'+f+'):\x20critique\x20prior\x20output\x20—\x20do\x20NOT\x20rewrite\x20full\x20wireframe/critique\x20essays.',q=[p,'Satisfaction\x20threshold:\x20'+g+'\x20—\x20default\x20accepts_prior=false\x20until\x20evidence\x20addresses\x20objections.','','Task:\x20'+i,j||'',k?'Reference\x20data:\x0a'+k:'','','Context\x20pack\x20(cite\x20these\x20in\x20grounding[]):',JSON['stringify'](b,null,0x2)['slice'](0x0,o)];return n&&q['push']('','Prior\x20persona\x20outputs\x20(read\x20critically\x20—\x20contest\x20specific\x20claims):',n),d?.['length']&&q['push']('','Open\x20objections\x20you\x20must\x20address\x20or\x20extend:',JSON['stringify'](d['slice'](0x0,0xa),null,0x2)),l&&q['push']('',l),!h?(e>0x0&&q['push']('','Rebuttal\x20round\x20'+e+'/'+f+':\x20address\x20open\x20objections\x20with\x20NEW\x20evidence.\x20Do\x20not\x20repeat\x20prior\x20paragraphs\x20verbatim.'),q['push']('','Requirements:','-\x20Every\x20objection\x20must\x20include\x20grounded_in\x20citing\x20task_map,\x20PRD,\x20UI\x20region,\x20or\x20DS\x20token.','-\x20Ask\x20at\x20least\x20one\x20contextual\x20question\x20about\x20the\x20real\x20task/UI/PRD.','-\x20Do\x20not\x20write\x20generic\x20handoff\x20paragraphs.','-\x20Do\x20NOT\x20repeat\x20points\x20already\x20covered\x20by\x20prior\x20personas.\x20If\x20you\x20agree,\x20state\x20\x22agree\x20with\x20<persona>\x20on\x20<point>\x22\x20and\x20move\x20on.','-\x20HARD\x20OUTPUT\x20CAP:\x20~'+(limits['objection_token_cap']??0x258)+'\x20tokens\x20—\x20lite\x20schema\x20+\x20deliberation\x20JSON\x20only.',DELIBERATION_JSON_HINT)):q['push']('','Produce\x20final\x20structured\x20output\x20+\x20deliberation\x20JSON\x20block.',DELIBERATION_JSON_HINT),q['filter'](Boolean)['join']('\x0a');}function buildRajPrompt(a,b,c,d){return['STALEMATE\x20—\x20arbitrate\x20unresolved\x20persona\x20disagreements\x20using\x20your\x205\x20product\x20principles.','','Context:',JSON['stringify'](a,null,0x2)['slice'](0x0,0x7d0),'','Persona\x20outputs:',summarizePriorOutputs(b,Object['keys'](b||{})),'','Open\x20objections:',JSON['stringify'](c,null,0x2),'','Round\x20log\x20summary:',JSON['stringify'](d['slice'](-0x8)['map'](e=>({'round':e['round'],'persona':e['persona'],'verdict':e['parsed']?.['verdict'],'blocking':e['parsed']?.['objections']?.['filter'](f=>f['blocking'])['length']})),null,0x2),'','Output\x20mandatory\x20Stalemate\x20Resolution\x20block\x20+\x20deliberation\x20JSON\x20with\x20verdict\x20SHIP|REVISE|BLOCK.',DELIBERATION_JSON_HINT]['join']('\x0a');}function extractScore(a){const b=a['match'](/(\d+(?:\.\d+)?)\s*\/\s*5/)||a['match'](/score[:\s]+(\d+(?:\.\d+)?)/i);return b?Number(b[0x1]):null;}async function runDeliberation(a){const {chain:b,experts:c,full_chain:d,ideation_chain:e,mode:f,task:g,routing:h,state:i,figma:j,config:k,callPersona:l,loadPersonaContext:m,buildReferencePack:n,noDeliberate:noDeliberate=![]}=a,o=loadDeliberationConfig(k),p=a['satisfaction_threshold']??o['satisfaction_threshold'],q=a['max_rounds']??o['max_rounds'];if(noDeliberate||o['default_mode']==='legacy')return runLegacySequential(a);const r=buildContextPack(i,g,j),s=getDeliberationGroups(b,{'full_chain':d,'ideation_chain':e,'experts':c,'mode':f}),t=a['resume_checkpoint']||i['host_run']?.['checkpoint']||null,u={...t?.['persona_outputs']||i['persona_outputs']||{}},v=[...t?.['round_log']||[]];let w=[...t?.['open_objections']||[]],x=t?.['round']??0x0,y=t?.['raj_escalated']??![],z=t?.['llm_calls']??0x0,A=t?.['input_tokens_est']??0x0,B=t?.['output_tokens_est']??0x0;const C=[...t?.['effort_log']||[]];let D=t?.['objections_raised']??0x0,E=t?.['objections_resolved']??0x0,F=[...t?.['covered_points']||i['covered_points']||[]];const G='Routing:\x20'+h['problem_type']+'\x20→\x20'+c['join'](',\x20'),H=t?.['group_index']??0x0,I=t?.['group_round']??0x0;for(let M=H;M<s['length'];M++){const N=s[M];let O=M===H?I:0x0;while(O<=q){const P=O===q,Q=N['filter'](T=>{if(O===0x0)return!![];const U=computeRoundStatus(v,p,w);return U['personas_must_rerun']['includes'](T)||!v['some'](V=>V['persona']===T&&V['parsed']?.['accepts_prior']);});if(!Q['length']&&O>0x0)break;const R=async T=>{const {system:U,manifest:V,effort:W,callProvider:X,callModel:Y,maxTokens:Z}=await m(T,{'isProduceRound':P,'isObjectionRound':!P,'objectionCap':o['objection_token_cap']}),a0=n?await n(T,g):null,a1=F['length']?dedup['buildCoveredPointsSummaryFromPoints'](F):'',a2=buildObjectionPrompt({'persona':T,'contextPack':r,'priorOutputs':u,'openObjections':w,'round':O,'maxRounds':q,'threshold':p,'isProduceRound':P,'task':g,'routingLine':G,'referenceCitations':a0?.['citations']?.['join']('\x0a'),'coveredPointsSummary':a1,'limits':o});let a3;try{a3=await l(T,U,a2,{'provider':X,'model':Y,'maxTokens':P?Z:Math['min'](Z,o['objection_token_cap']),'effort':W});}catch(a6){a6['name']==='HostLlmPendingError'&&(a6['checkpoint']={'group_index':M,'group_round':O,'persona_outputs':u,'round_log':v,'round':x,'open_objections':w,'raj_escalated':y,'llm_calls':z,'input_tokens_est':A,'output_tokens_est':B,'effort_log':C,'objections_raised':D,'objections_resolved':E,'covered_points':F});throw a6;}z+=0x1,A+=a3['input_tokens_est']||0x0,B+=a3['output_tokens_est']||0x0,C['push'](a3['effort_log_entry']);const a4=parseDeliberationOutput(a3['text']),a5={'round':x,'persona':T,'parsed':a4,'raw_length':a3['text']['length'],'at':new Date()['toISOString']()};v['push'](a5),u[T]={'text':a3['text'],'deliberation':a4,'at':a5['at'],'accepted':null,'full_prompt':a3['full_prompt']||null,'structured_output':a3['structured_output']||null};try{const a7=dedup['extractCoveredPoints'](a3['text'],T);a7&&a7['length']&&F['push']['apply'](F,a7);}catch{}return a5;};await Promise['all'](Q['map'](T=>R(T))),x+=0x1;const S=computeRoundStatus(v,p,w);w=S['open_objections'],D+=S['objections_raised'],E+=S['objections_resolved'];if(S['consensus_reached'])break;O+=0x1;if(O>q)break;}}const J=computeRoundStatus(v,p,w);w=J['open_objections'];if(shouldEscalateToRaj(J,o,x)&&!y){y=!![];const T=await m('raj',{'isProduceRound':!![],'isObjectionRound':![]}),U=buildRajPrompt(r,u,w,v),V=await l('raj',T['system'],U,{'provider':T['callProvider'],'model':T['callModel'],'maxTokens':T['maxTokens'],'effort':'hard'});z+=0x1,A+=V['input_tokens_est']||0x0,B+=V['output_tokens_est']||0x0;const W=parseDeliberationOutput(V['text']);v['push']({'round':x,'persona':'raj','parsed':W,'raw_length':V['text']['length'],'at':new Date()['toISOString']()}),u['raj']={'text':V['text'],'deliberation':W,'at':new Date()['toISOString'](),'accepted':null},w=[];}const K={...i['digest']?.['prior_scores']||{}};for(const [X,Y]of Object['entries'](u)){const Z=extractScore(Y['text']);if(Z!=null)K[X]=Z;}const L=computeRoundStatus(v,p,[]);return{'persona_outputs':u,'covered_points':F,'deliberation':{'round':x,'max_rounds':q,'satisfaction_threshold':p,'open_objections':L['open_objections'],'round_log':v,'consensus_reached':L['consensus_reached'],'raj_escalated':y,'mode':'adversarial'},'digest_patch':{'prior_scores':K},'metrics':{'llm_calls':z,'input_tokens_est':A,'output_tokens_est':B,'deliberation_rounds':x,'objections_raised':D,'objections_resolved':E,'raj_escalations':y?0x1:0x0,'effort_log':C}};}async function runLegacySequential(a){const {experts:b,task:c,routing:d,state:e,figma:f,callPersona:g,loadPersonaContext:h,buildReferencePack:i}=a,j={};let k=0x0,l=0x0,m=0x0;const n=[],o=buildContextPack(e,c,f),p={...e['digest']||{}};for(const q of b){const r=await h(q,{'isProduceRound':!![],'isObjectionRound':![]}),s=i?await i(q,c):null,t=summarizePriorOutputs(j,Object['keys'](j)),u=['Task:\x20'+c,f?'Figma:\x20'+f:'','Routing:\x20'+d['problem_type']+'\x20→\x20'+b['join'](',\x20'),s?'Reference\x20data:\x0a'+s['citations']['join']('\x0a'):'','Session\x20digest:\x20'+JSON['stringify'](p)['slice'](0x0,0x5dc),'Context\x20pack:\x20'+JSON['stringify'](o)['slice'](0x0,0x5dc),t?'Prior\x20persona\x20outputs:\x0a'+t:'','Produce\x20your\x20structured\x20output\x20block\x20as\x20defined\x20in\x20your\x20card/skill.']['filter'](Boolean)['join']('\x0a'),v=await g(q,r['system'],u,{'provider':r['callProvider'],'model':r['callModel'],'maxTokens':r['maxTokens'],'effort':r['effort']});k+=0x1,l+=v['input_tokens_est']||0x0,m+=v['output_tokens_est']||0x0,n['push'](v['effort_log_entry']),j[q]={'text':v['text'],'at':new Date()['toISOString'](),'accepted':null,'full_prompt':v['full_prompt']||null,'structured_output':v['structured_output']||null};const w=extractScore(v['text']);w!=null&&(p['prior_scores']={...p['prior_scores']||{},[q]:w});}return{'persona_outputs':j,'covered_points':[],'deliberation':{'round':0x0,'max_rounds':0x0,'satisfaction_threshold':0x0,'open_objections':[],'round_log':[],'consensus_reached':!![],'raj_escalated':![],'mode':'legacy'},'digest_patch':{'prior_scores':p['prior_scores']||{}},'metrics':{'llm_calls':k,'input_tokens_est':l,'output_tokens_est':m,'deliberation_rounds':0x0,'objections_raised':0x0,'objections_resolved':0x0,'raj_escalations':0x0,'effort_log':n}};}module['exports']={'loadDeliberationConfig':loadDeliberationConfig,'buildContextPack':buildContextPack,'parseDeliberationOutput':parseDeliberationOutput,'computeRoundStatus':computeRoundStatus,'shouldEscalateToRaj':shouldEscalateToRaj,'getDeliberationGroups':getDeliberationGroups,'buildObjectionPrompt':buildObjectionPrompt,'buildRajPrompt':buildRajPrompt,'runDeliberation':runDeliberation,'runLegacySequential':runLegacySequential,'DELIBERATION_JSON_HINT':DELIBERATION_JSON_HINT,'DEFAULTS':DEFAULTS};
+'use strict';
+
+/**
+ * Adversarial deliberation engine (v1.19).
+ * Personas review prior output with low default satisfaction until consensus or Raj.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const dedup = require('./dedup');
+
+const CONFIG_FILE = path.join(os.homedir(), '.analyzthis_design', 'config.json');
+
+const DEFAULTS = {
+  satisfaction_threshold: 0.4,
+  max_rounds: 3,
+  parallel_pairs: [['noor', 'anuj'], ['meera', 'priya']],
+  objection_token_cap: 600,
+  prior_output_chars_first: 800,
+  prior_output_chars_rebuttal: 400,
+  prior_output_chars_produce: 1200,
+  context_pack_chars_objection: 1500,
+  context_pack_chars_produce: 3000,
+  escalate_to_raj_after_round: 2,
+  default_mode: 'adversarial',
+};
+
+const DELIBERATION_JSON_HINT = `
+End your response with a fenced JSON block:
+\`\`\`json deliberation
+{
+  "grounding": [{"type": "task_map", "ref": "task_map[0]", "note": "..."}],
+  "satisfaction_with_prior": 0.3,
+  "accepts_prior": false,
+  "objections": [{"target_persona": "arjun", "claim": "...", "evidence_required": "...", "blocking": true, "grounded_in": "..."}],
+  "questions": ["..."],
+  "revisions": ["..."],
+  "verdict": "CONTEST"
+}
+\`\`\``;
+
+function loadDeliberationConfig(configIn) {
+  let cfg = configIn;
+  if (!cfg) {
+    try {
+      cfg = fs.existsSync(CONFIG_FILE) ? JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8')) : {};
+    } catch {
+      cfg = {};
+    }
+  }
+  const d = cfg.deliberation || {};
+  return {
+    satisfaction_threshold: d.satisfaction_threshold ?? DEFAULTS.satisfaction_threshold,
+    max_rounds: d.max_rounds ?? DEFAULTS.max_rounds,
+    parallel_pairs: d.parallel_pairs ?? DEFAULTS.parallel_pairs,
+    objection_token_cap: d.objection_token_cap ?? DEFAULTS.objection_token_cap,
+    prior_output_chars_first: d.prior_output_chars_first ?? DEFAULTS.prior_output_chars_first,
+    prior_output_chars_rebuttal: d.prior_output_chars_rebuttal ?? DEFAULTS.prior_output_chars_rebuttal,
+    prior_output_chars_produce: d.prior_output_chars_produce ?? DEFAULTS.prior_output_chars_produce,
+    context_pack_chars_objection: d.context_pack_chars_objection ?? DEFAULTS.context_pack_chars_objection,
+    context_pack_chars_produce: d.context_pack_chars_produce ?? DEFAULTS.context_pack_chars_produce,
+    escalate_to_raj_after_round: d.escalate_to_raj_after_round ?? DEFAULTS.escalate_to_raj_after_round,
+    default_mode: d.default_mode ?? DEFAULTS.default_mode,
+  };
+}
+
+function readVaultExcerpt(vaultPath, maxChars = 2000) {
+  if (!vaultPath || !fs.existsSync(vaultPath)) return '';
+  const parts = [];
+  const folders = ['PRDs', 'Brand', 'Components', 'Product'];
+  for (const folder of folders) {
+    const dir = path.join(vaultPath, folder);
+    if (!fs.existsSync(dir)) continue;
+    try {
+      for (const f of fs.readdirSync(dir).filter((n) => n.endsWith('.md')).slice(0, 2)) {
+        const text = fs.readFileSync(path.join(dir, f), 'utf8');
+        parts.push(`--- ${folder}/${f} ---\n${text.slice(0, 500)}`);
+      }
+    } catch { /* skip unreadable */ }
+    if (parts.join('').length > maxChars) break;
+  }
+  return parts.join('\n\n').slice(0, maxChars);
+}
+
+/**
+ * Build shared context pack from session state.
+ */
+function buildContextPack(state, task, figma = '') {
+  const taskMap = (state.task_map || []).slice(0, 8).map((t, i) => ({
+    id: i,
+    task: t.task,
+    frequency: t.frequency,
+    priority: t.priority,
+  }));
+
+  return {
+    task,
+    figma: figma || state.figma_node?.url || '',
+    task_map: taskMap,
+    task_map_summary: state.digest?.task_map_summary || task.slice(0, 240),
+    hierarchy_top3: state.digest?.hierarchy_top3 || state.information_hierarchy?.ranking?.slice(0, 3) || [],
+    ds_checklist: state.ds_checklist || {},
+    ds_at_risk: state.digest?.ds_at_risk || [],
+    design_spec_status: state.digest?.design_spec_status || state.design_spec?.status || '',
+    vault_excerpt: readVaultExcerpt(state.vault_path),
+    mode: state.mode || 'assess_only',
+  };
+}
+
+/**
+ * Parse deliberation JSON from persona LLM output.
+ */
+function parseDeliberationOutput(text) {
+  const empty = {
+    grounding: [],
+    satisfaction_with_prior: 0,
+    accepts_prior: false,
+    objections: [],
+    questions: [],
+    revisions: [],
+    verdict: 'CONTEST',
+    synthesis: '',
+  };
+
+  if (!text || typeof text !== 'string') return { ...empty, parse_error: 'empty' };
+
+  const fence = text.match(/```json\s*deliberation\s*([\s\S]*?)```/i)
+    || text.match(/```json\s*([\s\S]*?)```/);
+  if (fence) {
+    try {
+      const parsed = JSON.parse(fence[1].trim());
+      return {
+        grounding: parsed.grounding || [],
+        satisfaction_with_prior: Number(parsed.satisfaction_with_prior) || 0,
+        accepts_prior: !!parsed.accepts_prior,
+        objections: Array.isArray(parsed.objections) ? parsed.objections : [],
+        questions: Array.isArray(parsed.questions) ? parsed.questions : [],
+        revisions: Array.isArray(parsed.revisions) ? parsed.revisions : [],
+        verdict: parsed.verdict || 'CONTEST',
+        synthesis: parsed.synthesis || '',
+      };
+    } catch (e) {
+      return { ...empty, parse_error: e.message };
+    }
+  }
+
+  // Fallback: infer low satisfaction if output mentions objection language
+  const lower = text.toLowerCase();
+  const hasObjection = /objection|contest|disagree|not satisfied|blocking|evidence required/.test(lower);
+  return {
+    ...empty,
+    satisfaction_with_prior: hasObjection ? 0.2 : 0.5,
+    accepts_prior: !hasObjection,
+    verdict: hasObjection ? 'CONTEST' : 'ACCEPT',
+    synthesis: text.slice(0, 500),
+    parse_error: 'no_json_fence',
+  };
+}
+
+function objectionKey(obj) {
+  return `${obj.target_persona || ''}:${(obj.claim || '').slice(0, 80)}`.toLowerCase();
+}
+
+/**
+ * Compute round status from round log and threshold.
+ */
+function computeRoundStatus(roundLog, threshold, priorOpen = []) {
+  const open = [...priorOpen];
+  const seenClaims = new Set();
+  let objectionsRaised = 0;
+  let objectionsResolved = 0;
+  const personasMustRerun = new Set();
+
+  for (const entry of roundLog) {
+    const parsed = entry.parsed || {};
+    if (parsed.objections?.length) {
+      for (const obj of parsed.objections) {
+        objectionsRaised += 1;
+        const key = objectionKey(obj);
+        if (obj.blocking && !parsed.accepts_prior) {
+          if (!seenClaims.has(key)) {
+            seenClaims.add(key);
+            open.push({ ...obj, raised_by: entry.persona, round: entry.round });
+          }
+          if (obj.target_persona) personasMustRerun.add(obj.target_persona);
+        }
+      }
+    }
+    if (parsed.accepts_prior && parsed.satisfaction_with_prior >= threshold) {
+      objectionsResolved += parsed.objections?.filter((o) => !o.blocking).length || 0;
+    } else if (entry.persona) {
+      personasMustRerun.add(entry.persona);
+    }
+  }
+
+  // Remove resolved: target persona accepted in a later round
+  const filteredOpen = open.filter((obj) => {
+    const resolved = roundLog.some((e) =>
+      e.persona === obj.target_persona
+      && e.parsed?.accepts_prior
+      && (e.parsed?.satisfaction_with_prior || 0) >= threshold);
+    if (resolved) objectionsResolved += 1;
+    return !resolved;
+  });
+
+  const blockingCount = filteredOpen.filter((o) => o.blocking).length;
+  const repeatClaims = new Set();
+  const claimCounts = {};
+  for (const o of filteredOpen) {
+    const k = objectionKey(o);
+    claimCounts[k] = (claimCounts[k] || 0) + 1;
+    if (claimCounts[k] >= 2) repeatClaims.add(k);
+  }
+
+  return {
+    open_objections: filteredOpen,
+    blocking_count: blockingCount,
+    repeat_claims: [...repeatClaims],
+    personas_must_rerun: [...personasMustRerun],
+    consensus_reached: blockingCount === 0 && roundLog.length > 0
+      && roundLog.every((e) => (e.parsed?.satisfaction_with_prior || 0) >= threshold || e.parsed?.accepts_prior),
+    objections_raised: objectionsRaised,
+    objections_resolved: objectionsResolved,
+  };
+}
+
+function shouldEscalateToRaj(status, config, currentRound) {
+  if (status.blocking_count >= 2) return true;
+  if (status.repeat_claims.length >= 1) return true;
+  if (currentRound >= (config.escalate_to_raj_after_round || 2) && status.blocking_count >= 1) return true;
+  return false;
+}
+
+/**
+ * Resolve deliberation groups for this run.
+ */
+function getDeliberationGroups(chain, { full_chain, ideation_chain, experts, mode }) {
+  const groups = chain.deliberation_groups || {};
+  if (ideation_chain) return groups.ideation || [['meera'], ['noor', 'anuj'], ['arjun'], ['zara', 'priya']];
+  if (full_chain) return groups.critique || [['arjun'], ['meera', 'priya'], ['zara']];
+  if (mode === 'lite') {
+    const lite = groups.lite || [['arjun'], ['meera']];
+    const expertSet = new Set(experts || []);
+    return lite.map((g) => g.filter((p) => expertSet.has(p))).filter((g) => g.length);
+  }
+  // MoE subset: one persona per group max, preserve order
+  const result = [];
+  for (const id of experts || []) result.push([id]);
+  return result;
+}
+
+function summarizePriorOutputs(personaOutputs, personaIds, { round = 0, isProduceRound = false, limits = {} } = {}) {
+  const cap = isProduceRound
+    ? (limits.produce ?? 1200)
+    : (round > 0 ? (limits.rebuttal ?? 400) : (limits.first ?? 800));
+
+  const lines = [];
+  for (const id of personaIds) {
+    const entry = personaOutputs[id];
+    if (!entry?.text) continue;
+
+    // Rebuttal rounds: prefer parsed deliberation summary over full prose
+    if (round > 0 && !isProduceRound && entry.deliberation) {
+      const d = entry.deliberation;
+      const summary = {
+        verdict: d.verdict,
+        satisfaction: d.satisfaction_with_prior,
+        objections: (d.objections || []).slice(0, 3).map((o) => ({
+          target: o.target_persona,
+          claim: (o.claim || '').slice(0, 120),
+          grounded_in: o.grounded_in,
+        })),
+        revisions: (d.revisions || []).slice(0, 2),
+      };
+      const snippet = entry.text.replace(/```json\s*deliberation[\s\S]*?```/i, '').trim().slice(0, 180);
+      lines.push(`### ${id}\n${JSON.stringify(summary)}\n${snippet}${entry.text.length > 180 ? '…' : ''}`);
+      continue;
+    }
+
+    lines.push(`### ${id}\n${entry.text.slice(0, cap)}${entry.text.length > cap ? '…' : ''}`);
+  }
+  return lines.join('\n\n');
+}
+
+/**
+ * Build user prompt for review/objection round.
+ */
+function buildObjectionPrompt({
+  persona,
+  contextPack,
+  priorOutputs,
+  openObjections,
+  round,
+  maxRounds,
+  threshold,
+  isProduceRound,
+  task,
+  routingLine,
+  referenceCitations,
+  coveredPointsSummary,
+  limits = {},
+}) {
+  const priorIds = Object.keys(priorOutputs || {}).filter((id) => id !== persona);
+  const priorSummary = summarizePriorOutputs(priorOutputs, priorIds, {
+    round,
+    isProduceRound,
+    limits: {
+      first: limits.prior_output_chars_first,
+      rebuttal: limits.prior_output_chars_rebuttal,
+      produce: limits.prior_output_chars_produce,
+    },
+  });
+
+  const contextCap = isProduceRound
+    ? (limits.context_pack_chars_produce ?? 3000)
+    : (limits.context_pack_chars_objection ?? 1500);
+
+  const modeLine = isProduceRound
+    ? 'PRODUCE MODE (final round): synthesize your full output after deliberation.'
+    : `REVIEW MODE (round ${round}/${maxRounds}): critique prior output — do NOT rewrite full wireframe/critique essays.`;
+
+  const parts = [
+    modeLine,
+    `Satisfaction threshold: ${threshold} — default accepts_prior=false until evidence addresses objections.`,
+    '',
+    `Task: ${task}`,
+    routingLine || '',
+    referenceCitations ? `Reference data:\n${referenceCitations}` : '',
+    '',
+    'Context pack (cite these in grounding[]):',
+    JSON.stringify(contextPack, null, 2).slice(0, contextCap),
+  ];
+
+  if (priorSummary) {
+    parts.push('', 'Prior persona outputs (read critically — contest specific claims):', priorSummary);
+  }
+
+  if (openObjections?.length) {
+    parts.push('', 'Open objections you must address or extend:', JSON.stringify(openObjections.slice(0, 10), null, 2));
+  }
+
+  if (coveredPointsSummary) {
+    parts.push('', coveredPointsSummary);
+  }
+
+  if (!isProduceRound) {
+    if (round > 0) {
+      parts.push('', `Rebuttal round ${round}/${maxRounds}: address open objections with NEW evidence. Do not repeat prior paragraphs verbatim.`);
+    }
+    parts.push('', 'Requirements:',
+      '- Every objection must include grounded_in citing task_map, PRD, UI region, or DS token.',
+      '- Ask at least one contextual question about the real task/UI/PRD.',
+      '- Do not write generic handoff paragraphs.',
+      '- Do NOT repeat points already covered by prior personas. If you agree, state "agree with <persona> on <point>" and move on.',
+      `- HARD OUTPUT CAP: ~${limits.objection_token_cap ?? 600} tokens — lite schema + deliberation JSON only.`,
+      DELIBERATION_JSON_HINT);
+  } else {
+    parts.push('', 'Produce final structured output + deliberation JSON block.', DELIBERATION_JSON_HINT);
+  }
+
+  return parts.filter(Boolean).join('\n');
+}
+
+function buildRajPrompt(contextPack, personaOutputs, openObjections, roundLog) {
+  return [
+    'STALEMATE — arbitrate unresolved persona disagreements using your 5 product principles.',
+    '',
+    'Context:', JSON.stringify(contextPack, null, 2).slice(0, 2000),
+    '',
+    'Persona outputs:', summarizePriorOutputs(personaOutputs, Object.keys(personaOutputs || {})),
+    '',
+    'Open objections:', JSON.stringify(openObjections, null, 2),
+    '',
+    'Round log summary:', JSON.stringify(roundLog.slice(-8).map((r) => ({
+      round: r.round, persona: r.persona, verdict: r.parsed?.verdict, blocking: r.parsed?.objections?.filter((o) => o.blocking).length,
+    })), null, 2),
+    '',
+    'Output mandatory Stalemate Resolution block + deliberation JSON with verdict SHIP|REVISE|BLOCK.',
+    DELIBERATION_JSON_HINT,
+  ].join('\n');
+}
+
+/**
+ * Extract score from persona text for digest.prior_scores.
+ */
+function extractScore(text) {
+  const m = text.match(/(\d+(?:\.\d+)?)\s*\/\s*5/) || text.match(/score[:\s]+(\d+(?:\.\d+)?)/i);
+  return m ? Number(m[1]) : null;
+}
+
+/**
+ * Run full adversarial deliberation loop.
+ * @param {object} opts
+ * @param {function} opts.callPersona — async (personaId, system, user, opts) => { text, tokens... }
+ */
+async function runDeliberation(opts) {
+  const {
+    chain,
+    experts,
+    full_chain,
+    ideation_chain,
+    mode,
+    task,
+    routing,
+    state,
+    figma,
+    config,
+    callPersona,
+    loadPersonaContext,
+    buildReferencePack,
+    noDeliberate = false,
+  } = opts;
+
+  const dConfig = loadDeliberationConfig(config);
+  const threshold = opts.satisfaction_threshold ?? dConfig.satisfaction_threshold;
+  const maxRounds = opts.max_rounds ?? dConfig.max_rounds;
+
+  if (noDeliberate || dConfig.default_mode === 'legacy') {
+    return runLegacySequential(opts);
+  }
+
+  const contextPack = buildContextPack(state, task, figma);
+  const groups = getDeliberationGroups(chain, { full_chain, ideation_chain, experts, mode });
+  const checkpoint = opts.resume_checkpoint || state.host_run?.checkpoint || null;
+
+  const persona_outputs = { ...(checkpoint?.persona_outputs || state.persona_outputs || {}) };
+  const round_log = [...(checkpoint?.round_log || [])];
+  let open_objections = [...(checkpoint?.open_objections || [])];
+  let round = checkpoint?.round ?? 0;
+  let raj_escalated = checkpoint?.raj_escalated ?? false;
+  let llm_calls = checkpoint?.llm_calls ?? 0;
+  let input_tokens_est = checkpoint?.input_tokens_est ?? 0;
+  let output_tokens_est = checkpoint?.output_tokens_est ?? 0;
+  const effort_log = [...(checkpoint?.effort_log || [])];
+  let objections_raised = checkpoint?.objections_raised ?? 0;
+  let objections_resolved = checkpoint?.objections_resolved ?? 0;
+  let coveredPointsAccumulator = [...(checkpoint?.covered_points || state.covered_points || [])];
+
+  const routingLine = `Routing: ${routing.problem_type} → ${experts.join(', ')}`;
+  const startGroupIndex = checkpoint?.group_index ?? 0;
+  const startGroupRound = checkpoint?.group_round ?? 0;
+
+  // Execute deliberation groups — Raj runs AFTER all groups (never before Zara)
+  for (let groupIndex = startGroupIndex; groupIndex < groups.length; groupIndex++) {
+    const group = groups[groupIndex];
+    let groupRound = groupIndex === startGroupIndex ? startGroupRound : 0;
+    while (groupRound <= maxRounds) {
+      const isProduceRound = groupRound === maxRounds;
+      const personasToRun = group.filter((id) => {
+        if (groupRound === 0) return true;
+        const status = computeRoundStatus(round_log, threshold, open_objections);
+        return status.personas_must_rerun.includes(id) || !round_log.some((e) => e.persona === id && e.parsed?.accepts_prior);
+      });
+
+      if (!personasToRun.length && groupRound > 0) break;
+
+      const runOne = async (personaId) => {
+        const { system, manifest, effort, callProvider, callModel, maxTokens } =
+          await loadPersonaContext(personaId, {
+            isProduceRound,
+            isObjectionRound: !isProduceRound,
+            objectionCap: dConfig.objection_token_cap,
+          });
+
+        const referencePack = buildReferencePack ? await buildReferencePack(personaId, task) : null;
+
+        const coveredSummary = coveredPointsAccumulator.length
+          ? dedup.buildCoveredPointsSummaryFromPoints(coveredPointsAccumulator)
+          : '';
+
+        const user = buildObjectionPrompt({
+          persona: personaId,
+          contextPack,
+          priorOutputs: persona_outputs,
+          openObjections: open_objections,
+          round: groupRound,
+          maxRounds,
+          threshold,
+          isProduceRound,
+          task,
+          routingLine,
+          referenceCitations: referencePack?.citations?.join('\n'),
+          coveredPointsSummary: coveredSummary,
+          limits: dConfig,
+        });
+
+        let result;
+        try {
+          result = await callPersona(personaId, system, user, {
+            provider: callProvider,
+            model: callModel,
+            maxTokens: isProduceRound ? maxTokens : Math.min(maxTokens, dConfig.objection_token_cap),
+            effort,
+          });
+        } catch (err) {
+          if (err.name === 'HostLlmPendingError') {
+            err.checkpoint = {
+              group_index: groupIndex,
+              group_round: groupRound,
+              persona_outputs,
+              round_log,
+              round,
+              open_objections,
+              raj_escalated,
+              llm_calls,
+              input_tokens_est,
+              output_tokens_est,
+              effort_log,
+              objections_raised,
+              objections_resolved,
+              covered_points: coveredPointsAccumulator,
+            };
+          }
+          throw err;
+        }
+
+        llm_calls += 1;
+        input_tokens_est += result.input_tokens_est || 0;
+        output_tokens_est += result.output_tokens_est || 0;
+        effort_log.push(result.effort_log_entry);
+
+        const parsed = parseDeliberationOutput(result.text);
+        const entry = {
+          round: round,
+          persona: personaId,
+          parsed,
+          raw_length: result.text.length,
+          at: new Date().toISOString(),
+        };
+        round_log.push(entry);
+
+        persona_outputs[personaId] = {
+          text: result.text,
+          deliberation: parsed,
+          at: entry.at,
+          accepted: null,
+          full_prompt: result.full_prompt || null,
+          structured_output: result.structured_output || null,
+        };
+
+        try {
+          const covered = dedup.extractCoveredPoints(result.text, personaId);
+          if (covered && covered.length) {
+            coveredPointsAccumulator.push.apply(coveredPointsAccumulator, covered);
+          }
+        } catch {
+          // dedup unavailable — continue
+        }
+
+        return entry;
+      };
+
+      await Promise.all(personasToRun.map((id) => runOne(id)));
+
+      round += 1;
+      const status = computeRoundStatus(round_log, threshold, open_objections);
+      open_objections = status.open_objections;
+      objections_raised += status.objections_raised;
+      objections_resolved += status.objections_resolved;
+
+      if (status.consensus_reached) break;
+
+      groupRound += 1;
+      if (groupRound > maxRounds) break;
+    }
+  }
+
+  // Raj escalation after ALL deliberation groups (critique: Zara always runs before Raj)
+  const preRajStatus = computeRoundStatus(round_log, threshold, open_objections);
+  open_objections = preRajStatus.open_objections;
+  if (shouldEscalateToRaj(preRajStatus, dConfig, round) && !raj_escalated) {
+    raj_escalated = true;
+    const rajCtx = await loadPersonaContext('raj', { isProduceRound: true, isObjectionRound: false });
+    const rajUser = buildRajPrompt(contextPack, persona_outputs, open_objections, round_log);
+    const rajResult = await callPersona('raj', rajCtx.system, rajUser, {
+      provider: rajCtx.callProvider,
+      model: rajCtx.callModel,
+      maxTokens: rajCtx.maxTokens,
+      effort: 'hard',
+    });
+    llm_calls += 1;
+    input_tokens_est += rajResult.input_tokens_est || 0;
+    output_tokens_est += rajResult.output_tokens_est || 0;
+    const rajParsed = parseDeliberationOutput(rajResult.text);
+    round_log.push({ round, persona: 'raj', parsed: rajParsed, raw_length: rajResult.text.length, at: new Date().toISOString() });
+    persona_outputs.raj = { text: rajResult.text, deliberation: rajParsed, at: new Date().toISOString(), accepted: null };
+    open_objections = [];
+  }
+
+  const prior_scores = { ...(state.digest?.prior_scores || {}) };
+  for (const [id, out] of Object.entries(persona_outputs)) {
+    const score = extractScore(out.text);
+    if (score != null) prior_scores[id] = score;
+  }
+
+  const finalStatus = computeRoundStatus(round_log, threshold, []);
+
+  return {
+    persona_outputs,
+    covered_points: coveredPointsAccumulator,
+    deliberation: {
+      round,
+      max_rounds: maxRounds,
+      satisfaction_threshold: threshold,
+      open_objections: finalStatus.open_objections,
+      round_log,
+      consensus_reached: finalStatus.consensus_reached,
+      raj_escalated,
+      mode: 'adversarial',
+    },
+    digest_patch: { prior_scores },
+    metrics: {
+      llm_calls,
+      input_tokens_est,
+      output_tokens_est,
+      deliberation_rounds: round,
+      objections_raised,
+      objections_resolved,
+      raj_escalations: raj_escalated ? 1 : 0,
+      effort_log,
+    },
+  };
+}
+
+/** Legacy sequential pass-the-parcel ( --no-deliberate ) */
+async function runLegacySequential(opts) {
+  const {
+    experts, task, routing, state, figma, callPersona, loadPersonaContext, buildReferencePack,
+  } = opts;
+
+  const persona_outputs = {};
+  let llm_calls = 0;
+  let input_tokens_est = 0;
+  let output_tokens_est = 0;
+  const effort_log = [];
+  const contextPack = buildContextPack(state, task, figma);
+  const digest = { ...(state.digest || {}) };
+
+  for (const id of experts) {
+    const ctx = await loadPersonaContext(id, { isProduceRound: true, isObjectionRound: false });
+    const referencePack = buildReferencePack ? await buildReferencePack(id, task) : null;
+    const priorSummary = summarizePriorOutputs(persona_outputs, Object.keys(persona_outputs));
+
+    const user = [
+      `Task: ${task}`,
+      figma ? `Figma: ${figma}` : '',
+      `Routing: ${routing.problem_type} → ${experts.join(', ')}`,
+      referencePack ? `Reference data:\n${referencePack.citations.join('\n')}` : '',
+      `Session digest: ${JSON.stringify(digest).slice(0, 1500)}`,
+      `Context pack: ${JSON.stringify(contextPack).slice(0, 1500)}`,
+      priorSummary ? `Prior persona outputs:\n${priorSummary}` : '',
+      'Produce your structured output block as defined in your card/skill.',
+    ].filter(Boolean).join('\n');
+
+    const result = await callPersona(id, ctx.system, user, {
+      provider: ctx.callProvider,
+      model: ctx.callModel,
+      maxTokens: ctx.maxTokens,
+      effort: ctx.effort,
+    });
+
+    llm_calls += 1;
+    input_tokens_est += result.input_tokens_est || 0;
+    output_tokens_est += result.output_tokens_est || 0;
+    effort_log.push(result.effort_log_entry);
+    persona_outputs[id] = {
+      text: result.text,
+      at: new Date().toISOString(),
+      accepted: null,
+      full_prompt: result.full_prompt || null,
+      structured_output: result.structured_output || null,
+    };
+
+    const score = extractScore(result.text);
+    if (score != null) {
+      digest.prior_scores = { ...(digest.prior_scores || {}), [id]: score };
+    }
+  }
+
+  return {
+    persona_outputs,
+    covered_points: [],
+    deliberation: {
+      round: 0,
+      max_rounds: 0,
+      satisfaction_threshold: 0,
+      open_objections: [],
+      round_log: [],
+      consensus_reached: true,
+      raj_escalated: false,
+      mode: 'legacy',
+    },
+    digest_patch: { prior_scores: digest.prior_scores || {} },
+    metrics: {
+      llm_calls,
+      input_tokens_est,
+      output_tokens_est,
+      deliberation_rounds: 0,
+      objections_raised: 0,
+      objections_resolved: 0,
+      raj_escalations: 0,
+      effort_log,
+    },
+  };
+}
+
+module.exports = {
+  loadDeliberationConfig,
+  buildContextPack,
+  parseDeliberationOutput,
+  computeRoundStatus,
+  shouldEscalateToRaj,
+  getDeliberationGroups,
+  buildObjectionPrompt,
+  buildRajPrompt,
+  runDeliberation,
+  runLegacySequential,
+  DELIBERATION_JSON_HINT,
+  DEFAULTS,
+};