@app-studio/qa-医生

证明一个仓库 qa.bindings.json 描述它的寄存器 实际进入.

为什么会这样

一个成熟的QA设置被从一个存储器复制到另一个没有它的 装订正在重写。 在新的寄存器中,守护钩的图案 没有匹配文件, 因此它否认了任何内容, 并且看起来就像一个警卫 没什么好抱怨的 记录的端口是错误的,所以每个指令 在他们身上建起的,曾派人到一个不在那里的门去。 种子账户有 不存在, 因此与他们签约的特工 报告了认证错误 。 还有 文档 曾经 准确的提示没有输入点,所以没有人 读取.

没有任何一项失败。 这一切都是可憎的。 这个包裹就是 观察变成了检查.

运行它的两个方式,一个执行

根据要求:

pnpm exec qa doctor            # human report
pnpm exec qa doctor --json     # for agents and CI
pnpm exec qa doctor --strict   # warnings become errors

在仓库自己的套房里,这就是它不可滑动的原因:

// tests/qa-doctor.test.ts
import { doctorSuite } from '@app-studio/qa-doctor/vitest';

doctorSuite();

一个 it() 根据规则. qa doctor 当有人运行时会发现错误的束缚; 这在每一次CI跑道上都能发现, 在已经合并的套房里 跳过检查意味着跳出 套房,这是一个决定 有人必须 大声点 A 类 self/* 规则验证此文件存在 财务报告和审定财务报表 坠入其中 模糊测试命令选择, 因为测试没有运行比没有更糟糕 测试: 仓库看起来已选中 .

它检查什么

规则ID是稳定的: 由它们组成的CLI组, 测试它们,和主机 给他们准备点药.

报告

每个发现都包含三件事 而不是一个

✖ ports/bound-by-agrees — each declared port is the number the file that binds it actually uses
   ports.front says 5173, but playwright.config.ts never mentions that number.
   in: playwright.config.ts
   what this means: Every instruction built on this port sends people to a door
     that is not there, and the resulting connection refused reads as a broken
     application rather than a wrong binding.
   fix: Open playwright.config.ts, read the port it binds, and put that number
     in ports.front.

一个医生在一周内 就会被忽略了 被忽略的医生与没有医生是分不开的.

写你自己的规则

import { runRules, createDoctorContext } from '@app-studio/qa-doctor';
import type { Rule } from '@app-studio/qa-core';

const noOrphanedFeatures: Rule = {
  id: 'features/registered',
  describes: 'every feature directory is in the composed registry',
  appliesTo: (context) => context.exists('src/features'),
  check(context) {
    const declared = context.read('src/generated/registry.ts') ?? '';
    return context
      .glob('src/features/*/manifest.json')
      .filter((path) => !declared.includes(path.split('/')[2]!))
      .map((path) => ({
        level: 'error' as const,
        rule: 'features/registered',
        message: `${path} is not in the composed registry.`,
        means: 'The feature exists on disk and is not part of the application, which is invisible until someone looks for it.',
        fix: 'Run the composer, or delete the directory.',
      }));
  },
};

规则是纯粹的功能 DoctorContext因此,他们测试 固定 而不是违背你的真爱 这比平常更重要 这里,因为一个医生 没有人看过去红色 正是惰性机械 此软件包的存在是为了防止.

所需资源

节点.js20或更新. vitest 是一个可选的对等点, 仅用于 /vitest 进入点.