Skip to main content

Release Notes

Version history and changelog for Paracore.

V4.2.1 (March 2026) - The API Alignment & Resiliency Patch

Version 4.2.1 finalizes the "Pure Chained" Fluent API, implements a massive performance fix for UI Predicate Hydration, and bulletproofs the .NET 8 assembly resolution layer for external deployments.

  • "Pure Chained" Fluent API: Standardized all C# extension methods into a uniform Noun/Verb syntax (e.g., .FamilyName(), .ReflectionProperties()) and moved forensic diagnostics to a chained .Peek() method.
  • High-Performance UI Hydration: Resolved a severe scoping bug in Magic Hydration. Custom _Filter predicates now respect category attributes before evaluation, ensuring lightning-fast UI dropdowns for large models.
  • High-Density Data Guardrails: Introduced a protective threshold (30 items) for Pie and Bar charts to prevent unreadable "nonsense" visualizations from raw un-aggregated data.
  • REPL "Sandbox" Workflow: Added a "New" button to the multi-line REPL. This enables ephemeral experimentation by clearing the editor and unloading the current file, ensuring saved automation snippets are never accidentally modified during "what-if" testing.
  • Filtered CSV Export: The Analytics table export now strictly honors the frontend search/filter state, allowing for surgical data extraction.
  • Autodesk Deployment Resiliency: Strictly pinned the .NET 8 SDK and downgraded library dependencies to v8.0.1 to ensure total binary compatibility with Revit 2025's native AppDomain, even in heavily modded environments.
  • Dynamic Analytics: Graphing widgets now dynamically parse custom REPL projections without requiring rigid schemas.
  • Sentinel Output Consolidation: Refactored the Visual Query Builder's sentinel generation logic to utilize a unified C# local function (ShowResults()). This eliminates redundant table-generation code while maintaining the distinct execution paths for background reporting and on-demand gallery runs.

V4.2.0 (March 2026) - The BIM Laboratory & Intelligence Update

V4.2.0 is a massive milestone that transforms Paracore from a script orchestrator into a full-scale BIM Laboratory. This release introduces live interactive coding, reusable logic templates, a high-performance results grid, and professional-grade ergonomics.

Paracore REPL: The BIM Laboratory

  • Dual-Mode Interface:
    • Single-Line REPL: Rapid-fire discovery for quick inspections and one-liner commands.
    • Multi-Line Laboratory: A persistent, file-aware editor for building complex snippets.
  • Global Variable Persistence: Variables defined in the REPL stay in scope throughout your entire session, even if you switch scripts in the gallery or click between tabs.
  • Unified Execution Context: The REPL shares the same powerful environment as the main engine, meaning your laboratory snippets can reference the same hydration logic and libraries as your production scripts.
  • Persistent Command History: An intelligent history system (Up/Down arrows) that survives clear commands and application restarts.
  • File Operations: Save your laboratory discoveries into standalone .cs snippets or load existing C# fragments directly into the multi-line editor.

Transform your library into a suite of reusable BIM templates.

  • Persistent Logic: Paracore now extracts and saves the Visual Query graphs directly inside your scripts.
  • Template Selector: When creating a new script or sentinel, you can pick from a dropdown of existing queries. Start from a proven graph, tweak a few values, and deploy a new tool in seconds.
  • Canvas Reset: Instantly wipe your builder workspace with the new "Clear Canvas" option to start fresh without leaving the modal.

Active Data Grid & CSV Mass Editing

The Results Table is no longer just for viewing; it is now a high-performance data management hub.

  • Active Data Grid: Real-time interaction with script results. Double-click cells to modify Revit parameters (e.g., Room Names, Floor Finishes, Mark, Comments) directly from the table.
  • Surgical Mutability: To ensure model integrity, Paracore follows a strict "Revit first" principle. Editing is constrained to non-readonly, non-geometric parameters. Structural properties like Wall Length or Room Area must remain read-only to ensure project stability.
  • CSV Mass Import: Export your data to CSV, perform bulk edits in external tools, and re-import with atomic transaction safety.
  • Direct Element Selection: Click on any ID cell to instantly select and highlight the corresponding element in Revit.
  • BIM Data Precision: Full preservation of numeric precision across the entire data pipeline.

Visual Query Builder (Surgical Precision)

We've evolved the Visual Query Builder into a surgical tool for complex element filtering.

  • Prefix-Aware Naming: Common parameters (Name, Type, Comments) are now automatically prefixed with their category to ensure uniqueness.
  • Rich Parameter Metadata: Displays Storage Type, Instance/Type scope, and the underlying BuiltInParameter name.
  • Strict Nullability: Parameters are generated as nullable types for cleaner filtering.
  • Surgical Search & Discovery: Overhauled selection UI for navigating thousands of parameters effortlessly.

Magic Hydration: Predicate-Based Filtering

V4.2.0 introduces the next evolution of our hydration engine, significantly reducing the boilerplate required for custom data filtering.

  • Magic Hydration Predicates (New): You can now pre-filter automatic element lists using simple boolean predicates. By defining a _Filter method (e.g., LargeRooms_Filter), you can inject custom logic to narrow down dropdown options without manually re-filtering the entire document from scratch.
  • Intelligent Infrastructure: The engine handles the heavy lifting of gathering elements, while your predicate simply decides what makes the cut.
  • Professional Flexibility: While Magic Hydration provides a "Low-Code" path for filtering, the core _Options provider remains fully supported for developers who need maximum control.
  • Revit Property Protection: The engine now handles Revit API naming quirks (e.g., automatically mapping ViewSheet.SheetNumber for display) to ensure seamless data flow.

Minimalist Command Center & Ergonomics

  • Layout Stability: Eliminated console flicker and layout jitter during script execution.
  • Typography & Contrast: Typography scaled up to 14px/15px for perfect readability, with high-contrast "Eclipse" mode for technical tabs.
  • Portal-Based Tooltips: Metadata always renders correctly above all other UI layers.
  • Assembly Cache: Blazingly fast repeated execution - once compiled, script re-runs are instant.

Performance & Security

  • Wide FS Scope: Laboratory snippets can now be saved to any user-selected path (e.g., Desktop) in production.
  • Smart Source Discovery: Accurate scanning for container folders, initialization candidates, and established Paracore sources.

V4.0.0 (February 2026) - Model Quality at the Source

V4.0.0 transforms Paracore into a professional validation factory, shifting from a reactive script runner to an integrated "Quality-at-the-Source" architecture.

Sentinels: Quality Assurance at the Source

Sentinels are the heartbeat of this release, moving model validation to the early design stages.

  • Preventative Monitoring: Instead of discovering accumulated errors through external coordination platforms, Sentinels identify compliance breaches in real-time.
  • Minimized Rework: By catching issues as they arise, Paracore eliminates the frustration of large-scale retrospection and manual Revit adjustments, ensuring a clean model from day one.

Visual Query Builder: Automated Logic Generation

The Visual Query Builder simplifies complex element targeting through automated C# logic generation.

  • No-Manual-Code Filtering: Configure professional AND/OR hierarchies through a specialized UI that generates optimized filter logic automatically.
  • Precision Targeting: Target elements with surgical precision based on categories, parameters, and types without writing a single line of manual code.

One Source of Truth: Unified Architecture

We have unified the development and execution environments into a permanent, professional project structure.

  • Zero-Manual-Management: Paracore automates the entire C# lifecycle - from initialization to professional scaffolding - transparently at the source.
  • Integrated Scaffolding: Editing a script builds a permanent development environment (csproj, sln) directly within your project tree, ensuring zero synchronization lag.

Universal UI Overhaul

Paracore has undergone a total visual transformation. Every interface element - from the TopBar and Sidebar to the Gallery and Script Inspector - has been modernized for a premium, precision-tool experience.

  • Glassmorphic Design: Refined transparency and backdrop-blur effects create a modern, depth-focused interface across the entire application.
  • Sentinel Control FAB: A new Floating Action Button (FAB) provides instant access to the expanded Sentinel Control & Status window, centralizing real-time monitoring and reporting.
  • Enhanced Parameters & Modals: The Parameters tab and all application modals have been significantly upgraded. The NewScriptModal is completely redesigned to seamlessly accommodate the new Visual Query Builder workflow.
  • Professional Polish: Optimized typography, color palettes, and micro-animations ensure that every click and transition feels responsive, lively, and state-of-the-art.

Performance & Examples

  • Forge (Binary Distribution): Package your logic into sealed .ptool (Automation) or .wtool (Sentinel) binaries for professional distribution. For Sentinels, Forge compilation supercharges performance—ensuring that live background validation remains ultra-efficient and highly optimized.
  • Modernized Library: The Paracore-Examples repository has been fully upgraded to the V4 Structure, featuring starter templates for building your own custom automations and Sentinels.

For the full changelog, see the GitHub Releases.