Aura

This release introduces a major code-quality pipeline that enforces structural integrity on all Python file writes, a reworked project and thread organization, two new Planner-only diagnostic tools, toolbar and sidebar improvements, and important fixes for Gemini API usage.

Craft Code Quality Engine

All file-writing paths — write_file, edit_file, and edit_symbol — now route through a layered compilation and validation pipeline.

Pipeline Layers

• SafeMutator – Removes narration comments, empty __init__ blocks, and other artifacts before deeper analysis.
• CraftEngine – Checks for syntax errors, stub bodies, silent exception swallowing, and other authorship smells. Enforcement is scoped to Aura-owned code, so small patches in existing files are not overly penalized.
• ContractGate – Validates that edits respect the Planner's explicit contract (expected symbols, fields, forbidden methods, non-goals).
• ReferenceChecker – Verifies imports, undefined names, call signatures, and missing attributes. Now understands Python's relative import syntax and resolves imports relative to the correct package root.
• CodeFormatter – If the workspace has a Ruff configuration, runs ruff check --fix and ruff format on the result.

Key Improvements

• Existing file overwrite closed: Full-file rewrites now go through Craft, eliminating a bypass that allowed existing write_file calls to skip validation.
• ReferenceChecker performance: Dependency, cache, and build directories are pruned during traversal, avoiding expensive and misleading checks on .venv, node_modules, __pycache__, and similar directories.
• Relative import resolution: Aura's own relative imports are correctly resolved, eliminating false "undefined name" errors.
• Cache invalidation: The workspace index is invalidated immediately after an approved write, so newly added symbols are recognized without restarting the conversation.
• Delta-filtered diagnostics: Only new issues or pre-existing issues on changed lines block an edit. Old, unrelated issues elsewhere are ignored.
• Smarter issue matching: Diagnostics are matched using issue codes, normalized messages, and symbolic targets, not just line numbers.

Project Organization

The workspace sidebar now separates projects and files for a cleaner workflow.

• A new Projects section lists all workspaces, each with its own conversation threads.
• + New Project creates or switches workspaces.
• Each project shows recent threads; a Show more row expands the full list.
• Clicking a thread loads that conversation; clicking a project switches the active workspace.
• Existing conversations are automatically backfilled into the correct project and thread.
• Thread titles are cleaned before display.
• The current workspace is automatically registered as a project on launch.

Left Pane & Toolbar Polish

• The Files tree now appears above Projects in the left sidebar for faster workspace navigation.
• Toolbar buttons now show text beside icons: New (+), Open (folder), Read Only (lock).
• The Read Only button toggles a checked state and displays a "READ-ONLY" badge on the right when active.
• All toolbar buttons include descriptive tooltips. Dispatch and Approve switches also show tooltips.

New Planner Tools

Diagnostic Command (run_diagnostic_command)

• Planner-only, read-only command execution for quick repository inspection.
• Allowed: python -m py_compile, short python -c snippets, pytest, git status, git diff, git log, rg/grep, and basic file-listing commands.
• Blocked: mutating commands, installs, long-running processes, shell piping/redirection/chaining, unknown executables.
• Runs with shell=False where possible, strict timeout, output truncated to a safe maximum.
• Not exposed to Workers.

Workspace Snapshot (get_workspace_snapshot)

• Planner-only, compact project overview for first-turn awareness.
• Returns: workspace root, active project identity, recent project threads, git branch/status summary, changed file names, and detected project hints (e.g., pyproject.toml, package files).
• No large file reads, no crawling of dependency or cache directories.
• Reduces tool spam and gives the Planner a fast starting point for ambiguous or multi-file tasks.

API Fixes

• Multiple minor fixes for the Gemini API integration, resolving connection issues and improving response reliability.

Notes

• The Craft pipeline adds a small amount of post-write processing time, especially when Ruff formatting is enabled on large files. This is expected and will be further optimized in future releases.
• If a workspace does not have a Ruff config, the formatter step is skipped automatically.

Full Changelog: compare v1.3.6...v1.4.0