@aurelienbn/ agentlint-plugin-core (英语)

25 Agentlint对任何TypeScript repo的检讨:一个决定性的触发器发现地点,一个代理或一个人类解决.

[尖叫声] 需要引擎 @aurelienbbn/agentlint >=0.3.0 <0.9.0 作为同伴. 证据。 。 。 .

strictPreset   █████████████            13  settled rules
starterPreset  ██                        2  boundary-resilience, bounded-work
opt-in         ████████████             12  exported, in no preset: calibrate first

从2条开始,不是25条

agentlint init --preset "@aurelienbbn/agentlint-plugin-core#starterPreset"
agentlint rules test
agentlint rules scan --review
agentlint next --format json

init 保存已有的配置并打印安装命令;从未安装. 要求前校正绑定 agentlint check --all。 。 。 .

import { defineConfig } from "@aurelienbbn/agentlint";
import { defineFallbackMasksFailure, fakeParity, strictPreset } from "@aurelienbbn/agentlint-plugin-core";

export default defineConfig({
  extends: [strictPreset],
  rules: [fakeParity, defineFallbackMasksFailure({ minFallbacksPerScope: 3 })],
});

规则

* * 选择进入:导出,亲自登记 * * 只有人类才能接受发现。 预设忽略 **/*.d.ts。 。 。 .

只有在大多数选择规则 agentlint rules scan --review 调查结果导致变化. 每道都规定了昂贵或体积不明的固定装置.

fetch(url);                                                          // ❌ boundary-resilience: no signal/timeout
fetch(url, { signal: AbortSignal.timeout(2_000) });                  // ✅
try { await fetch(url, { signal }); } catch (error) { logger.warn('failed', error); }  // ❌ failure discarded (logging still discards)

expect(applyDiscount(price, pct)).toBe(price - (price * pct) / 100); // ❌ expected-value-recomputed
expect(applyDiscount(200, 15)).toBe(170);                            // ✅ states it

const email = form.get("email") || "";                               // ❌ fallback-masks-failure
<span title={user.email ?? ""}>{user.id ?? ""}</span>               // ✅ JSX display default

一个网络 try/catch 返回空字元由两者报告 fallback-masks-failure 财务报告和审定财务报表 boundary-resilience。 。 。 .

test-behavior-coverage triggers
file-density      ≥ 3 mock constructions, no assertion pins returned state or output
interaction-only  ≥ 2 tests, or ≥ minInteractionShare of a file's tests, assert interactions only
                  (skipped when file-density already fires; lists the doubles per test)
snapshot-only     ≥ 2 tests whose only oracle is a whole-value snapshot,
                  or an inline snapshot > maxInlineSnapshotLines

所有权:业务与其模块保持一致

operations-stay-with-owner 报告调用的文件 minOperations (4) 另一模块通过其公开进入进行更多操作. 一个模块的条目是相对导入解析到 api.ts (单位:千美元)entryPattern),或列出在 packages (单位:千美元)@acme/* 范围。 操作是小写开始的值名; PascalCase 和每个 type 导入是词汇,从不计数。 每个文件和每个所有者都计算在内,所以一个读取的模型调用三个模块中每个模块的两个操作都保持沉默.

// src/qa/story.ts: ❌ replays takedown's own state moves, so the seed belongs to takedown
import { requestComposed, requestSent, requestBounced, requestReplied } from "../takedown/api.ts";

// src/ops/act.ts: ✅ one outcome the owner offers, plus its vocabulary
import { merchantsStart, type TakedownSource } from "../takedown/api.ts";

固定是所有权,而不是一个更广泛的条目:将代码移入所有者,或者让所有者通过一份声明来贡献所收集的成分(种子,处理者,迁移). 排除构成根( Q)registry/, (中文(简体) ), workers/当它合法地组装每个模块时。 在一个模块化的单体(515个文件)上校正: 1 发现,重放另一个特性的动作的种子.

QQ 测试漂移:作者不接受

test-expectation-drift 权威默认为 "human":改变作者是想接受这一结论的政党. defineTestExpectationDrift({ authority: "agent" }) 恢复通常的默认值。 别小了 include 以测试文件:引擎在检测前通过绑定过滤更改,有两种取决于源编辑.

temporal-coupling signals
guard-throw          throw message says "not initialized/connected/started/configured/ready/loaded/opened",
                     "call x() first/before" or "must call/be initialized"
definite-assignment  undecorated `name!: T` assigned in a method, never in the constructor
nullable-init        `| null`/`| undefined` field set by exactly one init/initialize/setup/connect/open/
                     start/load/configure/bootstrap method, null-checked in ≥ 2 other methods

被宣布为无变化者和热点

protected-invariant-change 财务报告和审定财务报表 hotspot-change-review 船空而寂: 他们只用你所宣称的开火.

移徙:重新审查先前的接受情况

审查提示,不是正确证明.

现有接受情况需要重新审查.

登记的合同库存

从软件包导出 pnpm catalog. 规则特定选项和限制在上文和源测试中都有描述.

信用概念

• 迈克尔·费瑟斯所著"特征测试"(概念)
• Scott Wlaschin所著"选择属性进行基于地产的测试"(概念:反向和一能家族)
• 马丁·福勒所著"合同试验"(概念)
• 由Mark Seemann(概念)出品的"设计气息:临时交配"
• 由斯科特·瓦斯钦(英语:Scott Wlaschin (cept))所著"按类型来设计:使非法状态无法代表"
• "不要把逻辑放入测试"(Google测试博客)(概念)
• "Feature Envy"出自马丁·福勒的"重构"(概念,从班级升为单元)
• "FlagArgument"由马丁·福勒所著 (概念)
• J. B. Rainsberger所著"从合同测试开始"(概念)
• 由马丁·福勒所著"集成测试"(概念:狭义的集成测试是远程的两倍,不是适配器)
• 由Mark Seemann所著"Interfaces不是抽象"(概念:标题界面,再用抽象原理)
• 亚历克西斯·金的"帕斯,不要验证"(概念)
• Alexis King所著"Parse, don't experience" (概念:缺席被拒绝一次,在边界上)
• 桑迪·梅兹所著"错误的抽象"(概念)
• 由Vladimir Khorikov所著"When to Moc"(概念:交互断言属于未管理的流程边界)
• 不可能的奔驰 (arXiv 2510.20270)(概念:通过编辑预告)
• 由 Asyrafhussin(麻省理工学院) + Cursor(麻省理工学院) 所发码,概念被重新执行
• 代码由 Asyrafhussin (MIT,概念被重新执行)
• 由Asyrafhussin(麻省理工学院,概念重新实施;真实防卫清单)
• https://alexn.org/blog/2026/09/22/ai-has-no-wisdom-and-neither-will-you/ 互联网档案馆的存檔,存档日期2014-12-21 (激励;独立执行)
• https://alexn.org/blog/2026/09/22/ai-has-no-wisdom-and-neither-will-you/#isso-thread (英语) (激励;独立执行)