Validation and drift

validate() checks the files that actually exist under a project root. It does not report what a compiler intended to write.

const report = await Agents.validate("./my-project", {
  targets: ["cursor", "codex-cli"],
});

for (const [id, result] of Object.entries(report.results)) {
  console.log(id, result.status, result.score, result.issues);
}

if (!report.valid) process.exitCode = 1;

Statuses

The report includes targets, results, and a summary with counts for each status. Each target result includes a score, issues, and capability values.

Drift workflow

1. Keep the canonical manifest under version control.
2. Run compile() after changing the manifest.
3. Run validate() in CI against the checked-out project.
4. Fail the job when report.valid is false.

Validation is filesystem conformance. It does not prove that a proprietary desktop, cloud, or hosted agent is installed or executing a prompt.