@alint-js/core 0.0.29 → 0.0.31

package/dist/{retry-C4sGjSE5.mjs → agent-weXkvGkc.mjs}

@@ -47,4 +47,23 @@ function withAgentRetry(adapter, retries = 2) {
 	};
 }
 //#endregion
-export { isRetryableAgentError as n, withAgentRetry as r, RetryableAgentError as t };
+//#region src/agent/index.ts
+function combineAbortSignals(...candidates) {
+	const signals = candidates.filter((signal) => signal !== void 0);
+	if (signals.length === 0) return void 0;
+	if (signals.length === 1) return signals[0];
+	return AbortSignal.any(signals);
+}
+function defineTool(tool) {
+	return tool;
+}
+function requireAgent(context) {
+	if (!context.agent) throw new TypeError(`Rule "${context.id}" requires an agent, but none is configured. Set "agent" in alint config (e.g. agent: createApeiraAdapter()).`);
+	const agent = context.agent;
+	return async (request) => agent({
+		...request,
+		signal: request.signal ?? context.signal
+	});
+}
+//#endregion
+export { isRetryableAgentError as a, RetryableAgentError as i, defineTool as n, withAgentRetry as o, requireAgent as r, combineAbortSignals as t };

package/dist/agent.d.mts

@@ -1,4 +1,4 @@
-import { A as AgentTool, D as AgentAdapter, O as AgentRequest, j as AgentUsage, k as AgentResult, v as RuleContext } from "./types-CMLoj9J9.mjs";
+import { A as AgentTool, D as AgentAdapter, O as AgentRequest, j as AgentUsage, k as AgentResult, v as RuleContext } from "./types-CR_Grd6q.mjs";
 //#region src/agent/retry.d.ts
 /**
  * Declares that the complete adapter invocation can be safely replayed.
@@ -10,7 +10,8 @@ declare class RetryableAgentError extends Error {
 declare function isRetryableAgentError(error: unknown): error is RetryableAgentError;
 //#endregion
 //#region src/agent/index.d.ts
+declare function combineAbortSignals(...candidates: Array<AbortSignal | undefined>): AbortSignal | undefined;
 declare function defineTool(tool: AgentTool): AgentTool;
 declare function requireAgent(context: Pick<RuleContext, 'agent' | 'id' | 'signal'>): AgentAdapter;
 //#endregion
-export { type AgentAdapter, type AgentRequest, type AgentResult, type AgentTool, type AgentUsage, RetryableAgentError, defineTool, isRetryableAgentError, requireAgent };
+export { type AgentAdapter, type AgentRequest, type AgentResult, type AgentTool, type AgentUsage, RetryableAgentError, combineAbortSignals, defineTool, isRetryableAgentError, requireAgent };

package/dist/agent.mjs

@@ -1,15 +1,2 @@
-import { n as isRetryableAgentError, t as RetryableAgentError } from "./retry-C4sGjSE5.mjs";
-//#region src/agent/index.ts
-function defineTool(tool) {
-	return tool;
-}
-function requireAgent(context) {
-	if (!context.agent) throw new TypeError(`Rule "${context.id}" requires an agent, but none is configured. Set "agent" in alint config (e.g. agent: createApeiraAdapter()).`);
-	const agent = context.agent;
-	return async (request) => agent({
-		...request,
-		signal: request.signal ?? context.signal
-	});
-}
-//#endregion
-export { RetryableAgentError, defineTool, isRetryableAgentError, requireAgent };
+import { a as isRetryableAgentError, i as RetryableAgentError, n as defineTool, r as requireAgent, t as combineAbortSignals } from "./agent-weXkvGkc.mjs";
+export { RetryableAgentError, combineAbortSignals, defineTool, isRetryableAgentError, requireAgent };

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { B as RunnerStatsConfig, C as RuleSeverity, E as Target, F as ResolvedProvider, H as SetupModelDefinition, I as ModelSize, L as ProviderDefinition, M as ModelRequirement, N as ResolveModelOptions, P as ResolvedModel, R as ProviderType, S as RuleRegistry, T as RuleWithHandler, V as SetupConfig, _ as RuleConfigEntry, a as AlintLinterOptions, b as RuleHandlers, c as DiagnosticLocation, d as IgnoreConfig, f as LanguageDefinition, g as RuleCacheConfig, h as ProjectTarget, i as AlintConfigItem, l as DirectoryTarget, m as ProcessorDefinition, n as AlintConfigExtends, o as Awaitable, p as PluginDefinition, r as AlintConfigInput, s as DiagnosticDescriptor, t as AlintConfig, u as EnabledRule, v as RuleContext, w as RuleSpecializedHandlers, x as RuleInferenceUsageRecord, y as RuleDefinition, z as RunnerConfig } from "./types-CMLoj9J9.mjs";
+import { B as RunnerStatsConfig, C as RuleSeverity, E as Target, F as ResolvedProvider, H as SetupModelDefinition, I as ModelSize, L as ProviderDefinition, M as ModelRequirement, N as ResolveModelOptions, P as ResolvedModel, R as ProviderType, S as RuleRegistry, T as RuleWithHandler, V as SetupConfig, _ as RuleConfigEntry, a as AlintLinterOptions, b as RuleHandlers, c as DiagnosticLocation, d as IgnoreConfig, f as LanguageDefinition, g as RuleCacheConfig, h as ProjectTarget, i as AlintConfigItem, l as DirectoryTarget, m as ProcessorDefinition, n as AlintConfigExtends, o as Awaitable, p as PluginDefinition, r as AlintConfigInput, s as DiagnosticDescriptor, t as AlintConfig, u as EnabledRule, v as RuleContext, w as RuleSpecializedHandlers, x as RuleInferenceUsageRecord, y as RuleDefinition, z as RunnerConfig } from "./types-CR_Grd6q.mjs";
 import { _ as SourceTargetOfKind, a as LineRange, c as ProcessorContext, d as SourceLocation, f as SourcePosition, g as SourceTargetKind, h as SourceTarget, i as LanguageContext, l as ProcessorPostprocessContext, m as SourceRuntime, n as FileTarget, o as ProcessedSource, p as SourceRange, r as FunctionTarget, s as ProcessedSourceOrigin, t as ClassTarget, u as SourceFile, v as SourceTargetOrigin, y as SourceText } from "./types-DSvXUVZ7.mjs";
 //#region src/config/config-array.d.ts
 interface EffectiveAlintConfig {
@@ -50,13 +50,9 @@ declare function createBuiltInLanguageRegistry(): LanguageRegistry;
 //#endregion
 //#region src/core/types.d.ts
 interface AlintRunFailure {
-  filePath?: string;
+  job: ProgressJob;
+  kind: 'cache-replay' | 'handler' | 'timeout';
   message: string;
-  ruleId?: string;
-  target?: {
-    kind: ProgressTargetKind;
-    name?: string;
-  };
 }
 interface Diagnostic {
   cached?: boolean;
@@ -74,96 +70,70 @@ interface Diagnostic {
 }
 interface DiagnosticProgressPayload {
   diagnostic: Diagnostic;
-  diagnostics: Diagnostic[];
-  path?: ProgressPath;
+  job: ProgressJob;
 }
-interface FileProgressPayload {
-  endedAt?: number;
-  file: ProgressFilePath;
-  startedAt?: number;
+interface ExecutionCounts {
+  cached: number;
+  cancelled: number;
+  completed: number;
+  failed: number;
+  planned: number;
+  queued: number;
+  running: number;
+  /** Rules left unexecuted because they missed the cache under {@link RunOptions.cacheOnly}. */
+  skipped: number;
 }
 type InferenceUsageRecord = Omit<RuleInferenceUsageRecord, 'ruleId'> & {
   ruleId: string;
 };
-interface ProgressFilePath {
-  index: number;
-  path: string;
-  planned?: number;
-  total: number;
+interface JobEndPayload extends JobStartPayload {
+  cache: 'hit' | 'miss';
+  endedAt?: number;
+  failure?: AlintRunFailure;
+  state: 'cached' | 'cancelled' | 'completed' | 'failed' | 'skipped';
 }
-interface ProgressPath {
-  file: ProgressFilePath;
-  rule: {
-    id: string;
-    index: number;
-    total: number;
-  };
+interface JobQueuedPayload {
+  job: ProgressJob;
+}
+interface JobStartPayload {
+  job: ProgressJob;
+  startedAt?: number;
+}
+interface ProgressJob {
+  id: string;
+  index: number;
+  inputPath: string;
+  ruleId: string;
   target: {
-    index: number;
+    identity: string;
     kind: ProgressTargetKind;
     name?: string;
-    total: number;
   };
+  total: number;
 }
 interface ProgressReporter {
   onDiagnostic?: (payload: DiagnosticProgressPayload) => void;
-  onFileEnd?: (payload: FileProgressPayload) => void;
-  onFileStart?: (payload: FileProgressPayload) => void;
-  onRuleEnd?: (payload: RuleEndPayload) => void;
-  onRuleStart?: (payload: RuleStartPayload) => void;
+  onJobEnd?: (payload: JobEndPayload) => void;
+  onJobQueued?: (payload: JobQueuedPayload) => void;
+  onJobStart?: (payload: JobStartPayload) => void;
   onRunEnd?: (payload: RunEndPayload) => void;
   onRunStart?: (payload: RunStartPayload) => void;
-  onTargetEnd?: (payload: TargetProgressPayload) => void;
-  onTargetStart?: (payload: TargetProgressPayload) => void;
   onUsage?: (payload: UsageProgressPayload) => void;
 }
 type ProgressTargetKind = SourceTargetKind;
-interface RuleEndPayload {
-  cache: 'hit' | 'miss';
-  endedAt?: number;
-  path: ProgressPath;
-  startedAt?: number;
-  /**
-   * `skipped` only occurs under {@link RunOptions.cacheOnly}: the rule missed the cache and was
-   * never executed, so it produced no diagnostics. `cache` is still `'miss'` in that case.
-   */
-  state: 'completed' | 'errored' | 'skipped';
-}
-interface RuleStartPayload {
-  path: ProgressPath;
-  startedAt?: number;
-}
 interface RunEndPayload {
-  cached: number;
-  completed: number;
   diagnostics: Diagnostic[];
   endedAt?: number;
-  errored: number;
-  planned: number;
-  /** Rules left unexecuted because they missed the cache under {@link RunOptions.cacheOnly}. Always 0 otherwise. */
-  skipped: number;
+  execution: ExecutionCounts;
   startedAt?: number;
   usage: RunUsage;
 }
-interface RunExecution {
-  cached: number;
-  completed: number;
-  errored: number;
-  planned: number;
-  /** Rules left unexecuted because they missed the cache under {@link RunOptions.cacheOnly}. Always 0 otherwise. */
-  skipped: number;
-}
+type RunExecution = ExecutionCounts;
 type RunnerOptions = RunnerConfig;
 interface RunOptions {
   /**
    * Return only diagnostics that are already cached, without calling any model.
-   *
-   * Rules that miss the cache are skipped instead of executed, and the run leaves the cache
-   * file untouched. Read {@link RunExecution.skipped} to see how many rules a full run would
-   * still have to execute.
-   *
-   * Intended for callers that want to show known results for free, such as an editor
-   * displaying diagnostics on file open.
+   * Rules that miss the cache are skipped, and the cache remains read-only.
    */
   cacheOnly?: boolean;
   config?: AlintConfig;
@@ -187,14 +157,11 @@ interface RunOptions {
 }
 interface RunResult {
   diagnostics: Diagnostic[];
-  execution?: RunExecution;
+  execution: ExecutionCounts;
   usage: RunUsage;
 }
 interface RunStartPayload {
-  files?: ProgressFilePath[];
-  filesTotal: number;
-  planned: number;
-  rulesTotal: number;
+  jobsTotal: number;
   startedAt?: number;
 }
 interface RunUsage {
@@ -210,24 +177,28 @@ interface RunUsageTotals {
   records: InferenceUsageRecord[];
   totalTokens: number;
 }
-interface TargetProgressPayload {
-  endedAt?: number;
-  path: ProgressPath;
-  startedAt?: number;
-}
 interface UsageProgressPayload {
-  path?: ProgressPath;
+  job: ProgressJob;
   record: InferenceUsageRecord;
-  total: RunUsage;
 }
 //#endregion
 //#region src/core/run.d.ts
+declare class AlintRunCancelledError extends Error {
+  readonly result: RunResult;
+  constructor(result: RunResult, cause?: unknown);
+}
+/** Cancellation error carrying the partial result gathered before the abort. */
+declare class AlintAbortError extends AlintRunCancelledError {
+  constructor(result: RunResult, options?: {
+    cause?: unknown;
+  });
+}
 declare class AlintRunError extends Error {
-  readonly failure?: AlintRunFailure;
+  readonly failures: AlintRunFailure[];
   readonly result: RunResult;
   constructor(message: string, result: RunResult, options?: {
     cause?: unknown;
-    failure?: AlintRunFailure;
+    failures?: AlintRunFailure[];
   });
 }
 declare function runAlint(options?: RunOptions): Promise<RunResult>;
@@ -249,4 +220,4 @@ declare function buildRuleRegistry(config: Pick<EffectiveAlintConfig, 'plugins'
 //#region src/models/resolve.d.ts
 declare function resolveModel(registry: SetupConfig, options?: ResolveModelOptions): ResolvedModel;
 //#endregion
-export { type AlintConfig, type AlintConfigExtends, type AlintConfigInput, type AlintConfigItem, type AlintLinterOptions, AlintRunError, type AlintRunFailure, type Awaitable, type ClassTarget, type Diagnostic, type DiagnosticDescriptor, type DiagnosticLocation, type DiagnosticProgressPayload, type DirectoryTarget, type EffectiveAlintConfig, type EnabledRule, type FileProgressPayload, type FileTarget, type FunctionTarget, type IgnoreConfig, type InferenceUsageRecord, type LanguageContext, type LanguageDefinition, type LanguageRegistry, type LineRange, type ModelRequirement, type ModelSize, type PluginDefinition, type ProcessedSource, type ProcessedSourceOrigin, type ProcessorContext, type ProcessorDefinition, type ProcessorPostprocessContext, type ProgressFilePath, type ProgressPath, type ProgressReporter, type ProgressTargetKind, type ProjectTarget, type ProviderDefinition, type ProviderType, type ResolveConfigResult, type ResolveLanguageOptions, type ResolveModelOptions, type ResolvedModel, type ResolvedProvider, type RuleCacheConfig, type RuleConfigEntry, type RuleContext, type RuleDefinition, type RuleEndPayload, type RuleHandlers, type RuleInferenceUsageRecord, type RuleRegistry, type RuleSeverity, type RuleSpecializedHandlers, type RuleStartPayload, type RuleWithHandler, type RunEndPayload, type RunExecution, type RunOptions, type RunResult, type RunStartPayload, type RunUsage, type RunUsageTotals, type RunnerConfig, type RunnerStatsConfig, type SetupConfig, type SetupModelDefinition, type SourceFile, type SourceLocation, type SourcePosition, type SourceRange, type SourceRuntime, type SourceTarget, type SourceTargetKind, type SourceTargetOfKind, type SourceTargetOrigin, type SourceText, type Target, type TargetProgressPayload, type UsageProgressPayload, buildRuleRegistry, createBuiltInLanguageRegistry, createSourceFile, createSourceRuntime, defineConfig, definePlugin, defineRule, hasDiscoveryFilePatterns, matchesDiscoveryFile, normalizeConfig, registerLanguage, resolveConfigForDirectory, resolveConfigForFile, resolveConfigForProject, resolveLanguage, resolveModel, runAlint, sliceLines, sliceRange };
+export { AlintAbortError, type AlintConfig, type AlintConfigExtends, type AlintConfigInput, type AlintConfigItem, type AlintLinterOptions, AlintRunCancelledError, AlintRunError, type AlintRunFailure, type Awaitable, type ClassTarget, type Diagnostic, type DiagnosticDescriptor, type DiagnosticLocation, type DiagnosticProgressPayload, type DirectoryTarget, type EffectiveAlintConfig, type EnabledRule, type ExecutionCounts, type FileTarget, type FunctionTarget, type IgnoreConfig, type InferenceUsageRecord, type JobEndPayload, type JobQueuedPayload, type JobStartPayload, type LanguageContext, type LanguageDefinition, type LanguageRegistry, type LineRange, type ModelRequirement, type ModelSize, type PluginDefinition, type ProcessedSource, type ProcessedSourceOrigin, type ProcessorContext, type ProcessorDefinition, type ProcessorPostprocessContext, type ProgressJob, type ProgressReporter, type ProgressTargetKind, type ProjectTarget, type ProviderDefinition, type ProviderType, type ResolveConfigResult, type ResolveLanguageOptions, type ResolveModelOptions, type ResolvedModel, type ResolvedProvider, type RuleCacheConfig, type RuleConfigEntry, type RuleContext, type RuleDefinition, type RuleHandlers, type RuleInferenceUsageRecord, type RuleRegistry, type RuleSeverity, type RuleSpecializedHandlers, type RuleWithHandler, type RunEndPayload, type RunExecution, type RunOptions, type RunResult, type RunStartPayload, type RunUsage, type RunUsageTotals, type RunnerConfig, type RunnerStatsConfig, type SetupConfig, type SetupModelDefinition, type SourceFile, type SourceLocation, type SourcePosition, type SourceRange, type SourceRuntime, type SourceTarget, type SourceTargetKind, type SourceTargetOfKind, type SourceTargetOrigin, type SourceText, type Target, type UsageProgressPayload, buildRuleRegistry, createBuiltInLanguageRegistry, createSourceFile, createSourceRuntime, defineConfig, definePlugin, defineRule, hasDiscoveryFilePatterns, matchesDiscoveryFile, normalizeConfig, registerLanguage, resolveConfigForDirectory, resolveConfigForFile, resolveConfigForProject, resolveLanguage, resolveModel, runAlint, sliceLines, sliceRange };