release/1.0.0-alpha

.editorconfig

@@ -229,3 +229,28 @@ dotnet_naming_style.begins_with_i.required_prefix = I
 dotnet_naming_style.begins_with_i.required_suffix = 
 dotnet_naming_style.begins_with_i.word_separator = 
 dotnet_naming_style.begins_with_i.capitalization = pascal_case
+
+#### StyleCop Analyzer Rules ####
+
+# SA1633: File should have header
+# Suppressed because we use a custom LGPL header format
+dotnet_diagnostic.SA1633.severity = none
+
+# CA1707: Remove underscore from member names
+dotnet_diagnostic.CA1707.severity = none
+
+# SA1124: Do not use regions
+# Suppressed because regions are used to group related methods
+dotnet_diagnostic.SA1124.severity = none
+
+# IDE0051: Unused private members
+dotnet_diagnostic.IDE0051.severity = warning
+
+# IDE0052: Assigned but not used
+dotnet_diagnostic.IDE0052.severity = warning
+
+# CA1811: uncalled private code
+dotnet_diagnostic.CA1811.severity = warning
+
+# SA1210: Using directives should be ordered alphabetically by the namespaces
+dotnet_diagnostic.SA1210.severity = error

.github/CODEOWNERS

@@ -1,32 +1,33 @@
 # These owners will be the default owners for everything in
 # the repo. They will be requested for review when someone 
 # opens a pull request.
-*                   @marc-romu
+*                     @marc-romu
 
 # Protect the entire .github folder and all its contents
-/.github/           @marc-romu
-/.github/**         @marc-romu
-/.github/CODEOWNERS @marc-romu
+/.github/             @marc-romu
+/.github/**           @marc-romu
+/.github/CODEOWNERS   @marc-romu
 
 # Documentation
-/README.md          @marc-romu
-/CHANGELOG.md       @marc-romu
-/LICENSE            @marc-romu
-/CONTRIBUTING.md    @marc-romu
+/README.md            @marc-romu
+/CHANGELOG.md         @marc-romu
+/LICENSE              @marc-romu
+/CONTRIBUTING.md      @marc-romu
 /RELEASE_CHECKLIST.md @marc-romu
+/DEV.md               @marc-romu
 
 # Critical repository files
-/.gitignore         @marc-romu
-/.gitattributes     @marc-romu
-/.windsurf/**       @marc-romu
-*.ps1               @marc-romu
+/.gitignore           @marc-romu
+/.gitattributes       @marc-romu
+/.windsurf/**         @marc-romu
+*.ps1                 @marc-romu
 
 # Critical solution files
-/*.sln              @marc-romu
-/NuGet.Config       @marc-romu
-/Solution.props     @marc-romu
+/*.sln                @marc-romu
+/NuGet.Config         @marc-romu
+/Solution.props       @marc-romu
 /Directory.Build.props @marc-romu
 /Directory.Build.targets @marc-romu
 
 # Yak package
-/yak-package/**     @marc-romu
+/yak-package/**       @marc-romu

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -35,7 +35,7 @@ body:
     attributes:
       label: Rhino Version
       description: What version of Rhino are you using?
-      placeholder: e.g. RH8.13
+      placeholder: e.g. RH8.23
     validations:
       required: true
 
@@ -44,7 +44,7 @@ body:
     attributes:
       label: SmartHopper Version
       description: What version of SmartHopper are you using?
-      placeholder: e.g. 0.0.0-dev.250101
+      placeholder: e.g. 1.0.0-alpha
     validations:
       required: true
 

.github/actions/documentation/update-badges/action.yml

@@ -1,5 +1,5 @@
 name: 'Update Badges'
-description: 'Update the version and status badges in README.md'
+description: 'Update version and status badges in README.md (for-the-badge style only)'
 inputs:
   branch:
     description: 'Branch name (for context)'
@@ -25,92 +25,58 @@ runs:
         echo "Current version: $VERSION"
         echo "version=$VERSION" >> $GITHUB_OUTPUT
 
-    - name: Update version badge in README.md
+    - name: Update badges in README.md
       id: update-badge
       shell: bash
       run: |
         # Get the current version
         VERSION="${{ steps.get-version.outputs.version }}"
-
         echo "Current version from Solution.props: $VERSION"
-
-        # Format version for shields.io by encoding special characters
-        ENCODED_VERSION=$(echo "$VERSION" | sed 's/-/--/g' | sed 's/\./%2E/g')
-
-        # Determine color and status based on version
+
+        # Shields.io escaping: '-' -> '--', '_' -> '__', ' ' -> '_'
+        SHIELDS_VERSION=${VERSION//_/__}
+        SHIELDS_VERSION=${SHIELDS_VERSION//-/--}
+        SHIELDS_VERSION=${SHIELDS_VERSION// /_}
+
+        # Determine status color and text based on version suffix
+        STATUS_COLOR="brightgreen"
+        STATUS_TEXT="Stable"
         if [[ $VERSION == *"-dev"* ]]; then
-          COLOR="brown"
-          STATUS="Unstable%20Development"
+          STATUS_COLOR="brown"
+          STATUS_TEXT="Unstable%20Development"
         elif [[ $VERSION == *"-alpha"* ]]; then
-          COLOR="orange"
-          STATUS="Alpha"
+          STATUS_COLOR="orange"
+          STATUS_TEXT="Alpha"
         elif [[ $VERSION == *"-beta"* ]]; then
-          COLOR="yellow"
-          STATUS="Beta"
+          STATUS_COLOR="yellow"
+          STATUS_TEXT="Beta"
         elif [[ $VERSION == *"-rc"* ]]; then
-          COLOR="lightblue"
-          STATUS="Release%20Candidate"
-        else
-          COLOR="lightgreen"
-          STATUS="Stable"
+          STATUS_COLOR="purple"
+          STATUS_TEXT="Release%20Candidate"
         fi
-
-        # Create new badge URLs
-        VERSION_BADGE_URL="https://img.shields.io/badge/version-$ENCODED_VERSION-$COLOR"
-        STATUS_BADGE_URL="https://img.shields.io/badge/status-$STATUS-$COLOR"
-
-        # Create badge markdown
-        VERSION_BADGE="[![Version]($VERSION_BADGE_URL)](https://github.com/architects-toolkit/SmartHopper/releases)"
-        STATUS_BADGE="[![Status]($STATUS_BADGE_URL)](https://github.com/architects-toolkit/SmartHopper/releases)"
-
-        echo "New version badge: $VERSION_BADGE"
-        echo "New status badge: $STATUS_BADGE"
-
-        BADGES_CHANGED=false
-
-        # Update README.md with new badges
-        if [[ -f "README.md" ]]; then
-          # Check if README contains version badge and if it needs updating
-          if grep -q "\[\!\[Version\]" README.md; then
-            echo "Found version badge in README"
-
-            # Extract current badge URL to check if color matches
-            CURRENT_VERSION_BADGE=$(grep -o "\[\!\[Version\](https://img\.shields\.io/badge/version[^)]*)" README.md || echo "")
-
-            # Check if the badge needs updating (different version or color)
-            if [[ "$CURRENT_VERSION_BADGE" != *"$ENCODED_VERSION"* || "$CURRENT_VERSION_BADGE" != *"-$COLOR"* ]]; then
-              sed -i "s|\[\!\[Version\](https://img\.shields\.io/badge/version[^)]*)|[![Version]($VERSION_BADGE_URL)|g" README.md
-              echo "Updated version badge"
-              BADGES_CHANGED=true
-            else
-              echo "Version badge is already up to date"
-            fi
-          else
-            echo "No version badge found in README to replace"
-          fi
-
-          # Check if README contains status badge and if it needs updating
-          if grep -q "\[\!\[Status\]" README.md; then
-            echo "Found status badge in README"
-
-            # Extract current badge URL to check if status or color matches
-            CURRENT_STATUS_BADGE=$(grep -o "\[\!\[Status\](https://img\.shields\.io/badge/status[^)]*)" README.md || echo "")
-
-            # Check if the badge needs updating (different status or color)
-            if [[ "$CURRENT_STATUS_BADGE" != *"$STATUS"* || "$CURRENT_STATUS_BADGE" != *"-$COLOR"* ]]; then
-              sed -i "s|\[\!\[Status\](https://img\.shields\.io/badge/status[^)]*)|[![Status]($STATUS_BADGE_URL)|g" README.md
-              echo "Updated status badge"
-              BADGES_CHANGED=true
-            else
-              echo "Status badge is already up to date"
-            fi
-          else
-            echo "No status badge found in README to replace"
-          fi
-
-          # Output whether badges were changed
-          echo "badges-changed=$BADGES_CHANGED" >> $GITHUB_OUTPUT
-        else
-          echo "README.md not found, skipping badge update"
+
+        echo "Target version badge: ${SHIELDS_VERSION} / ${STATUS_COLOR}"
+        echo "Target status badge: ${STATUS_TEXT} / ${STATUS_COLOR}"
+
+        if [[ ! -f "README.md" ]]; then
+          echo "README.md not found"
           echo "badges-changed=false" >> $GITHUB_OUTPUT
+          exit 0
+        fi
+
+        # Update VERSION badge (for-the-badge format only)
+        # Pattern: https://img.shields.io/badge/version-{VERSION}-{COLOR}?style=for-the-badge
+        sed -i -E "s|(https://img\.shields\.io/badge/version-)[^?]+-([a-zA-Z]+)(\?style=for-the-badge)|\1${SHIELDS_VERSION}-${STATUS_COLOR}\3|" README.md
+
+        # Update STATUS badge (for-the-badge format only)
+        # Pattern: https://img.shields.io/badge/status-{TEXT}-{COLOR}?style=for-the-badge
+        sed -i -E "s|(https://img\.shields\.io/badge/status-)[^?]+-([a-zA-Z]+)(\?style=for-the-badge)|\1${STATUS_TEXT}-${STATUS_COLOR}\3|" README.md
+
+        # Check if any changes were made
+        if git diff --quiet README.md 2>/dev/null; then
+          echo "Badges already up to date"
+          echo "badges-changed=false" >> $GITHUB_OUTPUT
+        else
+          echo "Badges updated successfully"
+          echo "badges-changed=true" >> $GITHUB_OUTPUT
         fi

.github/actions/documentation/update-ready-badge/action.yml

@@ -0,0 +1,44 @@
+name: "Update Ready Badge"
+description: "Update the Ready to use badge in README.md to a specific status and color"
+author: "SmartHopper"
+
+inputs:
+  status:
+    description: "Badge status text (e.g., YES, NO)"
+    required: false
+    default: "YES"
+  color:
+    description: "Badge color (e.g., brightgreen, red, brown)"
+    required: false
+    default: "brightgreen"
+  file:
+    description: "Path to README file"
+    required: false
+    default: "README.md"
+
+runs:
+  using: "composite"
+  steps:
+    - name: Update Ready badge in README
+      shell: bash
+      run: |
+        set -euo pipefail
+        FILE="${{ inputs.file }}"
+        STATUS="${{ inputs.status }}"
+        COLOR="${{ inputs.color }}"
+
+        if [[ ! -f "$FILE" ]]; then
+          echo "File not found: $FILE" >&2
+          exit 1
+        fi
+
+        # Replace shields.io 'ready_to_use-<status>-<color>' portion, keeping query params
+        # Supports any current value and preserves surrounding markdown link
+        pattern='(https://img\.shields\.io/badge/ready_to_use-)[^?-]+-[^?]+(\?style=for-the-badge)'
+        replacement="\\1${STATUS}-${COLOR}\\2"
+
+        # Use perl for cross-platform inline regex with capture groups
+        perl -0777 -pe "s#$pattern#$replacement#g" "$FILE" > "$FILE.tmp"
+        mv "$FILE.tmp" "$FILE"
+
+        echo "Updated Ready badge to: status=$STATUS color=$COLOR in $FILE"

.github/labels.yml

@@ -133,6 +133,12 @@
 - name: "provider: DeepSeek"
   color: "000"
   description: "Issues related to the DeepSeek provider"
+- name: "provider: OpenRouter"
+  color: "000"
+  description: "Issues related to the OpenRouter provider"
+- name: "provider: Anthropic"
+  color: "000"
+  description: "Issues related to the Anthropic provider"
 
 # Scope Labels
 - name: "scope: Settings"
@@ -141,12 +147,21 @@
 - name: "scope: AI Tools"
   color: "000"
   description: "Issues related to the AI tools"
+- name: "scope: AI Calls"
+  color: "000"
+  description: "Issues related to the AI Calls logic"
 - name: "scope: Provider Manager"
   color: "000"
   description: "Issues related to the Provider Manager"
 - name: "scope: Context Manager"
   color: "000"
   description: "Issues related to the Context Manager"
+- name: "scope: Model Manager"
+  color: "000"
+  description: "Issues related to the Model Manager"
+- name: "scope: Tool Manager"
+  color: "000"
+  description: "Issues related to the Tool Manager"
 - name: "scope: UI"
   color: "000"
   description: "Issues related to the UI features"
@@ -156,3 +171,9 @@
 - name: "scope: Component Base"
   color: "000"
   description: "Issues related to the Component Base"
+- name: "scope: Conversation Session"
+  color: "000"
+  description: "Issues related to the Conversation Session logic"
+- name: "scope: Canvas Assistant"
+  color: "000"
+  description: "Issues related to the Canvas Assistant logic"

.github/workflows/chore-version-main-release.yml

@@ -49,11 +49,17 @@ jobs:
         with:
           new-version: ${{ steps.strip-date.outputs.new-version }}
 
+      # Update badges to match the new version
+      - name: Update badges
+        id: update-badges
+        if: steps.strip-date.outputs.new-version != steps.get-version.outputs.version
+        uses: ./.github/actions/documentation/update-badges
+
       - name: Commit and push changes
         if: steps.strip-date.outputs.new-version != steps.get-version.outputs.version
         run: |
           git config --local user.email "action@github.com"
           git config --local user.name "GitHub Action"
-          git add Solution.props
+          git add Solution.props README.md
           git commit -m "chore: remove date from version for main release"
           git push origin HEAD:${{ github.event.pull_request.head.ref }}

.github/workflows/dev-ready-badge-reset.yml

@@ -0,0 +1,43 @@
+name: ♻️ Reset Ready Badge on Dev Merges (non-release)
+
+on:
+  pull_request:
+    types: [closed]
+
+permissions:
+  contents: write
+
+jobs:
+  reset-ready-badge:
+    if: >-
+      ${{ github.event.pull_request.merged == true &&
+          github.event.pull_request.base.ref == 'dev' &&
+          !startsWith(github.event.pull_request.head.ref, 'release/') }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout dev
+        uses: actions/checkout@v4
+        with:
+          ref: dev
+
+      - name: Set up Git user
+        run: |
+          git config user.name "github-actions"
+          git config user.email "action@github.com"
+
+      - name: Set Ready badge to NO (brown)
+        uses: ./.github/actions/documentation/update-ready-badge
+        with:
+          status: NO
+          color: brown
+          file: README.md
+
+      - name: Commit and push if changed
+        run: |
+          if ! git diff --quiet README.md; then
+            git add README.md
+            git commit -m "docs(readme): reset Ready-to-use badge to NO on dev merge (non-release)"
+            git push origin dev
+          else
+            echo "No changes to README.md; skipping commit"
+          fi