analyzthis_design 2.0.0 → 2.1.0

package/dist/README.md

@@ -15,23 +15,28 @@ Install once. Run structured UX critiques, multi-phase ideation, and task-ground
 
 Use `npx analyzthis_design run-unchunked` for the legacy single-pass orchestrator.
 
-**npm:** [analyzthis_design](https://www.npmjs.com/package/analyzthis_design) · **Current version:** 2.0.0 · **Step-by-step guide:** [HOW-TO-USE.md](./HOW-TO-USE.md)
+**npm:** [analyzthis_design](https://www.npmjs.com/package/analyzthis_design) · **Current version:** 2.1.0 · **Step-by-step guide:** [HOW-TO-USE.md](./HOW-TO-USE.md)
 
 ---
 
 ## Quick start
 
 ```bash
-# 1. Install slash commands (Cursor/Claude/Codex/Grok/Windsurf)
-npx analyzthis_design
+# 1. Install the npm package (no auto-install, no obfuscation)
+npm install -g analyzthis_design
+
+# 2. Install slash commands into your IDE (explicit, consent-based)
+npx analyzthis_design --target all
 
-# 2. Run a task in v2.0 chunked mode (free/cheap models)
+# 3. Run a task in v2.0 chunked mode (free/cheap models)
 npx analyzthis_design run --task "Review invoice approval screen"
 
-# 3. Or use legacy single-pass orchestrator
+# 4. Or use legacy single-pass orchestrator
 npx analyzthis_design run-unchunked --task "Review invoice approval screen" --provider host
 ```
 
+> **Security:** This package publishes **plain source** — no obfuscation, no minification, no dynamic require. Every file in `dist/` is readable and auditable. The `postinstall` script only prints a welcome message; it does **not** write to any AI-agent directories. Skill installation requires an explicit `npx analyzthis_design --target <ide>` command.
+
 ### Install by target IDE
 
 ```bash
@@ -379,6 +384,9 @@ Ask → session digest → MoE router (1–2 experts, not 4) → persona cards (
 | **Persona cards** | `agents/cards/<persona>.md` (~500 tokens) are the default system prompt; the full `skills/<persona>/SKILL.md` is only opened for a C-or-below rubric lookup or an explicit deep/full request. |
 | **Lite output schema** | Grades + Top 2 fixes + score, by default. Deep/full schema is opt-in. |
 | **Retrieve-on-demand** | `npx analyzthis_design retrieve --file colors.csv --column "Product Type" --keywords saas` returns only matching rows, pre-formatted for citation — never the whole CSV. |
+| **Multi-file reference packs** | Each persona retrieves from 3-5 CSV files (not 1), pooled into a single ranker call. Arjun gets styles + ux-guidelines + ui-reasoning + charts; Zara gets colors + typography + styles + landing + icons. Same LLM cost as single-file, 3-5x coverage. |
+| **Best For Tags** | `styles.csv` and `typography.csv` have a `Best For Tags` column (semicolon-delimited product-type tokens) for reliable keyword filtering. Previously `Best For` was free-text and 31/84 styles were unfilterable. |
+| **CSV schema + validation** | `skills/design-reference/schema.json` defines all 28 CSV files' headers, filter columns, and cross-file joins. `npm run validate` checks integrity before publish. |
 | **Model tiers** | `structured` steps can run on a cheaper model (e.g. `gpt-4o-mini`); `critique`/`arbitrate` steps use a stronger model. Configurable per tier in `~/.analyzthis_design/config.json`. |
 | **Caching** | `lib/cache.js` caches retrieve results (invalidated automatically when the source CSV changes) and knowledge-bank slices (invalidated on `sync` / `session reset`). |
 | **Cost metrics** | Every `run` records `metrics` (llm_calls, experts_run, estimated tokens, cache_hits) into session state. |
@@ -458,12 +466,12 @@ evolve --extract → proposes:
   - reference-data rows (new product-type patterns)
   - router patches (task_type → best-performing expert)
         ↓
-evolve --apply <patchId> (human review) → skill/CSV/router updated
-        ↓
+  evolve --apply <patchId> (human review) → skill/CSV/router updated
+         ↓
 Next run retrieves:
   - per-persona knowledge slices (priority + fallback)
   - past lessons for similar tasks
-  - query-expanded + ranked reference rows
+  - query-expanded + ranked reference rows from 3-5 CSV files per persona
 ```
 
 ### Retrieval stack
@@ -709,12 +717,14 @@ npx analyzthis_design research --query <text>
 # Reference data (retrieve-on-demand)
 npx analyzthis_design retrieve --file <csv> --column <col> --keywords a,b [--limit N]
 
-# Standalone orchestrator
-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]
+# Standalone orchestrator (v2.0 chunked by default)
+npx analyzthis_design run --task "..." [--budget free|cheap|auto] [--sequential|--parallel] [--max-chunks N] [--dry-run]
+npx analyzthis_design run-unchunked --task "..." [--lite|--full] [--experts a,b] [--dry-run] [--deliberate|--no-deliberate]
 npx analyzthis_design run --continue --task "..."   # resume host-mode run after /devi
 
+# CSV validation
+npx analyzthis_design validate    # validate all 28 CSV files against schema.json
+
 # Self-evolving team (v1.21)
 npx analyzthis_design evolve --extract [--window N] [--dry-run]
 npx analyzthis_design evolve --apply <patchId> [--dry-run]
@@ -764,6 +774,7 @@ lib/
   chunk-synthesis.js    Merge chunk outputs into final verdict
   chunk-telemetry.js    Per-chunk model quality tracking
   chunk-run.js          Top-level chunked execution coordinator
+  reference-pack.js     Shared multi-file CSV + vault retrieval (buildReferencePack)
   moodboard.js          Mood-board engine: collect web/DS references, tag, deliberate
   dedup.js              Cross-persona redundancy detection
   lessons.js            Self-evolving lessons store (extract/retrieve/inject)
@@ -785,6 +796,7 @@ scripts/
   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/
+scripts/validate-csvs.js  CSV integrity validation against schema.json
 skills/
   devi/                 Host LLM runtime — voices personas from pending prompts
   kavi/                 Kavi — Knowledge Archivist (/kavi)
@@ -804,7 +816,7 @@ 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
-- **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`
+- **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`, `GROQ_API_KEY`, `TOGETHER_API_KEY`, `OPENROUTER_API_KEY`, `DEEPSEEK_API_KEY`. Local Ollama auto-detected at `localhost:11434`.
 - **Kavi `collect` enrichment:** optional — same keys as above; without keys, draft vault + sync still run
 
 ---
@@ -818,6 +830,10 @@ skills/
 | **Chunk telemetry** | Tracks per-model success rate so router improves over time |
 | **Legacy mode preserved** | `npx analyzthis_design run-unchunked` for the original single-pass orchestrator |
 | **Planner never cheap** | Planner always uses frontier/host; chunk models are cost-optimized |
+| **Multi-file reference retrieval** | Each persona retrieves from 3-5 CSV files (not 1) via a shared ranker — same LLM cost, 3-5x coverage |
+| **All 16 stacks detected** | `detectStack()` covers all 16 stack CSVs (flutter, swiftui, laravel, threejs, etc.) — was 8 |
+| **CSV schema + validation** | `npm run validate` checks all 28 CSV files against `schema.json` before publish |
+| **Best For Tags** | styles.csv + typography.csv have normalized tag columns for reliable keyword filtering |
 
 ## What's new in v1.22
 

package/dist/agents/cards/evolve-check.md

@@ -0,0 +1,38 @@
+# Evolve Check
+
+**Devi skill** — After a successful critique run, check if the team has enough data to evolve and offer to run the evolution cycle.
+
+---
+
+## When to invoke
+
+After a completed `run` or `run-unchunked` where:
+- Personas produced outputs
+- User accepted at least some outputs
+- Outcomes were confirmed (shipped/revised/blocked/missed)
+
+---
+
+## What to do
+
+1. Run: `npx analyzthis_design evolve --ready --project <project>`
+2. If ready → summarize pending patches and ask: "The team has enough data to evolve. Apply proposed patches?"
+3. If user says yes → run `npx analyzthis_design evolve --apply <patchId>` for each patch
+4. If not ready → tell user what's needed: "Need X more lessons / Y more outcomes"
+
+---
+
+## Example response
+
+> ��� **Devi here!** The critique run completed successfully. I checked the team's evolution status — we have **2 lessons** and **0 confirmed outcomes**. Need **3 more lessons** or **10 outcomes** to trigger evolution.
+>
+> Want me to run a critique on another screen to build up the data?
+
+---
+
+## Commands reference
+
+- `npx analyzthis_design evolve --ready --project <id>` — check readiness
+- `npx analyzthis_design evolve --metrics --project <id>` — show evolution dashboard
+- `npx analyzthis_design evolve --extract --dry-run` — preview patches
+- `npx analyzthis_design evolve --apply <id>` — apply a patch

package/dist/agents/manifests/evolve-check.json

@@ -0,0 +1,16 @@
+{
+  "id": "evolve-check",
+  "name": "Evolve Check",
+  "type": "utility",
+  "tier": "structured",
+  "system_card": "agents/cards/evolve-check.md",
+  "system_skill": "skills/evolve-check/SKILL.md",
+  "allowed_jobs": ["evolve_check", "metrics_report"],
+  "forbidden_jobs": ["critique", "wireframe", "synthesize"],
+  "knowledge_categories": [],
+  "max_output_tokens": 600,
+  "effort_overrides": {
+    "trivial": { "provider": "host", "model": "devi", "max_output_tokens": 400 },
+    "standard": { "provider": "host", "model": "devi", "max_output_tokens": 600 }
+  }
+}