feat(release): 0.3.0-alpha with AI tools, UI enhancement, security enhancements, and ci tests

.editorconfig

@@ -13,20 +13,19 @@ tab_width = 4
 
 # New line preferences
 end_of_line = crlf
-insert_final_newline = false
+insert_final_newline = true
 
 #### .NET Coding Conventions ####
 
 # Organize usings
 dotnet_separate_import_directive_groups = false
-dotnet_sort_system_directives_first = false
-file_header_template = "/*\n * SmartHopper - AI-powered Grasshopper Plugin\n * Copyright (C) {year} Marc Roca Musach\n *\n * This library is free software; you can redistribute it and/or\n * modify it under the terms of the GNU Lesser General Public\n * License as published by the Free Software Foundation; either\n * version 3 of the License, or (at your option) any later version.\n */"
+dotnet_sort_system_directives_first = true
 
 # this. and Me. preferences
-dotnet_style_qualification_for_event = false
-dotnet_style_qualification_for_field = false
-dotnet_style_qualification_for_method = false
-dotnet_style_qualification_for_property = false
+dotnet_style_qualification_for_event = true
+dotnet_style_qualification_for_field = true
+dotnet_style_qualification_for_method = true
+dotnet_style_qualification_for_property = true
 
 # Language keywords vs BCL types preferences
 dotnet_style_predefined_type_for_locals_parameters_members = true

.github/CODEOWNERS

@@ -13,13 +13,17 @@
 /CHANGELOG.md       @marc-romu
 /LICENSE            @marc-romu
 /CONTRIBUTING.md    @marc-romu
+/RELEASE_CHECKLIST.md @marc-romu
 
 # Critical repository files
 /.gitignore         @marc-romu
 /.gitattributes     @marc-romu
 /.windsurfrules     @marc-romu
+*.ps1               @marc-romu
 
 # Critical solution files
 /*.sln              @marc-romu
 /NuGet.Config       @marc-romu
-/Solution.props     @marc-romu
+/Solution.props     @marc-romu
+/Directory.Build.props @marc-romu
+/Directory.Build.targets @marc-romu

.github/labels.yml

@@ -83,6 +83,9 @@
 - name: "component: AI Chat Output"
   color: "000"
   description: "Issues related to the Chat Output component"
+- name: "component: Context Parameters"
+  color: "000"
+  description: "Issues related to the Context Parameters component"
 - name: "component: Deconstruct Metrics"
   color: "000"
   description: "Issues related to the Deconstruct Metrics component"
@@ -105,9 +108,12 @@
 - name: "feature: Settings"
   color: "000"
   description: "Issues related to the Settings menu"
-- name: "feature: AI"
+- name: "feature: AI Tools"
+  color: "000"
+  description: "Issues related to the AI tools"
+- name: "feature: Provider Manager"
   color: "000"
-  description: "Issues related to the AI features"
+  description: "Issues related to the Provider Manager"
 - name: "feature: UI"
   color: "000"
   description: "Issues related to the UI features"

.github/workflows/ci-dotnet-tests.yml

@@ -0,0 +1,58 @@
+name: 🧪 .NET CI
+# Description: This workflow runs .NET tests on the SmartHopper solution to ensure that changes do not break functionality.
+# 
+# Triggers:
+# - push to main branch
+# - pull_request targeting main branch
+# 
+# Permissions:
+# - contents: read - Required to read repository content
+# - pull-requests: read - Required to read pull request information
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+permissions:
+  contents: read
+  pull-requests: read
+
+jobs:
+  test:
+    runs-on: windows-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v3
+        with:
+          dotnet-version: '7.0.x'
+
+      - name: Prepare strong-name key
+        shell: pwsh
+        env:
+          SIGNING_SNK_BASE64: ${{ secrets.SIGNING_SNK_BASE64 }}
+        run: |
+          if (-not (Test-Path signing.snk)) {
+            if ($env:SIGNING_SNK_BASE64) {
+              Write-Host "Decoding signing.snk from Base64 secret"
+              ./Sign-StrongNames.ps1 -Base64 $env:SIGNING_SNK_BASE64
+            } else {
+              Write-Host "Generating temporary signing.snk"
+              ./Sign-StrongNames.ps1 -Generate
+            }
+          } else {
+            Write-Host "signing.snk already exists"
+          }
+
+      - name: Restore dependencies
+        run: dotnet restore SmartHopper.sln
+
+      - name: Build solution
+        run: dotnet build --no-restore --configuration Release SmartHopper.sln
+
+      - name: Run all tests
+        run: dotnet test --no-build --configuration Release --results-directory TestResults

.github/workflows/release-build.yml

@@ -36,7 +36,6 @@ permissions:
 jobs:
   build:
     runs-on: windows-latest
-
     steps:
     - name: Checkout repository
       uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608 # v4
@@ -100,43 +99,36 @@ jobs:
         Write-Host "This is a draft release. Skipping build and upload."
         exit 0
 
-    - name: Setup .NET
-      uses: actions/setup-dotnet@3447fd6a9f9e57506b15f895c5b76d3b197dc7c2 # v4
+    - name: Setup .NET SDK
+      uses: actions/setup-dotnet@v3
       with:
-        dotnet-version: 7.0.x
-    
-    - name: Setup .NET Framework
+        dotnet-version: '7.0.x'
+
+    - name: Decode strong-name key via script
       shell: pwsh
       run: |
-        # .NET Framework 4.8 is pre-installed on Windows 2022 runner
-        # Just verify it's available
-        Get-ChildItem "HKLM:\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full\"
-
-    - name: Configure NuGet Sources
+        # Initialize Developer PowerShell environment for VS tools
+        & 'C:\Program Files (x86)\Microsoft Visual Studio\2022\Enterprise\Common7\Tools\VsDevCmd.bat'
+        pwsh ./Sign-StrongNames.ps1 -Base64 "${{ secrets.SIGNING_SNK_BASE64 }}"
+
+    - name: Restore dependencies
+      run: dotnet restore SmartHopper.sln
+
+    - name: Build solution
+      run: dotnet build SmartHopper.sln --configuration Release --no-restore /p:SignAssembly=true /p:AssemblyOriginatorKeyFile=signing.snk
+
+    - name: Decode Authenticode PFX from secrets
       shell: pwsh
       run: |
-        # List current sources
-        Write-Host "Current NuGet sources:"
-        dotnet nuget list source
-
-        # Add Rhino source if not already present
-        $sources = dotnet nuget list source
-        if ($sources -notmatch "https://mcneel.jfrog.io/artifactory/api/nuget/rhino-packages") {
-            Write-Host "Adding Rhino NuGet source..."
-            dotnet nuget add source "https://mcneel.jfrog.io/artifactory/api/nuget/rhino-packages" -n rhinoSource
-        } else {
-            Write-Host "Rhino NuGet source already exists."
-        }
-
-        # Verify final configuration
-        Write-Host "Final NuGet sources:"
-        dotnet nuget list source
-
-    - name: Restore dependencies
-      run: dotnet restore
-
-    - name: Build
-      run: dotnet build --no-restore --configuration Release
+        Write-Host "Decoding Authenticode PFX from secrets..."
+        pwsh ./Sign-Authenticode.ps1 -Base64 "${{ secrets.SIGNING_PFX_BASE64 }}" -Password "${{ secrets.SIGNING_PFX_PASSWORD }}"
+
+    - name: Authenticode-sign provider assemblies
+      shell: pwsh
+      run: |
+        $version = "${{ steps.determine_version.outputs.VERSION }}"
+        Write-Host "Auth-signing SmartHopper provider DLLs in bin\\$version\\Release"
+        pwsh ./Sign-Authenticode.ps1 -Sign "bin\\$version\\Release" -Password "${{ secrets.SIGNING_PFX_PASSWORD }}"
 
     - name: Create Output Directory
       shell: pwsh
@@ -160,7 +152,7 @@ jobs:
         }
 
         # Define the target platforms
-        $platforms = @("net48", "net7.0-windows", "net7.0")
+        $platforms = @("net7.0-windows", "net7.0")
 
         # Copy only .gha and .dll files directly from each platform folder (not recursive)
         foreach ($platform in $platforms) {
@@ -218,7 +210,7 @@ jobs:
           ForEach-Object { Write-Host "  - $($_.Name)" }
 
         # Define the target platforms
-        $platforms = @("net48", "net7.0-windows", "net7.0")
+        $platforms = @("net7.0-windows", "net7.0")
         $missingFiles = $false
 
         foreach ($platform in $platforms) {
@@ -285,9 +277,8 @@ jobs:
       run: |
         $version = "${{ steps.determine_version.outputs.VERSION }}"
         $platforms = @{
-          "net48" = "SmartHopper-$version-Rhino7-Windows.zip"
           "net7.0-windows" = "SmartHopper-$version-Rhino8-Windows.zip"
-          "net7.0" = "SmartHopper-$version-Rhino8-Mac.zip"
+          "net7.0" = "SmartHopper-$version-Rhino8-Mac-not-tested.zip"
         }
 
         $zipPaths = @()
@@ -363,6 +354,6 @@ jobs:
         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
       with:
         upload_url: ${{ github.event_name == 'release' && github.event.release.upload_url || steps.get_release_url.outputs.UPLOAD_URL }}
-        asset_path: SmartHopper-${{ steps.determine_version.outputs.VERSION }}-Rhino8-Mac.zip
-        asset_name: SmartHopper-${{ steps.determine_version.outputs.VERSION }}-Rhino8-Mac.zip
+        asset_path: SmartHopper-${{ steps.determine_version.outputs.VERSION }}-Rhino8-Mac-not-tested.zip
+        asset_name: SmartHopper-${{ steps.determine_version.outputs.VERSION }}-Rhino8-Mac-not-tested.zip
         asset_content_type: application/zip

.gitignore

@@ -52,4 +52,8 @@ _ReSharper*/
 
 # Not licensed images
 design/icons/template/*
-design/icons/source/*
+design/icons/source/*
+
+# Code signing
+*.snk
+*.pfx

.windsurfrules

@@ -1,23 +1,37 @@
-1. This is a C# project, using .NET 7 and .NET 4.8 for both Windows and Mac.
-2. The aim of the project is to create some Grasshopper components.
-3. The project is structured in the following projects:
-   - SmartHopper.Core: Contains the core functionality
-   - SmartHopper.Core.Grasshopper: Contains the core functionality to interact with Grasshopper (type converters, utils, and tools)
-   - SmartHopper.Components: Contains the Grasshopper components. Most of the components depend on the Component Base defined in SmartHopper.Core/ComponentBase. Each component implements a tool for a specific function defined in SmartHopper.Core.Grasshopper/Tools. Tools will be callable from a component, or from the AIChatComponent, which is a chat interface with AI.
-   - SmartHopper.Config: Contains the configuration for the plugin and for the AI providers. It also defines the necessary models and interfaces.
-   - SmartHopper.Menu: Sets up the menu bar
-   - SmartHopper.Components.Test: Is a debugging solution, not available for production.
-   - SmartHopper.Providers.MistralAI: Contains the MistralAI provider
-   - SmartHopper.Providers.OpenAI: Contains the OpenAI provider
-   - SmartHopper.Providers.Template: Contains a Template project for new providers. This project is not registered in the solution.
-4. Use native Grasshopper types, objects and methods where possible.
-5. Use https://developer.rhino3d.com/ as the official documentation.
-6. Use English language only.
-7. Component Structure:
-   - All components should inherit from ComponentBase or a derived class.
-   - Components should be named with the pattern [Category][Action][Type]Component (e.g., AITextGenerateComponent).
-   - Consider using AIStatefulAsyncComponentBase since it already implements most of the required structure to manage AI methods, states and async operations.
-8. When asked for a PR/commit title or description, follow the rules in @.github/PULL_REQUEST_TEMPLATE.md
-9. Make only targeted edits to existing code.
+# Project-Specific Rules
 
-When the user asks you to add, change, deprecate, remove, fix, or security edit the code, if changes are relevant, mention them in the @CHANGELOG.md file under the "Unreleased" section. Do not modify other parts of the file. Subsections should be limited to and ordered as follows: Added, Changed, Deprecated, Removed, Fixed, Security
+1. Target platforms & frameworks:
+   - Rhino 8 (Grasshopper 1)
+   - Windows: .NET 7-windows
+   - macOS: .NET 7
+2. Solution structure:
+   - SmartHopper.Core: Contains the core functionality
+   - SmartHopper.Core.Grasshopper: Type converters, utilities & tool definitions
+   - SmartHopper.Components: Grasshopper components (inherit ComponentBase/AIStatefulAsyncComponentBase)
+   - SmartHopper.Config: Configuration models & ProviderManager
+   - SmartHopper.Menu: Menu bar setup
+   - SmartHopper.Components.Test: xUnit tests (not for production)
+   - SmartHopper.Providers.*: AI provider projects
+3. Component conventions:
+   - Inherit from ComponentBase or derived class (for example AIStatefulAsyncComponentBase for AI components)
+   - File name: `[Category][Action][Type]Component.cs`
+   - Override `RegisterInputParams()`, `RegisterOutputParams()`
+   - Provide unique `Guid`, `ComponentName`, `Nickname`, `Description`
+4. AI Tool conventions:
+   - Implement `IAIToolProvider` in `SmartHopper.Core.Grasshopper.Tools`
+   - File name: `*Tools.cs`
+   - Define AITool metadata (Name, Description, schema)
+   - Auto‑discover via `AIToolManager`
+5. AI Provider conventions:
+   - Use `SmartHopper.Providers.Template` as a starting point
+   - Implement `IAIProviderFactory` & `IAIProviderSettings`
+   - Document settings in JSON schema or Rhino config
+6. Documentation & changelog:
+   - Log API changes in `CHANGELOG.md` under **Unreleased**, in one of the following sections: Added, Changed, Deprecated, Removed, Fixed, Security
+   - Use PR template per `.github/PULL_REQUEST_TEMPLATE.md`
+   - Add docstrings to all public members
+7. General guidelines:
+   - Use native Grasshopper types & methods when possible
+   - Use https://developer.rhino3d.com/ as the official documentation
+   - Use English language only
+   - Only change code lines directly needed to implement the request; avoid unrelated refactors

CHANGELOG.md

@@ -7,33 +7,54 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+
+
+## [0.3.0-alpha] - 2025-04-27
+
 ### Added
 
 - Enabled the AIChat component to execute tools in Grasshopper.
 - Added optional 'Filter' input to `GhGetComponents` component for filtering by errors, warnings, remarks, selected, unselected, enabled, disabled, previewon, previewoff, previewcapable, notpreviewcapable. Supports include/exclude syntax (+/-) provided as a list of tags, each tag in a separate line, comma-separated or space-separated.
 - Added optional 'Type filter' input to `GhGetComponents` component to filter by component type (params, components, inputComponents, outputComponents and processingComponents).
 - Added `ConnectionGraphUtils` class in `SmartHopper.Core.Graph` namespace with method `ExpandByDepth` to expand a set of component IDs by following connections up to the given depth.
+- Added `GhRetrieveComponents` component and `ghretrievecomponents` AI tool for listing Grasshopper component types with descriptions, keywords, category filters, and list of inputs and outputs.
+- Added `ghcategories` AI tool in `GhTools` to list Grasshopper component categories and subcategories with optional soft string filter.
+- Added new `ghtogglepreview` AI tool in `GhObjTools` for toggling Grasshopper component preview by GUID.
+- Added new `ghtogglelock` AI tool in `GhObjTools` for toggling Grasshopper component lock state by GUID.
+- Added new `ghmoveobj` AI tool in `GhObjTools` for moving Grasshopper component pivot by GUID with absolute or relative position.
+- Added `MoveInstance` method in `GHCanvasUtils` to move existing instances by GUID with absolute or relative pivot positions.
+- Improved security in Providers by accepting only signed assemblies.
+- Added multiple CI Tests, for example, to ensure unsigned provider assemblies are rejected by `ProviderManager.VerifySignature`, to ensure only signed assemblies are loaded by `ProviderManager.LoadProviderAssembly`, and to ensure only enabled providers are registered by `ProviderManager.RegisterProviders`.
+- Added `AIToolCall.cs`, a new model for AI tool call requests.
+- Added `SmartHopperInitializer.cs`, a static class for safe startup and provider initialization.
+- Added `StyledMessageDialog` class in `SmartHopper.Config.Dialogs` for consistent message dialog styling with the SmartHopper logo.
+- Added `WebTools` to retrieve webpages from the Internet and provide them to the AI provider.
 
 ### Changed
 
 - Renamed the 'Branches Input' and 'Processed Branches' parameters to 'Data Count' and 'Iterations Count' in DeconstructMetricsComponents. Improved descriptions for both parameters.
-- Modified FilterListAsync in ListTools to return indices instead of filtered list items, with `AIListFilter` component now handling the final list construction.
+- Modified `FilterListAsync` in `ListTools` to return indices instead of filtered list items, with `AIListFilter` component now handling the final list construction.
 - Renamed `GhGetSelectedComponents` (GhGetSel) to `GhGetComponents`.
 - Moved `GhGet` execution logic to external tools managed by `ToolManager`.
 - Improved `ghget` tool's `typeFilter` input: supports include/exclude syntax (+/-) with multiple tokens (params, components, input, output, processing) and updated schema description with definitions and examples.
 - Reorganized `SmartHopper.Core.Grasshopper` files in subfolders that match the namespace.
+- Isolated settings so providers access them only via `ProviderManager`, not directly via `SmartHopperSettings`.
+- SmartHopper icon is now used for all dialogs within SmartHopper (about, settings, messages and ai chat)
 
 ### Removed
 
 - `GhGetComponent` was replaced by `GhGetSelectedComponents` (GhGetSel) and renamed back to `GhGetComponents`.
+- Removed support for net48. From now on, Rhino 8 or later is required.
+- Removed `ToolFunction` and `ToolArgument` in `AIResponse`, in favor of the more flexible `AIToolCall`.
 
 ### Fixed
 
+- Fixed double‐encryption of sensitive settings in `SettingsDialog.SaveSettings()` causing unreadable API keys
+- Fixed mismatch between in-memory and on-disk `TrustedProviders` when prompting in `ProviderManager.LoadProviderAssembly()`
 - Fixed a bug in `DataProcessor` where results were being duplicated when multiple branches were grouped together to unsuccessfully prevent unnecessary API calls [#32](https://github.com/architects-toolkit/SmartHopper/issues/32)
 - Fixed inconsistent list format handling between `AIListEvaluate` and `AIListFilter` components.
-
-### Fixed
-- Fixes "Bug: Unmatching paths in list components return duplicated values" ([#32](https://github.com/architects-toolkit/SmartHopper/issues/32)).
+- Fixed `MistralAI` provider not loading `AI Tools`.
+- Fixed `GhGetComponent` select functionality that was accidentally omitted in the new `GhTools`.
 
 ## [0.2.0-alpha] - 2025-04-06