@alint-js/core 0.1.3 → 0.1.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alint contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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 };