ai-consultants 4.0.2 → 4.0.4

package/.env.example

@@ -198,7 +198,7 @@ QWEN3_CMD=qwen
 # =============================================================================
 
 # GLM - The Methodologist
-GLM_MODEL=glm-5.3
+GLM_MODEL=glm-5.3-flash
 GLM_TIMEOUT=180
 GLM_API_MAX_TOKENS=16384
 GLM_API_URL=https://api.z.ai/api/coding/paas/v4/chat/completions
@@ -335,15 +335,12 @@ ENABLE_RELIABILITY_TRACKING=true
 # SESSION MANAGEMENT
 # =============================================================================
 
-SESSION_CLEANUP_DAYS=7       # Auto-cleanup sessions older than N days
+SESSION_CLEANUP_DAYS=7       # Deprecated no-op; retained for v4.x compatibility
 # SESSION_DIR=/custom/state/sessions
 
-# =============================================================================
-# INTERACTIVE MODE
-# =============================================================================
-
-ENABLE_PROGRESS_BARS=true    # Show progress bars during consultation
-ENABLE_EARLY_TERMINATION=true # Allow Ctrl+C to stop with partial results
+# Deprecated no-ops; retained for v4.x compatibility
+ENABLE_PROGRESS_BARS=true
+ENABLE_EARLY_TERMINATION=true
 
 # =============================================================================
 # PRE-FLIGHT CHECKS
@@ -383,10 +380,10 @@ INCLUDE_CRITICAL_COMMENTS=true
 MAX_BODY_SUMMARY_LINES=3
 MIN_IDENTIFIER_LENGTH=8
 PRESERVE_EXPORTS=true
-USE_COMPACT_PROMPTS=true
+USE_COMPACT_PROMPTS=true      # Deprecated no-op; retained for v4.x compatibility
 FORCE_PROJECT_TREE=false
-ENABLE_SELECTIVE_CONTEXT=false
-MAX_FILES_PER_CONSULTANT=5
+ENABLE_SELECTIVE_CONTEXT=false # Deprecated no-op; retained for v4.x compatibility
+MAX_FILES_PER_CONSULTANT=5     # Deprecated no-op; retained for v4.x compatibility
 
 # =============================================================================
 # REPORTING & STORAGE

package/CLAUDE.md

@@ -6,7 +6,7 @@ AI Consultants is a multi-model coverage system that queries up to 10 AI consult
 
 **Self-Exclusion**: The invoking agent is automatically excluded from both the panel and synthesis. Claude Code won't query or synthesize with Claude, Codex CLI won't query or synthesize with Codex, etc.
 
-**Version**: 4.0.2
+**Version**: 4.0.4
 
 ## Distribution
 
@@ -393,7 +393,7 @@ All consultants now use premium models by default:
 | Codex | gpt-5.6-sol |
 | Mistral | CLI: mistral-medium-3.5; API: mistral-large-3 |
 | DeepSeek | deepseek-v4-pro |
-| GLM | glm-5.3 |
+| GLM | glm-5.3-flash |
 | Grok | grok-4.6 |
 | Qwen3 | qwen3.7-max |
 | Kimi | kimi-code/k3 |
@@ -760,6 +760,22 @@ curl -fsSL https://raw.githubusercontent.com/matteoscurati/ai-consultants/main/s
 
 ## Changelog
 
+### v4.0.4
+
+- **Housekeeping now removes dead implementation without removing public compatibility.** The cleanup deletes uncalled API, cache, optimizer, common, cost, persona, reliability, routing-summary, and session-display helpers, plus the stale README changelog and redundant npm ignore file. The documented `get_routing_mode`, `get_recommended_count`, and `get_category_timeout` helpers stay available and are regression-tested. Six historic config keys that had no runtime reader remain accepted as explicitly deprecated no-ops through v4.x: `SESSION_CLEANUP_DAYS`, `ENABLE_PROGRESS_BARS`, `ENABLE_EARLY_TERMINATION`, `USE_COMPACT_PROMPTS`, `ENABLE_SELECTIVE_CONTEXT`, and `MAX_FILES_PER_CONSULTANT`.
+- **All Bash test suites now share one assertion framework.** `scripts/lib/test_helpers.sh` owns counters, pass/fail/skip rendering, regex/string/numeric/JSON/exit assertions, section rendering, and both concise and detailed summaries. `test_suite.sh` retains compatibility adapters for its established assertion call sites while delegating all mechanics; its summary fails on zero assertions or any failure. The previously excluded `test_functions.sh` is replaced by auto-discovered `test_common.sh`, which keeps regression coverage for diagnosed failures, quorum, health probes, feature-flag recognition, Kimi stream extraction, fenced/bare JSON normalization, confidence preservation, and both detailed-summary failure gates.
+- **The package and active guidance are smaller and truthful.** `package.json#files` is the sole npm allowlist; the package excludes the GitHub release-note archive, tests, fixtures, and maintainer release tooling while retaining active docs. The manifest moves 107 → 61 files, packed bytes 340,662 → 268,831, and unpacked bytes 1,145,406 → 929,330. Setup/CI instructions use `doctor` and `configure`, examples use XDG consultation paths, and routing documentation describes real affinity selection rather than an inert routing-mode/timeout path.
+- **Verification is wholly offline for this patch.** No consultant adapter, model, host transport, roster, cost rate, or synthesis behavior changed, so no billable live smoke was needed. Hermetic `npm test` passed 24/24 suites; core 447 assertions, configure 94 checks, installer/package 51 checks, common-helper 38 checks, Bash 3.2 syntax, ShellCheck, `npm ci --dry-run`, markdown links, and two rounds of cross-family cleanup review are green. PR #16 merged with its merge commit and all final CI checks passed.
+
+### v4.0.3
+
+- **GLM's active catalog target moves from `glm-5.3` to `glm-5.3-flash` without changing transport or tier semantics.** `scripts/config.sh:189` changes the clean-install default, and the maximum/premium/standard branches at `scripts/config.sh:626-656` select the same exact provider ID. `max_quality` still supplies `GLM_REASONING_EFFORT=max`; economy deliberately remains `glm-4-flash`.
+- **Existing managed installs advance without rewriting explicit choices.** `scripts/configure.sh:310-318` migrates the two exact historical generated defaults, `glm-5.2` and `glm-5.3`, to Flash and records `# ai-consultants:default`. A `# ai-consultants:pin` survives, including an explicit old `glm-5.3`; `scripts/test_configure.sh:449-461` covers both current-default migration and pin preservation.
+- **Identity and pricing stay honest.** The OpenAI-compatible adapter sends `glm-5.3-flash`, `reasoning_effort=max`, and the 16,384-token GLM budget; the synthetic transport test requires provider-reported identity and requested-model metadata (`scripts/test_api_transport.sh:253-263`). `docs/cost_rates.json` marks Flash unpriced and retains a zero/unpriced entry for legacy `glm-5.3` pins, avoiding the generic fallback rate.
+- **The exact ai-consultants transport completed one authorized no-retry live smoke.** Z.AI returned HTTP 200 and provider-reported `glm-5.3-flash` in about 12 seconds with 37 measured input tokens and 308 output tokens. The provider accepted max effort but returned near-structured text rather than the requested JSON; the adapter preserved `PONG` through its explicit unstructured fallback with confidence 5, so strict schema adherence is not claimed. PR #15 CI, the post-bump 23-suite gate, 452 core checks, configure 94/94, API transport 88/88, and ShellCheck are green.
+
+  Deliberately unchanged: `delegation-kit` remained read-only; its Claude-to-Z.AI gate and runner were not copied into this API-only consultant. Installation does not silently edit personal configuration, so an existing unpinned `.env` advances when the user runs `configure`; explicit pins remain user-owned. The separate `agent/model-defaults-4.1.0-wip` branch is not part of this patch release.
+
 ### v4.0.2
 
 - **The Grok adapter used to copy a rotating OAuth credential into a disposable HOME and delete any refreshed token at exit.** Parallel calls amplified the race: both could seed from one refresh token, one rotation vanished with its temp directory, and the ambient session could be left stale. `scripts/lib/grok_oauth.sh` now owns a durable generation under the XDG data root and `scripts/query_grok.sh` defaults to `GROK_OAUTH_MODE=shared`.

package/README.md

@@ -1,8 +1,8 @@
-# AI Consultants v4.0.2
+# AI Consultants v4.0.4
 
 > **Coverage, not a single guess.** A panel of up to 10 frontier models from different vendors fans out on your question in parallel and hands you the *union* of what they collectively see — the risks, edge cases, and approaches a single model misses.
 
-[![Version](https://img.shields.io/badge/version-4.0.2-blue.svg)](https://github.com/matteoscurati/ai-consultants)
+[![Version](https://img.shields.io/badge/version-4.0.4-blue.svg)](https://github.com/matteoscurati/ai-consultants)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![Claude Code Skill](https://img.shields.io/badge/Claude%20Code-Skill-orange.svg)](https://docs.anthropic.com/en/docs/claude-code/skills)
 [![GitHub stars](https://img.shields.io/github/stars/matteoscurati/ai-consultants?style=social)](https://github.com/matteoscurati/ai-consultants)
@@ -331,7 +331,7 @@ skillport status ai-consultants
 git clone https://github.com/matteoscurati/ai-consultants.git
 cd ai-consultants
 ./scripts/doctor.sh --fix
-./scripts/setup_wizard.sh
+./bin/ai-consultants configure
 ```
 
 **Commands:**
@@ -411,7 +411,7 @@ the observed version is response provenance only.
 
 | Consultant | Default Model | Persona | Focus |
 |------------|---------------|---------|-------|
-| **GLM** | glm-5.3 | The Methodologist | Structured approaches |
+| **GLM** | glm-5.3-flash | The Methodologist | Structured approaches |
 | **DeepSeek** | deepseek-v4-pro | The Code Specialist | Algorithms, code generation |
 
 ### Installing Consultant CLIs
@@ -483,7 +483,7 @@ detail instead of reducing every consultant to its summary.
 | Mistral CLI | mistral-medium-3.5 | mistral-medium-3.5 | mistral-medium-3.5 | devstral-small-2 |
 | Mistral API | mistral-large-3 | mistral-large-3 | mistral-large-3 | mistral-large-3 |
 | DeepSeek | deepseek-v4-pro | deepseek-v4-pro | deepseek-v4-flash | deepseek-v4-flash |
-| GLM | glm-5.3 | glm-5.3 | glm-5.3 | glm-4-flash |
+| GLM | glm-5.3-flash | glm-5.3-flash | glm-5.3-flash | glm-4-flash |
 | Grok | grok-4.6 | grok-4.6 | grok-4.5 | grok-4.5 |
 | Qwen3 | qwen3.8-max when Token Plan is configured; otherwise qwen3.7-max | qwen3.7-max | qwen3.6-35b-a3b | qwen3-32b |
 | Kimi | kimi-code/k3-256k | kimi-code/k3 | kimi-code/k3 | kimi-code/k3 |
@@ -698,15 +698,19 @@ Classify -> Route -> Fan out (parallel) -> Coverage synthesis
 Each consultation generates:
 
 ```
-/tmp/ai_consultations/TIMESTAMP/
+${XDG_CACHE_HOME:-$HOME/.cache}/ai-consultants/consultations/TIMESTAMP/
+├── context.md            # Built consultation context
 ├── gemini.json          # Individual responses
 ├── codex.json           #   with confidence scores
 ├── mistral.json
 ├── grok.json
 ├── synthesis.json       # Coverage union
+├── optimization_metrics.json
 └── report.md            # Human-readable report
 ```
 
+The command prints the exact output directory as its final stdout line.
+
 ---
 
 ## Best Practices
@@ -736,7 +740,8 @@ enough — the panel adds little.
 
 - **Never** include credentials or API keys in queries
 - Review and redact sensitive code before sending it to any external consultant
-- Files in `/tmp` are automatically cleaned up
+- Private query and context-staging files are removed automatically; generated
+  reports remain in the XDG cache directory until you remove them
 
 ---
 
@@ -748,121 +753,11 @@ enough — the panel adds little.
 - [Smart Routing](docs/SMART_ROUTING.md) - Category-based routing
 - [JSON Schema](docs/JSON_SCHEMA.md) - Output format specification
 - [Reference Details](references/details.md) - Presets, strategies, best practices
+- [Changelog](https://github.com/matteoscurati/ai-consultants/blob/main/CHANGELOG.md) - Complete version history
 - [Contributing](CONTRIBUTING.md) - How to contribute
 
 ---
 
-## Changelog
-
-### v2.23.0
-
-- **`ENABLE_REFLECTION` and `REFLECTION_CYCLES` removed.** The self-reflection module they controlled was never called by anything, so the settings had never affected a consultation — v2.16's `converge` and `adversarial` shapes already run critique-refine off measured consensus. **If you set either key**, remove it: `configure --set ENABLE_REFLECTION=...` now exits non-zero, and both keys are dropped when an existing `.env` is rewritten.
-- **The release gate works again.** Two test suites failed deterministically against any real user configuration, so no release since 2.22.0 could pass its own `npm test`.
-- **`npm test` no longer swallows failures.** A failing assertion followed by a passing one inside the same test function was counted as a pass, across 8 of 13 test functions.
-- **Feature flags can no longer be enrolled as consultants.** A registry that told feature flags apart from custom API agents was 18 entries out of date; it is now complete and pinned by a test.
-- **Preset tables corrected** — they described a debate and peer-review depth the code has not enforced since v2.16, and called `high-stakes`/`max_quality` "all consultants" when they enable 5 and 8 of 11. See the [v2.23.0 release note](docs/releases/v2.23.0.md).
-
-### v2.22.0
-
-- **`ai-consultants configure`**: a public automatic configurator. It detects your installed CLIs and API keys, picks CLI-first transports, and writes a private XDG config while preserving your existing settings and secrets. Drive it with repeatable `--set KEY=VALUE`, review it with `--interactive` / `--advanced`, or preview it with `--dry-run`. See the [v2.22.0 release note](docs/releases/v2.22.0.md).
-
-### v2.21.1
-
-- **Kimi K3**: Kimi now defaults to `kimi-code/k3`, and the adapter passes the model explicitly with `--model`.
-- **Focused 11-consultant roster**: Kilo, Aider, Amp, and Ollama were removed end-to-end, including their adapters and configuration variables. See the [v2.21.1 release note](docs/releases/v2.21.1.md) for migration guidance.
-
-### v2.15.1
-
-- **Gemini fixes (Antigravity CLI)**: the default model (`Gemini 3.1 Pro (High)`) wraps its JSON in a ```` ```json ```` fence; v2.15.0 didn't strip it, so every Gemini reply degraded to a generic fallback. Now de-fenced on all paths (response processing, self-reflection, synthesis).
-- **Works out-of-the-box for `npx`**: Gemini auto-selects API mode when `GEMINI_API_KEY` is set (the `agy` CLI can't be npm-installed and is OAuth-only), so a key-only environment no longer silently drops Gemini.
-- **Synthesis no longer hangs** when `agy` is the synthesizer (it was launched interactively instead of in print mode).
-
-### v2.10.0
-
-- **MiniMax M2.5 support**: New API-based consultant with "The Pragmatic Optimizer" persona
-- **15 consultants total**: Gemini, Codex, Mistral, Kilo, Cursor, Aider, Amp, Kimi, Claude, Qwen3, GLM, Grok, DeepSeek, MiniMax, Ollama
-- **npx distribution**: `npx ai-consultants "question"` - run directly without install
-- **npm packaging**: `package.json` with zero dependencies, `.npmignore` for clean publishing
-
-### v2.8.1
-
-- **Bug fixes**: Fixed `((count++))` abort under `set -e`, missing Amp in consultant map, hardcoded `claude` in synthesize.sh
-- **Security**: Variable name validation before `export` in escalation and cost-aware routing
-- **DRY refactoring**: Rewrote `query_kilo.sh` and `query_cursor.sh` using shared `process_consultant_response()`; added `get_model_for_tier()` as single source of truth
-
-### v2.8.0
-
-- **Amp CLI support**: New consultant with "The Systems Thinker" persona
-- **13 consultants total**: Gemini, Codex, Mistral, Kilo, Cursor, Aider, Amp, Claude, Qwen3, GLM, Grok, DeepSeek, Ollama
-- **Installation**: `curl -fsSL https://ampcode.com/install.sh | bash`
-
-### v2.7.0
-
-- **Qwen CLI support**: CLI/API mode switching for Qwen3 via qwen-code
-- **5 switchable agents**: Gemini, Codex, Claude, Mistral, and now Qwen3 support CLI/API mode
-- **CLI default**: `QWEN3_USE_API` defaults to `false` (CLI mode via qwen-code)
-
-### v2.6.0
-
-- **CLI/API mode switching**: Gemini, Codex, Claude, and Mistral can switch between CLI and API mode
-- **New environment variables**: `*_USE_API` and `*_API_URL` for each switchable agent
-- **Unified API query module**: `lib/api_query.sh` for consistent API handling
-
-### v2.5.0
-
-- **Model quality tiers**: Premium, standard, and economy tiers for all consultants
-- **New presets**: `max_quality`, `medium`, `fast` for quick tier selection
-- **Premium defaults**: All consultants now use premium models by default (March 2026)
-- **`apply_model_tier()` function**: Programmatically switch all models to a tier
-- **Updated models**: opus-4.6, gemini-3.1-pro-preview, gpt-5.3-codex, mistral-large-3, etc.
-
-### v2.4.0
-
-- **Budget enforcement**: Optional budget limits with configurable actions (warn/stop)
-- **Budget checks**: 4 enforcement points (before/after consultation, debate, synthesis)
-- **Budget configuration**: Configurable via natural language or environment variables
-
-### v2.3.0
-
-- **Semantic caching**: Cache responses to avoid redundant API calls (15-25% savings)
-- **Cost-aware routing**: Route simple queries to cheaper models (30-50% savings)
-- **Fallback escalation**: Auto-escalate to premium model if confidence < 7
-- **Debate optimization**: Skip debate if all consultants agree (opt-in)
-- **Category exceptions**: SECURITY/ARCHITECTURE always trigger debate
-- **Quality monitoring**: `optimization_metrics.json` tracks optimization impact
-- **Compact reports**: Shorter reports by default (summaries only)
-- **Response limits**: Per-category token limits (opt-in)
-
-### v2.2.0
-
-- **Claude consultant**: New consultant with "The Synthesizer" persona
-- **Self-exclusion**: Invoking agent automatically excluded from panel
-- **Presets**: Quick configuration with `--preset minimal/balanced/high-stakes/security`
-- **Doctor command**: Diagnostic and auto-fix tool
-- **Synthesis strategies**: `--strategy majority/risk_averse/security_first/compare_only`
-- **Confidence intervals**: Statistical confidence ranges (e.g., "8 +/- 1.2")
-- **Anonymous peer review**: Unbiased evaluation of responses
-- **Ollama support**: Local model inference for privacy
-- **Panic mode**: Automatic rigor when uncertainty detected
-- **One-liner install**: `curl | bash` installation
-
-### v2.1.0
-
-- New consultants: Aider, DeepSeek
-- 17 configurable personas
-- Token optimization with AST extraction
-
-### v2.0.0
-
-- Persona system with 15 predefined roles
-- Confidence scoring (1-10) on every response
-- Auto-synthesis with weighted recommendations
-- Multi-Agent Debate (MAD)
-- Smart routing by question category
-- Session management and cost tracking
-
----
-
 ## License
 
 MIT License - see [LICENSE](LICENSE) for details.

package/SKILL.md

@@ -5,10 +5,10 @@ license: MIT
 compatibility: Requires bash, jq, and at least 2 AI CLI tools (agy, codex, vibe, etc.). macOS and Linux.
 metadata:
   author: matteoscurati
-  version: 4.0.2
+  version: 4.0.4
 ---
 
-# AI Consultants v4.0.2 - AI Expert Panel
+# AI Consultants v4.0.4 - AI Expert Panel
 
 **Coverage, not a single guess.** Convene a panel of AI "consultants" from different vendors for coding questions: they fan out in parallel and you get the *union* of what they collectively see — the risks, edge cases, and approaches a single model misses. Each consultant has a **configurable persona** that decorrelates its analysis.
 
@@ -185,13 +185,17 @@ See [Full Configuration Reference](references/configuration.md) for all variable
 ## Output
 
 ```
-/tmp/ai_consultations/TIMESTAMP/
+${XDG_CACHE_HOME:-$HOME/.cache}/ai-consultants/consultations/TIMESTAMP/
+├── context.md          # Built consultation context
 ├── gemini.json        # Individual responses
 ├── codex.json
 ├── synthesis.json     # Coverage union
+├── optimization_metrics.json
 └── report.md          # Human-readable
 ```
 
+The command prints the exact output directory as its final stdout line.
+
 ## Doctor Command
 
 Diagnose and fix issues:

package/docs/COST_RATES.md

@@ -1,4 +1,4 @@
-# Cost Rates - AI Consultants v4.0.2
+# Cost Rates - AI Consultants v4.0.4
 
 This page documents the per-token rates used by the cost tracking system.
 
@@ -45,7 +45,8 @@ models programmatically.
 | gemini-3-flash | Legacy | $0.0005 | Removed Cursor consultant |
 | deepseek-v4-pro | Premium | $0.000435 | DeepSeek |
 | deepseek-v4-flash | Standard/Economy | $0.00014 | DeepSeek |
-| glm-5.3 | Maximum/Premium/Standard | Unpriced | GLM coding-plan endpoint |
+| glm-5.3-flash | Maximum/Premium/Standard | Unpriced | GLM coding-plan endpoint |
+| glm-5.3 | Legacy pins | Unpriced | GLM coding-plan endpoint |
 | glm-4-flash | Economy | $0.001 | GLM |
 | grok-4.6 | Maximum/Premium | $0.002 | Grok |
 | grok-4.5 | Standard/Economy | $0.002 | Grok |
@@ -86,7 +87,8 @@ models programmatically.
 | gemini-3-flash | Legacy | $0.003 | Removed Cursor consultant |
 | deepseek-v4-pro | Premium | $0.00087 | DeepSeek |
 | deepseek-v4-flash | Standard/Economy | $0.00028 | DeepSeek |
-| glm-5.3 | Maximum/Premium/Standard | Unpriced | GLM coding-plan endpoint |
+| glm-5.3-flash | Maximum/Premium/Standard | Unpriced | GLM coding-plan endpoint |
+| glm-5.3 | Legacy pins | Unpriced | GLM coding-plan endpoint |
 | glm-4-flash | Economy | $0.003 | GLM |
 | grok-4.6 | Maximum/Premium | $0.006 | Grok |
 | grok-4.5 | Standard/Economy | $0.006 | Grok |
@@ -174,7 +176,8 @@ the providers' official pricing pages: [Anthropic](https://platform.claude.com/d
 [MiniMax](https://platform.minimax.io/docs/guides/pricing-paygo). Gemini 3.7's
 listed rate is the promotion effective through December 31, 2026.
 
-`glm-5.3`, `qwen3.8-max`, and `kimi-code/k3-256k` are explicitly unpriced on
+`glm-5.3-flash`, legacy-pinned `glm-5.3`, `qwen3.8-max`, and
+`kimi-code/k3-256k` are explicitly unpriced on
 the transports used here. Their zero catalog entries prevent the estimator from
 inventing a dollar figure; session reports disclose their exclusion rather than
 presenting them as free.

package/docs/JSON_SCHEMA.md

@@ -1,4 +1,4 @@
-# JSON Schema - AI Consultants v3.5
+# AI Consultants JSON Schema
 
 This document describes the JSON schema used for consultant responses.
 

package/docs/SETUP.md

@@ -1,4 +1,4 @@
-# Setup Guide - AI Consultants v2.21.1
+# AI Consultants Setup Guide
 
 This guide walks you through installing and configuring AI Consultants for various AI coding agents.
 
@@ -688,33 +688,18 @@ Checks:
 ./scripts/doctor.sh --fix
 ```
 
-### Preflight Check
-
-```bash
-./scripts/preflight_check.sh
-```
-
-Expected output:
-```
-[OK] jq installed
-[OK] Gemini CLI installed and authenticated
-[OK] Codex CLI installed and authenticated
-Status: Ready
-```
-
-### Setup Wizard (Bash)
+### Configuration
 
-Interactive configuration:
+Auto-detect the available CLI and API transports:
 
 ```bash
-./scripts/setup_wizard.sh
+./bin/ai-consultants configure
 ```
 
-The wizard will:
-1. Check installed CLIs
-2. Test authentication
-3. Suggest configuration
-4. Generate `.env` file
+Use `--interactive` for a guided review, `--advanced` for every supported
+parameter, or `--dry-run` to preview the generated configuration without
+writing it. The deprecated `setup_wizard.sh` and `preflight_check.sh` entry
+points remain compatibility forwarders but are not the maintained interface.
 
 ---
 
@@ -805,10 +790,10 @@ After setup:
 **Bash:**
 ```bash
 # Test your configuration
-./scripts/consult_all.sh --preset minimal "How do I optimize a SQL query?"
+output_dir=$(./scripts/consult_all.sh --preset minimal "How do I optimize a SQL query?")
 
 # View the report
-cat /tmp/ai_consultations/*/report.md
+less "$output_dir/report.md"
 ```
 
 See [README.md](../README.md) for usage examples and full documentation.

package/docs/SMART_ROUTING.md

@@ -1,4 +1,4 @@
-# Smart Routing - AI Consultants v2.11
+# AI Consultants Smart Routing
 
 The Smart Routing system automatically selects the most suitable consultants based on the question category.
 
@@ -85,30 +85,11 @@ This is useful for:
 The matrix is loaded once per shell and cached in memory — no jq overhead
 on subsequent calls.
 
-## Routing Modes
-
-The system automatically determines how many consultants to involve:
-
-| Mode | Consultants | Categories | Rationale |
-|------|-------------|------------|-----------|
-| **full** | All enabled | SECURITY, GENERAL | All for complete perspectives |
-| **selective** | Top 5 by affinity | CODE_REVIEW, BUG_DEBUG, ARCHITECTURE, ALGORITHM, DATABASE, API_DESIGN, TESTING | Best matches for the category |
-| **single** | 1 | QUICK_SYNTAX | Only the best for quick answers |
-
-### Selection Logic
-
-```
-SECURITY      → full (all)     # Too important to exclude anyone
-QUICK_SYNTAX  → single (1)    # A quick answer is sufficient
-CODE_REVIEW   → selective (5) # Top 5 by affinity
-BUG_DEBUG     → selective (5)
-ARCHITECTURE  → selective (5)
-*             → full (all)    # Default: all enabled
-```
-
 ## Cost-Aware Routing (v2.3+)
 
-When `ENABLE_COST_AWARE_ROUTING=true`, the system routes queries to cheaper models based on complexity:
+When `ENABLE_COST_AWARE_ROUTING=true`, selected consultants use economy models
+for simple questions and can retry low-confidence responses with their premium
+model. Consultant selection itself continues to use the affinity matrix above.
 
 ```bash
 ENABLE_COST_AWARE_ROUTING=true
@@ -119,23 +100,6 @@ COMPLEXITY_THRESHOLD_MEDIUM=6    # Score 4-6 = use standard models
 
 See [COST_RATES.md](COST_RATES.md) for model pricing by tier.
 
-## Timeout per Category
-
-Timeouts optimized based on category complexity:
-
-| Category | Timeout | Rationale |
-|----------|---------|-----------|
-| QUICK_SYNTAX | 60s | Short answers |
-| DATABASE | 120s | Medium-complexity queries |
-| TESTING | 120s | Test case generation |
-| CODE_REVIEW | 180s | Detailed analysis |
-| BUG_DEBUG | 180s | Investigation |
-| ALGORITHM | 180s | Reasoning |
-| API_DESIGN | 180s | Detailed design |
-| GENERAL | 180s | Default |
-| ARCHITECTURE | 240s | Complex design |
-| SECURITY | 240s | In-depth analysis |
-
 ## Supported Categories
 
 ### CODE_REVIEW
@@ -235,8 +199,8 @@ ENABLE_SMART_ROUTING=true \
 
 # Output:
 # [INFO] Category: SECURITY
-# [INFO] Routing mode: full (all enabled consultants)
-# [INFO] Timeout: 240s
+# [INFO] Smart routing for category SECURITY...
+# [INFO] Selected consultants: Mistral Codex ...
 ```
 
 ## API Functions
@@ -255,12 +219,6 @@ select_consultants "SECURITY" 7    # → All enabled consultants
 # Check recommendation
 is_recommended "SECURITY" "Claude" 7 && echo "Recommended"
 
-# Get timeout
-get_category_timeout "ARCHITECTURE"  # → 240
-
-# Get routing mode
-get_routing_mode "QUICK_SYNTAX"      # → single
-
-# Cost-aware selection (v2.3)
-select_consultants_cost_aware "QUICK_SYNTAX" 7  # → Economy model selection
+# Cost-aware model selection (v2.3)
+get_cost_aware_model "codex" 2  # → Economy model when enabled
 ```

package/docs/cost_rates.json

@@ -1,5 +1,5 @@
 {
-  "version": "4.0.2",
+  "version": "4.0.4",
   "updated": "2026-08-23",
   "models": {
     "_comment_units": "All rates are USD per 1,000 tokens (per-1K). lib/costs.sh computes cost as (token_count / 1000) * rate, so every value here MUST be a per-1K rate = (provider $/1M price) / 1000. Do NOT paste $/MTok figures directly.",
@@ -402,6 +402,10 @@
       "input": 0,
       "output": 0
     },
+    "glm-5.3-flash": {
+      "input": 0,
+      "output": 0
+    },
     "kimi-code/k3-256k": {
       "input": 0,
       "output": 0
@@ -411,6 +415,7 @@
     "qwen3.8-max",
     "qwen3.8-max-preview",
     "glm-5.3",
+    "glm-5.3-flash",
     "kimi-code/k3-256k"
   ],
   "consultant_fallbacks": {
@@ -420,7 +425,7 @@
     "codex": "gpt-5.6-sol",
     "mistral": "mistral-large-3",
     "deepseek": "deepseek-v4-pro",
-    "glm": "glm-5.3",
+    "glm": "glm-5.3-flash",
     "grok": "grok-4.6",
     "qwen3": "qwen3.7-max",
     "kimi": "kimi-code/k3",
@@ -434,7 +439,7 @@
       "codex": "gpt-5.6-sol",
       "mistral": "mistral-medium-3.5",
       "deepseek": "deepseek-v4-pro",
-      "glm": "glm-5.3",
+      "glm": "glm-5.3-flash",
       "grok": "grok-4.6",
       "qwen3": "qwen3.8-max",
       "kimi": "kimi-code/k3-256k",
@@ -446,7 +451,7 @@
       "codex": "gpt-5.6-sol",
       "mistral": "mistral-medium-3.5",
       "deepseek": "deepseek-v4-pro",
-      "glm": "glm-5.3",
+      "glm": "glm-5.3-flash",
       "grok": "grok-4.6",
       "qwen3": "qwen3.7-max",
       "kimi": "kimi-code/k3",
@@ -458,7 +463,7 @@
       "codex": "gpt-5.6-terra",
       "mistral": "mistral-medium-3.5",
       "deepseek": "deepseek-v4-flash",
-      "glm": "glm-5.3",
+      "glm": "glm-5.3-flash",
       "grok": "grok-4.5",
       "qwen3": "qwen3.6-35b-a3b",
       "kimi": "kimi-code/k3",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-consultants",
-  "version": "4.0.2",
+  "version": "4.0.4",
   "description": "A cross-vendor panel of up to 10 AI models that returns the coverage union of their distinct perspectives",
   "bin": {
     "ai-consultants": "bin/ai-consultants"
@@ -19,6 +19,7 @@
     "SKILL.md",
     "CLAUDE.md",
     "docs/",
+    "!docs/releases/",
     "references/"
   ],
   "keywords": [

package/references/configuration.md

@@ -252,7 +252,7 @@ KIMI_MODEL=kimi-code/k3
 QWEN3_MODEL=qwen3.7-max
 QWEN3_MAX_QUALITY_TIMEOUT=600
 QWEN3_API_MAX_TOKENS=16384
-GLM_MODEL=glm-5.3
+GLM_MODEL=glm-5.3-flash
 GLM_API_MAX_TOKENS=16384
 GLM_REASONING_EFFORT=       # max_quality sets max
 GROK_MODEL=grok-4.6