@methiu/raigal 0.16.2

package/dist/index.d.ts

@@ -0,0 +1,351 @@
+import { z } from "zod/v4";
+//#region src/config/schema.d.ts
+declare const AislopConfigSchema: z.ZodObject<{
+  version: z.ZodDefault<z.ZodNumber>;
+  extends: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+  engines: z.ZodDefault<z.ZodObject<{
+    format: z.ZodDefault<z.ZodBoolean>;
+    lint: z.ZodDefault<z.ZodBoolean>;
+    "code-quality": z.ZodDefault<z.ZodBoolean>;
+    "ai-slop": z.ZodDefault<z.ZodBoolean>;
+    architecture: z.ZodDefault<z.ZodBoolean>;
+    security: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strict>>;
+  quality: z.ZodDefault<z.ZodObject<{
+    maxFunctionLoc: z.ZodDefault<z.ZodNumber>;
+    maxFileLoc: z.ZodDefault<z.ZodNumber>;
+    maxNesting: z.ZodDefault<z.ZodNumber>;
+    maxParams: z.ZodDefault<z.ZodNumber>;
+  }, z.core.$strict>>;
+  lint: z.ZodDefault<z.ZodObject<{
+    typecheck: z.ZodDefault<z.ZodBoolean>;
+    expoDoctor: z.ZodDefault<z.ZodBoolean>;
+    csharp: z.ZodDefault<z.ZodObject<{
+      projectEvaluation: z.ZodDefault<z.ZodBoolean>;
+      jb: z.ZodDefault<z.ZodBoolean>;
+      roslynator: z.ZodDefault<z.ZodBoolean>;
+      jbSeverityFloor: z.ZodDefault<z.ZodEnum<{
+        ERROR: "ERROR";
+        WARNING: "WARNING";
+        SUGGESTION: "SUGGESTION";
+        HINT: "HINT";
+      }>>;
+      jbExcludeTypes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+      jbProjects: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    cpp: z.ZodDefault<z.ZodObject<{
+      cppcheck: z.ZodDefault<z.ZodBoolean>;
+      clangTidy: z.ZodDefault<z.ZodBoolean>;
+      cppcheckEnable: z.ZodDefault<z.ZodString>;
+      jb: z.ZodDefault<z.ZodBoolean>;
+      jbProjects: z.ZodOptional<z.ZodString>;
+      jbSeverityFloor: z.ZodDefault<z.ZodEnum<{
+        ERROR: "ERROR";
+        WARNING: "WARNING";
+        SUGGESTION: "SUGGESTION";
+        HINT: "HINT";
+      }>>;
+      jbExcludeTypes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+  }, z.core.$strict>>;
+  security: z.ZodDefault<z.ZodObject<{
+    audit: z.ZodDefault<z.ZodBoolean>;
+    auditTimeout: z.ZodDefault<z.ZodNumber>;
+  }, z.core.$strict>>;
+  scoring: z.ZodDefault<z.ZodObject<{
+    weights: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    thresholds: z.ZodDefault<z.ZodObject<{
+      good: z.ZodDefault<z.ZodNumber>;
+      ok: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>>;
+    smoothing: z.ZodDefault<z.ZodNumber>;
+    maxPerRule: z.ZodDefault<z.ZodNumber>;
+  }, z.core.$strict>>;
+  ci: z.ZodDefault<z.ZodObject<{
+    failBelow: z.ZodDefault<z.ZodNumber>;
+    format: z.ZodDefault<z.ZodEnum<{
+      json: "json";
+    }>>;
+  }, z.core.$strict>>;
+  telemetry: z.ZodDefault<z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strict>>;
+  rules: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodEnum<{
+    error: "error";
+    warning: "warning";
+    off: "off";
+  }>>>;
+  exclude: z.ZodDefault<z.ZodArray<z.ZodString>>;
+  include: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+declare const RaigalConfigSchema: z.ZodObject<{
+  version: z.ZodDefault<z.ZodNumber>;
+  extends: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+  engines: z.ZodDefault<z.ZodObject<{
+    format: z.ZodDefault<z.ZodBoolean>;
+    lint: z.ZodDefault<z.ZodBoolean>;
+    "code-quality": z.ZodDefault<z.ZodBoolean>;
+    "ai-slop": z.ZodDefault<z.ZodBoolean>;
+    architecture: z.ZodDefault<z.ZodBoolean>;
+    security: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strict>>;
+  quality: z.ZodDefault<z.ZodObject<{
+    maxFunctionLoc: z.ZodDefault<z.ZodNumber>;
+    maxFileLoc: z.ZodDefault<z.ZodNumber>;
+    maxNesting: z.ZodDefault<z.ZodNumber>;
+    maxParams: z.ZodDefault<z.ZodNumber>;
+  }, z.core.$strict>>;
+  lint: z.ZodDefault<z.ZodObject<{
+    typecheck: z.ZodDefault<z.ZodBoolean>;
+    expoDoctor: z.ZodDefault<z.ZodBoolean>;
+    csharp: z.ZodDefault<z.ZodObject<{
+      projectEvaluation: z.ZodDefault<z.ZodBoolean>;
+      jb: z.ZodDefault<z.ZodBoolean>;
+      roslynator: z.ZodDefault<z.ZodBoolean>;
+      jbSeverityFloor: z.ZodDefault<z.ZodEnum<{
+        ERROR: "ERROR";
+        WARNING: "WARNING";
+        SUGGESTION: "SUGGESTION";
+        HINT: "HINT";
+      }>>;
+      jbExcludeTypes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+      jbProjects: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    cpp: z.ZodDefault<z.ZodObject<{
+      cppcheck: z.ZodDefault<z.ZodBoolean>;
+      clangTidy: z.ZodDefault<z.ZodBoolean>;
+      cppcheckEnable: z.ZodDefault<z.ZodString>;
+      jb: z.ZodDefault<z.ZodBoolean>;
+      jbProjects: z.ZodOptional<z.ZodString>;
+      jbSeverityFloor: z.ZodDefault<z.ZodEnum<{
+        ERROR: "ERROR";
+        WARNING: "WARNING";
+        SUGGESTION: "SUGGESTION";
+        HINT: "HINT";
+      }>>;
+      jbExcludeTypes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+  }, z.core.$strict>>;
+  security: z.ZodDefault<z.ZodObject<{
+    audit: z.ZodDefault<z.ZodBoolean>;
+    auditTimeout: z.ZodDefault<z.ZodNumber>;
+  }, z.core.$strict>>;
+  scoring: z.ZodDefault<z.ZodObject<{
+    weights: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    thresholds: z.ZodDefault<z.ZodObject<{
+      good: z.ZodDefault<z.ZodNumber>;
+      ok: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>>;
+    smoothing: z.ZodDefault<z.ZodNumber>;
+    maxPerRule: z.ZodDefault<z.ZodNumber>;
+  }, z.core.$strict>>;
+  ci: z.ZodDefault<z.ZodObject<{
+    failBelow: z.ZodDefault<z.ZodNumber>;
+    format: z.ZodDefault<z.ZodEnum<{
+      json: "json";
+    }>>;
+  }, z.core.$strict>>;
+  telemetry: z.ZodDefault<z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strict>>;
+  rules: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodEnum<{
+    error: "error";
+    warning: "warning";
+    off: "off";
+  }>>>;
+  exclude: z.ZodDefault<z.ZodArray<z.ZodString>>;
+  include: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+type RaigalConfig = z.infer<typeof RaigalConfigSchema>;
+type AislopConfig = RaigalConfig;
+//#endregion
+//#region src/config/index.d.ts
+declare const loadConfig: (directory: string) => AislopConfig;
+//#endregion
+//#region src/utils/discovery-classifiers.d.ts
+type Language = "typescript" | "javascript" | "python" | "go" | "rust" | "java" | "ruby" | "php" | "csharp" | "cpp";
+type Framework = "nextjs" | "react" | "vite" | "remix" | "expo" | "astro" | "django" | "flask" | "fastapi" | "none";
+//#endregion
+//#region src/utils/discovery-coverage.d.ts
+interface Coverage {
+  readonly dominantUnsupported: string | null;
+  readonly scoreable: boolean;
+  readonly supportedFiles: number;
+  readonly unsupportedFiles: number;
+}
+//#endregion
+//#region src/utils/discover.d.ts
+interface ProjectInfo {
+  rootDirectory: string;
+  projectName: string;
+  languages: Language[];
+  frameworks: Framework[];
+  sourceFileCount: number;
+  coverage: Coverage;
+  installedTools: Record<string, boolean>;
+}
+interface DiscoveryInputs {
+  readonly includePatterns?: string[];
+  readonly installedTools?: Record<string, boolean>;
+  readonly projectFiles?: string[];
+  readonly sourceFiles?: string[];
+}
+declare const discoverProject: (directory: string, excludePatterns?: string[], inputs?: DiscoveryInputs) => Promise<ProjectInfo>;
+//#endregion
+//#region src/commands/doctor-plan.d.ts
+interface DoctorEngineRow {
+  engine: string;
+  tool: string;
+  status: "ok" | "missing" | "skipped";
+  remediation?: string;
+  skipReason?: string;
+}
+//#endregion
+//#region src/commands/doctor.d.ts
+interface BuildDoctorRenderInput {
+  projectName: string;
+  languageLabel: string;
+  rows: DoctorEngineRow[];
+  invocation: string;
+  printBrand?: boolean;
+}
+declare const buildDoctorRender: (input: BuildDoctorRenderInput) => string;
+interface DoctorOptions {
+  printBrand?: boolean;
+}
+declare const doctorCommand: (directory: string, options?: DoctorOptions) => Promise<void>;
+//#endregion
+//#region src/ui/rail.d.ts
+type RailStepStatus = "active" | "done" | "warn" | "failed" | "skipped";
+interface RailStep {
+  status: RailStepStatus;
+  label: string;
+  notes?: string[];
+}
+//#endregion
+//#region src/commands/fix.d.ts
+interface FixOptions {
+  verbose: boolean;
+  force?: boolean;
+  /** Restrict to reversible fixes only (imports, comment removal, safe formatter runs) */
+  safe?: boolean;
+  dryRun?: boolean;
+  changes?: boolean;
+  staged?: boolean;
+  base?: string;
+  /** Agent CLI to launch with remaining issues (e.g. "claude", "codex") */
+  agent?: string;
+  /** Print the prompt to stdout instead of launching an agent */
+  prompt?: boolean;
+  showHeader?: boolean;
+  printBrand?: boolean;
+}
+declare const fixCommand: (directory: string, config: AislopConfig, options?: FixOptions) => Promise<{
+  exitCode: number;
+}>;
+//#endregion
+//#region src/commands/init.d.ts
+interface BuildInitRenderInput {
+  steps: RailStep[];
+  nextCommand: string;
+  includeHeader?: boolean;
+  printBrand?: boolean;
+}
+declare const buildInitSuccessRender: (input: BuildInitRenderInput) => string;
+interface InitOptions {
+  printBrand?: boolean;
+  strict?: boolean;
+}
+declare const initCommand: (directory: string, options?: InitOptions) => Promise<void>;
+//#endregion
+//#region src/commands/rules-render.d.ts
+interface RuleEntry {
+  id: string;
+  engine: string;
+  severity: "error" | "warning" | "info";
+  fixable: boolean;
+}
+interface BuildRulesRenderInput {
+  rules: RuleEntry[];
+  invocation?: string;
+  printBrand?: boolean;
+  includeHeader?: boolean;
+}
+declare const buildRulesRender: (input: BuildRulesRenderInput) => string;
+declare const buildRuleDetailRender: (rule: RuleEntry, input?: {
+  printBrand?: boolean;
+  includeHeader?: boolean;
+}) => string;
+//#endregion
+//#region src/commands/rules.d.ts
+interface RulesOptions {
+  printBrand?: boolean;
+  interactive?: boolean;
+}
+declare const rulesCommand: (directory: string, options?: RulesOptions) => Promise<void>;
+//#endregion
+//#region src/commands/scan-exit-code.d.ts
+type FailOnMode = "none" | "error" | "warning";
+//#endregion
+//#region src/commands/scan-options.d.ts
+interface ScanOptions {
+  changes: boolean;
+  staged: boolean;
+  base?: string;
+  verbose: boolean;
+  json: boolean;
+  sarif?: boolean;
+  showHeader?: boolean;
+  printBrand?: boolean;
+  exclude?: string[];
+  include?: string[];
+  /** Used for telemetry to distinguish scan vs ci invocation */
+  command?: "scan" | "ci";
+  failOn?: FailOnMode;
+}
+//#endregion
+//#region src/engines/types.d.ts
+type Severity = "error" | "warning" | "info";
+type EngineName = "format" | "lint" | "code-quality" | "ai-slop" | "architecture" | "security";
+type ChangeContext = "changed-line" | "existing-file-context" | "unknown";
+interface Diagnostic {
+  filePath: string;
+  engine: EngineName;
+  rule: string;
+  severity: Severity;
+  message: string;
+  help: string;
+  line: number;
+  column: number;
+  category: string;
+  fixable: boolean;
+  detail?: string;
+  changeContext?: ChangeContext;
+  redactSource?: boolean;
+}
+interface EngineResult {
+  engine: EngineName;
+  diagnostics: Diagnostic[];
+  elapsed: number;
+  skipped: boolean;
+  skipReason?: string;
+}
+//#endregion
+//#region src/commands/scan.d.ts
+declare const scanCommand: (directory: string, config: AislopConfig, options: ScanOptions) => Promise<{
+  exitCode: number;
+}>;
+//#endregion
+//#region src/scoring/index.d.ts
+interface ScoreResult {
+  score: number;
+  label: string;
+  effectiveSourceFileCount?: number;
+  sourceFileCountMode?: "provided" | "estimated-from-diagnostics" | "not-needed";
+}
+declare const calculateScore: (diagnostics: Diagnostic[], weights: Record<string, number>, thresholds: {
+  good: number;
+  ok: number;
+}, sourceFileCount?: number, smoothing?: number, maxPerRule?: number) => ScoreResult;
+//#endregion
+export { type AislopConfig, AislopConfigSchema, type Diagnostic, type EngineName, type EngineResult, type Framework, type Language, type ProjectInfo, type RaigalConfig, RaigalConfigSchema, type ScoreResult, type Severity, buildDoctorRender, buildInitSuccessRender, buildRuleDetailRender, buildRulesRender, calculateScore, discoverProject, doctorCommand, fixCommand, initCommand, loadConfig, rulesCommand, scanCommand };