v2.0.1 MLCon Edition

This release raises the IntelliJ baseline to 2025.3+ (build 253), resolves all remaining platform deprecation warnings, and achieves full parity between the VS Code and IntelliJ extensions.

IntelliJ Platform Upgrade (233 → 253+)

• Minimum IntelliJ version: Raised from 2023.3 (build 233) to 2025.3 (build 253).
• Java target: Upgraded from 17 to 21 (required for 253+).
• Kotlin compiler: Upgraded from 1.9.21 to 2.0.21 (matches IntelliJ 2025.3 bundled Kotlin).

All Deprecated API Warnings Resolved

• AnActionEvent.createFromInputEvent() → removed. ActionInvoker now uses ActionManager.tryToExecute() directly (no manual event construction needed).
• AnAction.update() external call → removed (was an @OverrideOnly violation). tryToExecute() handles update checks internally.
• CredentialAttributes(serviceName, key, user) 3-param → 2-param CredentialAttributes(serviceName, user) with generateServiceName. (2 usages)
• Plugin Verifier: 0 scheduled-for-removal, 0 override-only, 0 deprecated.
• Verifier IDE list expanded to full 9-version matrix (2023.3–2026.2 EAP).

IntelliJ UX Fixes

• Init button: Now runs .qonqrete/qonqrete.sh init from project root instead of cd .qonqrete/ && ./qonqrete.sh init. Fixes /bin/bash: ./qonqrete.sh: is a directory error when a directory exists at the project root with the same name.
• First-launch dialog crash: Removed erroneous isModal = false that caused showAndGet() to throw IllegalStateException during deploy-to-workspace.
• Qonstruction name prompt: Now only shown when noSync (skip repo-root sync) is enabled. When sync-back is on, outputs go to repo root — no name needed. Best UX with minimal friction.
• QONQ_NON_INTERACTIVE=1 now injected into build environment to prevent blocking prompts during IDE-driven runs (matches VSCode behavior).

VS Code ↔ IntelliJ Full Alignment

• Default settings now identical:
  • defaultSensitivity: 3 → 1
  • defaultCycles: 3 → 1
  • noSync: false (was true in VSCode, now false in both)
  • useSqrapyard: false → true
• Provider list synced: Added mlx and llama-cpp local providers to IntelliJ (present in VSCode, previously missing from JetBrains).
• DeepSeek model list synced: Both IDEs now offer all 4 V4 variants: deepseek-v4-flash, deepseek-v4-flash-thinking, deepseek-v4-pro, deepseek-v4-pro-thinking.
• OpenRouter DeepSeek reference: Fixed from deepseek-chat-v3 to deepseek/deepseek-v4-flash (matching VSCode).
• tasq.md template: IntelliJ now uses the same rich template as VSCode, with tips, examples, and a guided structure.

VS Code Extension Fixes

• noSync default: Changed from true to false in package.json. Users opting for repo-root sync-back (default, easiest path) won’t see a qonstruction name prompt. Only users enabling skip-sync will be asked.
• Qonstruction name prompt: Made conditional on config.noSync === true across all 4 run entry points in runTasq.ts.

Why This Matters

v2.0.1 completes the MLCon Edition arc with full IDE parity. The IntelliJ and VS Code extensions now share identical defaults, provider lists, model offerings, UX flows, and runtime behavior — making QonQrete a consistent experience regardless of which IDE you use.

v1.4.6 MLCon Edition

This release ships core runtime fixes, the DeepSeek V4 model upgrade, and a fully clean IntelliJ Plugin Verifier bill across all supported IDE versions.

Core Runtime

• Fedora SELinux permission fix: Rootless Podman on SELinux-enforcing hosts (Fedora, RHEL) could not write to the bind-mounted workspace (/qonq/audit/timeline.md). The :z SELinux relabel flag cannot work in rootless mode (users lack privileges). Fix: --security-opt label=disable for rootless Podman on Linux. The container remains fully constrained by the user namespace, --cap-drop=ALL, --no-new-privileges, and --read-only rootfs.

• Interleaved validation cross-briq deferral: During multi-briq builds, the scoped qualifier would flag index.html referencing app.js as “missing local file” when app.js hadn’t been created yet by a later briq, blocking the build. Fixed: cross-scope missing file references are now deferred to the full deterministic validation pass.

• DeepSeek V4 model upgrade: Default models upgraded from the legacy deepseek-chat / deepseek-reasoner to the current V4 generation: deepseek-v4-flash, deepseek-v4-flash-thinking, deepseek-v4-pro, deepseek-v4-pro-thinking. Updated in model capabilities, pricing, default fallbacks, VS Code extension model picker, IntelliJ AI config UI, installer, and documentation. Legacy aliases retained for backward compat.

IntelliJ Plugin Verifier — Zero Warnings (2023.3–2026.2 EAP)

• AnActionEvent(...) constructor → AnActionEvent.createFromInputEvent() (scheduled for removal)
• AnAction.beforeActionPerformedUpdate() → AnAction.update() (override-only violation)
• CredentialAttributes(serviceName, key) → 3-param constructor with null className (deprecated, 2 usages)
• PluginManagerCore.getPlugin() → classloader META-INF/plugin.xml resource read (internal API, 2026.2 only)
• DeepSeek model names updated in plugin AI config UI

Result: 0 scheduled-for-removal, 0 override-only, 0 deprecated, 0 internal API.

Why This Matters

v1.4.6 rounds out the MLCon Edition arc with production-hardened runtime fixes, next-generation model defaults, and a clean IntelliJ Plugin Verifier bill that proves the plugin is compatible with all current and upcoming IDE versions without warnings.

v1.4.5 MLCon Edition

This release consolidates the MLCon 2026 arc — from the pre-conference sprint through live demo validation to post-conference IntelliJ hardening and license cleanup.

Truthful Inspection & Execution Control

• Final qodeyard/ files are authoritative review evidence
• Deterministic snippet metadata avoids prompt-clipping confusion
• Verdict synthesis prioritizes deterministic gates over advisory noise
• Plan/build/review/repair flows are structured with bounded repair loops

Runtime UX Cleanup

• Reduced heartbeat chatter, concise default stream rendering with optional raw mode
• ConstruQtor defaults to hybrid coding mode
• -N/--no-sync skips repo-root sync-back; outputs stay in qage/qonstruction paths for inspection

Provider & Model Alignment

• Primary defaults: venice / deepseek-v3.2 for primary AI agents
• Provider and model selection configurable per agent
• Local runtime support via mlx and llama-cpp

IntelliJ Plugin: Full JetBrains Ecosystem Coverage

• Verified compatibility with all IntelliJ-based IDEs: IDEA, PyCharm, WebStorm, GoLand, CLion, RubyMine, Rider, DataGrip, PhpStorm
• Resolved class loading issues on 2023.x IDE builds
• Fixed NoClassDefFoundError for ProgressManager on certain JetBrains runtime versions
• Corrected PluginException on startup for fresh installations
• CI matrix covers IntelliJ Platform 2023.2 through 2026.1 (eight parallel runners)

Canonical Versioning & Installer Hygiene

• Root VERSION file is the single source of truth across runtime, IDE plugins, and CI
• qonqrete.sh reads QONQ_VERSION from VERSION (fail-loud on missing/empty)
• The single install.sh at repo root serves as the source of truth, placed directly into the nginx image
• Versioned release archive qonqrete-v1.4.5.zip created

License Update

• LICENSE updated in this release

Why This Matters

QonQrete v1.4.5 is the consolidated MLCon Edition — structured execution with truthful inspection, controlled sync, full JetBrains IDE compatibility, canonical versioning across the entire deployment chain, and an updated license. The IntelliJ plugin now works reliably across the full JetBrains ecosystem, the install pipeline is version-consistent from top to bottom, and the controlled execution story proven at MLCon is backed by four rounds of post-conference polish.

🚀 v1.2.0 — Hassle-Free Bootstrap

This release transforms the QonQrete developer experience. Getting started is now three clicks: Deploy → Set API Keys → Run.

✅ New in v1.2.0

🔑 Secure API Key Management

• OS-level credential storage — Keys stored in system keychain, never in config files
• VS Code: Uses ExtensionContext.secrets (OS keychain API)
• IntelliJ: Uses PasswordSafe (encrypted credential store)
• Auto-migration — Old settings.json keys moved to secure storage
• Env var priority — Real environment variables always take precedence

🌐 Expanded AI Provider Support

• OpenRouter — Access 200+ models through a single API key
• Qwen — Re-implemented via DashScope OpenAI-compatible endpoint
• DeepSeek — Full support for deepseek-chat and deepseek-reasoner
• Gemini — Google AI with GOOGLE_API_KEY / GEMINI_API_KEY equivalence
• Anthropic — Claude models with streaming support
• OpenAI — GPT-4.1, o3-mini, o4-mini, and more

⚙️ IDE AI Configuration Commands

• Set AI Configuration — Interactive dialog for provider/model selection
• Per-agent configuration — TasqLeveler, InstruQtor, ConstruQtor, InspeQtor
• Model suggestions — Auto-populated based on selected provider
• Custom models — Enter any model name for your provider
• API key status — Visual indicator showing which keys are set

📦 Deploy to Workspace

• One-click install into .qonqrete/ directory
• Auto-gitignore — .qonqrete/ automatically added
• Version-tagged images — qonqrete-qage:1.2.0 for reproducibility
• Path priority — .qonqrete/qonqrete.sh preferred over legacy paths

📝 Root tasq.md Workflow

• Edit at project root — User-facing tasq.md at workspace root
• Auto-sync — Synced to runtime before each run
• Create Tasq command — Starter template with one click

🔄 GitHub Actions CI/CD

• VS Code extension — Automated VSIX build and release
• IntelliJ plugin — Automated ZIP build and release
• Runtime package — Core QonQrete distribution

📊 Full Component Matrix

🔐 Security Model

┌─────────────────────────────────────────────────┐
│           API KEY SECURITY FLOW                 │
├─────────────────────────────────────────────────┤
│                                                 │
│  1. User enters API key in IDE                  │
│              ↓                                  │
│  2. Stored in OS keychain (encrypted)           │
│              ↓                                  │
│  3. At runtime: injected into terminal env      │
│              ↓                                  │
│  4. Container receives via environment          │
│              ↓                                  │
│  5. Never written to disk, never logged         │
│                                                 │
│  Priority: ENV VAR > STORED SECRET > ERROR      │
│                                                 │
└─────────────────────────────────────────────────┘

🎯 Supported Providers & Models

🔧 Backward Compatible

• Legacy paths (qonqrete.sh at root, qonqrete/qonqrete.sh) still detected
• Legacy untagged qonqrete-qage image still works
• Existing worqspace-only workflows unchanged
• Old settings.json API keys auto-migrated to secure storage

💾 Local-First. Secure. Zero-Config.

🎉 IDE Integration Milestone: VS Code & IntelliJ Now Working!

This is a historic release for QonQrete. Both the VS Code extension and IntelliJ plugin are now fully functional and production-ready.

🚀 What This Means

• VS Code users: Install the extension, start building with QonQrete
• JetBrains users: Install the plugin, start building with QonQrete
• Both coming to official marketplaces — VS Code Marketplace and JetBrains Marketplace

✅ v1.1.9 Production Hardening

IntelliJ Plugin

• Gradle Wrapper: Ships VALID jar (builds from clean checkout)
• Marker Watcher: Uses daemon thread (proper JVM shutdown)
• Auto-Refresh: Tool window refreshes when run completes
• Status Widget: Shows version + run state
• CommandBuilder: Centralized command assembly with shell escaping
• QonQreteValidation: Input validation utility
• ShellEscape: Single source of truth for bash escaping
• “Clean All” Button: Bulk cleanup with confirmation
• “Open Tasq” Button: Quick tasq.md access
• Tooltips: All config controls have helpful tooltips
• Qage Timestamps: Displayed in qage list with artifact counts
• 40+ Unit Tests: Comprehensive coverage

VS Code Extension

• Version sync with IntelliJ plugin
• Consistent CLI integration

📊 Full Component Matrix

🎯 What’s Next

• VS Code Marketplace: Official listing
• JetBrains Marketplace: Official listing
• Documentation: IDE-specific quickstart guides
• Video tutorials: Coming to WoNQ.TV

🏗️ Architecture Overview

┌─────────────────────────────────────────────────────────────┐
│                    QonQrete v1.1.9                          │
├─────────────────────────────────────────────────────────────┤
│  IDE Layer                                                   │
│  ┌──────────────────┐  ┌──────────────────┐                 │
│  │  VS Code Ext     │  │  IntelliJ Plugin │                 │
│  │  (TypeScript)    │  │  (Kotlin)        │                 │
│  └────────┬─────────┘  └────────┬─────────┘                 │
│           │                     │                           │
│           └──────────┬──────────┘                           │
│                      ▼                                      │
│  ┌──────────────────────────────────────────────────────┐   │
│  │              QonQrete CLI (qonqrete.sh)              │   │
│  └──────────────────────────────────────────────────────┘   │
│                      │                                      │
│                      ▼                                      │
│  ┌──────────────────────────────────────────────────────┐   │
│  │                   Qrane (Orchestrator)                │   │
│  └──────────────────────────────────────────────────────┘   │
│                      │                                      │
│                      ▼                                      │
│  ┌──────────────────────────────────────────────────────┐   │
│  │  InstruQtor → ConstruQtor → InspeQtor → QontractGuard│   │
│  └──────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────┘

💾 Local-First. File-Based. Secure. Now IDE-Native.

🔧 IDE Plugin Hardening

This release focuses on production hardening for both IDE plugins.

✅ IntelliJ Plugin Fixes

• Unix Execution: Now ALWAYS uses verified bash (not system default)
• Command Construction: Proper shell escaping for all commands
• autoOpenToolWindowOnRun: Actually works now
• Artifact Browser: Full per-file click-to-open functionality
• Repo Discovery: Handles ambiguity with persistence
• gradle-wrapper.jar: Now ships a VALID jar (was HTML placeholder)

✅ VS Code Extension Fixes

• Unix Bash Wrapping: Proper shell execution on Unix systems
• Command Construction: Consistent argument handling

🧪 Testing

• Added comprehensive unit tests for both plugins
• Fixed weak test coverage in IntelliJ plugin

📦 What’s Included

🧠 IntelliJ Plugin: JetBrains IDE Support

This release brings QonQrete to the JetBrains ecosystem with a fully native IntelliJ IDEA plugin.

✅ What’s New

• IntelliJ Plugin (v1.1.7): Native Kotlin implementation
• Tool Window Panel: Full worQspace visualization
• Settings Configurable: IDE-native settings integration
• Status Widget Factory: Status bar integration
• Action Suite: Full set of QonQrete actions

🎯 Supported IDEs

• IntelliJ IDEA (Community & Ultimate)
• WebStorm
• PyCharm
• PhpStorm
• All JetBrains IDEs (2023.3+)

🔧 Features

📦 Installation

# Build from source
cd intellij-plugin
./gradlew buildPlugin

# Install from disk in IDE
# Settings → Plugins → ⚙️ → Install from Disk

🏗️ Architecture

sh.qonqrete.intellij/
├── actions/          // IDE actions
├── services/         // Project services
├── ui/               // Tool windows & widgets
└── util/             // CommandBuilder, validation

🚀 VS Code Extension: IDE Integration Begins

This release marks a major milestone: QonQrete now has a first-class VS Code extension.

✅ What’s New

• VS Code Extension (v1.0.0): Full integration with the QonQrete CLI
• Sidebar Panel: View worQspace status, run history, and qage navigation
• Run TasQ Command: Start QonQrete runs directly from VS Code
• Config Wizard: Interactive configuration setup
• Status Bar: Live feedback on QonQrete run state

🎯 Why This Matters

No more terminal hopping. The extension brings QonQrete’s local-first, file-based AI orchestration directly into your development workflow.

📦 Installation

# From VSIX
code --install-extension qonqrete-1.1.0.vsix

# Or search "QonQrete" in VS Code Marketplace (coming soon)

🔧 Features

🛡️ QONTRACT Lockdown: Predictability by Design

This release is about repeatable runs: tightened, predictable, anti-drift enforced.

✅ What’s New

• QontractGuard: enforces QONTRACT invariants + rule sets (contracts > vibes)
• InspeQtor + QontractGuard loop: keeps cyQles convergent, reduces drift
• UserGate mode: per-cyQle steering (edit ReQap, adjust direction, continue)
• File-based audit trail: decisions and outputs stay inspectable on disk

📁 Run Artifacts (Audit Trail)

🔐 Keep Code Out of Cloud AI

You can feed agents only qontext.d/, bloq.d/, tasq*, and qontract* artifacts instead of your full repo, while preserving a complete audit trail locally.

🧱 Batched Briq Generation (Blueprint → Fabrication)

High-sensitivity builds (>= 8) now avoid output truncation by generating briqs in two phases:

1. Blueprint (JSON): titles/objectives list (no truncation risk)
2. Fabrication (Batched): full briq content generated in safe chunks

Configuration

instruqtor:
  batch_mode: true
  batch_size: 5

Example

./qonqrete.sh run -b 10 -c 4 -a

This reliably produces 50–250+ briqs without token-limit truncation, unlocking enterprise-scale task decomposition.

🔥 Inverted Briq Sensitivity Scale (0–16)

The scale is now intuitive: higher number = more briqs.

🤖 Non-Interactive Qonstruction Save (-n)

./qonqrete.sh run -a -b 6 -c 3 -n myproject

Auto-saves to worqspace/qonstructions/ and cleans up the original Qage.

🌀 Gemini-Only Qontrabender

Qontrabender is now skipped when the ConstruQtor provider isn’t Gemini, reducing unnecessary overhead for other providers.

🧯 Hotfix: HuggingFace Cache Permissions in Hardened Docker

This release fixes a critical error when using Qontextor in local_mode: complex (semantic embeddings) inside the hardened container.

The Problem (v1.0.0-stable)

The hardened runtime mounts a tmpfs over /home/qrane/.cache, which can force runtime model downloads and trigger permission/lock failures.

The Fix (v1.0.1-stable)

• Pre-cache all-MiniLM-L6-v2 during build into /opt/hf_cache
• Export:
  • HF_HOME=/opt/hf_cache
  • SENTENCE_TRANSFORMERS_HOME=/opt/hf_cache
  • TRANSFORMERS_CACHE=/opt/hf_cache
• Qontextor:
  • Sets env vars before imports
  • Catches PermissionError and falls back to AST-only analysis

Upgrade Note

Rebuild the container:

./qonqrete.sh init

🎉 THE PRODUCTION RELEASE!

After months of intensive development and 90 validation runs across the WoNQ Matrix testing framework, QonQrete v1.0.0-stable is ready for prime time!

🔥 Critical Fix #1: Bulletproof Language Detection

The Problem (v0.9.x)

When using OpenAI as the AI provider, code blocks like ```py would create files named “py” instead of being skipped:

# AI output:                  # Result (WRONG):
```py                         → File "py" created
print("hello")                  (should have been skipped!)

The Fix (v1.0.0-stable)

The language_keywords set expanded from 23 entries to 400+ entries!

Provider Compatibility

🔥 Critical Fix #2: Enforced Briq Sensitivity

The Problem (v0.9.x)

Previously, briq_sensitivity was just a “hint” to the AI, resulting in wildly inconsistent outputs.

The Fix (v1.0.0-stable)

Briq counts are now ENFORCED with hard min/max ranges:

Enforcement Logic:

1. AI generates briqs with MANDATORY count prompt
2. System checks if count is within range
3. Too few → Retry with stronger prompt (up to 2 retries)
4. Too many → Merge consecutive briqs to meet max
5. Log compliance: [OK] Briq count 4 is within range [3-5]

🆕 New CLI Features

# Default: 4 cycles
./qonqrete.sh run

# Override to 6 cycles for complex projects
./qonqrete.sh run -c 6

# Combine with sensitivity for full control
./qonqrete.sh run -b 5 -c 6  # Complex project config
./qonqrete.sh run -b 7 -c 4  # Simple project config (default)

⚙️ Configuration Changes

🧪 WoNQ Matrix Validation

90 validation runs across every combination of sensitivity levels (0-9) and cycle counts (1-9):

╔═══════════════════════════════════════════════════════════════╗
║                 WoNQ MATRIX RESULTS                           ║
╠═══════════════════════════════════════════════════════════════╣
║ Total Runs:           90 (100% coverage)                      ║
║ Clean Completions:    90 (100% success)                       ║
║ Champion Score:       658 (sensitivity=3, cycle=7)            ║
║ Global Average:       554                                     ║
║ Scores ≥600:          35.6%                                   ║
╚═══════════════════════════════════════════════════════════════╝

Key Findings

1. Sweet Spot: Sensitivity 2-4 with 5-7 cycles produces the best results
2. Champion Config: sens=3, cycle=7 consistently hits peak performance
3. Avoid: Sensitivity ≥7 shows diminishing returns; Cycle 8 is a “death valley”

💰 Cost Efficiency

📊 Diff Summary

Total: +536 lines of production hardening

📋 Migration Guide

From v0.9.9-beta

1. No breaking changes - Drop-in replacement
2. Update config.yaml (optional):

   briq_sensitivity: 7  # was 5
   auto_cycle_limit: 4  # was 0
   

3. No container rebuild required

✅ Checklist

• All tests passing
• 90 WoNQ Matrix validation runs complete
• Multi-provider compatibility verified
• Documentation updated
• RELEASE-NOTES.md updated
• VERSION bumped to 1.0.0-stable
• No breaking changes from v0.9.9-beta

QonQrete is ready for prime time! 🗝️

🎯 Summary

Final stabilization release before v1.0.0. Fixes critical bugs discovered during multi-cycle autonomous builds, cleans up console output, and removes broken dependencies.

🐛 Bug Fixes

v0.9.8 (included)

v0.9.9

📝 Files Changed

Core Pipeline

• worqer/construqtor.py - Skeleton detection before write
• worqer/qontextor.py - Removed broken pycg, uses jedi only
• worqer/inspeqtor.py - Internal LoQal verification (Stage 3)
• worqspace/pipeline_config.yaml - Removed standalone loqal_verifier

Console Output

• qrane/qrane.py - Updated VISIBLE_KEYWORDS, BLOCKED_KEYWORDS, CONTENT_FILTER_PATTERNS

Dependencies

• requirements.txt - Removed pycg (broken package)

Documentation

• All docs updated to v0.9.9-beta
• doc/RELEASE-NOTES.md - Added v0.9.8 and v0.9.9 sections

✅ Verified Features

🔄 Migration

# Rebuild container (requirements.txt changed)
./qonqrete.sh init

🧪 Testing Done

• Multi-cycle autonomous builds (3+ cycles)
• Syntax validation on all Python files
• Verified skeleton detection works
• Verified console output is cleaner

📊 Console Output Before/After

Before v0.9.9:

〘aQQ〙『tasQleveler』⸎ ## 📋 Overview
〘aQQ〙『tasQleveler』⸎ ## 📦 Dependency Graph
〘aQQ〙『tasQleveler』⸎ # 🎯 Golden Path Test:
〘aQQ〙『inspeQtor』  ⸎ |-----|---------|-----|
〘aQQ〙『inspeQtor』  ⸎ -- Batch 1/1: 6 briqs --
〘aQQ〙『Qontextor』  ⸎ - [WARN] pycg not found...

After v0.9.9:

〘aQQ〙『tasQleveler』⸎ [TasqLeveler] ✅ Enhanced tasq: 180 lines
〘aQQ〙『inspeQtor』  ⸎ === InspeQtor v0.9.0 Complete: [SUCCESS] ===

Ready for v1.0.0 🚀

🚀 TasqLeveler Agent - Automatic Tasq Enhancement

The Big Idea: A well-structured tasq.md = dramatically better output quality. So why not let AI enhance your tasq automatically?

TasqLeveler is a new agent that runs ONCE on Cycle 1, BEFORE InstruQtor. It supercharges your tasq.md with:

🔧 Universal File Rule (s00permode)

The Problem: Previous “refinement mode” approach was too restrictive - it artificially limited what cycles 2+ could do, potentially blocking legitimate new file creation.

The Solution: Removed all mode-based logic. Replaced with ONE simple universal rule that applies to ALL cycles:

📁 File EXISTS in qodeyard? → MODIFY it or EXTEND it. Never recreate it. 📄 File DOESN’T EXIST yet? → CREATE it.

This prevents the rebuild-from-scratch bug while maintaining full creative freedom.

✅ Confirmed: Batched Reviews Working Perfectly!

Deep analysis of v0.8.7 production run (28 briqs, 7 cyQles) confirmed:

• Zero [UNKNOWN] assessments - batch parsing working correctly
• All [FAILURE] results are real AI assessments, not parse failures
• Retry mechanism working - briq027 failed once (Gemini API error), succeeded on attempt 2
• Cost efficiency achieved - 28 briqs reviewed in 3 batches for ~$0.01 total

🔧 LoQal Verifier Display Fix

Problem: “Running local validation…” was showing under construQtor in the event log, but it’s conceptually part of inspeQtor’s LoQal Verification stage.

Fix: Changed display to use [LoQal] prefix for clearer attribution.

🎯 Default Config Updates

Updated config.yaml with production-ready defaults, including upgrading construQtor to gemini-2.5-pro.

🐛 Bug Fix: Display Filter Was Completely Broken

Problem: ConstruQtor and InspeQtor status messages weren’t showing in the event log at all.

Root Cause: The is_content_line() function was being called BEFORE checking VISIBLE_KEYWORDS, and it was matching patterns in legitimate status lines.

Fix: Complete rewrite of display filter logic to prioritize VISIBLE_KEYWORDS and apply content filtering only to lines without visible keywords.

🚀 Major: Batched Reviews (90% Fewer API Calls!)

The Problem: v0.8.5 with per-briq reviews made 77+ API calls per cycle, burning $16+ with GPT-4.1.

The Solution: Batched reviews group multiple briqs into single API calls, resulting in up to 90% savings.

💰 New Default: Gemini 2.5 Flash-Lite

All agents now default to gemini-2.5-flash-lite ($0.10/$0.40 per 1M tokens), providing a 75-95% cost reduction compared to previous models.

🚨 TOKEN BURN FIX - CRITICAL

Problem Identified: Running InspeQtor with gpt-4.1 (not mini) on 77 briqs × 2 stages = ~154 AI calls burned ~$25 in a single run.

Root Cause: InspeQtor was configured with gpt-4.1 ($2.00/$8.00 per 1M tokens) instead of gpt-4.1-mini ($0.40/$1.60 per 1M tokens).

✨ New Features

1. Cost Estimation Display

InstruQtor and InspeQtor now show estimated costs before AI calls.

2. Cleaner Display Filter System

Completely overhauled the display filter to suppress noise from per-briq assessments and logs.

🐛 Bug Fixes

1. Fixed Empty/Invalid __init__.py Files Being Written

Problem: AI sometimes outputs empty code blocks resulting in files containing just ``` (markdown fence) instead of valid Python.

Fix: Improved code block regex parser to skip files with empty or invalid content.

2. Improved Import Resolution in LoQal Verifier

Problem: Import checker was flagging src.utils.logger as missing even when src/utils/logger.py existed.

Fix: Enhanced import resolution to search recursively for module names.

✨ New Features & Enhancements

1. Interleaved Pipeline (Build → Validate → Build → Validate)

ConstruQtor now processes each briq with interleaved validation, running local syntax and import checks after each build step.

2. Per-Briq ExeQ Summaries

ConstruQtor now writes execution summaries to exeq.d/cyqle{N}/ for each briq.

3. Smarter LoQal Verifier Skeleton Matching

Fixed false positive warnings for standard library imports and typing constructs.

✨ LoQal Verifier Integration

Integrated a deterministic local verification agent that runs after ConstruQtor.

What It Checks (NO AI Required)

1. Syntax Validation: python -m py_compile on all .py files
2. Import Resolution: Verifies local imports resolve to actual files
3. Skeleton Signature Matching: Ensures functions exist that are called elsewhere

Self-Healing Feedback Loop

Verification errors are appended to the reqap.md, which is read by InstruQtor in the next cycle, creating a self-healing feedback loop.

✨ ConstruQtor Per-Briq Retry

Added configurable retry mechanism for individual briq failures:

# config.yaml
agents:
  construqtor:
    max_attempts: 3           # Retry failed briqs up to 3 times
    stop_on_briq_fail: true   # Stop cycle if briq fails after all retries

• ConstruQtor now tracks attempts per briq
• Failed briqs are retried with error context appended to prompt
• Status output shows attempt count: [✅ SUCCESS] (attempts: 2)
• Configurable stop_on_briq_fail - set false to continue despite failures

🌀 Qontrabender - The Cache Bender

A new agent that manages hybrid caching with intelligent content classification:

• Variable Fidelity: Mixes MEAT (full code) + BONES (skeletons) based on file importance
• Policy-Driven Configuration: All behavior controlled via caching_policy.yaml
• Multiple Operational Modes: 6 pre-configured modes for different use cases
• Schema Validation: YAML validation prevents bad configuration from breaking the flow
• Improved Volatile Detection: Cycle-based, diff-based, git diff, and mtime fallback

📊 Triple-Core Memory System

QonQrete now features a Triple-Core Memory System:

This release introduces a major upgrade to the qontextor agent, enabling a fully local, deterministic, and highly detailed analysis of the codebase. This new “Local Qontextor Stack” significantly reduces reliance on AI for context generation, leading to massive cost savings, increased speed, and enhanced privacy.

✨ New Features & Major Enhancements

1. Fully Local qontextor Agent

The qontextor agent can now run in a completely local mode (provider: local in config.yaml), which is the new default. This mode uses a sophisticated stack of local analysis tools to build a deep understanding of the codebase without any AI calls.

2. The Local Qontextor Stack

The new local mode is powered by a multi-layered analysis stack:

• Python AST: For extracting the fundamental structure of the code (classes, functions, signatures).
• Docstrings & Verb Heuristics: To understand the purpose of code, either from existing documentation or by inferring it from function names.
• Jedi: For static analysis, providing type inference and cross-file relationship understanding.
• PyCG: To generate a comprehensive call graph, mapping out dependencies and execution flow.

3. Fast vs. Complex Local Modes

The local qontextor can be fine-tuned for speed or detail:

• local_mode: 'fast': Provides a very fast analysis using AST, Jedi, and heuristics.
• local_mode: 'complex': Enhances the analysis by using a local sentence-transformers model to create deep semantic embeddings of the code’s purpose.

4. qontextor CLI Helpers

The qontextor agent can now be invoked directly from the command line:

• python3 worqer/qontextor.py --query "<search_term>": Performs a semantic search for symbols.
• python3 worqer/qontextor.py --verb "<verb_pattern>": Finds symbols matching a verb pattern.
• python3 worqer/qontextor.py --ripple "<symbol_name>": Analyzes the ripple effect of changing a symbol.

5. Enforced Verb Usage for construQtor

The construQtor agent’s prompt has been updated to enforce strict naming conventions for functions and methods.

6. Increased Verbosity for Agents

qompressor and qontextor now provide more verbose output, printing each file they process.

🐛 Bug Fixes

• Fixed a NameError in the inspeqtor agent that was causing it to crash during the review phase.
• Fixed a NameError in the qontextor agent related to the extract_first_sentence function.
• Added a docker system prune command to qonqrete.sh to prevent “No space left on device” errors.

🚀 Performance & Cost

• Indexing Cost: Reduced to zero when using the local qontextor.
• Cost per Run: Up to 25x cheaper due to massive reduction in tokens sent to AI providers.
• Speed: Approximately 3x faster on average due to smaller prompts and local processing.

Added

• Dynamic Local Agent Loader: Implemented a dynamic local agent loader in qrane/qrane.py, allowing agents configured with provider: local in config.yaml to dynamically load and execute corresponding Python scripts from the worqer directory based on their model name.

Changed

• qrane.py: Modified run_orchestration to dynamically determine agent script paths for local providers.
• Dockerfile: Added npm install -g @qwen-code/qwen-code@latest to install the Qwen CLI tool.
• lib_ai.py: Modified _run_qwen to pass prompts to the qwen CLI via standard input instead of command-line arguments.

Fixed

• QWEN_API_KEY Environment Variable: Ensured qonqrete.sh passes QWEN_API_KEY to the container.
• construQtor Briq Processing: Improved construQtor’s handling of briqs.

v0.6.2-beta - 2025-12-18

Added

• “local” Provider: Implemented a “local” provider for offline agents like calqulator and qompressor.
• Qwen Model Testing: Tested qwen-turbo, qwen-coder, and qwen-max models.

Changed

• Default Briq Format: The instruqtor now defaults to a more reliable markdown-based format for briqs.

Fixed

• AI Reliability: The new markdown format for briqs significantly improves reliability.

v0.6.1-beta - 2025-12-16

Added

• Qwen Provider Integration: Integrated the Qwen AI provider into the system.
• New Documentation: Added extensive documentation on core concepts:
  • CONTEXT.md, MEMORY.md, MINDSTACK.md, MINDSTACK_ARCH.md, QWEN_90K_FIX.md, SKELETON.md

Changed

• Default Task: Updated worqspace/tasq.md to a more complex task for better testing.

This release introduces the Qompressor and Qontextor agents, forming a “Dual-Core” memory system that dramatically reduces cost and increases speed.

The Numbers

The Scenario: A medium-sized project (50 files, ~10,000 lines of code).

• Raw Size: ~100,000 Tokens.

Summary: You are paying 4% of the cost for 100% of the intelligence.

New Agents

• Qompressor (The Skeletonizer): Creates a low-token “skeleton” of the codebase in bloq.d. Provides architectural context with zero token cost.
• Qontextor (The Symbol Mapper): Uses AI to analyze skeletonized code and generate a detailed YAML map of symbols, purposes, and dependencies in qontext.d.
• CalQulator (The Cost Estimator): Analyzes briQ files to provide token and cost estimates for the upcoming construqtor cycle.
• FunQtions Library: New shared library qrane/lib_funqtions.py for common utility functions.

Bug Fixes

• Loader Spinner: Fixed blocking spinner animation using select.select() loop.
• Calqulator Output: Restored visibility of cost calculation table in headless mode.
• Briq Filenames: Corrected double underscores in briq filenames.

Added

• Comprehensive Test Suite: Introduced a new TESTS.md file outlining a full suite of functional tests, including a provider and model matrix, mode and briq sensitivity matrix, and edge/regression scenarios.
• Extensive Model Support: Added and verified support for a wide range of new models from OpenAI, Google, Anthropic, and DeepSeek.

Fixed

• Gemini API response.text error: Critical bug fix for crashes when Gemini API returned blocked/empty responses.
• Assessment Parsing: More robust parsing for the inspeqtor’s assessment output.

v0.4.9-alpha - 2025-12-07

Changed

• DeepSeek Provider: Replaced non-functional deepseek-cli with custom provider using official OpenAI client.

Fixed

• Environment Variable Handling: qonqrete.sh now conditionally passes API keys, preventing “unbound variable” errors.

v0.4.8-alpha - 2025-12-06

Added

• DeepSeek Provider: System now supports DeepSeek models via deepseek-cli tool.
• Hybrid Provider Model: AI interaction library supports Python libraries for OpenAI, Gemini, Anthropic, and CLI for DeepSeek.

Changed

• Dynamic API Key Validation: qrane.py reads config.yaml to validate required API keys.

v0.4.7-alpha - 2025-12-06

Added

• Anthropic Claude Provider: System now supports Anthropic’s Claude models.
• Unified Python Provider Interface: Refactored to use official Python clients for all providers.

Removed

• CLI Pre-flight Checks: Removed sgpt and gemini CLI checks as no longer relevant.

v0.4.6-alpha - 2025-12-06

Added

• Configurable Execution Mode: Default mode controlled via cheqpoint boolean in config.yaml.
• --user / -u Flag: Force user-gated mode from command line.

Fixed

• TUI Mode Crash: Fixed “I/O operation on closed file” error.
• Gatekeeper Assessment Parsing: More robust regex-based parsing.
• construqtor Path Duplication: No more nested qodeyard/qodeyard directories.

v0.4.5-alpha - 2025-12-04

Changed

• Logging Architecture: Raw output in struqture/qonsole_<agent>.log, events in struqture/events_<agent>.log.

Fixed

• Headless Mode Crash: Fixed “I/O operation on closed file” error.
• construqtor AI Output Parsing: Extremely strict system prompt with clear output format example.

v0.4.5-alpha - 2025-12-03

Added

• Sqrapyard Project Seeding: On startup, qonqrete.sh checks worqspace/sqrapyard and copies files to qodeyard as a starting point.
• tasq.md Seeding: If tasq.md exists in sqrapyard, it’s used as the initial task.
• Verbose Startup Logging: Explicit logs about seeding or starting fresh.
• Pre-run Delay: 3-second delay after host logs for user readability.

Changed

• Ephemeral Workspaces: Each run creates unique qage_<timestamp> directory for isolation.
• Instruqtor Sensitivity: 10 distinct levels (0-9) via QONQ_SENSITIVITY environment variable.
• Context Awareness: Both instruqtor and construqtor read all qodeyard files for full context.

Fixed

• Stricter Path Sanitization: Removes ../ from AI-generated filenames.
• AI Filename Resilience: Handles AI providing language name instead of filename.

v0.4.4-alpha - 2025-12-02

Fixed

• Instruqtor Logic: Overhauled sensitivity logic.
• Construqtor: Fixed agent failure bug.
• AI Reliability: Robust retry mechanism for intermittent AI failures.

v0.4.3-alpha - 2025-12-02

Added

• Init Seeding: qonqrete.sh init copies sqrapyard to qodeyard if available.

v0.4.2-alpha - 2025-11-28

Added

• Architect Role: Implemented in instruqtor for improved planning.
• Micro-dosing: Technique for better AI results.

v0.4.1-alpha - 2025-11-27

Fixed

• Critical Regressions: Patched syntax errors from v0.4.0.

v0.4.0-alpha - 2025-11-26

Added

• Operational Modes: Agents operate with “personas” via --mode flag.
• Briq Sensitivity: --briq-sensitivity flag (0-9) for task breakdown control.
• TUI Overhaul: Major improvements.

v0.3.0-alpha - 2025-11-25

Changed

• Branding: README.md displays logo.png.
• Versioning: Hardened build process for clean VERSION file.

v0.2.7-alpha - 2025-11-24

• Hotfix: Addressed critical IndentationError in qrane/qrane.py.

v0.2.6-alpha - 2025-11-23

• TUI Experience: Fixed “flash and gone” issue.

v0.2.5-alpha - 2025-11-22

• Agent Stability: Fixed critical NameError and improved console error visibility.

v0.2.4-alpha - 2025-11-21

• Documentation: Consolidated reports into COMING_SOON.md and DOCUMENTATION.md.

v0.2.3-alpha - 2025-11-20

• TUI Stability: Fixed NameError crash in TUI mode.

v0.2.2-alpha - 2025-11-19

Major Refactoring

• Implemented dynamic agent pipeline.
• Centralized path management.
• Added pre-flight checks for dependencies.
• Implemented TUI state persistence.

v0.2.1-alpha - 2025-11-18

• Dynamic Versioning: Centralized in VERSION file.
• Integrated Docker Output: Streamed into TUI.

v0.2.0-alpha - 2025-11-17

Added

• TUI Enhancements: Raw log view, fullscreen mode, key shortcuts.
• Microsandbox (MSB) Integration: Support for msb.

v0.1.1-alpha - 2025-11-14

• TUI Mode: Introduced --tui flag.
• Workspace Cleaning: Added clean command.

v0.1.0-alpha - 2025-11-12

• Initial public alpha release of QonQrete.