@alint-js/core 0.1.4 → 0.2.0

package/README.md

@@ -28,18 +28,20 @@ export const rule = defineRule({
   create: ctx => ({
     async onTargetFile(target) {
       const model = await ctx.model({ size: 'small' })
+      const file = await ctx.src.readFile(target.file)
 
       ctx.report({
         filePath: target.file.path,
         loc: target.loc,
-        message: `reviewed with ${model.id}`,
+        message: `reviewed ${file.lines.length} lines with ${model.id}`,
       })
     },
   }),
 })
 ```
 
-Project rules receive compact file and target entries. Read source only when the rule needs it:
+Source and project rules receive compact descriptors. Source handlers should pass `target.file`
+to `ctx.src.readFile()` so core can detect changes since planning. Read source only when needed:
 
 ```ts
 import { defineRule } from '@alint-js/core'
@@ -57,9 +59,10 @@ export const projectRule = defineRule({
 })
 ```
 
-`ProjectFileEntry` and `ProjectTargetEntry` intentionally omit source text and arbitrary
-extractor metadata. Calls to `ctx.src.readFile()` are explicit and plugin-owned, so a project
-rule controls which source files it loads and how long it retains them.
+`PlannedSourceTarget`, `ProjectFileEntry`, and `ProjectTargetEntry` intentionally omit source text.
+Calls to `ctx.src.readFile()` are explicit and plugin-owned, so a rule controls which source files
+it loads and how long it retains them. Cache hits do not invoke the handler and therefore do not
+perform its execution-time read.
 
 Use the agent contract for tool-using rules:
 
@@ -119,8 +122,9 @@ explore with tools before answering, because a forced tool call is a single shot
 
 ## Memory boundaries
 
-`alint` bounds its engine-owned source sessions. It cannot bound source files retained by plugin
-code after `ctx.src.readFile()` returns.
+`alint` bounds concurrent source planning reads and parser work. Planning releases rich extractor
+values as soon as compact jobs are admitted; queued jobs do not retain source text. It cannot bound
+source files retained by plugin code after `ctx.src.readFile()` returns.
 
 A valid cache written by the same `alint` version is still read from one monolithic JSON document.
 An extremely large cache may therefore exhaust available memory.

package/dist/agent.d.mts

@@ -1,4 +1,4 @@
-import { F as AgentTool, I as AgentUsage, M as AgentAdapter, N as AgentRequest, P as AgentResult, b as RuleContext } from "./types-DKylUrAn.mjs";
+import { F as AgentTool, I as AgentUsage, M as AgentAdapter, N as AgentRequest, P as AgentResult, b as RuleContext } from "./types-deBCDA4_.mjs";
 //#region src/agent/retry.d.ts
 /**
  * Declares that the complete adapter invocation can be safely replayed.

package/dist/{define-8BzWDcPs.d.mts → define-CJ2QJPZ8.d.mts}

@@ -1,4 +1,4 @@
-import { E as RuleOptionsSchema, i as AlintConfigItem, p as PluginDefinition, t as AlintConfig, w as RuleOptionsInput, x as RuleDefinition, y as RuleConfigEntry } from "./types-DKylUrAn.mjs";
+import { E as RuleOptionsSchema, i as AlintConfigItem, p as PluginDefinition, t as AlintConfig, w as RuleOptionsInput, x as RuleDefinition, y as RuleConfigEntry } from "./types-deBCDA4_.mjs";
 //#region src/dsl/define.d.ts
 type AnyRuleDefinition = RuleDefinition<any>;
 type ConfigItemWithPluginRules<Plugins, Rules> = Omit<AlintConfigItem, 'plugins' | 'rules'> & {

package/dist/dsl.d.mts

@@ -1,3 +1,3 @@
-import { A as RuleWithHandler, C as RuleInferenceUsageRecord, D as RuleRegistry, E as RuleOptionsSchema, O as RuleSeverity, S as RuleHandlers, T as RuleOptionsOutput, _ as ProjectTargetEntry, a as AlintLinterOptions, b as RuleContext, c as DiagnosticLocation, d as IgnoreConfig, f as LanguageDefinition, g as ProjectTarget, h as ProjectFileEntry, i as AlintConfigItem, j as Target, k as RuleSpecializedHandlers, 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 RuleCacheConfig, w as RuleOptionsInput, x as RuleDefinition, y as RuleConfigEntry } from "./types-DKylUrAn.mjs";
-import { n as definePlugin, r as defineRule, t as defineConfig } from "./define-8BzWDcPs.mjs";
+import { A as RuleWithHandler, C as RuleInferenceUsageRecord, D as RuleRegistry, E as RuleOptionsSchema, O as RuleSeverity, S as RuleHandlers, T as RuleOptionsOutput, _ as ProjectTargetEntry, a as AlintLinterOptions, b as RuleContext, c as DiagnosticLocation, d as IgnoreConfig, f as LanguageDefinition, g as ProjectTarget, h as ProjectFileEntry, i as AlintConfigItem, j as Target, k as RuleSpecializedHandlers, 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 RuleCacheConfig, w as RuleOptionsInput, x as RuleDefinition, y as RuleConfigEntry } from "./types-deBCDA4_.mjs";
+import { n as definePlugin, r as defineRule, t as defineConfig } from "./define-CJ2QJPZ8.mjs";
 export { type AlintConfig, type AlintConfigExtends, type AlintConfigInput, type AlintConfigItem, type AlintLinterOptions, type Awaitable, type DiagnosticDescriptor, type DiagnosticLocation, type DirectoryTarget, type EnabledRule, type IgnoreConfig, type LanguageDefinition, type PluginDefinition, type ProcessorDefinition, type ProjectFileEntry, type ProjectTarget, type ProjectTargetEntry, type RuleCacheConfig, type RuleConfigEntry, type RuleContext, type RuleDefinition, type RuleHandlers, type RuleInferenceUsageRecord, type RuleOptionsInput, type RuleOptionsOutput, type RuleOptionsSchema, type RuleRegistry, type RuleSeverity, type RuleSpecializedHandlers, type RuleWithHandler, type Target, defineConfig, definePlugin, defineRule };