From c56161c360b9f71b0da4b3289e29dfdac23692a8 Mon Sep 17 00:00:00 2001 From: "freshness-bot[bot]" Date: Sat, 25 Jul 2026 18:09:57 +0000 Subject: [PATCH] docs: Freshness-Audit 2026-07-25 Automatisch erzeugt durch den woechentlichen OSS-Freshness-Audit. Nur Dokumentation und Metadaten, kein Produktivcode. --- .../ISSUE_TEMPLATE/matrix_recommendation.md | 4 ++-- CHANGELOG.md | 10 ++++++++++ README.md | 2 ++ docs/architecture.md | 19 +++++++++++++++++-- 4 files changed, 31 insertions(+), 4 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/matrix_recommendation.md b/.github/ISSUE_TEMPLATE/matrix_recommendation.md index a74d7bc..c1c5c80 100644 --- a/.github/ISSUE_TEMPLATE/matrix_recommendation.md +++ b/.github/ISSUE_TEMPLATE/matrix_recommendation.md @@ -6,7 +6,7 @@ labels: ["recommendation", "content"] ## Which matrix cell? -Specify the matrix cell this recommendation applies to (e.g., "High Growth / Low Engagement"). +Specify the matrix cell this recommendation applies to (e.g., "Quick Wins" or "Strategic"). ## Recommendation Title @@ -22,7 +22,7 @@ What signals or data conditions should cause this recommendation to appear? Desc ## Tags -List relevant tags (e.g., `adoption`, `engagement`, `governance`, `license-risk`). +List relevant tags (e.g., `Apex`, `SOQL`, `LWC`, `Integration`). ## References diff --git a/CHANGELOG.md b/CHANGELOG.md index 51b5690..de6e7bb 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -14,3 +14,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - 9-field prioritization matrix with German recommendations - Settings dialog for API key management - GitHub Pages deployment workflow +- Try-with-sample-screenshot button for the onboarding flow +- OCR calibration for the Org Performance layout, with an opt-in OCR diagnostic panel +- Metadata analyzer for local SFDX projects (Apex CPU/DML/SOQL patterns, row-lock detection, Flow patterns, roll-up/workflow/trigger duplicate detection) — local build only +- AI-generated fix suggestions for metadata findings (BYOK, Claude Haiku by default with a Sonnet option), with session-scoped caching +- Markdown export of analysis results (executive summary and detailed findings), including AI fix suggestions when present +- Severity color coding, tooltips, and context hints in the matrix UI + +### Fixed +- Multiple OCR extraction and counter-parsing fixes for the Org Performance layout +- Recommendations matrix signal-mapping and cell-placement corrections (see `docs/RECOMMENDATIONS_AUDIT.md`) diff --git a/README.md b/README.md index 9381f8a..aa51073 100644 --- a/README.md +++ b/README.md @@ -98,6 +98,8 @@ OrgPulse has two build outputs from a single codebase: - Screenshot diagnostics plus metadata analysis of SFDX projects - Runs on localhost via `npm run dev:local` - Metadata analyzer scans Apex classes, triggers, and Flows for patterns correlating with Scale Center signals +- AI-generated fix suggestions per finding (BYOK, Claude Haiku by default with a Sonnet option) +- Export all findings as a Markdown report (executive summary plus detailed findings) - Not deployed — for architects working with real Salesforce metadata - Command: `npm run dev:local` diff --git a/docs/architecture.md b/docs/architecture.md index 2475315..52c738f 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -46,13 +46,25 @@ The optional Deep Analysis Mode uses the Anthropic Claude Vision API. Instead of src/ ├── index.html # Single-page application shell ├── styles/ -│ └── main.css # Design system + all component styles +│ ├── main.css # Design system + all component styles +│ └── metadata.css # Local-build metadata section styles ├── js/ │ ├── matrix.js # Main entry point — orchestrates everything │ ├── ocr.js # Tesseract.js OCR integration │ ├── vision.js # Anthropic Claude Vision API integration │ ├── settings.js # API key management modal +│ ├── validation.js # Metric whitelist validation for Vision findings │ └── recommendations.js # Maps analysis results to matrix cells +├── api/ +│ └── claudeClient.js # Shared Claude API call helper (timeout, typed errors) +├── ui/ +│ ├── metadataSection.js # Local-build metadata analysis UI +│ └── markdownExporter.js # Markdown report export +├── metadata/ # Local-build-only: SFDX project metadata analysis +│ ├── index.js # Public API for the metadata module +│ ├── analyzers/ # apexCpuAnalyzer, apexRowLockAnalyzer, flowAnalyzer, metadataAnalyzer +│ ├── fixSuggestions/ # AI-generated fix suggestions (fixSuggester.js, fixCache.js) +│ └── fs/ # File System Access API integration (directory picker, file reader) └── data/ └── recommendations.json # 9-field matrix content and recommendations ``` @@ -64,7 +76,10 @@ matrix.js (entry point) ├── settings.js (API key CRUD) ├── ocr.js (Tesseract.js, lazy-loaded) ├── vision.js (Claude API, imports settings.js) -└── recommendations.js (matching logic) +├── recommendations.js (matching logic) +└── ui/metadataSection.js (local build only, lazy-loaded) + ├── metadata/index.js (SFDX project analysis) + └── metadata/fixSuggestions/ (imports api/claudeClient.js) ``` ## Data Flow