@opensip-cli/checks-universal 0.1.0

package/dist/__tests__/no-unimplemented-markers.test.js

@@ -0,0 +1,140 @@
+import { runCheckOnFixture } from '@opensip-cli/test-support';
+import { describe, expect, it } from 'vitest';
+import { analyzeUnimplementedMarkers, noUnimplementedMarkers, } from '../checks/no-unimplemented-markers.js';
+describe('analyzeUnimplementedMarkers', () => {
+    describe('TypeScript / JavaScript', () => {
+        it('flags throw new Error with a not-implemented message', () => {
+            const v = analyzeUnimplementedMarkers(`throw new Error('not implemented')`, 'a.ts');
+            expect(v).toHaveLength(1);
+            expect(v[0]?.line).toBe(1);
+            expect(v[0]?.severity).toBe('warning');
+        });
+        it('flags "unimplemented" phrasing too', () => {
+            const v = analyzeUnimplementedMarkers(`throw new Error("unimplemented")`, 'a.js');
+            expect(v).toHaveLength(1);
+        });
+        it('flags throw new NotImplementedError', () => {
+            const v = analyzeUnimplementedMarkers(`throw new NotImplementedError()`, 'a.tsx');
+            expect(v).toHaveLength(1);
+        });
+        it('flags a bare NotImplementedError() call', () => {
+            const v = analyzeUnimplementedMarkers(`return NotImplementedError('x')`, 'a.mjs');
+            expect(v).toHaveLength(1);
+        });
+        it('does NOT flag a plain throw with an unrelated message', () => {
+            const v = analyzeUnimplementedMarkers(`throw new Error('connection refused')`, 'a.ts');
+            expect(v).toHaveLength(0);
+        });
+        it('does NOT flag a normal string that merely contains a marker word', () => {
+            const v = analyzeUnimplementedMarkers(`const msg = 'TODO: not implemented section header'`, 'a.ts');
+            expect(v).toHaveLength(0);
+        });
+        it('does NOT flag the idiom when quoted as markdown inline-code (doc prose)', () => {
+            // e.g. a check longDescription: "Stub methods that `throw new Error('Not implemented')`".
+            const v = analyzeUnimplementedMarkers("Detects stub methods that `throw new Error('Not implemented')` in prod", 'a.ts');
+            expect(v).toHaveLength(0);
+        });
+        it('STILL flags a real throw using a template-literal message', () => {
+            const v = analyzeUnimplementedMarkers('throw new Error(`not implemented: ${name}`)', 'a.ts');
+            expect(v).toHaveLength(1);
+        });
+    });
+    describe('Python', () => {
+        it('flags raise NotImplementedError with a message', () => {
+            const v = analyzeUnimplementedMarkers(`raise NotImplementedError("soon")`, 'a.py');
+            expect(v).toHaveLength(1);
+        });
+        it('flags bare raise NotImplementedError', () => {
+            const v = analyzeUnimplementedMarkers(`    raise NotImplementedError`, 'a.py');
+            expect(v).toHaveLength(1);
+        });
+        it('does NOT flag an ellipsis stub body or pass', () => {
+            const v = analyzeUnimplementedMarkers(`def f():\n    ...\n\ndef g():\n    pass`, 'a.py');
+            expect(v).toHaveLength(0);
+        });
+    });
+    describe('Rust', () => {
+        it('flags todo!() macro', () => {
+            const v = analyzeUnimplementedMarkers(`    todo!()`, 'a.rs');
+            expect(v).toHaveLength(1);
+        });
+        it('flags unimplemented!() macro', () => {
+            const v = analyzeUnimplementedMarkers(`    unimplemented!("later")`, 'a.rs');
+            expect(v).toHaveLength(1);
+        });
+        it('does NOT flag a normal function body', () => {
+            const v = analyzeUnimplementedMarkers(`fn f() -> i32 { 1 + 1 }`, 'a.rs');
+            expect(v).toHaveLength(0);
+        });
+    });
+    describe('Go', () => {
+        it('flags panic with a not-implemented message', () => {
+            const v = analyzeUnimplementedMarkers(`    panic("not implemented")`, 'a.go');
+            expect(v).toHaveLength(1);
+        });
+        it('flags panic with a TODO message', () => {
+            const v = analyzeUnimplementedMarkers(`    panic("TODO: wire this up")`, 'a.go');
+            expect(v).toHaveLength(1);
+        });
+        it('does NOT flag a panic with an unrelated runtime message', () => {
+            const v = analyzeUnimplementedMarkers(`    panic("index out of range")`, 'a.go');
+            expect(v).toHaveLength(0);
+        });
+    });
+    describe('Java', () => {
+        it('flags throw new UnsupportedOperationException', () => {
+            const v = analyzeUnimplementedMarkers(`throw new UnsupportedOperationException("Not supported yet.");`, 'A.java');
+            expect(v).toHaveLength(1);
+        });
+        it('does NOT flag an ordinary exception throw', () => {
+            const v = analyzeUnimplementedMarkers(`throw new IllegalArgumentException("bad");`, 'A.java');
+            expect(v).toHaveLength(0);
+        });
+    });
+    describe('C / C++', () => {
+        it('flags throw std::logic_error with a not-implemented message', () => {
+            const v = analyzeUnimplementedMarkers(`throw std::logic_error("not implemented");`, 'a.cpp');
+            expect(v).toHaveLength(1);
+        });
+        it('flags an assert(... && "not implemented") stub', () => {
+            const v = analyzeUnimplementedMarkers(`assert(false && "unimplemented path");`, 'a.h');
+            expect(v).toHaveLength(1);
+        });
+        it('does NOT flag an unrelated logic_error or assert', () => {
+            const v = analyzeUnimplementedMarkers(`throw std::logic_error("size mismatch");\nassert(x > 0);`, 'a.cc');
+            expect(v).toHaveLength(0);
+        });
+    });
+    describe('dispatch + edge cases', () => {
+        it('returns [] for an unsupported extension', () => {
+            const v = analyzeUnimplementedMarkers(`throw new Error('not implemented')`, 'a.txt');
+            expect(v).toHaveLength(0);
+        });
+        it('counts at most one violation per line', () => {
+            const v = analyzeUnimplementedMarkers(`throw new NotImplementedError('not implemented')`, 'a.ts');
+            expect(v).toHaveLength(1);
+        });
+        it('reports accurate line numbers across a multi-line file', () => {
+            const src = `line one\nthrow new Error('not implemented')\nline three`;
+            const v = analyzeUnimplementedMarkers(src, 'a.ts');
+            expect(v).toHaveLength(1);
+            expect(v[0]?.line).toBe(2);
+        });
+    });
+    describe('check wrapper (real execution)', () => {
+        const marker = `export const compute = (): number => {\n  throw new Error('not implemented')\n}\n`;
+        it('skips test files', async () => {
+            const run = await runCheckOnFixture(noUnimplementedMarkers, {
+                files: [{ path: 'foo.test.ts', content: marker }],
+            });
+            expect(run.findings).toHaveLength(0);
+        });
+        it('flags production source files', async () => {
+            const run = await runCheckOnFixture(noUnimplementedMarkers, {
+                files: [{ path: 'foo.ts', content: marker }],
+            });
+            expect(run.findings).toHaveLength(1);
+        });
+    });
+});
+//# sourceMappingURL=no-unimplemented-markers.test.js.map

package/dist/__tests__/no-unimplemented-markers.test.js.map

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

package/dist/__tests__/public-api-jsdoc-scope.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Public-API scoping tests for `public-api-jsdoc`.
+ *
+ * Verifies the check's tuned behavior: only files reachable from the
+ * containing package's `package.json#exports` entries via
+ * `export ... from` re-export chains are flagged. Internal helper
+ * files whose `export` is intra-package-only are skipped.
+ */
+export {};
+//# sourceMappingURL=public-api-jsdoc-scope.test.d.ts.map

package/dist/__tests__/public-api-jsdoc-scope.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api-jsdoc-scope.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/public-api-jsdoc-scope.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/__tests__/public-api-jsdoc-scope.test.js

@@ -0,0 +1,176 @@
+/**
+ * @fileoverview Public-API scoping tests for `public-api-jsdoc`.
+ *
+ * Verifies the check's tuned behavior: only files reachable from the
+ * containing package's `package.json#exports` entries via
+ * `export ... from` re-export chains are flagged. Internal helper
+ * files whose `export` is intra-package-only are skipped.
+ */
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { fileCache } from '@opensip-cli/fitness';
+import { afterAll, afterEach, beforeAll, describe, expect, it } from 'vitest';
+import { _resetPublicApiGraphCache } from '../checks/documentation/_public-api-graph.js';
+import { checks } from '../index.js';
+function findCheck(slug) {
+    const check = checks.find((c) => c.config.slug === slug);
+    if (!check)
+        throw new Error(`check not found: ${slug}`);
+    return check;
+}
+function makeFixtureDir(prefix) {
+    return mkdtempSync(join(tmpdir(), `cu-pubapi-${prefix}-`));
+}
+function writeFixture(cwd, rel, content) {
+    const abs = join(cwd, rel);
+    mkdirSync(dirname(abs), { recursive: true });
+    writeFileSync(abs, content);
+    return abs;
+}
+afterEach(() => {
+    fileCache.clear();
+    _resetPublicApiGraphCache();
+});
+describe('public-api-jsdoc — package.json exports scoping', () => {
+    let cwd;
+    let publicFile;
+    let internalFile;
+    let untrackedFile;
+    beforeAll(() => {
+        cwd = makeFixtureDir('exports');
+        writeFixture(cwd, 'package.json', JSON.stringify({
+            name: 'fixture-pkg',
+            type: 'module',
+            exports: { '.': './dist/index.js' },
+        }));
+        // Re-exported from index → in the public surface.
+        writeFixture(cwd, 'src/index.ts', [
+            "export * from './public.js'",
+            // `internal-helper` is imported but NOT re-exported below — so its
+            // exports are NOT part of the public surface.
+            "import { helper } from './internal-helper.js'",
+            'export const useHelper = () => helper()',
+        ].join('\n'));
+        publicFile = writeFixture(cwd, 'src/public.ts', ['export function publicNoJsdoc() { return 1 }'].join('\n'));
+        internalFile = writeFixture(cwd, 'src/internal-helper.ts', ['export function helper() { return 2 }'].join('\n'));
+        // A completely unrelated file in src/ — not reachable from index.
+        untrackedFile = writeFixture(cwd, 'src/orphan.ts', ['export function orphan() { return 3 }'].join('\n'));
+    });
+    afterAll(() => rmSync(cwd, { recursive: true, force: true }));
+    it('flags exports in files reachable via re-exports', async () => {
+        const result = await findCheck('public-api-jsdoc').run(cwd, {
+            targetFiles: [publicFile],
+        });
+        expect(result.signals.length).toBeGreaterThan(0);
+        expect(result.signals[0]?.message).toContain('publicNoJsdoc');
+    });
+    it('skips internal helper files imported (but not re-exported) from the barrel', async () => {
+        const result = await findCheck('public-api-jsdoc').run(cwd, {
+            targetFiles: [internalFile],
+        });
+        expect(result.signals.length).toBe(0);
+    });
+    it('skips orphan files not reachable from any export entry', async () => {
+        const result = await findCheck('public-api-jsdoc').run(cwd, {
+            targetFiles: [untrackedFile],
+        });
+        expect(result.signals.length).toBe(0);
+    });
+});
+describe('public-api-jsdoc — fallback behavior', () => {
+    let cwd;
+    let file;
+    beforeAll(() => {
+        cwd = makeFixtureDir('fallback');
+        // No package.json → cannot resolve surface → check falls back to
+        // flagging every export (historical broad behavior).
+        file = writeFixture(cwd, 'src/leaf.ts', ['export function leaf() { return 1 }'].join('\n'));
+    });
+    afterAll(() => rmSync(cwd, { recursive: true, force: true }));
+    it('falls back to broad behavior when no package.json is found', async () => {
+        const result = await findCheck('public-api-jsdoc').run(cwd, {
+            targetFiles: [file],
+        });
+        // The walk hits the tmpdir without ever finding a package.json,
+        // so the check open-fails and flags `leaf`.
+        expect(result.signals.length).toBeGreaterThan(0);
+    });
+});
+describe('public-api-jsdoc — exports map shapes', () => {
+    let cwd;
+    let publicFile;
+    beforeAll(() => {
+        cwd = makeFixtureDir('conditional-exports');
+        // Conditional + multi-subpath exports — the graph walk should
+        // descend through the object structure and collect each leaf string.
+        writeFixture(cwd, 'package.json', JSON.stringify({
+            name: 'fixture-pkg',
+            type: 'module',
+            exports: {
+                '.': {
+                    import: './dist/index.js',
+                    require: './dist/index.cjs',
+                },
+                './sub': './dist/sub.js',
+                './bad-wildcard/*': './dist/parts/*.js',
+            },
+        }));
+        writeFixture(cwd, 'src/index.ts', ["export * from './a.js'"].join('\n'));
+        publicFile = writeFixture(cwd, 'src/a.ts', ['export function aNoJsdoc() { return 1 }'].join('\n'));
+        writeFixture(cwd, 'src/sub.ts', ['export function subSymbol() { return 2 }'].join('\n'));
+    });
+    afterAll(() => rmSync(cwd, { recursive: true, force: true }));
+    it('descends through conditional + subpath exports', async () => {
+        const result = await findCheck('public-api-jsdoc').run(cwd, {
+            targetFiles: [publicFile],
+        });
+        expect(result.signals.length).toBeGreaterThan(0);
+    });
+    it('skips wildcard subpath patterns without crashing', async () => {
+        // Just verify that the wildcard entry doesn't break the run; the
+        // `src/a.ts` reachability comes from the `.` entry.
+        const result = await findCheck('public-api-jsdoc').run(cwd, {
+            targetFiles: [publicFile],
+        });
+        expect(result).toBeDefined();
+    });
+});
+describe('public-api-jsdoc — binary-only package has empty surface', () => {
+    let cwd;
+    let file;
+    beforeAll(() => {
+        cwd = makeFixtureDir('bin-only');
+        writeFixture(cwd, 'package.json', JSON.stringify({
+            name: 'bin-only-pkg',
+            type: 'module',
+            bin: { 'my-cli': './dist/index.js' },
+        }));
+        file = writeFixture(cwd, 'src/leaf.ts', ['export function leafSymbol() { return 1 }'].join('\n'));
+    });
+    afterAll(() => rmSync(cwd, { recursive: true, force: true }));
+    it('treats every source file as internal when only `bin` is declared', async () => {
+        const result = await findCheck('public-api-jsdoc').run(cwd, {
+            targetFiles: [file],
+        });
+        expect(result.signals.length).toBe(0);
+    });
+});
+describe('public-api-jsdoc — fallback when no exports field', () => {
+    let cwd;
+    let file;
+    beforeAll(() => {
+        cwd = makeFixtureDir('main-only');
+        writeFixture(cwd, 'package.json', JSON.stringify({ name: 'main-only-pkg', main: './dist/index.js' }));
+        writeFixture(cwd, 'src/index.ts', ["export * from './public.js'"].join('\n'));
+        file = writeFixture(cwd, 'src/public.ts', ['export function publicMainOnly() { return 1 }'].join('\n'));
+    });
+    afterAll(() => rmSync(cwd, { recursive: true, force: true }));
+    it('honors `main` field when `exports` is absent', async () => {
+        const result = await findCheck('public-api-jsdoc').run(cwd, {
+            targetFiles: [file],
+        });
+        expect(result.signals.length).toBeGreaterThan(0);
+    });
+});
+//# sourceMappingURL=public-api-jsdoc-scope.test.js.map

package/dist/__tests__/public-api-jsdoc-scope.test.js.map

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

package/dist/__tests__/resilience-fp.test.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @fileoverview FP-regression suite for two resilience checks.
+ *
+ * - exit-code-correctness: a catch block that propagates failure via a numeric
+ *   `cli.setExitCode(1)` (the CLI-dispatcher pattern) must NOT be flagged as a
+ *   silent exit-0. Only the named-constant form was recognized before.
+ * - unbounded-memory: a `JSON.parse(readFileSync(...))` structured-doc load and
+ *   a module-self-relative committed-asset read are bounded by nature and must
+ *   NOT be flagged as OOM risks.
+ *
+ * Each case also pins that genuine positives still fire.
+ */
+export {};
+//# sourceMappingURL=resilience-fp.test.d.ts.map

package/dist/__tests__/resilience-fp.test.d.ts.map

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

package/dist/__tests__/resilience-fp.test.js

@@ -0,0 +1,110 @@
+/**
+ * @fileoverview FP-regression suite for two resilience checks.
+ *
+ * - exit-code-correctness: a catch block that propagates failure via a numeric
+ *   `cli.setExitCode(1)` (the CLI-dispatcher pattern) must NOT be flagged as a
+ *   silent exit-0. Only the named-constant form was recognized before.
+ * - unbounded-memory: a `JSON.parse(readFileSync(...))` structured-doc load and
+ *   a module-self-relative committed-asset read are bounded by nature and must
+ *   NOT be flagged as OOM risks.
+ *
+ * Each case also pins that genuine positives still fire.
+ */
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { fileCache } from '@opensip-cli/fitness';
+import { afterEach, describe, expect, it } from 'vitest';
+import { checks } from '../index.js';
+function findCheck(slug) {
+    const check = checks.find((c) => c.config.slug === slug);
+    if (!check)
+        throw new Error(`check not found: ${slug}`);
+    return check;
+}
+function writeFixture(cwd, rel, content) {
+    const abs = join(cwd, rel);
+    mkdirSync(dirname(abs), { recursive: true });
+    writeFileSync(abs, content);
+    return abs;
+}
+afterEach(() => fileCache.clear());
+describe('exit-code-correctness — numeric setExitCode FP regression', () => {
+    it('does NOT flag a catch that calls cli.setExitCode(1)', async () => {
+        const cwd = mkdtempSync(join(tmpdir(), 'cu-fp-exit-'));
+        const file = writeFixture(cwd, 'src/cli/worker.ts', [
+            'export function run(cli: any, path: string): void {',
+            '  try {',
+            '    doWork(path);',
+            '    cli.setExitCode(0);',
+            '  } catch (error) {',
+            '    logger.error({ err: String(error) });',
+            '    cli.setExitCode(1);',
+            '  }',
+            '}',
+        ].join('\n'));
+        const result = await findCheck('exit-code-correctness').run(cwd, { targetFiles: [file] });
+        expect(result.signals).toHaveLength(0);
+        rmSync(cwd, { recursive: true, force: true });
+    });
+    it('STILL flags a catch that logs and silently continues', async () => {
+        const cwd = mkdtempSync(join(tmpdir(), 'cu-fp-exit2-'));
+        const file = writeFixture(cwd, 'src/cli/silent.ts', [
+            'export function run(path: string): void {',
+            '  try {',
+            '    doWork(path);',
+            '  } catch (error) {',
+            '    logger.error({ err: String(error) });',
+            '  }',
+            '}',
+        ].join('\n'));
+        const result = await findCheck('exit-code-correctness').run(cwd, { targetFiles: [file] });
+        expect(result.signals.length).toBeGreaterThan(0);
+        rmSync(cwd, { recursive: true, force: true });
+    });
+});
+describe('unbounded-memory — bounded-read FP regression', () => {
+    it('does NOT flag JSON.parse(readFileSync(...)) structured-doc loads', async () => {
+        const cwd = mkdtempSync(join(tmpdir(), 'cu-fp-mem1-'));
+        const file = writeFixture(cwd, 'src/worker.ts', [
+            'import { readFileSync } from "node:fs";',
+            'export function load(specPath: string) {',
+            '  const spec = JSON.parse(readFileSync(specPath, "utf8"));',
+            '  return spec;',
+            '}',
+        ].join('\n'));
+        const result = await findCheck('unbounded-memory').run(cwd, { targetFiles: [file] });
+        expect(result.signals).toHaveLength(0);
+        rmSync(cwd, { recursive: true, force: true });
+    });
+    it('does NOT flag a module-self-relative committed-asset read', async () => {
+        const cwd = mkdtempSync(join(tmpdir(), 'cu-fp-mem2-'));
+        const file = writeFixture(cwd, 'src/vendor-read.ts', [
+            'import { readFileSync } from "node:fs";',
+            'import { dirname, join } from "node:path";',
+            'import { fileURLToPath } from "node:url";',
+            'const HERE = dirname(fileURLToPath(import.meta.url));',
+            'export function bundle(): string {',
+            '  const candidate = join(HERE, "..", "vendor", "bundle.js");',
+            '  return readFileSync(candidate, "utf8");',
+            '}',
+        ].join('\n'));
+        const result = await findCheck('unbounded-memory').run(cwd, { targetFiles: [file] });
+        expect(result.signals).toHaveLength(0);
+        rmSync(cwd, { recursive: true, force: true });
+    });
+    it('STILL flags an unguarded read of an external path', async () => {
+        const cwd = mkdtempSync(join(tmpdir(), 'cu-fp-mem3-'));
+        const file = writeFixture(cwd, 'src/upload.ts', [
+            'import { readFileSync } from "node:fs";',
+            'export function ingest(userPath: string): string {',
+            '  const raw = readFileSync(userPath, "utf8");',
+            '  return raw.toUpperCase();',
+            '}',
+        ].join('\n'));
+        const result = await findCheck('unbounded-memory').run(cwd, { targetFiles: [file] });
+        expect(result.signals.length).toBeGreaterThan(0);
+        rmSync(cwd, { recursive: true, force: true });
+    });
+});
+//# sourceMappingURL=resilience-fp.test.js.map

package/dist/__tests__/resilience-fp.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resilience-fp.test.js","sourceRoot":"","sources":["../../src/__tests__/resilience-fp.test.ts"],"names":[],"mappings":"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"}

package/dist/checks/architecture/__tests__/no-kebab-option-indexing.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=no-kebab-option-indexing.test.d.ts.map

package/dist/checks/architecture/__tests__/no-kebab-option-indexing.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-kebab-option-indexing.test.d.ts","sourceRoot":"","sources":["../../../../src/checks/architecture/__tests__/no-kebab-option-indexing.test.ts"],"names":[],"mappings":""}

package/dist/checks/architecture/__tests__/no-kebab-option-indexing.test.js

@@ -0,0 +1,32 @@
+/**
+ * Unit tests for the `no-kebab-option-indexing` guardrail.
+ */
+import { describe, expect, it } from 'vitest';
+import { analyzeNoKebabOptionIndexing as analyze } from '../no-kebab-option-indexing.js';
+const SRC = 'packages/cli/src/commands/host-subcommand-groups.ts';
+describe('analyzeNoKebabOptionIndexing', () => {
+    it('flags opts indexed by a kebab-case key and names the camelCase fix', () => {
+        const v = analyze("const x = opts['summary-only'];\n", SRC);
+        expect(v).toHaveLength(1);
+        expect(v[0]?.type).toBe('no-kebab-option-indexing');
+        expect(v[0]?.message).toContain('summaryOnly');
+    });
+    it('flags rawOpts/parsedOpts kebab indexing with either quote style', () => {
+        expect(analyze('const x = rawOpts["report-to"];\n', SRC)).toHaveLength(1);
+        expect(analyze("const x = parsedOpts['dry-run'];\n", SRC)).toHaveLength(1);
+    });
+    it('does not flag camelCase property access', () => {
+        expect(analyze('const x = opts.summaryOnly;\n', SRC)).toEqual([]);
+    });
+    it('does not flag kebab indexing of non-options objects (headers/style/env)', () => {
+        expect(analyze("const x = headers['content-type'];\n", SRC)).toEqual([]);
+        expect(analyze("const x = style['font-size'];\n", SRC)).toEqual([]);
+    });
+    it('skips comment lines', () => {
+        expect(analyze("// never write opts['summary-only'] — Commander camelCases it\n", SRC)).toEqual([]);
+    });
+    it('skips test files', () => {
+        expect(analyze("const x = opts['summary-only'];\n", `${SRC.replace('.ts', '.test.ts')}`)).toEqual([]);
+    });
+});
+//# sourceMappingURL=no-kebab-option-indexing.test.js.map

package/dist/checks/architecture/__tests__/no-kebab-option-indexing.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-kebab-option-indexing.test.js","sourceRoot":"","sources":["../../../../src/checks/architecture/__tests__/no-kebab-option-indexing.test.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,4BAA4B,IAAI,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAEzF,MAAM,GAAG,GAAG,qDAAqD,CAAC;AAElE,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC5C,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC5E,MAAM,CAAC,GAAG,OAAO,CAAC,mCAAmC,EAAE,GAAG,CAAC,CAAC;QAC5D,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACpD,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,MAAM,CAAC,OAAO,CAAC,mCAAmC,EAAE,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC1E,MAAM,CAAC,OAAO,CAAC,oCAAoC,EAAE,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,CAAC,OAAO,CAAC,+BAA+B,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QACjF,MAAM,CAAC,OAAO,CAAC,sCAAsC,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACzE,MAAM,CAAC,OAAO,CAAC,iCAAiC,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC7B,MAAM,CAAC,OAAO,CAAC,iEAAiE,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,CAC7F,EAAE,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAC1B,MAAM,CACJ,OAAO,CAAC,mCAAmC,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,CAAC,CAClF,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/checks/architecture/__tests__/tool-has-manifest.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tool-has-manifest.test.d.ts.map

package/dist/checks/architecture/__tests__/tool-has-manifest.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-has-manifest.test.d.ts","sourceRoot":"","sources":["../../../../src/checks/architecture/__tests__/tool-has-manifest.test.ts"],"names":[],"mappings":""}