Merge pull request #15 from devopsabcs-engineering/feature/2023-fix-ibm-helpurl-latest Fixes AB#2023

fix: normalize IBM helpUrl to use /archives/latest/ instead of versio…


Fixes AB#2023

Author: emmanuelknafo

src/lib/report/__tests__/sarif-generator.test.ts

@@ -152,11 +152,11 @@ describe('generateSarif', () => {
   it('IBM rule IDs with underscores produce valid markdown links', () => {
     const violations = [makeViolation({
       id: 'label_name_visible',
-      helpUrl: 'https://able.ibm.com/rules/archives/2026.03.04/doc/en-US/label_name_visible.html',
+      helpUrl: 'https://able.ibm.com/rules/archives/latest/doc/en-US/label_name_visible.html',
     })];
     const sarif = generateSarif('https://example.com', violations, '1.0.0');
     const markdown = sarif.runs[0].tool.driver.rules[0].help.markdown;
-    expect(markdown).toContain('[Rule documentation](https://able.ibm.com/rules/archives/2026.03.04/doc/en-US/label_name_visible.html)');
+    expect(markdown).toContain('[Rule documentation](https://able.ibm.com/rules/archives/latest/doc/en-US/label_name_visible.html)');
     expect(markdown).not.toContain('label\\_name');
   });
 });

src/lib/scanner/__tests__/result-normalizer.test.ts

@@ -169,12 +169,12 @@ describe('normalizeIbmResults', () => {
     expect(result[0].helpUrl).toBe('https://able.ibm.com/rules/archives/latest/doc/en-US/img_alt_valid.html');
   });
 
-  it('extracts base URL from IBM help field', () => {
+  it('extracts base URL from IBM help field and normalizes to latest archive', () => {
     const result = normalizeIbmResults([makeIbmResult({
       ruleId: 'style_color_misuse',
       help: 'https://able.ibm.com/rules/archives/2026.03.04/doc/en-US/style_color_misuse.html#ruleInfo=%7B%22someKey%22%3A%22someValue%22%7D',
     })]);
-    expect(result[0].helpUrl).toBe('https://able.ibm.com/rules/archives/2026.03.04/doc/en-US/style_color_misuse.html');
+    expect(result[0].helpUrl).toBe('https://able.ibm.com/rules/archives/latest/doc/en-US/style_color_misuse.html');
   });
 
   it('falls back to archive URL when help is not a URL', () => {
@@ -191,6 +191,7 @@ describe('normalizeIbmResults', () => {
       help: 'https://able.ibm.com/rules/archives/2026.03.04/doc/en-US/some_rule.html',
     })]);
     expect(result[0].help).toBe('Human readable text');
+    expect(result[0].helpUrl).toBe('https://able.ibm.com/rules/archives/latest/doc/en-US/some_rule.html');
   });
 
   it('includes category as a tag when present', () => {

src/lib/scanner/result-normalizer.ts

@@ -56,7 +56,10 @@ function extractIbmHelpUrl(rawHelp: string | undefined, ruleId: string): string
   if (rawHelp) {
     try {
       const url = new URL(rawHelp);
-      return `${url.origin}${url.pathname}`;
+      const ruleFile = url.pathname.split('/').pop();
+      if (ruleFile) {
+        return `https://able.ibm.com/rules/archives/latest/doc/en-US/${ruleFile}`;
+      }
     } catch {
       // not a URL, fall through
     }