Feature/mrc usage report data

.github/workflows/mrc-usage-report-scheduler.yml

@@ -0,0 +1,44 @@
+# .github/workflows/mrc-usage-report-scheduler.yml
+#
+# Architectural Decision: Why Two Workflows?
+#
+# This setup uses two separate GitHub Actions workflows:
+# 1. Scheduler Workflow (this file):
+#    - Runs on a schedule (`cron`) from the default branch (e.g., `main`).
+#    - GitHub requires scheduled workflows to be on the default branch to run reliably.
+#    - Its only job is to trigger the worker workflow.
+#
+# 2. Worker Workflow (`mrc-usage-report-worker.yml`):
+#    - Contains the actual logic for generating the MRC usage report.
+#    - It is triggered by this scheduler to run on a specific feature branch (`feature/mrc-usage-report-data`).
+#    - This allows development and testing of the reporting logic on a feature branch
+#      without merging it into the default branch, ensuring the production code remains stable.
+#
+# This separation ensures that we can have a reliable, scheduled trigger while still
+# having the flexibility to develop the report generation logic in an isolated branch.
+
+name: MRC Usage Report - Scheduler
+
+on:
+  schedule:
+    # Runs daily at 8 AM EST (12 PM UTC)
+    - cron: "0 12 * * *"
+  workflow_dispatch: # Allows manual triggering from the Actions tab
+
+jobs:
+  trigger_worker_workflow:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout feature branch to ensure we have the latest code
+        uses: actions/checkout@v4
+        with:
+          ref: "feature/mrc-usage-report-data"
+
+      - name: Trigger the worker workflow
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          WORKER_WORKFLOW: "mrc-usage-report-worker.yml"
+          FEATURE_BRANCH: "feature/mrc-usage-report-data"
+        run: |
+          echo "Triggering workflow ${{ env.WORKER_WORKFLOW }} on branch ${{ env.FEATURE_BRANCH }}"
+          gh workflow run ${{ env.WORKER_WORKFLOW }} --ref ${{ env.FEATURE_BRANCH }}

.github/workflows/mrc-usage-report-worker.yml

@@ -0,0 +1,162 @@
+name: MRC Usage Report Generation
+
+on:
+  workflow_dispatch:
+
+jobs:
+  generate-and-publish-report:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write # For checking out repositories
+      pages: write # For publishing to GitHub Pages
+      id-token: write # For OIDC authentication with GitHub Pages
+
+    steps:
+      - name: Checkout maas-react-components (current repo)
+        uses: actions/checkout@v4
+        with:
+          ref: feature/mrc-usage-report-data
+          path: maas-react-components-repo
+
+      - name: Clean up old report data and files
+        run: |
+          rm -rf maas-react-components-repo/mrc-usage-report-data
+          rm -f maas-react-components-repo/tools/mrc-usage-report/reports/mrc-usage-report-all.json
+          rm -f maas-react-components-repo/tools/mrc-usage-report/reports/mrc-usage-report-all.html
+
+      - name: Print directory structure (maas-react-components)
+        run: |
+          echo "==== DIRECTORY STRUCTURE INFORMATION ===="
+          echo "Current working directory: $(pwd)"
+          echo "maas-react-components-repo location: $(pwd)/maas-react-components-repo"
+          ls -la maas-react-components-repo
+
+      - name: Checkout maas-ui
+        uses: actions/checkout@v4
+        with:
+          repository: SolaceDev/maas-ui
+          ref: sthomas/mrc-usage-report
+          path: maas-ui
+          token: ${{ secrets.PACKAGES_ADMIN_TOKEN }}
+
+      - name: Print directory structure (maas-ui)
+        run: |
+          echo "==== MAAS-UI DIRECTORY STRUCTURE ===="
+          echo "maas-ui-repo location: $(pwd)/maas-ui"
+          ls -la maas-ui
+          echo "maas-ui-repo/tools location: $(pwd)/maas-ui/tools"
+          ls -la maas-ui/tools || echo "tools directory not found"
+          echo "maas-ui-repo/tools/mrc-usage-report location: $(pwd)/maas-ui/tools/mrc-usage-report"
+          ls -la maas-ui/tools/mrc-usage-report || echo "mrc-usage-report directory not found"
+
+      - name: Checkout maas-ops-ui
+        uses: actions/checkout@v4
+        with:
+          repository: SolaceDev/maas-ops-ui
+          ref: iphadte/DATAGO-103044
+          path: maas-ops-ui
+          token: ${{ secrets.PACKAGES_ADMIN_TOKEN }}
+
+      - name: Print directory structure (maas-ops-ui)
+        run: |
+          echo "==== MAAS-OPS-UI DIRECTORY STRUCTURE ===="
+          echo "maas-ops-ui-repo location: $(pwd)/maas-ops-ui"
+          ls -la maas-ops-ui
+          echo "maas-ops-ui-repo/tools location: $(pwd)/maas-ops-ui/tools"
+          ls -la maas-ops-ui/tools || echo "tools directory not found"
+          echo "maas-ops-ui-repo/tools/mrc-usage-report location: $(pwd)/maas-ops-ui/tools/mrc-usage-report"
+          ls -la maas-ops-ui/tools/mrc-usage-report || echo "mrc-usage-report directory not found"
+          echo "maas-ops-ui-repo/tools/mrc-report-merger location: $(pwd)/maas-ops-ui/tools/mrc-report-merger"
+          ls -la maas-ops-ui/tools/mrc-report-merger || echo "mrc-report-merger directory not found"
+          echo "maas-ops-ui-repo/tools/json-splitter location: $(pwd)/maas-ops-ui/tools/json-splitter"
+          ls -la maas-ops-ui/tools/json-splitter || echo "json-splitter directory not found"
+
+      - name: Checkout broker manager
+        uses: actions/checkout@v4
+        with:
+          repository: SolaceDev/broker-manager
+          ref: mrc-usage-report
+          path: broker-manager
+          token: ${{ secrets.PACKAGES_ADMIN_TOKEN }}
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+
+      - name: Generate all usage reports
+        run: |
+          npm i
+          npm run build
+          npm start -- --all --maas-ui-path ../../../maas-ui --maas-ops-ui-path ../../../maas-ops-ui --broker-manager-path ../../../broker-manager --format html
+          npm start -- --all --maas-ui-path ../../../maas-ui --maas-ops-ui-path ../../../maas-ops-ui --broker-manager-path ../../../broker-manager --format json
+
+        working-directory: maas-react-components-repo/tools/mrc-usage-report
+
+      - name: Split merged JSON
+        run: |
+          echo "==== SPLIT MERGED JSON ===="
+          echo "Current working directory: $(pwd)"
+          ls -la
+          echo "Checking for input file:"
+          ls -la ../mrc-usage-report/reports/mrc-usage-report-all.json || echo "merged-report.json not found"
+          echo "Creating reports directory if it doesn't exist..."
+          echo "Installing dependencies..."
+          npm install
+
+          npm install
+          npm run build
+
+          echo "Running npm start with parameters..."
+          npm start -- -i ../mrc-usage-report/reports/mrc-usage-report-all.json -o ../../../maas-react-components-repo/mrc-usage-report-data
+          echo "--- Verifying contents of output directory ---"
+          pwd
+          ls -lR ../../../maas-react-components-repo/mrc-usage-report-data
+
+          echo "Listing generated files:"
+          find . -type f -name "*.json" | sort
+
+          echo "Contents of first split file (if any):"
+          find . -type f -name "*.json" | sort | head -n 1 | xargs cat || echo "No split files found"
+
+        working-directory: maas-react-components-repo/tools/mrc-usage-report-json-splitter
+
+      - name: Upload merged reports
+        uses: actions/upload-artifact@v4
+        with:
+          name: merged-reports
+          path: |
+            maas-react-components-repo/tools/mrc-usage-report/reports/
+            maas-react-components-repo/mrc-usage-report-data
+
+      - name: Commit and push report data
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+
+          cd maas-react-components-repo
+          echo "--- Verifying directory before git add ---"
+          echo "Current working directory: $(pwd)"
+          echo "Listing contents of current directory:"
+          ls -la
+          echo "Checking mrc-usage-report-data directory:"
+          ls -lR mrc-usage-report-data
+          pwd
+
+          git config --global user.name "github-actions[bot]"
+          git config --global user.email "github-actions[bot]@users.noreply.github.com"
+
+          echo "--- Git status before add ---"
+          git status
+          git add .
+          echo "--- Git status after add ---"
+          git status
+
+          if git diff --staged --quiet; then
+            echo "No changes to commit."
+          else
+            set -e
+            COMMIT_MESSAGE="feat: add mrc usage report data for $(date +'%Y-%m-%d %H:%M')"
+            git commit --no-verify -m "$COMMIT_MESSAGE"
+            git push
+          fi

.github/workflows/new-components-report.yml

@@ -0,0 +1,79 @@
+name: New Components Report
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: read
+
+jobs:
+  build-report:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          ref: feature/mrc-usage-report-data
+
+      - name: Generate new components report
+        env:
+          LITELLM_API_KEY: ${{ secrets.LITELLM_API_KEY }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          set -e
+
+          PROMPT_FILE="prompts/new-components-report/new-components-report-prompt.md"
+          PROMPT_CONTENT=$(cat "$PROMPT_FILE")
+
+          JSON_PAYLOAD=$(jq -n \
+            --arg prompt "$PROMPT_CONTENT" \
+            --arg github_token "$GITHUB_TOKEN" \
+            '{
+              "model": "claude-3-5-sonnet",
+              "messages": [
+                {
+                  "role": "user",
+                  "content": $prompt
+                }
+              ],
+              "metadata": {
+                "github_token": $github_token
+              }
+            }')
+
+          API_RESPONSE=$(curl -s -X POST "https://lite-llm.mymaas.net/chat/completions" \
+            -H "Content-Type: application/json" \
+            -H "Authorization: Bearer $LITELLM_API_KEY" \
+            -d "$JSON_PAYLOAD")
+
+          REPORT_CONTENT=$(echo "$API_RESPONSE" | jq -r '.choices[0].message.content')
+
+          MARKDOWN_REPORT=$(echo "$REPORT_CONTENT" | awk '/```markdown/{flag=1; next} /```/{flag=0} flag')
+          HTML_REPORT=$(echo "$REPORT_CONTENT" | awk '/```html/{flag=1; next} /```/{flag=0} flag')
+
+          echo "$MARKDOWN_REPORT" > prompts/new-components-report/new-components-report.md
+          echo "$HTML_REPORT" > prompts/new-components-report/new-components-report.html
+
+          echo "Reports generated:"
+          echo "Markdown: prompts/new-components-report/new-components-report.md"
+          echo "HTML: prompts/new-components-report/new-components-report.html"
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: new-components-report
+          path: |
+            prompts/new-components-report/new-components-report.md
+            prompts/new-components-report/new-components-report.html
+
+      - name: Set current date
+        run: echo "CURRENT_DATE=$(date +'%Y-%m-%d %H:%M')" >> $GITHUB_ENV
+
+      - name: Commit report files
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          commit_message: "docs: update new components report (${{ env.CURRENT_DATE }})"
+          branch: feature/new-component-data
+          file_pattern: prompts/new-components-report/new-components-report.md prompts/new-components-report/new-components-report.html

.gitignore

@@ -8,3 +8,9 @@ storybook/coverage
 storybook/.nyc_output
 *.iml
 .DS_Store
+
+tools/mrc-usage-report-json-splitter/output
+tools/mrc-usage-report-broker-manager/reports
+tools/mrc-usage-report-maas-ops-ui/reports
+tools/mrc-usage-report-maas-ui/reports
+tools/mrc-usage-report-merger/merged-reports

mrc-usage-report-data/per-application/broker-manager/broker-manager/SolaceButton/commonProps.json

@@ -0,0 +1 @@
+[{"name":"variant","count":3},{"name":"href","count":2},{"name":"target","count":1},{"name":"onClick","count":1}]

mrc-usage-report-data/per-application/broker-manager/broker-manager/SolaceButton/customization.json

@@ -0,0 +1 @@
+{"styledComponentCount":0,"customStylesCount":0,"overriddenPropertiesCounts":{}}

mrc-usage-report-data/per-application/broker-manager/broker-manager/SolaceButton/files.json

@@ -0,0 +1 @@
+["../../../broker-manager/src/pages/help/learning-centre/react-components/standard-card.js","../../../broker-manager/src/pages/help/learning-centre/react-components/section.js"]

mrc-usage-report-data/per-application/broker-manager/broker-manager/SolaceButton/instances.json

@@ -0,0 +1 @@
+{"keyMap":{"filePath":"a","name":"b","props":"c","type":"d","value":"e"},"data":[{"a":"../../../broker-manager/src/pages/help/learning-centre/react-components/standard-card.js","c":[{"b":"href","d":"expression","e":"sublink.url"},{"b":"variant","d":"string","e":"link"},{"b":"target","d":"string","e":"_blank"}]},{"a":"../../../broker-manager/src/pages/help/learning-centre/react-components/standard-card.js","c":[{"b":"onClick","d":"variable","e":"handleTutorialClick"},{"b":"variant","d":"string","e":"text"}]},{"a":"../../../broker-manager/src/pages/help/learning-centre/react-components/section.js","c":[{"b":"variant","d":"string","e":"link"},{"b":"href","d":"expression","e":"footer.url"}]}]}

mrc-usage-report-data/per-application/broker-manager/broker-manager/SolaceButton/totalUsages.json

@@ -0,0 +1 @@
+3

mrc-usage-report-data/per-application/broker-manager/broker-manager/SolaceButton/usagesByMfe.json

@@ -0,0 +1 @@
+{"broker-manager":3}

mrc-usage-report-data/per-application/broker-manager/broker-manager/SolaceCard/commonProps.json

@@ -0,0 +1 @@
+[{"name":"dataQa","count":2},{"name":"width","count":2},{"name":"minWidth","count":1},{"name":"readOnly","count":1},{"name":"cardHeaderProps","count":1},{"name":"height","count":1},{"name":"padding","count":1},{"name":"onClick","count":1},{"name":"cardContent","count":1}]

mrc-usage-report-data/per-application/broker-manager/broker-manager/SolaceCard/customization.json

@@ -0,0 +1 @@
+{"styledComponentCount":0,"customStylesCount":0,"overriddenPropertiesCounts":{}}

mrc-usage-report-data/per-application/broker-manager/broker-manager/SolaceCard/files.json

@@ -0,0 +1 @@
+["../../../broker-manager/src/pages/help/learning-centre/react-components/standard-card.js","../../../broker-manager/src/pages/help/learning-centre/react-components/top-level-card.js"]

mrc-usage-report-data/per-application/broker-manager/broker-manager/SolaceCard/instances.json

@@ -0,0 +1 @@
+{"keyMap":{"filePath":"a","name":"b","props":"c","type":"d","value":"e"},"data":[{"a":"../../../broker-manager/src/pages/help/learning-centre/react-components/standard-card.js","c":[{"b":"dataQa","d":"string","e":"standard-card"},{"b":"minWidth","d":"string","e":"371px"},{"b":"width","d":"string","e":"475px"},{"b":"readOnly","d":"boolean","e":"true"},{"b":"cardHeaderProps","d":"object","e":"{\n        title: title,\n        subTitle: description,\n        icon: (\n          <img \n            width=\"80px\"\n            height=\"40px\"\n            src={image}\n            style={{\n              display: \"block\",\n              objectFit: \"cover\",\n              objectPosition: \"center\",\n            }}\n          />\n        ),\n        actionElements: (\n          <div style={{ alignItems: 'center', display: 'flex', gap: '8px' }}>\n            <SolaceButton onClick={handleTutorialClick} variant=\"text\">\n              Tutorials\n            </SolaceButton>\n            <SolaceMenu\n              buttonProps={{\n                'aria-label': 'Actions menu',\n                children: <MoreHorizOutlinedIcon />,\n                title: 'Actions',\n                variant: 'icon',\n              }}\n              items={generateMenuItems()}\n              numOfMenuItemDisplayed={3}\n            />\n          </div>\n        ),\n      }"}]},{"a":"../../../broker-manager/src/pages/help/learning-centre/react-components/top-level-card.js","c":[{"b":"dataQa","d":"string","e":"top-level-card"},{"b":"height","d":"string","e":"300px"},{"b":"width","d":"string","e":"300px"},{"b":"padding","d":"string","e":"0px"},{"b":"onClick","d":"function","e":"() => window.open(url, \"_blank\")"},{"b":"cardContent","d":"jsx","e":"<div className='top-level-card'>\n          {image && <img src={image} className='image'/>}\n          <div className='description'>\n            <h5>{title}</h5>              \n            <p className=\"margin\">{description}</p>\n          </div>\n        </div>"}]}]}

mrc-usage-report-data/per-application/broker-manager/broker-manager/SolaceCard/totalUsages.json

@@ -0,0 +1 @@
+2

mrc-usage-report-data/per-application/broker-manager/broker-manager/SolaceCard/usagesByMfe.json

@@ -0,0 +1 @@
+{"broker-manager":2}

mrc-usage-report-data/per-application/broker-manager/broker-manager/SolaceMenu/commonProps.json

@@ -0,0 +1 @@
+[{"name":"buttonProps","count":1},{"name":"items","count":1},{"name":"numOfMenuItemDisplayed","count":1}]

mrc-usage-report-data/per-application/broker-manager/broker-manager/SolaceMenu/customization.json

@@ -0,0 +1 @@
+{"styledComponentCount":0,"customStylesCount":0,"overriddenPropertiesCounts":{}}

mrc-usage-report-data/per-application/broker-manager/broker-manager/SolaceMenu/files.json

@@ -0,0 +1 @@
+["../../../broker-manager/src/pages/help/learning-centre/react-components/standard-card.js"]

mrc-usage-report-data/per-application/broker-manager/broker-manager/SolaceMenu/instances.json

@@ -0,0 +1 @@
+{"keyMap":{"filePath":"a","name":"b","props":"c","type":"d","value":"e"},"data":[{"a":"../../../broker-manager/src/pages/help/learning-centre/react-components/standard-card.js","c":[{"b":"buttonProps","d":"object","e":"{\n                'aria-label': 'Actions menu',\n                children: <MoreHorizOutlinedIcon />,\n                title: 'Actions',\n                variant: 'icon',\n              }"},{"b":"items","d":"expression","e":"generateMenuItems()"},{"b":"numOfMenuItemDisplayed","d":"number","e":"3"}]}]}

mrc-usage-report-data/per-application/broker-manager/broker-manager/SolaceMenu/totalUsages.json

@@ -0,0 +1 @@
+1

mrc-usage-report-data/per-application/broker-manager/broker-manager/SolaceMenu/usagesByMfe.json

@@ -0,0 +1 @@
+{"broker-manager":1}

mrc-usage-report-data/per-application/broker-manager/broker-manager/SolaceTypography/commonProps.json

@@ -0,0 +1 @@
+[{"name":"variant","count":1}]

mrc-usage-report-data/per-application/broker-manager/broker-manager/SolaceTypography/customization.json

@@ -0,0 +1 @@
+{"styledComponentCount":0,"customStylesCount":0,"overriddenPropertiesCounts":{}}

mrc-usage-report-data/per-application/broker-manager/broker-manager/SolaceTypography/files.json

@@ -0,0 +1 @@
+["../../../broker-manager/src/pages/help/learning-centre/react-components/section.js"]

mrc-usage-report-data/per-application/broker-manager/broker-manager/SolaceTypography/instances.json

@@ -0,0 +1 @@
+{"keyMap":{"filePath":"a","name":"b","props":"c","type":"d","value":"e"},"data":[{"a":"../../../broker-manager/src/pages/help/learning-centre/react-components/section.js","c":[{"b":"variant","d":"string","e":"body1"}]}]}

mrc-usage-report-data/per-application/broker-manager/broker-manager/SolaceTypography/totalUsages.json

@@ -0,0 +1 @@
+1

mrc-usage-report-data/per-application/broker-manager/broker-manager/SolaceTypography/usagesByMfe.json

@@ -0,0 +1 @@
+{"broker-manager":1}