@ agentreins/ 核心
框架不可知引擎 绳子: 建筑规则,基线, architecture.yml 装载器,报告,撞击分析,医生规则,模块注释和适配器合同.
你不安装这个包
它与CLI。 在项目中使用指针(节点22或更新):
npm install -D @agentreins/cli @agentreins/adapter-js
npx reins install
npx reins init
见 @ agentreins/ cli (英语) 为快速开始.
里面的东西
- 规则数字 :
layer-direction(仅从本身和下面各层进口一层),domain-boundary(域外代码只导入其公共 API),no-cycles,以及integrity(计划的变化和不断增长的基线可见一斑)。 信件指定规则、原因和定律,并可在architecture.yml。 。 。 . - 基线:今天的违章行为被冻结了,所以只有新的违章行为才会失败;排序,没有时间戳,在拉请求中干净的diff.
architecture.yml装填器:验证计划,并报告其出场路径的每一个问题,全部同时报告. 未知的密钥是错误: 类型不能默通 .- 影响分析 (单位:千美元)
impactOf: 倒转scope。它将适配器的导入边缘与域合并:谁消费一个文件(按域组),它会绕过一个公共的 API 导入,而 API 将文件中断更改会被触碰 。 权力reins impact。 。 。 . - 三角信号 (单位:千美元)
scopeSignals, (中文(简体) ),suggestLevel: 将文件列表转换为最小任务级别( c)small编号 :medium编号 :large) (中文(简体) ). 同样的阈能reins scope医生的triage-mismatch,所以代理所宣布的就是 diff 所衡量的. - 报告:文本和JSON(表
schema数字),每个发现都有其规则,理由和固定. - 医生: 后面的工作流程规则
reins doctor(旅行对diff,笔记本,模块笔记,AGENTS.md大小)和进度笔记本解析器和一行一时编辑器后面reins progress。 。 。 . - 模块注释: 解析,路径 – 注释检索(
notesFor),从导入图中起草(draftNote),和从git历史(英语:rankStaleNotes) (中文(简体) ). - 审计积压: 后面的本地发现文件
reins audit——解析,渲染,状态变化. - 球形匹配:它自己的配对者(
*, (中文(简体) ),**, (中文(简体) ),?, (中文(简体) ),{a,b}),用于地层,域和公共API. 没有光荣的依赖.
核心从不读取源文件, 也不知道框架: 它只看到 { from, to, kind } 导入边,由语言适配器计算。 所有框架或语言( TypeScript, Vite, Next) 都生活在适配器中 @ agentreins/ 适应器- js。 。 。 .
写入适配器
适配器只导入合同的切入点 :
import { CONTRACT_VERSION, validateAdapter, validateEdges, normalizeGraph, matchesAny } from '@agentreins/core/contract';
合同的版本(reins.contract: 1 在适配器中 package.json; CLI拒绝不匹配的:
detect(repoPath)——这个适配器适用于回波吗? 返回时true,一个预设名称或没有.graph(repoPath, config)——导入边:{ from, to, kind }类型static, (中文(简体) ),dynamic(单位:千美元)import()和type(仅类型),外加文件列表,出入口和警告. 规则应该跳过的一种边缘是球队的召唤(ignore_kinds规则,不是适配器的. 永远不要无声地掉入边缘:未解决的别名必须成为警告,或check绿地穿过一个洞.GraphResult可添加barrels财务报告和审定财务报表uses每个进口商通过再出口桶真正使用的东西,所以init可以分辨哪个文件夹拥有什么和impact可以把进口商算在桶后作为真实文件的消费者。 可选:规则只需要edges。 。 。 .evaluate(edges, config, graph)备选框架规则,需要的不仅仅是边缘(文件内容、指令);next-server-client合并为同一报告和基线.presets, (中文(简体) ),suggestPreset, (中文(简体) ),loadPreset- 备选启动计划reins init(层,域从何而来. 没有他们check同样的工作;init只是要求手写architecture.yml。 。 。 .
合同记载于 文件/适应合同。命名第三方适配器 reins-adapter-<language>;CLI从 adapter: <language> 内 architecture.yml。 。 。 .
学多点
许可证
麻省理工学院