move to proper location

conductor/archive/gemini_cli_parity_20260225/index.md

@@ -0,0 +1,5 @@
+# Track gemini_cli_parity_20260225 Context
+
+- [Specification](./spec.md)
+- [Implementation Plan](./plan.md)
+- [Metadata](./metadata.json)

conductor/archive/gemini_cli_parity_20260225/metadata.json

@@ -0,0 +1,8 @@
+{
+  "track_id": "gemini_cli_parity_20260225",
+  "type": "feature",
+  "status": "new",
+  "created_at": "2026-02-25T00:00:00Z",
+  "updated_at": "2026-02-25T00:00:00Z",
+  "description": "Make sure gemini cli behavior and feature set have full parity with regular direct gemini api usage in ai_client.py and elsewhere"
+}

conductor/archive/gemini_cli_parity_20260225/plan.md

@@ -0,0 +1,32 @@
+# Implementation Plan: Gemini CLI Parity
+
+## Phase 1: Infrastructure & Common Logic
+- [x] Task: Initialize MMA Environment `activate_skill mma-orchestrator`
+- [x] Task: Audit `gemini_cli_adapter.py` and `ai_client.py` for parity gaps (Findings: missing count_tokens, safety settings, and robust system prompt handling in CLI adapter)
+- [x] Task: Implement common logging utilities for CLI bridge observability
+- [x] Task: Conductor - User Manual Verification 'Infrastructure & Common Logic' (Protocol in workflow.md)
+
+## Phase 2: Token Counting & Safety Settings
+- [x] Task: Write failing tests for token estimation in `GeminiCLIAdapter`
+- [x] Task: Implement token counting parity in `GeminiCLIAdapter`
+- [x] Task: Write failing tests for safety setting application in `GeminiCLIAdapter`
+- [x] Task: Implement safety filter application in `GeminiCLIAdapter`
+- [x] Task: Conductor - User Manual Verification 'Token Counting & Safety Settings' (Protocol in workflow.md)
+
+## Phase 3: Tool Calling Parity & System Instructions
+- [x] Task: Write failing tests for system instruction usage in `GeminiCLIAdapter`
+- [x] Task: Implement system instruction propagation in `GeminiCLIAdapter`
+- [x] Task: Write failing tests for tool call/response mapping in `cli_tool_bridge.py`
+- [x] Task: Synchronize tool call handling between bridge and `ai_client.py`
+- [x] Task: Conductor - User Manual Verification 'Tool Calling Parity & System Instructions' (Protocol in workflow.md)
+
+## Phase 4: Final Verification & Performance Diagnostics
+- [x] Task: Implement automated parity regression tests comparing CLI vs Direct API outputs
+- [x] Task: Verify bridge latency and error handling robustness
+- [x] Task: Conductor - User Manual Verification 'Final Verification & Performance Diagnostics' (Protocol in workflow.md)
+
+## Phase 5: Edge Case Resilience & GUI Integration Tests
+- [x] Task: Implement tests for context bleed prevention (filtering non-assistant messages)
+- [x] Task: Implement tests for parameter name resilience (dir_path/file_path aliases)
+- [x] Task: Implement tests for tool call loop termination and payload persistence
+- [x] Task: Conductor - User Manual Verification 'Edge Case Resilience' (Protocol in workflow.md)

conductor/archive/gemini_cli_parity_20260225/spec.md

@@ -0,0 +1,27 @@
+# Specification: Gemini CLI Parity
+
+## Overview
+Achieve full functional and behavioral parity between the Gemini CLI integration (`gemini_cli_adapter.py`, `cli_tool_bridge.py`) and the direct Gemini API implementation (`ai_client.py`). This ensures that users leveraging the Gemini CLI as a headless backend provider experience the same level of capability, reliability, and observability as direct API users.
+
+## Functional Requirements
+- **Token Estimation Parity:** Implement accurate token counting for both input and output in the Gemini CLI adapter to match the precision of the direct API.
+- **Safety Settings Parity:** Enable full configuration and enforcement of Gemini safety filters when using the CLI provider.
+- **Tool Calling Parity:** Synchronize tool definition mapping, call handling, and response processing between the CLI bridge and the direct SDK.
+- **System Instructions Parity:** Ensure system prompts and instructions are consistently passed and handled across both providers.
+- **Bridge Robustness:** Enhance the `cli_tool_bridge.py` and adapter to improve latency, error handling (retries), and detailed subprocess observability.
+
+## Non-Functional Requirements
+- **Observability:** Detailed logging of CLI subprocess interactions for debugging.
+- **Performance:** Minimize the overhead introduced by the bridge mechanism.
+- **Maintainability:** Ensure that future changes to `ai_client.py` can be easily mirrored in the CLI adapter.
+
+## Acceptance Criteria
+- [ ] Token counts for identical prompts match within a 5% margin between CLI and Direct API.
+- [ ] Safety settings configured in the GUI are correctly applied to CLI sessions.
+- [ ] Tool calls from the CLI are successfully executed and returned via the bridge without loss of context.
+- [ ] System instructions are correctly utilized by the model when using the CLI.
+- [ ] Automated tests verify that responses and tool execution flows are identical for both providers.
+
+## Out of Scope
+- Performance optimizations for the `gemini` CLI binary itself.
+- Support for non-Gemini CLI providers in this track.