analyzthis_design 1.18.0 → 1.20.0

package/README.md

@@ -2,9 +2,9 @@
 
 A set of AI design personas and a task-first evaluation framework that plugs into Cursor, Claude Code, and Codex CLI as slash commands — plus an agentic MoE router with shared session state so you can call the same graph from any IDE or from the CLI.
 
-Install once. Run structured UX critiques, multi-phase ideation, and task-grounded screen reviews — directly inside your AI chat.
+Install once. Run structured UX critiques, multi-phase ideation, and task-grounded screen reviews — directly inside your AI chat. **No external LLM API keys required** for CLI orchestrator runs: **`/devi`** voices each persona from your host IDE (Cursor, Claude, etc.).
 
-**npm:** [analyzthis_design](https://www.npmjs.com/package/analyzthis_design)
+**npm:** [analyzthis_design](https://www.npmjs.com/package/analyzthis_design) · **Current version:** 1.20.0
 
 ---
 
@@ -66,8 +66,9 @@ All skills use the **Agent Skills** `SKILL.md` standard — same files work acro
 | `/persona-orchestrator` | **Agentic critique entry point** (not for wireframes). MoE router + session state, ux-story-gate intake, persona chain, DS / hierarchy / verify gates → SHIP/REVISE/BLOCK |
 | `/ux-story-gate` | Task-first gate: PRDs, DS/Figma discovery, MoE routing, browser verify, assess-only mode |
 | `/design-critic` | 4-persona critique → Composite Score + Information Hierarchy Gate |
+| `/deliberation-protocol` | Adversarial review rules — grounding, objection JSON, parallel pairs, Raj escalation |
 
-### 8 Personas
+### 9 Personas (+ host runtime)
 
 Invoke critique personas for targeted, already-grounded questions. For **wireframes**, use `/ux-ideator`, `/noor`, or `/anuj`. For full screen **critique**, prefer `/persona-orchestrator` or `/ux-story-gate`. Run **`/kavi`** first so they have project context.
 
@@ -81,6 +82,7 @@ Invoke critique personas for targeted, already-grounded questions. For **wirefra
 | `/noor` | IA Architect | Minimalist Concept A + declared ranked information hierarchy |
 | `/anuj` | Power-User Advocate | Dense Concept B — bulk actions, keyboard shortcuts, hierarchy kept prominent |
 | `/raj` | Arbitrator | Resolves persona stalemates using 5 ranked product principles. Never speaks first. |
+| `/devi` | Host LLM runtime | Voices other personas when CLI `run` uses host mode (no API keys). Reads pending prompts → writes responses → `--continue` resumes |
 
 ### Supporting skills
 
@@ -89,10 +91,11 @@ Invoke critique personas for targeted, already-grounded questions. For **wirefra
 | `/design-personas` | Session context template — fill in once before a session |
 | `/knowledge-bank` | Auto-populated from your connected vault (or from Kavi collect). All personas read this first. |
 | `/design-reference` | CSV reference data (colors, typography, UX guidelines, stacks, …) |
+| `/collect-knowledge` | Alias for `/kavi` |
 
 ---
 
-## Agentic system (v1.15)
+## Agentic system (v1.20)
 
 ```
 User ask / Figma URL
@@ -101,14 +104,112 @@ User ask / Figma URL
         ↓
   ux-story-gate Phases 0–1.5 (PRD + DS/Figma + MoE router)
         ↓
-  MoE subset (default, 1–2 experts) OR design-critic / ideation chain (explicit "full")
+  Adversarial deliberation (parallel objection rounds, low satisfaction default)
         ↓
-  Hard gates: DS tokens → Information Hierarchy → Browser verify (skipped if assess_only + no URL)
+  MoE subset (default) OR full chain (explicit "full")
         ↓
-  Session state + cost metrics persisted  →  SHIP / REVISE / BLOCK
+  Zara (delight) → Raj on stalemate (after all groups — never before Zara)
+        ↓
+  Phase 5 synthesis (composite score + hierarchy gate + top 3)
+        ↓
+  Hard gates: DS → Hierarchy → Verify
+        ↓
+  SHIP / REVISE / BLOCK
+```
+
+### Devi — host LLM (no API keys) · v1.20
+
+When no `OPENAI_API_KEY` / `ANTHROPIC_API_KEY` / `GEMINI_API_KEY` / `ZAI_API_KEY` is set, **`run` defaults to `provider: host`**. The orchestrator writes each persona step as a prompt file; **`/devi`** (or your host IDE agent) embodies that persona and writes the response back. No paid API calls.
+
+```bash
+# 1. Start run — pauses at first persona with prompt path
+npx analyzthis_design run --task "Review invoice approval screen" --full
+
+# 2. In Cursor / Claude: invoke /devi
+#    (reads pending/*.json, writes responses/*.md in persona voice)
+
+# 3. Check queue + continue
+npx analyzthis_design devi status
+npx analyzthis_design run --continue --task "Review invoice approval screen" --full
+```
+
+**Prompt queue layout:**
+
+```
+~/.analyzthis_design/runs/{project-id}/{run-id}/
+  pending/001-arjun.json    ← orchestrator writes
+  responses/001-arjun.md    ← Devi / host IDE writes
+  manifest.json
 ```
 
-**Shared session state** lives at `~/.analyzthis_design/sessions/{project-id}/session-state.json` so Ask→Agent turns do not re-derive the task map, DS checklist, or routing decision.
+**Submit a response manually:**
+
+```bash
+npx analyzthis_design devi respond \
+  --run ~/.analyzthis_design/runs/{project-id}/{run-id} \
+  --step 001-arjun \
+  --file my-arjun-response.md
+```
+
+**Override host mode** when you have API keys:
+
+```bash
+export ANTHROPIC_API_KEY=sk-...
+npx analyzthis_design run --task "..." --provider anthropic
+```
+
+Skill: `/devi` · Implementation: `lib/host-llm.js`, `lib/provider.js`
+
+### Phase 5 synthesis · v1.20
+
+After deliberation closes, the orchestrator builds a **composite synthesis** automatically:
+
+- Per-persona scores (Arjun, Meera, Priya, Zara)
+- **Verdict:** SHIP / REVISE / BLOCK
+- **Top 3 actionable changes** (ranked)
+- **Information Hierarchy Gate** (Arjun visual hierarchy + Meera hierarchy check)
+
+Stored in session as `synthesis` (JSON) and `synthesis_markdown` (display block). Printed at end of every completed `run`.
+
+### Adversarial deliberation (v1.19+)
+
+Personas **debate** grounded in real task_map, PRD, and UI context — they do not pass generic handoff documents.
+
+| Knob | Default | Meaning |
+|------|---------|---------|
+| `satisfaction_threshold` | 0.4 | Personas hard to please — must see evidence before `accepts_prior: true` |
+| `max_rounds` | 3 | Cap on objection rounds (token-bounded) |
+| `parallel_pairs` | Noor∥Anuj, Meera∥Priya | Adversarial critique in parallel |
+
+```bash
+npx analyzthis_design run --task "Review onboarding" --full --dry-run   # see deliberation groups
+npx analyzthis_design run --task "..." --satisfaction 0.3               # even harder to satisfy
+npx analyzthis_design run --task "..." --no-deliberate                  # legacy sequential mode
+npx analyzthis_design metrics                                           # deliberation_rounds, objections
+```
+
+Config: `~/.analyzthis_design/config.json` → `deliberation` block (see `supabase/deliberation-config.example.json`).
+
+Skill: `/deliberation-protocol` | Schema: `agents/deliberation-schema.json`
+
+**Low satisfaction ≠ unlimited tokens.** Objection rounds use lite schema + 600-token cap; synthesis and Raj use full produce mode.
+
+**Raj order (v1.20):** Raj escalates **after all deliberation groups** complete — Zara always runs before Raj in the critique chain.
+
+---
+
+**Shared session state** lives at `~/.analyzthis_design/sessions/{project-id}/session-state.json`.
+
+Key fields after a run:
+
+| Field | Contents |
+|---|---|
+| `persona_outputs` | Each persona's text + parsed deliberation JSON |
+| `deliberation` | `round_log`, `open_objections`, `consensus_reached`, `raj_escalated` |
+| `synthesis` | Composite scores, verdict, top 3, hierarchy gate |
+| `synthesis_markdown` | Phase 5 block for display / export |
+| `host_run` | Host-mode checkpoint when paused for Devi (`run_dir`, `checkpoint`) |
+| `metrics` | `llm_calls`, `deliberation_rounds`, `objections_raised`, token estimates |
 
 ```bash
 npx analyzthis_design session init
@@ -129,18 +230,29 @@ agents/
 **Standalone runtime (v2):**
 
 ```bash
-# Print routing only (no API calls)
+# Print routing + deliberation groups (no LLM calls)
 npx analyzthis_design run --task "Fix contrast on landing page" --dry-run
 
-# Call Anthropic / OpenAI per persona step (MoE subset, lite schema — the default)
+# Host mode (default when no API keys) — Devi voices personas
+npx analyzthis_design run --task "Review invoice screen" --full
+npx analyzthis_design devi status
+npx analyzthis_design run --continue --task "Review invoice screen" --full
+
+# External API providers (optional)
 export ANTHROPIC_API_KEY=sk-...
 npx analyzthis_design run --task "Review this screen" --figma https://figma.com/... --provider anthropic
 
-# Force the full design-critic chain, or bypass the router entirely
+# Force full chain, bypass router, tune deliberation
 npx analyzthis_design run --task "Full critique of onboarding" --full
 npx analyzthis_design run --task "Just check spacing" --experts arjun
+npx analyzthis_design run --task "..." --max-rounds 2 --satisfaction 0.5
+npx analyzthis_design run --task "..." --no-deliberate   # legacy sequential handoff
 ```
 
+**Provider resolution order:** explicit `--provider` → config → first available API key → **`host`** (Devi).
+
+Supported providers: `host` | `anthropic` | `openai` | `google` | `zai`
+
 Provider defaults live in `~/.analyzthis_design/config.json`:
 
 ```json
@@ -209,7 +321,7 @@ flowchart TB
     Router -->|effort| Resolve[resolveModel persona effort]
     Resolve -->|gate? hard override| Matrix[effort_matrix in chain.json]
     Resolve -->|persona| Overrides[manifest.effort_overrides]
-    Matrix --> Call[callLlm provider model maxTokens]
+    Matrix --> Call[callLlm host or API provider]
     Overrides --> Call
     Call --> Metrics[metrics.effort_log + cost_usd]
     Metrics --> CostCmd[npx analyzthis_design cost]
@@ -226,9 +338,9 @@ Classifier rules (first match wins, safety rules before savings rules):
 **Gates never downgrade.** `ds_gate`, `information_hierarchy_gate`, and `verify_gate` are pinned to `hard` via `chain.gate_override` regardless of the classified effort — they're the safety net that makes downgrading persona work safe.
 
 Default effort matrix (in `agents/chain.json`):
-- trivial → `glm-4.5-flash` (free) or Gemini Flash-Lite, ~500-token cap
-- standard → `gemini-2.5-flash` or `gpt-4o-mini`, ~1200-token cap
-- hard → `claude-sonnet-5` or `gpt-5`, ~1800-token cap
+- **trivial** → `host` / Devi (~600-token cap for objection rounds) — or API model when keys set
+- **standard** → `gemini-2.5-flash` or `gpt-4o-mini`, ~1200-token cap
+- **hard** → `claude-sonnet-5` or `gpt-5`, ~1800-token cap
 
 Per-persona `effort_overrides` in each manifest refine this (e.g. Arjun's `trivial` is the color-system-only scoped mode at 700 tokens; his `hard` is the full Honeycomb + Visual Audit at 1800).
 
@@ -520,8 +632,14 @@ npx analyzthis_design research --query <text>
 npx analyzthis_design retrieve --file <csv> --column <col> --keywords a,b [--limit N]
 
 # Standalone orchestrator
-npx analyzthis_design run --task "..." [--figma URL] [--provider anthropic|openai|google|zai] [--dry-run] [--output path]
+npx analyzthis_design run --task "..." [--figma URL] [--provider host|anthropic|openai|google|zai] [--dry-run] [--output path]
 npx analyzthis_design run --task "..." [--lite | --full] [--experts a,b]
+npx analyzthis_design run --task "..." [--deliberate | --no-deliberate] [--max-rounds N] [--satisfaction 0.4]
+npx analyzthis_design run --continue --task "..."   # resume host-mode run after /devi
+
+# Devi — host LLM queue (v1.20)
+npx analyzthis_design devi status [--run path]
+npx analyzthis_design devi respond --run <run-dir> --step 001-arjun --file response.md
 
 # Efficiency / cost
 npx analyzthis_design metrics [--project id] [--all]
@@ -551,13 +669,23 @@ lib/
   export.js             LoRA training-pair export hook
   feedback.js           Persona unhappiness + correction logging (session + global JSONL)
   feedback-submit.js    Opt-in anonymized submit to Supabase (community feedback)
+  deliberation.js       Adversarial satisfaction loops, context pack, Raj escalation
+  host-llm.js           Devi bridge — pending/response queue, checkpoint on pause
+  provider.js           Auto-detect API keys or default to host
+  synthesis.js          Phase 5 composite score + hierarchy gate + top 3
   cost.js               $-cost report from metrics × config.pricing
-  orchestrator/run.js   Standalone LLM runtime (v2) — MoE, effort-graded tiers, caps, cache-aware
+  orchestrator/run.js   Standalone runtime (v2) — MoE, host/API providers, synthesis
+scripts/
+  run-live-quality.js   Host-mode quality test (fixtures through real engine)
+  quality-check.js      Validate persona outputs vs skill + deliberation protocol
+  demo-fictional-deliberation.js  Dry-run walkthrough for FlowPay scenario
 scripts/obfuscate.js    Build step → dist/
 skills/
+  devi/                 Host LLM runtime — voices personas from pending prompts
   kavi/                 Kavi — Knowledge Archivist (/kavi)
   collect-knowledge/    Alias for Kavi (backward compatible)
   persona-orchestrator/ Agentic critique entry point
+  deliberation-protocol/ Adversarial review rules (v1.19+)
   ux-story-gate/        Task-first gate + DS/MoE/verify/assess phases
   design-critic/        4-persona critique + hierarchy gate
   ux-ideator/           6-phase ideation
@@ -571,7 +699,21 @@ skills/
 
 - Node.js 16+
 - Any Agent Skills–compatible host: [Cursor](https://cursor.com), [Claude Code](https://code.claude.com), Codex CLI, [Grok Build](https://x.ai), or Windsurf Cascade
-- For `run` / `collect` enrichment: `ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, `GEMINI_API_KEY`, or `ZAI_API_KEY`
+- **CLI `run`:** works without API keys via **`/devi`** host mode (default). Optional keys for automated API runs: `ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, `GEMINI_API_KEY`, `ZAI_API_KEY`
+- **Kavi `collect` enrichment:** optional — same keys as above; without keys, draft vault + sync still run
+
+---
+
+## What's new in v1.20
+
+| Feature | Description |
+|---------|-------------|
+| **`/devi` host LLM** | No API keys needed — orchestrator writes prompts, host IDE voices personas |
+| **`run --continue`** | Resume after Devi fills `responses/*.md` |
+| **Phase 5 synthesis** | Auto composite score, verdict, top 3, hierarchy gate in session |
+| **Raj ordering fix** | Zara always runs before Raj; Raj escalates after all groups |
+| **Rebuttal rounds** | Prompts require new evidence — no verbatim repeat on objection re-runs |
+| **`devi status` / `devi respond`** | CLI helpers for the prompt queue |
 
 ---
 

package/agents/cards/anuj.md

@@ -20,3 +20,9 @@ Top fix: [one line]
 Full Concept B text wireframe (hierarchy check, primary action, nav level, visible-on-load at full density, keyboard shortcuts, progressive disclosure, rationale) — see `skills/anuj/SKILL.md` "Output — Concept B". Use deep mode for ideation runs or full/deep critiques.
 
 **Citation:** `[filename, row N: "exact quoted value"]` — e.g. `[ux-guidelines.csv, row 22: "..."]`. Only run this persona when task Frequency = daily/weekly.
+
+## Deliberation modes (v1.19)
+
+**Review mode (rounds 0–N-1):** Critique prior output with grounded objections. Default `accepts_prior: false`. Include deliberation JSON block.
+
+**Produce mode (final round):** Full output schema after consensus or Raj. See `skills/deliberation-protocol/SKILL.md`.

package/agents/cards/arjun.md

@@ -21,3 +21,9 @@ Combined score: [X/5]
 Full UX Critique + Visual Design Audit blocks with per-dimension reasons — see `skills/arjun/SKILL.md` "Output format". Use deep mode when the user asks for a full/deep critique, any dimension scores C or below and needs the full rubric quoted, or `default_chain` is running.
 
 **Citation:** `[filename, row N: "exact quoted value"]`. Consult `skills/arjun/SKILL.md` Grade Rubric tables when scoring C or below and rubric detail is needed.
+
+## Deliberation modes (v1.19)
+
+**Review mode (rounds 0–N-1):** Critique prior output with grounded objections. Default `accepts_prior: false`. Include deliberation JSON block.
+
+**Produce mode (final round):** Full output schema after consensus or Raj. See `skills/deliberation-protocol/SKILL.md`.

package/agents/cards/devi.md

@@ -0,0 +1,15 @@
+# Devi — Host LLM runtime (card)
+
+Meta-agent that **voices** other personas when the orchestrator runs in `host` mode (no external API keys).
+
+**Allowed:** read pending orchestrator prompts; embody any persona skill/card; write response files; batch-process a run directory; resume orchestrator via `--continue`.
+
+**Forbidden:** produce final code edits; skip deliberation JSON; speak as Devi in persona output (always write as the target persona).
+
+## Quick flow
+
+```
+run --task "..."  →  pending/001-arjun.json  →  /devi  →  responses/001-arjun.md  →  run --continue
+```
+
+See `skills/devi/SKILL.md` for the full protocol.

package/agents/cards/meera.md

@@ -19,3 +19,9 @@ Score: [1-5]
 Full Business Impact block (metric impact, hierarchy check, segment, GTM lever, retention hook, adoption risk, verdict) — see `skills/meera/SKILL.md` "Output format". Use deep mode for full/deep critiques or when `default_chain` is running.
 
 **Citation:** `[filename, row N: "exact quoted value"]` — e.g. `[products.csv, row 6: "..."]`. Consult `skills/meera/SKILL.md` for the full reference-data table when a specific product-type match is needed.
+
+## Deliberation modes (v1.19)
+
+**Review mode (rounds 0–N-1):** Critique prior output with grounded objections. Default `accepts_prior: false`. Include deliberation JSON block.
+
+**Produce mode (final round):** Full output schema after consensus or Raj. See `skills/deliberation-protocol/SKILL.md`.

package/agents/cards/noor.md

@@ -20,3 +20,9 @@ Rationale: [one line, Hick's Law / progressive disclosure]
 Full Concept A text wireframe (hierarchy, primary action, nav level, visible-on-load, progressive disclosure, nav path, rationale) — see `skills/noor/SKILL.md` "Output — Concept A". Use deep mode for ideation runs or full/deep critiques.
 
 **Citation:** `[filename, row N: "exact quoted value"]` — e.g. `[stacks/shadcn.csv, row 8: "..."]`. Consult `skills/noor/SKILL.md` when naming specific components.
+
+## Deliberation modes (v1.19)
+
+**Review mode (rounds 0–N-1):** Critique prior output with grounded objections. Default `accepts_prior: false`. Include deliberation JSON block.
+
+**Produce mode (final round):** Full output schema after consensus or Raj. See `skills/deliberation-protocol/SKILL.md`.

package/agents/cards/priya.md

@@ -19,3 +19,9 @@ Score: [1-5]
 Full Feasibility Analysis block (score, blockers, ranked risks, effort, simpler alternative) — see `skills/priya/SKILL.md` "Output format". Use deep mode for full/deep critiques or when `default_chain` is running.
 
 **Citation:** `[filename, row N: "exact quoted value"]` — e.g. `[stacks/nextjs.csv, row 12: "..."]`. Consult `skills/priya/SKILL.md` for the stack-file table matching the session's tech stack.
+
+## Deliberation modes (v1.19)
+
+**Review mode (rounds 0–N-1):** Critique prior output with grounded objections. Default `accepts_prior: false`. Include deliberation JSON block.
+
+**Produce mode (final round):** Full output schema after consensus or Raj. See `skills/deliberation-protocol/SKILL.md`.

package/agents/cards/raj.md

@@ -21,3 +21,9 @@ What [losing agent] gives up: [named]
 ```
 
 **Citation:** `[filename, row N: "exact quoted value"]`. Consult `skills/raj/SKILL.md` for the ranked product-principles list (Owner governs, Data honesty, Intentionality over automation, Persona density split, PRD scope boundary) and their worked examples before deciding.
+
+## Deliberation modes (v1.19)
+
+**Review mode (rounds 0–N-1):** Critique prior output with grounded objections. Default `accepts_prior: false`. Include deliberation JSON block.
+
+**Produce mode (final round):** Full output schema after consensus or Raj. See `skills/deliberation-protocol/SKILL.md`.

package/agents/cards/zara.md

@@ -22,3 +22,9 @@ If high-frequency working surface: output only "no delight needed here — speed
 Full Delight Pass block (surface, moment, type, specific addition, why-this-one, cost, design-system pointer) — see `skills/zara/SKILL.md` "Output format". Use deep mode for full/deep critiques or when `default_chain` is running.
 
 **Citation:** `[filename, row N: "exact quoted value"]`. Apply the `styles.csv` 5-step filter in `skills/zara/SKILL.md` before citing — never read the full file.
+
+## Deliberation modes (v1.19)
+
+**Review mode (rounds 0–N-1):** Critique prior output with grounded objections. Default `accepts_prior: false`. Include deliberation JSON block.
+
+**Produce mode (final round):** Full output schema after consensus or Raj. See `skills/deliberation-protocol/SKILL.md`.

package/agents/chain.json

@@ -1,20 +1,26 @@
 {
   "description": "Default sequential graph for a full multi-persona critique (design-critic). The MoE router in router.json selects a smaller subset of this chain by default; only run this full chain for an explicit full-screen review.",
   "default_expert_budget": 2,
+  "deliberation_mode": "adversarial",
+  "objection_token_cap": 600,
   "default_chain": [
     { "step": 1, "persona": "arjun",  "handoff_from": null,     "handoff_to": "meera",  "parallel_safe_with": [] },
     { "step": 2, "persona": "meera",  "handoff_from": "arjun",  "handoff_to": "priya",  "parallel_safe_with": ["priya"] },
     { "step": 3, "persona": "priya",  "handoff_from": "meera",  "handoff_to": "zara",   "parallel_safe_with": ["meera"] },
     { "step": 4, "persona": "zara",   "handoff_from": "priya",  "handoff_to": null,     "parallel_safe_with": [] }
   ],
+  "deliberation_groups": {
+    "critique": [["arjun"], ["meera", "priya"], ["zara"]],
+    "ideation": [["meera"], ["noor", "anuj"], ["arjun"], ["zara", "priya"]],
+    "lite": [["arjun"], ["meera"]]
+  },
   "ideation_chain": [
     { "step": 1, "persona": "meera", "handoff_to": ["noor", "anuj"], "parallel_safe_with": [] },
     { "step": 2, "persona": "noor",  "handoff_from": "meera", "handoff_to": "arjun", "parallel_safe_with": ["anuj"] },
     { "step": 2, "persona": "anuj",  "handoff_from": "meera", "handoff_to": "arjun", "parallel_safe_with": ["noor"] },
     { "step": 3, "persona": "arjun", "handoff_from": ["noor", "anuj"], "handoff_to": "zara", "parallel_safe_with": [] },
     { "step": 4, "persona": "zara",  "handoff_from": "arjun", "handoff_to": "priya", "parallel_safe_with": [] },
-    { "step": 5, "persona": "priya", "handoff_from": "zara",  "handoff_to": "raj", "parallel_safe_with": [] },
-    { "step": 6, "persona": "raj",   "handoff_from": "priya", "handoff_to": null, "parallel_safe_with": [] }
+    { "step": 5, "persona": "priya", "handoff_from": "zara",  "handoff_to": null, "parallel_safe_with": [] }
   ],
   "tiers": {
     "router": null,
@@ -30,7 +36,7 @@
   },
   "effort_matrix": {
     "description": "Effort-graded model selection (v1.10). Each persona call is classified trivial|standard|hard and resolved against this matrix. Falls back to the legacy tiers map above when a persona manifest has no effort_overrides for the chosen effort.",
-    "trivial":  { "provider": "zai",      "model": "glm-4.5-flash",        "max_output_tokens": 500  },
+    "trivial":  { "provider": "host",   "model": "devi",                 "max_output_tokens": 600  },
     "standard": { "provider": "google",    "model": "gemini-2.5-flash",    "max_output_tokens": 1200 },
     "hard":     { "provider": "anthropic", "model": "claude-sonnet-5",     "max_output_tokens": 1800 }
   },

package/agents/deliberation-schema.json

@@ -0,0 +1,44 @@
+{
+  "description": "Structured output every persona emits during adversarial deliberation rounds (v1.19).",
+  "persona_output_block": {
+    "grounding": [
+      {
+        "type": "task_map | prd | ui_region | ds_token | figma",
+        "ref": "string — e.g. task_map[0], PRD line, header/CTA, --color-primary",
+        "note": "string — why this citation matters"
+      }
+    ],
+    "satisfaction_with_prior": "number 0.0–1.0 — how satisfied with prior persona output",
+    "accepts_prior": "boolean — true only if satisfaction >= threshold",
+    "objections": [
+      {
+        "target_persona": "string — persona id being challenged",
+        "claim": "string — specific claim being contested",
+        "evidence_required": "string — what would resolve this",
+        "blocking": "boolean — must resolve before synthesis",
+        "grounded_in": "string — citation to task/PRD/UI"
+      }
+    ],
+    "questions": ["string — contextual questions about UI, PRD, task, JTBD"],
+    "revisions": ["string — concrete changes required in prior output"],
+    "verdict": "SHIP | REVISE | BLOCK | CONTEST | ACCEPT",
+    "synthesis": "string — optional; full produce-mode output on final round only"
+  },
+  "session_deliberation": {
+    "round": "number — current round index",
+    "max_rounds": "number",
+    "satisfaction_threshold": "number 0.0–1.0",
+    "open_objections": ["object — unresolved objections from round_log"],
+    "round_log": [
+      {
+        "round": "number",
+        "persona": "string",
+        "parsed": "object — parsed deliberation block",
+        "raw_length": "number"
+      }
+    ],
+    "consensus_reached": "boolean",
+    "raj_escalated": "boolean",
+    "mode": "adversarial | legacy"
+  }
+}

package/agents/manifests/devi.json

@@ -0,0 +1,31 @@
+{
+  "id": "devi",
+  "role": "host_llm",
+  "system_skill": "skills/devi/SKILL.md",
+  "system_card": "agents/cards/devi.md",
+  "tier": "structured",
+  "max_output_tokens": 900,
+  "parallel_safe_with": [],
+  "inputs": ["pending_prompts", "persona_skills", "session_state"],
+  "outputs": ["persona_responses"],
+  "allowed_tools": [],
+  "allowed_jobs": [
+    "read orchestrator pending prompts and embody target personas",
+    "write response files for host-mode orchestrator runs",
+    "batch-process all pending steps in a run directory"
+  ],
+  "forbidden_jobs": [
+    "replace persona critique content with meta-commentary",
+    "call external LLM APIs (Devi IS the host LLM)",
+    "implement code without explicit build approval"
+  ],
+  "routing_triggers": ["host_llm", "devi", "pending", "continue run"],
+  "never_route_for": ["design_critique", "wireframe"],
+  "chain_position": 0,
+  "handoff_from": [],
+  "handoff_to": ["arjun", "meera", "priya", "zara", "noor", "anuj", "raj"],
+  "requires_session_state": true,
+  "effort_overrides": {
+    "trivial": { "provider": "host", "max_output_tokens": 900 }
+  }
+}

package/agents/session-schema.json

@@ -69,6 +69,35 @@
     ],
     "vault_path": "string — Obsidian vault written by Kavi collect (empty until first collect)",
     "last_collect_at": "ISO 8601 timestamp — last successful collect run",
+    "deliberation": {
+      "round": "number — current deliberation round",
+      "max_rounds": "number",
+      "satisfaction_threshold": "number 0.0–1.0",
+      "open_objections": ["object — unresolved blocking objections"],
+      "round_log": ["object — per-persona per-round parsed output"],
+      "consensus_reached": "boolean",
+      "raj_escalated": "boolean",
+      "mode": "adversarial | legacy"
+    },
+    "host_run": {
+      "run_id": "string — host LLM run directory id",
+      "run_dir": "string — absolute path to pending/responses queue",
+      "task": "string — task text for --continue",
+      "status": "in_progress | pending_devi | complete",
+      "last_pending": { "step_id": "string", "persona": "string" },
+      "checkpoint": "object | null — deliberation resume state",
+      "started_at": "ISO 8601",
+      "completed_at": "ISO 8601 | omitted"
+    },
+    "synthesis": {
+      "scores": "object — per-persona scores",
+      "total": "number",
+      "max_total": "number",
+      "verdict": "SHIP | REVISE | BLOCK",
+      "top3": ["object — ranked actionable changes"],
+      "hierarchy_gate": "object — gate status"
+    },
+    "synthesis_markdown": "string — Phase 5 composite block for display/export",
     "digest": {
       "task_map_summary": "string — short summary passed to persona calls instead of the full task_map/persona_outputs history",
       "hierarchy_top3": ["string — top 3 ranked hierarchy items, if declared"],
@@ -86,7 +115,11 @@
       "cache_hits": "number — retrieve/cache hits during the last run",
       "mode": "lite | full",
       "effort_log": [{ "persona": "string", "effort": "trivial|standard|hard", "model": "string|null", "scoped_mode": "string|null" }],
-      "cost_usd": "number — estimated $ cost of the run from config.pricing (0 when pricing missing)"
+      "cost_usd": "number — estimated $ cost of the run from config.pricing (0 when pricing missing)",
+      "deliberation_rounds": "number — adversarial rounds executed in last run",
+      "objections_raised": "number",
+      "objections_resolved": "number",
+      "raj_escalations": "number"
     }
   }
 }