@opensip-tools/fitness 1.0.7 → 1.0.8

package/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
 
-> @opensip-tools/fitness@1.0.7 build /home/runner/work/opensip-tools/opensip-tools/packages/fitness/engine
+> @opensip-tools/fitness@1.0.8 build /home/runner/work/opensip-tools/opensip-tools/packages/fitness/engine
 > tsc
 

package/.turbo/turbo-test.log

@@ -1,48 +1,49 @@
 
-> @opensip-tools/fitness@1.0.7 test /home/runner/work/opensip-tools/opensip-tools/packages/fitness/engine
+> @opensip-tools/fitness@1.0.8 test /home/runner/work/opensip-tools/opensip-tools/packages/fitness/engine
 > vitest run --passWithNoTests
 
 
  RUN  v2.1.9 /home/runner/work/opensip-tools/opensip-tools/packages/fitness/engine
 
- ✓ src/__tests__/gate.test.ts (28 tests) 203ms
- ✓ src/framework/__tests__/registry.test.ts (24 tests) 140ms
- ✓ src/recipes/__tests__/service.test.ts (28 tests) 1111ms
- ✓ src/framework/__tests__/import-graph.test.ts (20 tests) 689ms
-   ✓ findStronglyConnectedComponents > handles a deep graph without recursion blowing the stack 467ms
- ✓ src/plugins/__tests__/check-package-discovery.test.ts (16 tests) 213ms
- ✓ src/recipes/__tests__/check-resolution.test.ts (14 tests) 106ms
- ✓ src/__tests__/sarif.test.ts (15 tests) 71ms
- ✓ src/plugins/__tests__/lang-domain.test.ts (8 tests) 231ms
- ✓ src/framework/__tests__/result-builder.test.ts (25 tests) 118ms
- ✓ src/framework/__tests__/scope-resolver.test.ts (8 tests) 249ms
- ✓ src/plugins/__tests__/loader.test.ts (10 tests) 5899ms
-   ✓ loadPlugin > registers Check instances exported as named exports (no array wrapper) 5739ms
- ✓ src/framework/__tests__/define-check.test.ts (17 tests) 52ms
- ✓ src/framework/__tests__/content-filter.test.ts (10 tests) 13ms
- ✓ src/framework/__tests__/file-cache.test.ts (15 tests) 247ms
- ✓ src/framework/__tests__/path-matcher.test.ts (12 tests) 137ms
- ✓ src/framework/__tests__/content-filter-dispatch.test.ts (6 tests) 60ms
- ✓ src/recipes/__tests__/registry.test.ts (15 tests) 34ms
- ✓ src/targets/__tests__/loader.test.ts (11 tests) 112ms
- ✓ src/framework/__tests__/file-accessor.test.ts (11 tests) 117ms
- ✓ src/framework/__tests__/strip-literals.test.ts (17 tests) 28ms
- ✓ src/framework/__tests__/ast-utilities.test.ts (19 tests) 143ms
- ✓ src/recipes/__tests__/built-in-recipes.test.ts (14 tests) 54ms
- ✓ src/targets/__tests__/target-registry.test.ts (11 tests) 18ms
- ✓ src/signalers/__tests__/loader.test.ts (8 tests) 63ms
- ✓ src/framework/__tests__/execution-context.test.ts (4 tests) 175ms
- ✓ src/recipes/__tests__/retry.test.ts (6 tests) 22ms
- ✓ src/framework/__tests__/directive-inventory.test.ts (9 tests) 28ms
- ✓ src/framework/__tests__/command-executor.test.ts (5 tests) 78ms
- ✓ src/targets/__tests__/resolver.test.ts (6 tests) 54ms
- ✓ src/framework/__tests__/check-config.test.ts (6 tests) 22ms
- ✓ src/framework/__tests__/severity-mapping.test.ts (13 tests) 14ms
- ✓ src/framework/__tests__/register-helpers.test.ts (4 tests) 23ms
- ✓ src/recipes/__tests__/check-config.test.ts (4 tests) 11ms
+ ✓ src/__tests__/gate.test.ts (28 tests) 258ms
+ ✓ src/recipes/__tests__/service.test.ts (28 tests) 672ms
+ ✓ src/framework/__tests__/registry.test.ts (24 tests) 73ms
+ ✓ src/framework/__tests__/import-graph.test.ts (20 tests) 778ms
+   ✓ findStronglyConnectedComponents > handles a deep graph without recursion blowing the stack 533ms
+ ✓ src/plugins/__tests__/check-package-discovery.test.ts (16 tests) 244ms
+ ✓ src/recipes/__tests__/check-resolution.test.ts (14 tests) 155ms
+ ✓ src/__tests__/sarif.test.ts (15 tests) 70ms
+ ✓ src/plugins/__tests__/lang-domain.test.ts (8 tests) 142ms
+ ✓ src/framework/__tests__/result-builder.test.ts (25 tests) 114ms
+ ✓ src/framework/__tests__/scope-resolver.test.ts (8 tests) 265ms
+ ✓ src/plugins/__tests__/loader.test.ts (10 tests) 6800ms
+   ✓ loadPlugin > registers Check instances exported as named exports (no array wrapper) 6459ms
+ ✓ src/framework/__tests__/content-filter.test.ts (10 tests) 74ms
+ ✓ src/framework/__tests__/define-check.test.ts (17 tests) 62ms
+ ✓ src/framework/__tests__/file-cache.test.ts (15 tests) 137ms
+ ✓ src/framework/__tests__/path-matcher.test.ts (12 tests) 194ms
+ ✓ src/framework/__tests__/content-filter-dispatch.test.ts (6 tests) 93ms
+ ✓ src/recipes/__tests__/registry.test.ts (15 tests) 20ms
+ ✓ src/targets/__tests__/loader.test.ts (11 tests) 94ms
+ ✓ src/framework/__tests__/file-accessor.test.ts (11 tests) 106ms
+ ✓ src/framework/__tests__/strip-literals.test.ts (17 tests) 26ms
+ ✓ src/framework/__tests__/ast-utilities.test.ts (19 tests) 96ms
+ ✓ src/recipes/__tests__/built-in-recipes.test.ts (14 tests) 62ms
+ ✓ src/targets/__tests__/target-registry.test.ts (11 tests) 43ms
+ ✓ src/framework/__tests__/execution-context.test.ts (4 tests) 118ms
+ ✓ src/signalers/__tests__/loader.test.ts (8 tests) 109ms
+ ✓ src/recipes/__tests__/retry.test.ts (6 tests) 20ms
+ ✓ src/framework/__tests__/directive-parsing.test.ts (8 tests) 8ms
+ ✓ src/targets/__tests__/resolver.test.ts (6 tests) 67ms
+ ✓ src/framework/__tests__/command-executor.test.ts (5 tests) 106ms
+ ✓ src/framework/__tests__/directive-inventory.test.ts (9 tests) 8ms
+ ✓ src/framework/__tests__/check-config.test.ts (6 tests) 16ms
+ ✓ src/framework/__tests__/severity-mapping.test.ts (13 tests) 17ms
+ ✓ src/framework/__tests__/register-helpers.test.ts (4 tests) 17ms
+ ✓ src/recipes/__tests__/check-config.test.ts (4 tests) 12ms
 
- Test Files  33 passed (33)
-      Tests  419 passed (419)
-   Start at  20:35:32
-   Duration  22.43s (transform 5.92s, setup 0ms, collect 22.40s, tests 10.53s, environment 31ms, prepare 10.76s)
+ Test Files  34 passed (34)
+      Tests  427 passed (427)
+   Start at  21:42:26
+   Duration  24.97s (transform 7.13s, setup 0ms, collect 24.18s, tests 11.07s, environment 62ms, prepare 13.30s)
 

package/.turbo/turbo-typecheck.log

@@ -1,4 +1,4 @@
 
-> @opensip-tools/fitness@1.0.7 typecheck /home/runner/work/opensip-tools/opensip-tools/packages/fitness/engine
+> @opensip-tools/fitness@1.0.8 typecheck /home/runner/work/opensip-tools/opensip-tools/packages/fitness/engine
 > tsc --noEmit
 

package/dist/framework/__tests__/directive-parsing.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview Regression tests for the comment-prefix support added
+ * to `extractCheckIdFromDirective` in 1.0.8 (Markdown + HTML + shell/
+ * YAML).
+ *
+ * Prior to 1.0.8 the parser only recognised `//` and `/*` openers, so
+ * pragmas inside Markdown documents (`<!-- @fitness-ignore-file ... -->`)
+ * or YAML/shell files (`# @fitness-ignore-file ...`) silently
+ * failed — the directive was extracted as null and the file was
+ * scanned despite the author's intent.
+ */
+export {};
+//# sourceMappingURL=directive-parsing.test.d.ts.map

package/dist/framework/__tests__/directive-parsing.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directive-parsing.test.d.ts","sourceRoot":"","sources":["../../../src/framework/__tests__/directive-parsing.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/framework/__tests__/directive-parsing.test.js

@@ -0,0 +1,49 @@
+/**
+ * @fileoverview Regression tests for the comment-prefix support added
+ * to `extractCheckIdFromDirective` in 1.0.8 (Markdown + HTML + shell/
+ * YAML).
+ *
+ * Prior to 1.0.8 the parser only recognised `//` and `/*` openers, so
+ * pragmas inside Markdown documents (`<!-- @fitness-ignore-file ... -->`)
+ * or YAML/shell files (`# @fitness-ignore-file ...`) silently
+ * failed — the directive was extracted as null and the file was
+ * scanned despite the author's intent.
+ */
+import { describe, expect, it } from 'vitest';
+import { parseFileIgnoreDirective } from '../directive-parsing.js';
+describe('parseFileIgnoreDirective — comment-prefix support', () => {
+    it('recognises `//` (TypeScript / JavaScript / C-family)', () => {
+        const content = '// @fitness-ignore-file file-length-limit -- justified\nrest of file';
+        expect(parseFileIgnoreDirective(content, 'file-length-limit')).toBe(true);
+    });
+    it('recognises `/*` (block comment in JS-family)', () => {
+        const content = '/* @fitness-ignore-file file-length-limit -- justified */\nrest of file';
+        expect(parseFileIgnoreDirective(content, 'file-length-limit')).toBe(true);
+    });
+    it('recognises `<!--` (Markdown + HTML)', () => {
+        const content = '<!-- @fitness-ignore-file file-length-limit -- doc-set catalogue grows by design -->\n# Heading';
+        expect(parseFileIgnoreDirective(content, 'file-length-limit')).toBe(true);
+    });
+    it('recognises `#` (shell / YAML / Python)', () => {
+        const content = '# @fitness-ignore-file file-length-limit -- config grows by design\nkey: value';
+        expect(parseFileIgnoreDirective(content, 'file-length-limit')).toBe(true);
+    });
+    it('does not recognise an unsupported prefix', () => {
+        const content = '; @fitness-ignore-file file-length-limit -- ini-style comments not supported\n[section]';
+        expect(parseFileIgnoreDirective(content, 'file-length-limit')).toBe(false);
+    });
+    it('requires the directive to actually appear after the comment opener', () => {
+        const content = '<!-- not a directive line -->\nrest';
+        expect(parseFileIgnoreDirective(content, 'file-length-limit')).toBe(false);
+    });
+    it('matches only the specific check id requested', () => {
+        const content = '<!-- @fitness-ignore-file other-check -- ... -->\nrest';
+        expect(parseFileIgnoreDirective(content, 'file-length-limit')).toBe(false);
+    });
+    it('only scans the first 50 lines', () => {
+        const filler = Array.from({ length: 60 }, () => 'x').join('\n');
+        const content = `${filler}\n<!-- @fitness-ignore-file file-length-limit -- too late -->`;
+        expect(parseFileIgnoreDirective(content, 'file-length-limit')).toBe(false);
+    });
+});
+//# sourceMappingURL=directive-parsing.test.js.map

package/dist/framework/__tests__/directive-parsing.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"directive-parsing.test.js","sourceRoot":"","sources":["../../../src/framework/__tests__/directive-parsing.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE7C,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAElE,QAAQ,CAAC,mDAAmD,EAAE,GAAG,EAAE;IACjE,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,OAAO,GAAG,sEAAsE,CAAA;QACtF,MAAM,CAAC,wBAAwB,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC3E,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,OAAO,GAAG,yEAAyE,CAAA;QACzF,MAAM,CAAC,wBAAwB,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC3E,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,OAAO,GAAG,iGAAiG,CAAA;QACjH,MAAM,CAAC,wBAAwB,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC3E,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,OAAO,GAAG,gFAAgF,CAAA;QAChG,MAAM,CAAC,wBAAwB,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC3E,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,OAAO,GAAG,yFAAyF,CAAA;QACzG,MAAM,CAAC,wBAAwB,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC5E,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC5E,MAAM,OAAO,GAAG,qCAAqC,CAAA;QACrD,MAAM,CAAC,wBAAwB,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC5E,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,OAAO,GAAG,wDAAwD,CAAA;QACxE,MAAM,CAAC,wBAAwB,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC5E,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC/D,MAAM,OAAO,GAAG,GAAG,MAAM,+DAA+D,CAAA;QACxF,MAAM,CAAC,wBAAwB,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC5E,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/framework/directive-parsing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"directive-parsing.d.ts","sourceRoot":"","sources":["../../src/framework/directive-parsing.ts"],"names":[],"mappings":"AACA;;;;;;;;GAQG;AAsFH;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAClC,OAAO,CAYT;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAClC,GAAG,CAAC,MAAM,CAAC,CAyBb"}
+{"version":3,"file":"directive-parsing.d.ts","sourceRoot":"","sources":["../../src/framework/directive-parsing.ts"],"names":[],"mappings":"AACA;;;;;;;;GAQG;AA6GH;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAClC,OAAO,CAYT;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAClC,GAAG,CAAC,MAAM,CAAC,CAyBb"}

package/dist/framework/directive-parsing.js

@@ -47,15 +47,37 @@ function isCheckIdChar(char) {
     const isSpecialChar = code === 95 || code === 45 || code === 47;
     return isLowerCase || isUpperCase || isDigit || isSpecialChar;
 }
+/**
+ * Comment-opener prefixes the directive parser recognizes. `//` and
+ * `/*` cover the TypeScript / JavaScript / C-family languages; `<!--`
+ * covers Markdown and HTML so doc files (READMEs, arch docs, the
+ * metric taxonomy) can carry `@fitness-ignore-file <slug>` pragmas
+ * the same way source code does. `#` covers shell / YAML / Python so
+ * config files and scripts use the same surface.
+ *
+ * Tuple shape: `[opener, length]`. Length is encoded once here so the
+ * scanner doesn't repeat it per opener — `<!--` is 4 chars, the
+ * others are 2/1.
+ */
+const COMMENT_OPENERS = [
+    ['//', 2],
+    ['/*', 2],
+    ['<!--', 4],
+    ['#', 1],
+];
 function extractCheckIdFromDirective(line, directiveKeyword) {
-    // Both `//` and `/*` are 2-char prefixes; sliceLen is fixed.
-    const sliceLen = 2;
-    let commentIndex = line.indexOf('//');
-    if (commentIndex === -1) {
-        commentIndex = line.indexOf('/*');
-        if (commentIndex === -1)
-            return null;
+    let commentIndex = -1;
+    let sliceLen = 0;
+    for (const [opener, length] of COMMENT_OPENERS) {
+        const idx = line.indexOf(opener);
+        if (idx !== -1) {
+            commentIndex = idx;
+            sliceLen = length;
+            break;
+        }
     }
+    if (commentIndex === -1)
+        return null;
     const afterComment = line.slice(commentIndex + sliceLen).trimStart();
     if (!afterComment.startsWith(directiveKeyword))
         return null;

package/dist/framework/directive-parsing.js.map

@@ -1 +1 @@
-{"version":3,"file":"directive-parsing.js","sourceRoot":"","sources":["../../src/framework/directive-parsing.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"directive-parsing.js","sourceRoot":"","sources":["../../src/framework/directive-parsing.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opensip-tools/fitness",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "license": "MIT",
   "description": "Fitness checks engine for OpenSIP Tools",
   "repository": {
@@ -28,8 +28,8 @@
     "minimatch": "^10.0.0",
     "typescript": "~5.7.0",
     "zod": "^3.24.0",
-    "@opensip-tools/contracts": "1.0.7",
-    "@opensip-tools/core": "1.0.7"
+    "@opensip-tools/core": "1.0.8",
+    "@opensip-tools/contracts": "1.0.8"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.0",

package/src/framework/__tests__/directive-parsing.test.ts

@@ -0,0 +1,58 @@
+/**
+ * @fileoverview Regression tests for the comment-prefix support added
+ * to `extractCheckIdFromDirective` in 1.0.8 (Markdown + HTML + shell/
+ * YAML).
+ *
+ * Prior to 1.0.8 the parser only recognised `//` and `/*` openers, so
+ * pragmas inside Markdown documents (`<!-- @fitness-ignore-file ... -->`)
+ * or YAML/shell files (`# @fitness-ignore-file ...`) silently
+ * failed — the directive was extracted as null and the file was
+ * scanned despite the author's intent.
+ */
+
+import { describe, expect, it } from 'vitest'
+
+import { parseFileIgnoreDirective } from '../directive-parsing.js'
+
+describe('parseFileIgnoreDirective — comment-prefix support', () => {
+  it('recognises `//` (TypeScript / JavaScript / C-family)', () => {
+    const content = '// @fitness-ignore-file file-length-limit -- justified\nrest of file'
+    expect(parseFileIgnoreDirective(content, 'file-length-limit')).toBe(true)
+  })
+
+  it('recognises `/*` (block comment in JS-family)', () => {
+    const content = '/* @fitness-ignore-file file-length-limit -- justified */\nrest of file'
+    expect(parseFileIgnoreDirective(content, 'file-length-limit')).toBe(true)
+  })
+
+  it('recognises `<!--` (Markdown + HTML)', () => {
+    const content = '<!-- @fitness-ignore-file file-length-limit -- doc-set catalogue grows by design -->\n# Heading'
+    expect(parseFileIgnoreDirective(content, 'file-length-limit')).toBe(true)
+  })
+
+  it('recognises `#` (shell / YAML / Python)', () => {
+    const content = '# @fitness-ignore-file file-length-limit -- config grows by design\nkey: value'
+    expect(parseFileIgnoreDirective(content, 'file-length-limit')).toBe(true)
+  })
+
+  it('does not recognise an unsupported prefix', () => {
+    const content = '; @fitness-ignore-file file-length-limit -- ini-style comments not supported\n[section]'
+    expect(parseFileIgnoreDirective(content, 'file-length-limit')).toBe(false)
+  })
+
+  it('requires the directive to actually appear after the comment opener', () => {
+    const content = '<!-- not a directive line -->\nrest'
+    expect(parseFileIgnoreDirective(content, 'file-length-limit')).toBe(false)
+  })
+
+  it('matches only the specific check id requested', () => {
+    const content = '<!-- @fitness-ignore-file other-check -- ... -->\nrest'
+    expect(parseFileIgnoreDirective(content, 'file-length-limit')).toBe(false)
+  })
+
+  it('only scans the first 50 lines', () => {
+    const filler = Array.from({ length: 60 }, () => 'x').join('\n')
+    const content = `${filler}\n<!-- @fitness-ignore-file file-length-limit -- too late -->`
+    expect(parseFileIgnoreDirective(content, 'file-length-limit')).toBe(false)
+  })
+})

package/src/framework/directive-parsing.ts

@@ -56,14 +56,37 @@ function isCheckIdChar(char: string): boolean {
   return isLowerCase || isUpperCase || isDigit || isSpecialChar
 }
 
+/**
+ * Comment-opener prefixes the directive parser recognizes. `//` and
+ * `/*` cover the TypeScript / JavaScript / C-family languages; `<!--`
+ * covers Markdown and HTML so doc files (READMEs, arch docs, the
+ * metric taxonomy) can carry `@fitness-ignore-file <slug>` pragmas
+ * the same way source code does. `#` covers shell / YAML / Python so
+ * config files and scripts use the same surface.
+ *
+ * Tuple shape: `[opener, length]`. Length is encoded once here so the
+ * scanner doesn't repeat it per opener — `<!--` is 4 chars, the
+ * others are 2/1.
+ */
+const COMMENT_OPENERS: readonly (readonly [string, number])[] = [
+  ['//', 2],
+  ['/*', 2],
+  ['<!--', 4],
+  ['#', 1],
+]
+
 function extractCheckIdFromDirective(line: string, directiveKeyword: string): string | null {
-  // Both `//` and `/*` are 2-char prefixes; sliceLen is fixed.
-  const sliceLen = 2
-  let commentIndex = line.indexOf('//')
-  if (commentIndex === -1) {
-    commentIndex = line.indexOf('/*')
-    if (commentIndex === -1) return null
+  let commentIndex = -1
+  let sliceLen = 0
+  for (const [opener, length] of COMMENT_OPENERS) {
+    const idx = line.indexOf(opener)
+    if (idx !== -1) {
+      commentIndex = idx
+      sliceLen = length
+      break
+    }
   }
+  if (commentIndex === -1) return null
 
   const afterComment = line.slice(commentIndex + sliceLen).trimStart()
   if (!afterComment.startsWith(directiveKeyword)) return null