@opensip-cli/checks-universal 0.1.0

package/dist/checks/documentation/public-api-jsdoc.js

@@ -0,0 +1,131 @@
+// @fitness-ignore-file duplicate-implementation-detection -- similar patterns across diagnostic modules
+/**
+ * @fileoverview Public API JSDoc check
+ */
+import { defineCheck } from '@opensip-cli/fitness';
+import { isInPublicApiSurface } from './_public-api-graph.js';
+/**
+ * Patterns for exported declarations that should have JSDoc
+ */
+const EXPORT_PATTERNS = [
+    /^export\s+(?:async\s+)?function\s+(\w+)/,
+    /^export\s+class\s+(\w+)/,
+    /^export\s+interface\s+(\w+)/,
+    /^export\s+type\s+(\w+)\s*=\s*(?!z\.infer)/,
+    /^export\s+const\s+(\w+)\s*=\s*(?:async\s*)?\(/,
+];
+/** Re-export barrels don't need JSDoc */
+const REEXPORT_PATTERN = /^export\s+(?:\{|\*\s+from|type\s+\{)/;
+/**
+ * Determine the kind of export for messaging
+ */
+function getExportKind(line) {
+    if (line.includes('function '))
+        return 'function';
+    if (line.includes('class '))
+        return 'class';
+    if (line.includes('interface '))
+        return 'interface';
+    if (line.includes('type '))
+        return 'type';
+    if (line.includes('const '))
+        return 'const';
+    return 'declaration';
+}
+/**
+ * Analyze a file for missing JSDoc on public API exports.
+ *
+ * Only fires on files that are part of the containing package's
+ * published API surface — files reachable from the package's
+ * `package.json#exports` entries via `export ... from` re-export
+ * chains. Internal helper files (not re-exported from the package
+ * barrel) are skipped: their `export` keyword is a TypeScript
+ * intra-package visibility marker, not part of the npm-published
+ * public API.
+ *
+ * When the package surface cannot be determined (no `package.json`,
+ * no `exports` field), the check falls back to its historical broad
+ * behavior — every `export` is treated as public.
+ */
+// eslint-disable-next-line sonarjs/cognitive-complexity -- Inherent complexity: line-by-line export pattern matching with preceding JSDoc detection and re-export filtering
+function analyzeJsdoc(content, filePath) {
+    if (!isInPublicApiSurface(filePath))
+        return [];
+    const violations = [];
+    const lines = content.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i] ?? '';
+        const trimmed = line.trim();
+        // Skip re-exports (they inherit docs from the source)
+        if (REEXPORT_PATTERN.test(trimmed))
+            continue;
+        // Check if this line is an export declaration
+        for (const pattern of EXPORT_PATTERNS) {
+            const match = pattern.exec(trimmed);
+            if (!match?.[1])
+                continue;
+            const exportName = match[1];
+            // Look backward for JSDoc comment (/** ... */)
+            let hasJsdoc = false;
+            for (let j = i - 1; j >= Math.max(0, i - 15); j--) {
+                const prevLine = (lines[j] ?? '').trim();
+                if (prevLine === '')
+                    continue; // skip blank lines
+                if (prevLine.endsWith('*/')) {
+                    hasJsdoc = true;
+                    break;
+                }
+                if (prevLine.startsWith('//'))
+                    continue; // skip single-line comments
+                if (prevLine.startsWith('*'))
+                    continue; // inside JSDoc block
+                break; // non-comment, non-blank line means no JSDoc
+            }
+            if (!hasJsdoc) {
+                violations.push({
+                    line: i + 1,
+                    message: `Exported ${getExportKind(trimmed)} '${exportName}' is missing JSDoc documentation`,
+                    severity: 'warning',
+                    suggestion: `Add a /** ... */ JSDoc comment describing the purpose of '${exportName}'`,
+                    type: 'missing-jsdoc',
+                    match: trimmed.slice(0, 120),
+                });
+            }
+            break; // Only match first pattern per line
+        }
+    }
+    return violations;
+}
+/**
+ * Check: documentation/public-api-jsdoc
+ *
+ * Requires JSDoc documentation on all public API exports in shared packages.
+ */
+export const publicApiJsdoc = defineCheck({
+    id: '48d891e3-0be3-49bf-9448-723b4664b714',
+    slug: 'public-api-jsdoc',
+    scope: { languages: ['typescript'], concerns: ['backend', 'server'] },
+    contentFilter: 'raw',
+    confidence: 'medium',
+    description: 'Requires JSDoc documentation on all public API exports in shared packages',
+    longDescription: `**Purpose:** Ensures all public API exports in shared packages have JSDoc documentation, since these form the platform's published API surface.
+
+**Detects:**
+- Exported functions, classes, interfaces, types, and function-like constants without \`/** ... */\` JSDoc comments
+- Excludes re-exports (\`export { ... } from\`, \`export * from\`) since they inherit docs from the source
+- Excludes \`z.infer\` type aliases since they are self-documenting
+
+**Why it matters:** Shared packages are consumed by the entire platform. Undocumented public APIs force consumers to read source code to understand behavior.
+
+**Scope:** Files reachable from the package's \`package.json#exports\` entry barrels via \`export ... from\` re-export chains. Internal helper files (not re-exported from the package barrel) are skipped — their \`export\` keyword is an intra-package visibility marker, not part of the npm-published public API.
+
+**Package shape handling:**
+- Packages with an \`exports\` field — surface is the closure of those entries.
+- Packages with only \`main\` / \`module\` — surface is that entry's closure.
+- Binary-only packages (\`bin\` set, no \`exports\` / \`main\` / \`module\`) — empty surface; nothing is flagged.
+- No containing \`package.json\` — falls back to flagging every \`export\` (historical broad behavior, used by ad-hoc fixtures).`,
+    tags: ['documentation', 'api', 'quality'],
+    fileTypes: ['ts'],
+    analyze: analyzeJsdoc,
+});
+//# sourceMappingURL=public-api-jsdoc.js.map

package/dist/checks/documentation/public-api-jsdoc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api-jsdoc.js","sourceRoot":"","sources":["../../../src/checks/documentation/public-api-jsdoc.ts"],"names":[],"mappings":"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"}

package/dist/checks/file-length-limit.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @fileoverview Flag files that exceed a recommended line count.
+ *
+ * Operates on raw content — file length is identical regardless of
+ * language. Counts only non-empty lines so massive whitespace-padded
+ * files don't slip through and trivial generated boilerplate isn't
+ * over-counted (configurable later if needed).
+ */
+import { type CheckViolation } from '@opensip-cli/fitness';
+/**
+ * Pure analysis function. Exported so unit tests can exercise the
+ * line-counting logic without spinning up an ExecutionContext.
+ */
+export declare function analyzeFileLength(content: string): CheckViolation[];
+export declare const fileLengthLimit: import("@opensip-cli/fitness").Check;
+//# sourceMappingURL=file-length-limit.d.ts.map

package/dist/checks/file-length-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-length-limit.d.ts","sourceRoot":"","sources":["../../src/checks/file-length-limit.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAe,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAKxE;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE,CAqBnE;AAED,eAAO,MAAM,eAAe,sCAO1B,CAAC"}

package/dist/checks/file-length-limit.js

@@ -0,0 +1,47 @@
+/**
+ * @fileoverview Flag files that exceed a recommended line count.
+ *
+ * Operates on raw content — file length is identical regardless of
+ * language. Counts only non-empty lines so massive whitespace-padded
+ * files don't slip through and trivial generated boilerplate isn't
+ * over-counted (configurable later if needed).
+ */
+import { defineCheck } from '@opensip-cli/fitness';
+const SOFT_LIMIT = 400;
+const HARD_LIMIT = 800;
+/**
+ * Pure analysis function. Exported so unit tests can exercise the
+ * line-counting logic without spinning up an ExecutionContext.
+ */
+export function analyzeFileLength(content) {
+    const lines = content.split('\n').filter((l) => l.trim().length > 0);
+    if (lines.length <= SOFT_LIMIT)
+        return [];
+    const violations = [];
+    if (lines.length > HARD_LIMIT) {
+        violations.push({
+            message: `File has ${lines.length} non-empty lines (hard limit ${HARD_LIMIT})`,
+            severity: 'error',
+            line: 1,
+            suggestion: 'Split this file into focused modules organized by responsibility',
+        });
+    }
+    else {
+        violations.push({
+            message: `File has ${lines.length} non-empty lines (soft limit ${SOFT_LIMIT})`,
+            severity: 'warning',
+            line: 1,
+            suggestion: 'Consider splitting before this exceeds the hard limit',
+        });
+    }
+    return violations;
+}
+export const fileLengthLimit = defineCheck({
+    id: 'fc8b5ec9-d020-4e76-b16f-f5f73ce9d21e',
+    slug: 'file-length-limit',
+    description: `Files longer than ${HARD_LIMIT} lines hint at insufficient module decomposition`,
+    scope: { languages: [], concerns: [] },
+    tags: ['quality', 'modularity'],
+    analyze: (content) => analyzeFileLength(content),
+});
+//# sourceMappingURL=file-length-limit.js.map

package/dist/checks/file-length-limit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-length-limit.js","sourceRoot":"","sources":["../../src/checks/file-length-limit.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,WAAW,EAAuB,MAAM,sBAAsB,CAAC;AAExE,MAAM,UAAU,GAAG,GAAG,CAAC;AACvB,MAAM,UAAU,GAAG,GAAG,CAAC;AAEvB;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrE,IAAI,KAAK,CAAC,MAAM,IAAI,UAAU;QAAE,OAAO,EAAE,CAAC;IAE1C,MAAM,UAAU,GAAqB,EAAE,CAAC;IACxC,IAAI,KAAK,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;QAC9B,UAAU,CAAC,IAAI,CAAC;YACd,OAAO,EAAE,YAAY,KAAK,CAAC,MAAM,gCAAgC,UAAU,GAAG;YAC9E,QAAQ,EAAE,OAAO;YACjB,IAAI,EAAE,CAAC;YACP,UAAU,EAAE,kEAAkE;SAC/E,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,UAAU,CAAC,IAAI,CAAC;YACd,OAAO,EAAE,YAAY,KAAK,CAAC,MAAM,gCAAgC,UAAU,GAAG;YAC9E,QAAQ,EAAE,SAAS;YACnB,IAAI,EAAE,CAAC;YACP,UAAU,EAAE,uDAAuD;SACpE,CAAC,CAAC;IACL,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,WAAW,CAAC;IACzC,EAAE,EAAE,sCAAsC;IAC1C,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE,qBAAqB,UAAU,kDAAkD;IAC9F,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;IACtC,IAAI,EAAE,CAAC,SAAS,EAAE,YAAY,CAAC;IAC/B,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,iBAAiB,CAAC,OAAO,CAAC;CACjD,CAAC,CAAC"}

package/dist/checks/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @fileoverview Top-level barrel for cross-language fitness checks
+ *
+ * Re-exports every category in this package, plus the existing
+ * single-file checks (`file-length-limit`, `no-todo-comments`).
+ */
+export * from './architecture/index.js';
+export * from './documentation/index.js';
+export * from './quality/index.js';
+export * from './resilience/index.js';
+export * from './security/index.js';
+export * from './testing/index.js';
+export * from './file-length-limit.js';
+export * from './no-todo-comments.js';
+export * from './no-unimplemented-markers.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/checks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/checks/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC"}

package/dist/checks/index.js

@@ -0,0 +1,16 @@
+/**
+ * @fileoverview Top-level barrel for cross-language fitness checks
+ *
+ * Re-exports every category in this package, plus the existing
+ * single-file checks (`file-length-limit`, `no-todo-comments`).
+ */
+export * from './architecture/index.js';
+export * from './documentation/index.js';
+export * from './quality/index.js';
+export * from './resilience/index.js';
+export * from './security/index.js';
+export * from './testing/index.js';
+export * from './file-length-limit.js';
+export * from './no-todo-comments.js';
+export * from './no-unimplemented-markers.js';
+//# sourceMappingURL=index.js.map

package/dist/checks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/checks/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC"}

package/dist/checks/no-todo-comments.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @fileoverview Cross-language TODO/FIXME comment detection.
+ *
+ * Uses the language adapter's `strip-strings` filter so TODO markers
+ * appearing inside string literals don't false-fire. The filter
+ * dispatches through the registered LanguageAdapter, so this check
+ * works for any language whose adapter implements stripStrings.
+ */
+import { type CheckViolation } from '@opensip-cli/fitness';
+/**
+ * Pure analysis function. Exported so unit tests can exercise the
+ * detection logic without standing up the full Check framework
+ * (defineCheck wraps `analyze` into an `execute` closure that
+ * requires an ExecutionContext to invoke).
+ */
+export declare function analyzeTodoComments(content: string): CheckViolation[];
+export declare const noTodoComments: import("@opensip-cli/fitness").Check;
+//# sourceMappingURL=no-todo-comments.d.ts.map

package/dist/checks/no-todo-comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-todo-comments.d.ts","sourceRoot":"","sources":["../../src/checks/no-todo-comments.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,OAAO,EAA2B,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAQpF;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE,CAiBrE;AAED,eAAO,MAAM,cAAc,sCAoCzB,CAAC"}

package/dist/checks/no-todo-comments.js

@@ -0,0 +1,79 @@
+/* eslint-disable sonarjs/fixme-tag -- this file's job is to detect TODO/FIXME markers; the words appear in identifiers and JSDoc by necessity */
+// @fitness-ignore-file no-todo-comments -- this file's job is to detect TODO/FIXME/XXX/OPTIMIZE markers; the words appear in regex and JSDoc by design
+/**
+ * @fileoverview Cross-language TODO/FIXME comment detection.
+ *
+ * Uses the language adapter's `strip-strings` filter so TODO markers
+ * appearing inside string literals don't false-fire. The filter
+ * dispatches through the registered LanguageAdapter, so this check
+ * works for any language whose adapter implements stripStrings.
+ */
+import { defineCheck, isTestFile } from '@opensip-cli/fitness';
+// HACK is intentionally excluded — `no-temporary-workarounds` owns HACK
+// (with qualifier needles like "temporary"/"workaround"). Including HACK
+// here as well caused duplicate findings on the same line; see the
+// 2026-05-23 checks-universal architecture audit, NF1.
+const TODO_PATTERN = /\b(TODO|FIXME|XXX|OPTIMIZE)\b/g;
+/**
+ * Pure analysis function. Exported so unit tests can exercise the
+ * detection logic without standing up the full Check framework
+ * (defineCheck wraps `analyze` into an `execute` closure that
+ * requires an ExecutionContext to invoke).
+ */
+export function analyzeTodoComments(content) {
+    const violations = [];
+    const lines = content.split('\n');
+    for (const [i, line_] of lines.entries()) {
+        const line = line_;
+        let match;
+        TODO_PATTERN.lastIndex = 0;
+        while ((match = TODO_PATTERN.exec(line)) !== null) {
+            violations.push({
+                message: `${match[1]} marker should be tracked in an issue, not left in source`,
+                severity: 'warning',
+                line: i + 1,
+                suggestion: 'File an issue and remove the marker, or convert to a tracked work item',
+            });
+        }
+    }
+    return violations;
+}
+export const noTodoComments = defineCheck({
+    id: '842e7d00-c8e8-4a57-873a-c03caec7e603',
+    slug: 'no-todo-comments',
+    description: 'TODO/FIXME/XXX/OPTIMIZE markers should not ship to production',
+    scope: { languages: [], concerns: [] },
+    tags: ['quality', 'documentation'],
+    // Restrict to source files. Markdown files legitimately discuss TODO
+    // markers (CONTRIBUTING examples, docs about the check itself); the
+    // marker hygiene rule only applies to executable code.
+    fileTypes: [
+        'ts',
+        'tsx',
+        'js',
+        'jsx',
+        'mjs',
+        'cjs',
+        'py',
+        'go',
+        'java',
+        'rs',
+        'c',
+        'cc',
+        'cpp',
+        'h',
+        'hpp',
+    ],
+    // Use 'strip-strings' so the check sees comments but not string-literal
+    // text. A literal value containing the word "TODO" is not a comment.
+    contentFilter: 'strip-strings',
+    analyze: (content, filePath) => {
+        // Test files routinely contain TODO/FIXME markers as fixture content
+        // or pedagogical examples (e.g. test cases for this very check).
+        // The production-code hygiene rule does not apply to tests.
+        if (isTestFile(filePath))
+            return [];
+        return analyzeTodoComments(content);
+    },
+});
+//# sourceMappingURL=no-todo-comments.js.map

package/dist/checks/no-todo-comments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-todo-comments.js","sourceRoot":"","sources":["../../src/checks/no-todo-comments.ts"],"names":[],"mappings":"AAAA,iJAAiJ;AACjJ,uJAAuJ;AACvJ;;;;;;;GAOG;AACH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAuB,MAAM,sBAAsB,CAAC;AAEpF,wEAAwE;AACxE,yEAAyE;AACzE,mEAAmE;AACnE,uDAAuD;AACvD,MAAM,YAAY,GAAG,gCAAgC,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,MAAM,UAAU,GAAqB,EAAE,CAAC;IACxC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,KAAK,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,KAAK,CAAC;QACnB,IAAI,KAA6B,CAAC;QAClC,YAAY,CAAC,SAAS,GAAG,CAAC,CAAC;QAC3B,OAAO,CAAC,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAClD,UAAU,CAAC,IAAI,CAAC;gBACd,OAAO,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,2DAA2D;gBAC/E,QAAQ,EAAE,SAAS;gBACnB,IAAI,EAAE,CAAC,GAAG,CAAC;gBACX,UAAU,EAAE,wEAAwE;aACrF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CAAC;IACxC,EAAE,EAAE,sCAAsC;IAC1C,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,+DAA+D;IAC5E,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;IACtC,IAAI,EAAE,CAAC,SAAS,EAAE,eAAe,CAAC;IAClC,qEAAqE;IACrE,oEAAoE;IACpE,uDAAuD;IACvD,SAAS,EAAE;QACT,IAAI;QACJ,KAAK;QACL,IAAI;QACJ,KAAK;QACL,KAAK;QACL,KAAK;QACL,IAAI;QACJ,IAAI;QACJ,MAAM;QACN,IAAI;QACJ,GAAG;QACH,IAAI;QACJ,KAAK;QACL,GAAG;QACH,KAAK;KACN;IACD,wEAAwE;IACxE,qEAAqE;IACrE,aAAa,EAAE,eAAe;IAC9B,OAAO,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE;QAC7B,qEAAqE;QACrE,iEAAiE;QACjE,4DAA4D;QAC5D,IAAI,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,EAAE,CAAC;QACpC,OAAO,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;CACF,CAAC,CAAC"}

package/dist/checks/no-unimplemented-markers.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @fileoverview Cross-language "not implemented yet" stub-marker detection.
+ *
+ * Detects the highest-signal indicator of unfinished work: explicit
+ * THROW/MACRO idioms that announce the code is not implemented
+ * (`throw new Error('not implemented')`, `raise NotImplementedError`,
+ * `todo!()`, `unimplemented!()`, `panic("not implemented")`,
+ * `throw new UnsupportedOperationException`, `throw std::logic_error("not implemented")`).
+ *
+ * Uses the `raw` content filter (NOT `strip-strings`): the markers live
+ * inside string ARGUMENTS (e.g. `throw new Error('not implemented')`), so
+ * stripping string literals would erase the very text we match on.
+ *
+ * Patterns are dispatched by file extension and tuned for low false
+ * positives — each requires an unambiguous construct, not a bare word.
+ */
+import { type CheckViolation } from '@opensip-cli/fitness';
+/**
+ * Pure analysis function. Exported so unit tests can exercise the detection
+ * logic per-language without standing up the full Check framework.
+ */
+export declare function analyzeUnimplementedMarkers(content: string, filePath: string): CheckViolation[];
+export declare const noUnimplementedMarkers: import("@opensip-cli/fitness").Check;
+//# sourceMappingURL=no-unimplemented-markers.d.ts.map

package/dist/checks/no-unimplemented-markers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-unimplemented-markers.d.ts","sourceRoot":"","sources":["../../src/checks/no-unimplemented-markers.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAA2B,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAyHpF;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE,CA0B/F;AAED,eAAO,MAAM,sBAAsB,sCA+CjC,CAAC"}

package/dist/checks/no-unimplemented-markers.js

@@ -0,0 +1,198 @@
+// @fitness-ignore-file no-unimplemented-markers -- this file's job is to detect "not implemented" stub idioms; the trigger patterns appear here in regex and prose by design
+/**
+ * @fileoverview Cross-language "not implemented yet" stub-marker detection.
+ *
+ * Detects the highest-signal indicator of unfinished work: explicit
+ * THROW/MACRO idioms that announce the code is not implemented
+ * (`throw new Error('not implemented')`, `raise NotImplementedError`,
+ * `todo!()`, `unimplemented!()`, `panic("not implemented")`,
+ * `throw new UnsupportedOperationException`, `throw std::logic_error("not implemented")`).
+ *
+ * Uses the `raw` content filter (NOT `strip-strings`): the markers live
+ * inside string ARGUMENTS (e.g. `throw new Error('not implemented')`), so
+ * stripping string literals would erase the very text we match on.
+ *
+ * Patterns are dispatched by file extension and tuned for low false
+ * positives — each requires an unambiguous construct, not a bare word.
+ */
+import { defineCheck, isTestFile } from '@opensip-cli/fitness';
+/** Unfinished-work phrasing shared by the message-bearing language patterns. */
+const UNIMPLEMENTED_MESSAGE = /not\s*implemented|unimplemented/i;
+/**
+ * True when the idiom at `idx` is opened inside a markdown inline-code span — a
+ * backtick precedes it on the same line. A real `throw`/`raise`/`panic`/macro
+ * statement is never *introduced* by a backtick; but check `longDescription`
+ * strings and docs routinely write `` `throw new Error('not implemented')` `` as
+ * prose. We test the prefix only (not the whole line) so a genuine statement
+ * that happens to use a template-literal message — `throw new Error(\`not
+ * implemented: ${x}\`)` — is still flagged. Zero false positives, no real stub
+ * suppressed.
+ */
+function isMarkdownQuoted(line, idx) {
+    return line.slice(0, idx).includes('`');
+}
+/**
+ * Build a `MarkerPattern.test` from a line regex. The construct matches when the
+ * regex hits AND (optionally) its captured argument satisfies `messageTest` AND
+ * the hit is not markdown-quoted prose. Centralising the `isMarkdownQuoted`
+ * guard here keeps every language consistent: a real statement is flagged, a
+ * doc-string quoting the idiom is not.
+ */
+function lineMatcher(re, messageTest) {
+    return (line) => {
+        const match = re.exec(line);
+        if (match === null)
+            return false;
+        if (messageTest && !messageTest(match[1] ?? ''))
+            return false;
+        return !isMarkdownQuoted(line, match.index);
+    };
+}
+const isUnimplementedArg = (arg) => UNIMPLEMENTED_MESSAGE.test(arg);
+/** A Go panic whose argument reads as unfinished work (not every panic). */
+function isGoPanicArg(arg) {
+    return UNIMPLEMENTED_MESSAGE.test(arg) || /(^|["'`])\s*TODO|:\s*TODO/.test(arg);
+}
+const TS_JS_PATTERNS = [
+    {
+        marker: "throw new Error('not implemented')",
+        test: lineMatcher(/throw\s+new\s+Error\s*\(([^)]*)\)/i, isUnimplementedArg),
+    },
+    // `throw new NotImplementedError(...)` and a bare `NotImplementedError(` call.
+    { marker: 'NotImplementedError', test: lineMatcher(/\bNotImplementedError\s*\(/) },
+];
+const PYTHON_PATTERNS = [
+    // `raise NotImplementedError` with or without parens/message.
+    { marker: 'raise NotImplementedError', test: lineMatcher(/\braise\s+NotImplementedError\b/) },
+];
+const RUST_PATTERNS = [
+    { marker: 'todo!()', test: lineMatcher(/\btodo!\s*\(/) },
+    { marker: 'unimplemented!()', test: lineMatcher(/\bunimplemented!\s*\(/) },
+];
+const GO_PATTERNS = [
+    { marker: 'panic("not implemented")', test: lineMatcher(/\bpanic\s*\(([^)]*)\)/, isGoPanicArg) },
+];
+const JAVA_PATTERNS = [
+    // Covers the IDE-generated "Not supported yet." stub.
+    {
+        marker: 'throw new UnsupportedOperationException',
+        test: lineMatcher(/throw\s+new\s+UnsupportedOperationException\b/),
+    },
+];
+const CPP_PATTERNS = [
+    {
+        marker: 'throw std::logic_error("not implemented")',
+        test: lineMatcher(/throw\s+std::logic_error\s*\(([^)]*)\)/, isUnimplementedArg),
+    },
+    // `assert(... && "not implemented")` — the common C/C++ stub idiom.
+    {
+        marker: 'assert(... && "not implemented")',
+        test: lineMatcher(/\bassert\s*\((.*)\)/, isUnimplementedArg),
+    },
+];
+/** Extension → language patterns. Extensions absent here are unsupported. */
+const PATTERNS_BY_EXTENSION = {
+    ts: TS_JS_PATTERNS,
+    tsx: TS_JS_PATTERNS,
+    js: TS_JS_PATTERNS,
+    jsx: TS_JS_PATTERNS,
+    mjs: TS_JS_PATTERNS,
+    cjs: TS_JS_PATTERNS,
+    py: PYTHON_PATTERNS,
+    rs: RUST_PATTERNS,
+    go: GO_PATTERNS,
+    java: JAVA_PATTERNS,
+    c: CPP_PATTERNS,
+    cc: CPP_PATTERNS,
+    cpp: CPP_PATTERNS,
+    h: CPP_PATTERNS,
+    hpp: CPP_PATTERNS,
+};
+/** Map a file extension to the language's marker patterns (null = unsupported). */
+function patternsForExtension(filePath) {
+    const dot = filePath.lastIndexOf('.');
+    if (dot === -1)
+        return null;
+    const ext = filePath.slice(dot + 1).toLowerCase();
+    return PATTERNS_BY_EXTENSION[ext] ?? null;
+}
+/**
+ * Pure analysis function. Exported so unit tests can exercise the detection
+ * logic per-language without standing up the full Check framework.
+ */
+export function analyzeUnimplementedMarkers(content, filePath) {
+    const patterns = patternsForExtension(filePath);
+    if (patterns === null)
+        return [];
+    const violations = [];
+    const lines = content.split('\n');
+    for (const [i, line] of lines.entries()) {
+        for (const { marker, test } of patterns) {
+            if (test(line)) {
+                violations.push({
+                    message: `Unimplemented-work marker found (\`${marker}\` idiom): code announces it is not implemented`,
+                    // Soft shipped default; repos wanting a hard gate set `failOnWarnings`
+                    // (this repo does — see opensip-cli.config.yml).
+                    severity: 'warning',
+                    line: i + 1,
+                    suggestion: 'Implement before shipping, or track the work in an issue and remove the placeholder',
+                    match: line.trim(),
+                });
+                // One violation per line is enough; avoid double-counting overlapping
+                // idioms (e.g. a NotImplementedError throw matching two TS patterns).
+                break;
+            }
+        }
+    }
+    return violations;
+}
+export const noUnimplementedMarkers = defineCheck({
+    id: 'b8ec0d20-e5b5-487d-8d02-955b0f960cf6',
+    slug: 'no-unimplemented-markers',
+    description: 'Code must not announce it is unimplemented (throw/macro "not implemented" idioms)',
+    longDescription: `**Purpose:** Flags explicit "not implemented yet" stub idioms — the highest-signal indicator of unfinished work — across all six supported languages. Goal: never ship code that announces it isn't implemented.
+
+**Detects (per language):**
+- **TS/JS:** \`throw new Error(...)\` whose message matches not-implemented; \`throw new NotImplementedError\`; \`NotImplementedError(\`
+- **Python:** \`raise NotImplementedError\`
+- **Rust:** \`todo!(\` and \`unimplemented!(\` macros
+- **Go:** \`panic(...)\` whose message reads as unfinished work (not every panic)
+- **Java:** \`throw new UnsupportedOperationException\` (the IDE "Not supported yet" stub)
+- **C/C++:** \`throw std::logic_error(...)\` or \`assert(... && "...")\` mentioning not-implemented
+
+**Why it matters:** These markers are unambiguous declarations that a code path is a placeholder. Surfacing them on every fitness run prevents stubs from reaching production.
+
+**Scope:** Source files only; test files are skipped.`,
+    scope: { languages: [], concerns: [] },
+    tags: ['quality', 'best-practices'],
+    confidence: 'high',
+    // Restrict to source files across all six supported languages.
+    fileTypes: [
+        'ts',
+        'tsx',
+        'js',
+        'jsx',
+        'mjs',
+        'cjs',
+        'py',
+        'go',
+        'java',
+        'rs',
+        'c',
+        'cc',
+        'cpp',
+        'h',
+        'hpp',
+    ],
+    // Use 'raw': the markers live inside string ARGUMENTS, so 'strip-strings'
+    // would erase them before this check ever sees them.
+    contentFilter: 'raw',
+    analyze: (content, filePath) => {
+        // Test files routinely contain these idioms as fixture content or
+        // pedagogical examples (e.g. test cases for this very check).
+        if (isTestFile(filePath))
+            return [];
+        return analyzeUnimplementedMarkers(content, filePath);
+    },
+});
+//# sourceMappingURL=no-unimplemented-markers.js.map

package/dist/checks/no-unimplemented-markers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-unimplemented-markers.js","sourceRoot":"","sources":["../../src/checks/no-unimplemented-markers.ts"],"names":[],"mappings":"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"}

package/dist/checks/quality/api/graphql-offset-pagination.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview Detect offset-based pagination in GraphQL queries
+ *
+ * Offset pagination produces unstable results when data changes between page
+ * fetches (the "shifting page" problem). Cursor-based pagination (keyset via
+ * where clause) provides stable results.
+ */
+export declare const graphqlOffsetPagination: import("@opensip-cli/fitness").Check;
+//# sourceMappingURL=graphql-offset-pagination.d.ts.map

package/dist/checks/quality/api/graphql-offset-pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-offset-pagination.d.ts","sourceRoot":"","sources":["../../../../src/checks/quality/api/graphql-offset-pagination.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAMH,eAAO,MAAM,uBAAuB,sCA8DlC,CAAC"}