aidevops 3.32.308 → 3.32.310

package/README.md

@@ -60,7 +60,7 @@ The result: an AI operations platform that manages projects across every busines
 [![Copyright](https://img.shields.io/badge/Copyright-Marcus%20Quinn%202025--2026-blue.svg)](https://github.com/marcusquinn)
 
 <!-- Release & Version Info -->
-[![Version](https://img.shields.io/badge/Version-3.32.308-blue.svg)](https://github.com/marcusquinn/aidevops/releases)
+[![Version](https://img.shields.io/badge/Version-3.32.310-blue.svg)](https://github.com/marcusquinn/aidevops/releases)
 [![npm version](https://img.shields.io/npm/v/aidevops)](https://www.npmjs.com/package/aidevops)
 [![Homebrew](https://img.shields.io/badge/homebrew-marcusquinn%2Ftap-orange)](https://github.com/marcusquinn/homebrew-tap)
 [![GitHub repository](https://img.shields.io/badge/github-repository-181717.svg?logo=github)](https://github.com/marcusquinn/aidevops)
@@ -119,7 +119,7 @@ the required notices and preferred credit text.
 - `/auto-browse` - Learn, optimize, and graduate repeatable browser operations and web data-mining workflows
 - `/report-render` - Render report-ready Markdown or JSON to HTML with sticky TOC, print CSS, evidence badges, and source cards for PDF export
 - `/report-token-use` - Generate a local per-session token, model, compaction, and MCP-use report
-- `/optimize-tiers` - Compare production routing telemetry with sealed historical model replay before changing model defaults
+- `/optimize-tiers` - Optionally investigate unresolved model comparisons with production telemetry and sealed historical replay
 - `/pulse` - Run the autonomous supervisor loop for dispatch, merge, diagnostics, and stuck-work recovery
 - `/serve-sim` / `serve-sim-helper.sh` - Exercise mobile web flows in simulator-backed local previews
 
@@ -446,7 +446,9 @@ See `.agents/tools/task-management/beads.md` for complete documentation and inst
 
 ### OpenAI Models in OpenCode (Recommended)
 
-OpenCode with OpenAI is the current recommended aidevops setup. The default routing uses GPT-5.6 Luna for bounded low-consequence work, Terra for established-pattern implementation, and Sol for consequential decisions, architecture, and synthesis-heavy work.
+OpenCode with OpenAI is the current recommended aidevops setup. Delegation defaults are GPT-5.6 Luna **medium** for bounded low-consequence work, Terra **high** for established-pattern implementation, and Sol **medium** for consequential decisions, architecture, and synthesis-heavy work. GPT-6 Astra **medium** is an optional interactive daily driver; selecting it does not replace the cheaper child tiers.
+
+Optimise through ordinary verified work, retries and parent repair rather than a prerequisite benchmark project. API prices are directional resource-cost estimates, not ChatGPT subscription allowance percentages. See [practical model and effort selection](.agents/tools/context/model-routing.md#practical-model-and-effort-selection) for the strategy, estimate scope and safe escalation rules.
 
 **Authenticate via the pool:**
 
@@ -457,7 +459,7 @@ aidevops model-accounts-pool add openai
 
 **Why this is the default:**
 
-- **Best current cross-tier results** — strongest observed balance across interactive Build+, workers, review, and dispatch tiers
+- **Pragmatic defaults** — reversible choices improved through actual completion and repair evidence, not a claim of benchmark superiority
 - **Tiered cost/latency split** — Luna for bounded work, Terra for general implementation, and Sol where deeper judgement is worth the extra budget
 - **Provider isolation** — OpenAI accounts rotate independently from Anthropic, Google, Cursor, and local providers
 - **Fallback-friendly** — Claude, Gemini, Cursor, and local models remain available when a task or rate-limit profile calls for them
@@ -1365,7 +1367,6 @@ The setup script offers to install these tools automatically.
 
 ### **AI Prompt Optimization**
 
-- **[Augment Context Engine](https://docs.augmentcode.com/context-services/mcp/overview)**: Semantic codebase retrieval with deep code understanding
 - **[Repomix](https://repomix.com/)**: Pack codebases into AI-friendly context (80% token reduction with compress mode)
 - **[DSPy](https://dspy.ai/)**: Framework for programming with language models
 - **[DSPyGround](https://dspyground.com/)**: Interactive playground for prompt optimization
@@ -1450,13 +1451,12 @@ See `.agents/tools/ocr/glm-ocr.md` for batch processing, PDF workflows, and Peek
 
 **Model Context Protocol servers for real-time AI assistant integration.** The framework configures these MCPs for **[OpenCode](https://opencode.ai/)** (TUI, Desktop, and Extension for Zed/VSCode).
 
-### **All Supported MCPs (20 available)**
+### **All Supported MCPs (19 available)**
 
 MCP integrations use reviewed local package runners or remote HTTPS endpoints. Security-sensitive local integrations use exact package pins where required; setup may globally cache selected tools for faster startup. Run `setup.sh` or `aidevops update-tools` to refresh managed tooling.
 
 | MCP | Purpose | Tier | API Key Required |
 |-----|---------|------|------------------|
-| [Augment Context Engine](https://docs.augmentcode.com/context-services/mcp/overview) | Semantic codebase retrieval | Global | Yes (Augment account) |
 | [Claude Code MCP](https://github.com/steipete/claude-code-mcp) | Claude as sub-agent | Global | No |
 | [Amazon Order History](https://github.com/marcusquinn/amazon-order-history-csv-download-mcp) | Order data extraction | Per-agent | No |
 | [Chrome DevTools](https://chromedevtools.github.io/devtools-protocol/) | Browser debugging & automation | Per-agent | No |
@@ -1503,7 +1503,6 @@ These use direct API calls via curl, avoiding MCP server startup entirely:
 
 **Context & Codebase:**
 
-- [Augment Context Engine](https://docs.augmentcode.com/context-services/mcp/overview) - Semantic codebase retrieval with deep code understanding
 - [llm-tldr](https://github.com/parcadei/llm-tldr) - Semantic code analysis with 95% token savings ([details below](#llm-tldr---semantic-code-analysis))
 - [Context7](https://context7.com/) - Real-time documentation access for thousands of libraries
 - [Repomix](https://github.com/yamadashy/repomix) - Pack codebases into AI-friendly context
@@ -1848,84 +1847,6 @@ Repomix runs as an MCP server for direct AI assistant integration:
 
 See `.agents/tools/context/context-builder.md` for complete documentation.
 
-## **Augment Context Engine - Semantic Codebase Search**
-
-[Augment Context Engine](https://docs.augmentcode.com/context-services/mcp/overview) provides semantic codebase retrieval - understanding your code at a deeper level than simple text search. It's the recommended tool for real-time interactive coding sessions.
-
-### Why Augment Context Engine?
-
-| Feature | grep/glob | Augment Context Engine |
-|---------|-----------|------------------------|
-| Text matching | Exact patterns | Semantic understanding |
-| Cross-file context | Manual | Automatic |
-| Code relationships | None | Understands dependencies |
-| Natural language | No | Yes |
-
-Use it to:
-
-- Find related code across your entire codebase
-- Understand project architecture quickly
-- Discover patterns and implementations
-- Get context-aware code suggestions
-
-### Quick Setup
-
-```bash
-# 1. Install Auggie CLI (requires Node.js 22+)
-npm install -g @augmentcode/auggie@prerelease
-
-# 2. Authenticate (opens browser)
-auggie login
-
-# 3. Verify installation
-auggie token print
-```
-
-### MCP Integration
-
-Add to your AI assistant's MCP configuration:
-
-**OpenCode** (`~/.config/opencode/opencode.json`):
-
-```json
-{
-  "mcp": {
-    "augment-context-engine": {
-      "type": "local",
-      "command": ["auggie", "--mcp"],
-      "enabled": true
-    }
-  }
-}
-```
-
-**claude-code CLI**:
-
-```bash
-claude mcp add-json auggie-mcp --scope user '{"type":"stdio","command":"auggie","args":["--mcp"]}'
-```
-
-### Verification
-
-Test with this prompt:
-
-```text
-What is this project? Please use codebase retrieval tool to get the answer.
-```
-
-The AI should provide a semantic understanding of your project architecture.
-
-### Repomix vs Augment Context Engine
-
-| Use Case | Tool | When to Use |
-|----------|------|-------------|
-| **Interactive coding** | Augment Context Engine | Real-time semantic search during development |
-| **Share with external AI** | Repomix | Self-contained snapshot for ChatGPT, Claude web, etc. |
-| **Architecture review** | Repomix (compress) | 80% token reduction, structure only |
-| **CI/CD integration** | Repomix GitHub Action | Automated context in releases |
-
-See `.agents/tools/context/augment-context-engine.md` for complete documentation.
-
 ### llm-tldr - Semantic Code Analysis
 
 [llm-tldr](https://github.com/parcadei/llm-tldr) extracts code structure and semantics, saving ~95% tokens compared to raw code. From the [Continuous-Claude](https://github.com/parcadei/Continuous-Claude-v3) project.
@@ -2073,6 +1994,12 @@ Primary agents live at `.agents/<name>.md`. Each is a domain expert with its own
 
 The `aidevops-` prefix differentiates framework commands from each client's native slash commands and groups them alphabetically in the command picker. It applies to **every** aidevops slash command — not just main agents — so `/aidevops-preflight`, `/aidevops-release`, `/aidevops-commit` etc. all sort together in your `/` menu.
 
+Codex setup/update also installs global `AGENTS.md` guidance, native workflow
+skills and compatible lifecycle hooks. Build+ loads by default; use `/skills`
+for workflows and `/hooks` to review/trust new hooks. Existing personal settings
+are preserved. For full-access launch flags and runtime differences, see
+[Codex CLI integration](.agents/tools/ai-assistants/codex-cli.md).
+
 #### Supported AI clients (14)
 
 The framework installs itself across these clients. Slash commands, agent definitions, and (optionally) session-memory mining are wired up per-client by `setup.sh`, gated on per-client feature flags in `.agents/scripts/runtime-registry.sh`.
@@ -2081,7 +2008,7 @@ The framework installs itself across these clients. Slash commands, agent defini
 |---|---|---|---|---|
 | OpenCode | ✅ `~/.config/opencode/command/` | config-based | ✅ default | Native tab-through primary agents |
 | Claude Code | ✅ `~/.claude/commands/` | ✅ `~/.claude/agents/` | ✅ default | Full feature parity |
-| Codex CLI | ✅ `~/.codex/prompts/` | — | ✅ default | Invoked as `/prompts:aidevops-<name>` |
+| Codex CLI | ✅ native skills + legacy `~/.codex/prompts/` | Workflow skills | ✅ default | `$aidevops-<name>`; legacy `/prompts:aidevops-<name>` |
 | Cursor | ✅ `~/.cursor/commands/` (≥1.6) | ✅ `~/.cursor/agents/` | ✅ default | Frontmatter stripped (not supported) |
 | Droid (Factory) | ✅ `~/.factory/commands/` | — | opt-in | — |
 | Gemini CLI | ✅ `~/.gemini/commands/` | — | opt-in | Converted to TOML (`prompt = """..."""`) |

package/VERSION

@@ -1 +1 @@
-3.32.308
+3.32.310

package/aidevops.sh

@@ -5,7 +5,7 @@
 # AI DevOps Framework CLI
 # Usage: aidevops <command> [options]
 #
-# Version: 3.32.308
+# Version: 3.32.310
 
 set -euo pipefail
 
@@ -1631,12 +1631,12 @@ _main_check_version() {
 	cli_version=$(get_version)
 	[[ -f "$AGENTS_DIR/VERSION" ]] && agents_version=$(cat "$AGENTS_DIR/VERSION") || agents_version="not installed"
 	if [[ "$agents_version" == "not installed" ]]; then
-		echo -e "${YELLOW}[WARN]${NC} Agents not installed. Run: aidevops update"
-		echo ""
+		echo -e "${YELLOW}[WARN]${NC} Agents not installed. Run: aidevops update" >&2
+		echo "" >&2
 	elif [[ "$cli_version" != "$agents_version" ]]; then
-		echo -e "${YELLOW}[WARN]${NC} Version mismatch - CLI: $cli_version, Agents: $agents_version"
-		echo -e "       Run: aidevops update"
-		echo ""
+		echo -e "${YELLOW}[WARN]${NC} Version mismatch - CLI: $cli_version, Agents: $agents_version" >&2
+		echo -e "       Run: aidevops update" >&2
+		echo "" >&2
 	fi
 	return 0
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aidevops",
-  "version": "3.32.308",
+  "version": "3.32.310",
   "description": "AI DevOps Framework - AI-assisted development workflows, code quality, and deployment automation",
   "type": "module",
   "packageManager": "bun@1.3.11",

package/setup.sh

@@ -17,7 +17,7 @@ fi
 # AI Assistant Server Access Framework Setup Script
 # Helps developers set up the framework for their infrastructure
 #
-# Version: 3.32.308
+# Version: 3.32.310
 #
 # Quick Install:
 #   npm install -g aidevops && aidevops update          (recommended)