valent-pipeline 0.19.32 → 0.19.33

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "valent-pipeline",
-  "version": "0.19.32",
+  "version": "0.19.33",
   "description": "v3 multi-agent AI pipeline for software development lifecycle",
   "type": "module",
   "bin": {

package/src/lib/spec-conformance.js

@@ -66,10 +66,38 @@ export function isGatableToken(token) {
   return true;
 }
 
-/** Remove a trailing line-comment so a commented-out `// it.skip(...)` is not flagged as a skip. */
-function stripLineComment(line) {
-  const i = line.indexOf('//');
-  return i === -1 ? line : line.slice(0, i);
+/**
+ * Blank out JS/TS comments — both line and block comments — so a skip marker that appears only inside
+ * a comment (a commented-out `// it.skip(...)`, or an `it.skip` mentioned inside a JSDoc/block comment)
+ * is not mistaken for a real skip (HARNESS-GAPS 2026-06-18). Comment bytes become spaces; newlines and
+ * tabs are preserved so line numbers and the waiver line-window stay exact. String / template literals
+ * are tracked, so a comment-looking substring INSIDE a string is left intact — a real marker is never
+ * hidden (no false-negatives).
+ */
+export function stripComments(content) {
+  const s = String(content || '');
+  let out = '';
+  let state = 'code'; // code | line | block | sq | dq | tpl
+  const ws = (ch) => (ch === '\n' || ch === '\t' ? ch : ' ');
+  for (let i = 0; i < s.length; i++) {
+    const c = s[i];
+    const d = s[i + 1];
+    if (state === 'code') {
+      if (c === '/' && d === '/') { state = 'line'; out += '  '; i++; continue; }
+      if (c === '/' && d === '*') { state = 'block'; out += '  '; i++; continue; }
+      if (c === "'") { state = 'sq'; out += c; continue; }
+      if (c === '"') { state = 'dq'; out += c; continue; }
+      if (c === '`') { state = 'tpl'; out += c; continue; }
+      out += c; continue;
+    }
+    if (state === 'line') { if (c === '\n') { state = 'code'; out += c; } else out += ws(c); continue; }
+    if (state === 'block') { if (c === '*' && d === '/') { state = 'code'; out += '  '; i++; } else out += ws(c); continue; }
+    // inside a string/template literal: copy verbatim, honor backslash escapes, close on the quote
+    out += c;
+    if (c === '\\') { out += (s[i + 1] ?? ''); i++; continue; }
+    if ((state === 'sq' && c === "'") || (state === 'dq' && c === '"') || (state === 'tpl' && c === '`')) state = 'code';
+  }
+  return out;
 }
 
 /**
@@ -81,14 +109,16 @@ function stripLineComment(line) {
  */
 function scanSkips(file) {
   const out = [];
-  const lines = (file.content || '').split(/\r?\n/);
-  for (let i = 0; i < lines.length; i++) {
-    const raw = lines[i];
-    const code = stripLineComment(raw);
+  const raw = (file.content || '').split(/\r?\n/);
+  // Match skip markers in CODE only — comments (line `//` and block `/* */`) are blanked so a marker
+  // that merely appears inside a comment is not flagged. The waiver check still reads the RAW line,
+  // since the `valent-waiver:` token lives in a comment / the it.skip() title.
+  const code = stripComments(file.content || '').split(/\r?\n/);
+  for (let i = 0; i < raw.length; i++) {
     SKIP_MARKER.lastIndex = 0;
-    const m = code.match(SKIP_MARKER);
+    const m = (code[i] || '').match(SKIP_MARKER);
     if (!m) continue;
-    const waived = WAIVER_RE.test(raw) || lines.slice(Math.max(0, i - 3), i).some((l) => WAIVER_RE.test(l));
+    const waived = WAIVER_RE.test(raw[i]) || raw.slice(Math.max(0, i - 3), i).some((l) => WAIVER_RE.test(l));
     if (waived) continue;
     out.push({
       kind: 'unwaived-skip',