semantic-complexity 0.0.7-741984fb → 0.0.15-f5745e88

package/dist/cli/index.js

@@ -0,0 +1,103 @@
+#!/usr/bin/env node
+/**
+ * semantic-complexity CLI
+ */
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { analyzeBread } from '../analyzers/bread.js';
+import { analyzeCheese } from '../analyzers/cheese.js';
+import { analyzeHam } from '../analyzers/ham.js';
+import { normalize, calculateEquilibrium } from '../simplex/index.js';
+import { checkGate } from '../gate/index.js';
+// package.json에서 버전 동적으로 읽기
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const packageJson = JSON.parse(readFileSync(join(__dirname, '../../package.json'), 'utf-8'));
+function main() {
+    const args = process.argv.slice(2);
+    if (args.length === 0 || args.includes('--help') || args.includes('-h')) {
+        printHelp();
+        process.exit(0);
+    }
+    if (args.includes('--version') || args.includes('-v')) {
+        console.log(`semantic-complexity v${packageJson.version}`);
+        process.exit(0);
+    }
+    const filePath = args.find(arg => !arg.startsWith('-'));
+    if (!filePath) {
+        console.error('Error: No file path provided');
+        process.exit(1);
+    }
+    const gateType = (args.find(arg => arg.startsWith('--gate='))?.split('=')[1] || 'mvp');
+    try {
+        const source = readFileSync(filePath, 'utf-8');
+        analyze(source, filePath, gateType);
+    }
+    catch {
+        console.error(`Error reading file: ${filePath}`);
+        process.exit(1);
+    }
+}
+function analyze(source, filePath, gateType) {
+    console.log(`\nAnalyzing: ${filePath}`);
+    console.log('='.repeat(50));
+    // Analyze each axis
+    const bread = analyzeBread(source);
+    const cheese = analyzeCheese(source);
+    const ham = analyzeHam(source);
+    // Calculate simplex & equilibrium
+    const simplex = normalize(bread, cheese, ham);
+    const equilibrium = calculateEquilibrium(simplex);
+    // Check gate
+    const gate = checkGate(gateType, cheese, ham);
+    // Output results
+    console.log('\n[Bread - Security]');
+    console.log(`  Trust Boundaries: ${bread.trustBoundaryCount}`);
+    console.log(`  Auth Explicitness: ${(bread.authExplicitness * 100).toFixed(1)}%`);
+    console.log(`  Secrets Detected: ${bread.secretPatterns.filter(s => s.severity === 'high').length} high, ${bread.secretPatterns.filter(s => s.severity === 'medium').length} medium`);
+    console.log(`  Hidden Deps: global=${bread.hiddenDeps.global}, env=${bread.hiddenDeps.env}, io=${bread.hiddenDeps.io}`);
+    console.log('\n[Cheese - Cognitive]');
+    console.log(`  Max Nesting: ${cheese.maxNesting}`);
+    console.log(`  State×Async×Retry: ${cheese.stateAsyncRetry.axes.join('×') || 'none'} (${cheese.stateAsyncRetry.count})`);
+    console.log(`  Accessible: ${cheese.accessible ? 'YES' : 'NO'}`);
+    if (cheese.violations.length > 0) {
+        console.log(`  Violations: ${cheese.violations.join(', ')}`);
+    }
+    console.log('\n[Ham - Behavioral]');
+    console.log(`  Golden Test Coverage: ${(ham.goldenTestCoverage * 100).toFixed(1)}%`);
+    console.log(`  Critical Paths: ${ham.criticalPaths.length}`);
+    console.log(`  Untested Critical: ${ham.untestedCriticalPaths.length}`);
+    console.log('\n[Simplex]');
+    console.log(`  Coordinates: B=${simplex.bread.toFixed(2)}, C=${simplex.cheese.toFixed(2)}, H=${simplex.ham.toFixed(2)}`);
+    console.log(`  Equilibrium: ${equilibrium.inEquilibrium ? 'YES' : 'NO'} (energy=${equilibrium.energy.toFixed(3)})`);
+    if (equilibrium.dominantAxis) {
+        console.log(`  Dominant Axis: ${equilibrium.dominantAxis}`);
+    }
+    console.log(`\n[Gate: ${gateType.toUpperCase()}]`);
+    console.log(`  Result: ${gate.passed ? 'PASSED' : 'FAILED'}`);
+    if (gate.violations.length > 0) {
+        console.log('  Violations:');
+        gate.violations.forEach(v => console.log(`    - ${v.message}`));
+    }
+    process.exit(gate.passed ? 0 : 1);
+}
+function printHelp() {
+    console.log(`
+semantic-complexity - Code complexity analyzer (Bread-Cheese-Ham model)
+
+Usage:
+  semantic-complexity <file> [options]
+
+Options:
+  --gate=<type>   Gate type: poc, mvp, production (default: mvp)
+  --version, -v   Show version
+  --help, -h      Show this help
+
+Examples:
+  semantic-complexity src/app.ts
+  semantic-complexity src/api.ts --gate=production
+`);
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/gate/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Gate - PoC / MVP / Production quality gates
+ */
+import type { GateType, GateResult } from '../types/index.js';
+import type { CheeseResult } from '../analyzers/cheese.js';
+import type { HamResult } from '../analyzers/ham.js';
+export { checkWaiver, checkInlineWaiver, checkExternalWaiver, parseEssentialComplexity, parseWaiverFile, findWaiverFile, matchFilePattern, isWaiverExpired, detectComplexitySignals, detectComplexImports, buildComplexityContext, generateReviewQuestions, ESSENTIAL_COMPLEXITY_SIGNALS, COMPLEX_DOMAIN_LIBRARIES, } from './waiver.js';
+export type { EssentialComplexityConfig, ComplexitySignal, ComplexityContext, WaiverResult, ExternalWaiverEntry, WaiverFile, } from './waiver.js';
+declare const BASE_THRESHOLDS: {
+    nesting_max: number;
+    concepts_per_function: number;
+    hidden_dep_max: number;
+    golden_test_min: number;
+};
+export declare const STAGE_POLICIES: Record<GateType, {
+    waiver_allowed: boolean;
+}>;
+/**
+ * Get thresholds for a specific gate type
+ */
+export declare function getThresholds(gateType: GateType): typeof BASE_THRESHOLDS;
+export interface CheckGateOptions {
+    source?: string;
+    filePath?: string;
+    projectRoot?: string;
+}
+/**
+ * Check if code passes the gate
+ */
+export declare function checkGate(gateType: GateType, cheese: CheeseResult, ham: HamResult, options?: CheckGateOptions): GateResult;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/gate/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,QAAQ,EACR,UAAU,EAEX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAIrD,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,EACxB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,EACvB,4BAA4B,EAC5B,wBAAwB,GACzB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,yBAAyB,EACzB,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,UAAU,GACX,MAAM,aAAa,CAAC;AAGrB,QAAA,MAAM,eAAe;;;;;CAKpB,CAAC;AAyBF,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,QAAQ,EAAE;IAAE,cAAc,EAAE,OAAO,CAAA;CAAE,CAIxE,CAAC;AAEF;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,eAAe,CAWxE;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,YAAY,EACpB,GAAG,EAAE,SAAS,EACd,OAAO,GAAE,gBAAqB,GAC7B,UAAU,CAkEZ"}

package/dist/gate/index.js

@@ -0,0 +1,117 @@
+/**
+ * Gate - PoC / MVP / Production quality gates
+ */
+import { checkWaiver } from './waiver.js';
+// Re-export waiver functions
+export { checkWaiver, checkInlineWaiver, checkExternalWaiver, parseEssentialComplexity, parseWaiverFile, findWaiverFile, matchFilePattern, isWaiverExpired, detectComplexitySignals, detectComplexImports, buildComplexityContext, generateReviewQuestions, ESSENTIAL_COMPLEXITY_SIGNALS, COMPLEX_DOMAIN_LIBRARIES, } from './waiver.js';
+// Base thresholds (MVP baseline)
+const BASE_THRESHOLDS = {
+    nesting_max: 4,
+    concepts_per_function: 9,
+    hidden_dep_max: 2,
+    golden_test_min: 0.8,
+};
+// Stage adjustments from MVP baseline
+const STAGE_ADJUSTMENTS = {
+    poc: {
+        nesting_max: +2,
+        concepts_per_function: +3,
+        hidden_dep_max: +1,
+        golden_test_min: -0.3,
+    },
+    mvp: {
+        nesting_max: 0,
+        concepts_per_function: 0,
+        hidden_dep_max: 0,
+        golden_test_min: 0,
+    },
+    production: {
+        nesting_max: -1,
+        concepts_per_function: -2,
+        hidden_dep_max: -1,
+        golden_test_min: +0.15,
+    },
+};
+// Stage policies (exported for external use)
+export const STAGE_POLICIES = {
+    poc: { waiver_allowed: false },
+    mvp: { waiver_allowed: false },
+    production: { waiver_allowed: true },
+};
+/**
+ * Get thresholds for a specific gate type
+ */
+export function getThresholds(gateType) {
+    const adjustments = STAGE_ADJUSTMENTS[gateType];
+    return {
+        nesting_max: BASE_THRESHOLDS.nesting_max + adjustments.nesting_max,
+        concepts_per_function: BASE_THRESHOLDS.concepts_per_function + adjustments.concepts_per_function,
+        hidden_dep_max: BASE_THRESHOLDS.hidden_dep_max + adjustments.hidden_dep_max,
+        golden_test_min: BASE_THRESHOLDS.golden_test_min + adjustments.golden_test_min,
+    };
+}
+/**
+ * Check if code passes the gate
+ */
+export function checkGate(gateType, cheese, ham, options = {}) {
+    const thresholds = getThresholds(gateType);
+    const violations = [];
+    let waiverApplied = false;
+    // Check waiver if source is provided and waiver is allowed for this stage
+    if (options.source && STAGE_POLICIES[gateType].waiver_allowed) {
+        const waiver = checkWaiver(options.source, options.filePath, options.projectRoot);
+        if (waiver.waived) {
+            waiverApplied = true;
+            // Apply waiver config overrides
+            if (waiver.config?.nesting !== undefined) {
+                thresholds.nesting_max = waiver.config.nesting;
+            }
+            if (waiver.config?.conceptsTotal !== undefined) {
+                thresholds.concepts_per_function = waiver.config.conceptsTotal;
+            }
+        }
+    }
+    // Check nesting
+    if (cheese.maxNesting > thresholds.nesting_max) {
+        violations.push({
+            rule: 'nesting_max',
+            actual: cheese.maxNesting,
+            threshold: thresholds.nesting_max,
+            message: `Nesting depth ${cheese.maxNesting} exceeds ${thresholds.nesting_max}`,
+        });
+    }
+    // Check hidden dependencies
+    if (cheese.hiddenDependencies > thresholds.hidden_dep_max) {
+        violations.push({
+            rule: 'hidden_dep_max',
+            actual: cheese.hiddenDependencies,
+            threshold: thresholds.hidden_dep_max,
+            message: `Hidden deps ${cheese.hiddenDependencies} exceeds ${thresholds.hidden_dep_max}`,
+        });
+    }
+    // Check golden test coverage
+    if (ham.goldenTestCoverage < thresholds.golden_test_min) {
+        violations.push({
+            rule: 'golden_test_min',
+            actual: ham.goldenTestCoverage,
+            threshold: thresholds.golden_test_min,
+            message: `Test coverage ${(ham.goldenTestCoverage * 100).toFixed(1)}% below ${(thresholds.golden_test_min * 100).toFixed(1)}%`,
+        });
+    }
+    // Check state×async×retry
+    if (cheese.stateAsyncRetry.violated) {
+        violations.push({
+            rule: 'state_async_retry',
+            actual: cheese.stateAsyncRetry.count,
+            threshold: 1,
+            message: `state×async×retry co-occurrence: ${cheese.stateAsyncRetry.axes.join('×')}`,
+        });
+    }
+    return {
+        passed: violations.length === 0,
+        gateType,
+        violations,
+        waiverApplied,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/gate/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/gate/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,6BAA6B;AAC7B,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,EACxB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,EACvB,4BAA4B,EAC5B,wBAAwB,GACzB,MAAM,aAAa,CAAC;AAWrB,iCAAiC;AACjC,MAAM,eAAe,GAAG;IACtB,WAAW,EAAE,CAAC;IACd,qBAAqB,EAAE,CAAC;IACxB,cAAc,EAAE,CAAC;IACjB,eAAe,EAAE,GAAG;CACrB,CAAC;AAEF,sCAAsC;AACtC,MAAM,iBAAiB,GAA6C;IAClE,GAAG,EAAE;QACH,WAAW,EAAE,CAAC,CAAC;QACf,qBAAqB,EAAE,CAAC,CAAC;QACzB,cAAc,EAAE,CAAC,CAAC;QAClB,eAAe,EAAE,CAAC,GAAG;KACtB;IACD,GAAG,EAAE;QACH,WAAW,EAAE,CAAC;QACd,qBAAqB,EAAE,CAAC;QACxB,cAAc,EAAE,CAAC;QACjB,eAAe,EAAE,CAAC;KACnB;IACD,UAAU,EAAE;QACV,WAAW,EAAE,CAAC,CAAC;QACf,qBAAqB,EAAE,CAAC,CAAC;QACzB,cAAc,EAAE,CAAC,CAAC;QAClB,eAAe,EAAE,CAAC,IAAI;KACvB;CACF,CAAC;AAEF,6CAA6C;AAC7C,MAAM,CAAC,MAAM,cAAc,GAAkD;IAC3E,GAAG,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE;IAC9B,GAAG,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE;IAC9B,UAAU,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE;CACrC,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,QAAkB;IAC9C,MAAM,WAAW,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAEhD,OAAO;QACL,WAAW,EAAE,eAAe,CAAC,WAAW,GAAG,WAAW,CAAC,WAAW;QAClE,qBAAqB,EACnB,eAAe,CAAC,qBAAqB,GAAG,WAAW,CAAC,qBAAqB;QAC3E,cAAc,EAAE,eAAe,CAAC,cAAc,GAAG,WAAW,CAAC,cAAc;QAC3E,eAAe,EACb,eAAe,CAAC,eAAe,GAAG,WAAW,CAAC,eAAe;KAChE,CAAC;AACJ,CAAC;AAQD;;GAEG;AACH,MAAM,UAAU,SAAS,CACvB,QAAkB,EAClB,MAAoB,EACpB,GAAc,EACd,UAA4B,EAAE;IAE9B,MAAM,UAAU,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAoB,EAAE,CAAC;IACvC,IAAI,aAAa,GAAG,KAAK,CAAC;IAE1B,0EAA0E;IAC1E,IAAI,OAAO,CAAC,MAAM,IAAI,cAAc,CAAC,QAAQ,CAAC,CAAC,cAAc,EAAE,CAAC;QAC9D,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAClF,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,aAAa,GAAG,IAAI,CAAC;YACrB,gCAAgC;YAChC,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,KAAK,SAAS,EAAE,CAAC;gBACzC,UAAU,CAAC,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;YACjD,CAAC;YACD,IAAI,MAAM,CAAC,MAAM,EAAE,aAAa,KAAK,SAAS,EAAE,CAAC;gBAC/C,UAAU,CAAC,qBAAqB,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC;YACjE,CAAC;QACH,CAAC;IACH,CAAC;IAED,gBAAgB;IAChB,IAAI,MAAM,CAAC,UAAU,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;QAC/C,UAAU,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,aAAa;YACnB,MAAM,EAAE,MAAM,CAAC,UAAU;YACzB,SAAS,EAAE,UAAU,CAAC,WAAW;YACjC,OAAO,EAAE,iBAAiB,MAAM,CAAC,UAAU,YAAY,UAAU,CAAC,WAAW,EAAE;SAChF,CAAC,CAAC;IACL,CAAC;IAED,4BAA4B;IAC5B,IAAI,MAAM,CAAC,kBAAkB,GAAG,UAAU,CAAC,cAAc,EAAE,CAAC;QAC1D,UAAU,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,gBAAgB;YACtB,MAAM,EAAE,MAAM,CAAC,kBAAkB;YACjC,SAAS,EAAE,UAAU,CAAC,cAAc;YACpC,OAAO,EAAE,eAAe,MAAM,CAAC,kBAAkB,YAAY,UAAU,CAAC,cAAc,EAAE;SACzF,CAAC,CAAC;IACL,CAAC;IAED,6BAA6B;IAC7B,IAAI,GAAG,CAAC,kBAAkB,GAAG,UAAU,CAAC,eAAe,EAAE,CAAC;QACxD,UAAU,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,iBAAiB;YACvB,MAAM,EAAE,GAAG,CAAC,kBAAkB;YAC9B,SAAS,EAAE,UAAU,CAAC,eAAe;YACrC,OAAO,EAAE,iBAAiB,CAAC,GAAG,CAAC,kBAAkB,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,UAAU,CAAC,eAAe,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;SAC/H,CAAC,CAAC;IACL,CAAC;IAED,0BAA0B;IAC1B,IAAI,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,CAAC;QACpC,UAAU,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,mBAAmB;YACzB,MAAM,EAAE,MAAM,CAAC,eAAe,CAAC,KAAK;YACpC,SAAS,EAAE,CAAC;YACZ,OAAO,EAAE,oCAAoC,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;SACrF,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,MAAM,EAAE,UAAU,CAAC,MAAM,KAAK,CAAC;QAC/B,QAAQ;QACR,UAAU;QACV,aAAa;KACd,CAAC;AACJ,CAAC"}

package/dist/gate/waiver.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Essential Complexity Waiver System
+ *
+ * 본질적 복잡도 면제 시스템:
+ * - __essential_complexity__ 파싱 (인라인)
+ * - .waiver.json 파일 지원 (외부)
+ * - ADR 존재 여부 검증
+ * - ComplexityContext (토대 정보) 생성
+ *
+ * 사용법:
+ *   // 방법 1: 모듈에서 인라인 선언
+ *   export const __essential_complexity__ = {
+ *     adr: "docs/adr/003-inference-complexity.md",
+ *   };
+ *
+ *   // 방법 2: 프로젝트 루트에 .waiver.json 파일 생성
+ *   // {
+ *   //   "version": "1.0",
+ *   //   "waivers": [
+ *   //     { "pattern": "src/crypto/*.ts", "adr": "ADR-007" }
+ *   //   ]
+ *   // }
+ *
+ *   // Gate에서 체크
+ *   const waiver = checkWaiver(source, filePath);
+ *   if (waiver.waived) {
+ *     // 복잡도 검사 유예
+ *   }
+ */
+export interface EssentialComplexityConfig {
+    adr?: string;
+    nesting?: number;
+    conceptsTotal?: number;
+    conceptsParams?: number;
+}
+export interface ComplexitySignal {
+    category: 'math' | 'algorithm' | 'domain';
+    pattern: string;
+    description: string;
+}
+export interface ComplexityContext {
+    signals: ComplexitySignal[];
+    imports: string[];
+    metrics: Record<string, number>;
+    questions: string[];
+}
+export interface WaiverResult {
+    waived: boolean;
+    reason?: string;
+    adrPath?: string;
+    config?: EssentialComplexityConfig;
+    externalWaiver?: ExternalWaiverEntry;
+}
+export interface ExternalWaiverEntry {
+    pattern: string;
+    adr: string;
+    justification?: string;
+    approvedAt?: string;
+    expiresAt?: string | null;
+    approver?: string;
+}
+export interface WaiverFile {
+    $schema?: string;
+    version: string;
+    waivers: ExternalWaiverEntry[];
+}
+type SignalCategory = 'math' | 'algorithm' | 'domain';
+export declare const ESSENTIAL_COMPLEXITY_SIGNALS: Record<SignalCategory, Array<[RegExp, string]>>;
+export declare const COMPLEX_DOMAIN_LIBRARIES: Set<string>;
+export declare function parseEssentialComplexity(source: string): EssentialComplexityConfig | null;
+export declare function detectComplexitySignals(source: string): ComplexitySignal[];
+export declare function detectComplexImports(source: string): string[];
+export declare function generateReviewQuestions(signals: ComplexitySignal[], imports: string[]): string[];
+export declare function buildComplexityContext(source: string, metrics?: Record<string, number>): ComplexityContext;
+export declare function parseWaiverFile(waiverPath: string): WaiverFile | null;
+export declare function findWaiverFile(filePath: string, projectRoot: string): string | null;
+export declare function matchFilePattern(filePath: string, pattern: string): boolean;
+export declare function isWaiverExpired(entry: ExternalWaiverEntry): boolean;
+export declare function checkExternalWaiver(filePath: string, projectRoot: string): WaiverResult;
+export declare function checkWaiver(source: string, filePath?: string, projectRoot?: string): WaiverResult;
+export declare function checkInlineWaiver(source: string, filePath?: string, projectRoot?: string): WaiverResult;
+export {};
+//# sourceMappingURL=waiver.d.ts.map

package/dist/gate/waiver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waiver.d.ts","sourceRoot":"","sources":["../../src/gate/waiver.ts"],"names":[],"mappings":"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"}