project.tests-run-in-disposable-repos@1

What it is

URI

majordomus://rule/project.tests-run-in-disposable-repos@1

Kind

rule

Identity

project.tests-run-in-disposable-repos@1

Path

.ai/repo/rules/project/tests-run-in-disposable-repos.v1.md

Provenance

declared

Media type

text/markdown

As a capability

rule.project.tests-run-in-disposable-repos@1

Front matter

{
  "id": "project.tests-run-in-disposable-repos",
  "version": 1,
  "kind": "rule",
  "title": "Tests run in disposable repositories",
  "description": "Behavioural cases run through bash test/run.sh in a temporary repository each, never against this checkout.",
  "statement": "Behavioural cases run through bash test/run.sh in a temporary repository each, never against this checkout.",
  "status": "active",
  "class": "blocking",
  "depends_on": [],
  "tags": [
    "testing"
  ],
  "x-majordomus": {
    "tests": [
      "test/cases/51_derived_artifacts_committed.sh"
    ]
  }
}

Content

---
id: project.tests-run-in-disposable-repos
version: 1
kind: rule
title: Tests run in disposable repositories
description: Behavioural cases run through bash test/run.sh in a temporary repository each, never against this checkout.
statement: Behavioural cases run through bash test/run.sh in a temporary repository each, never against this checkout.
status: active
class: blocking
depends_on: []
tags: [testing]

x-majordomus:
  tests: [test/cases/51_derived_artifacts_committed.sh]
---

# Rationale

A case that runs against the checkout it lives in changes the state it is testing; test/run.sh creates a fresh repository per case for that reason.

# Required behaviour

Behavioural cases run through bash test/run.sh in a temporary repository each, never against this checkout.

# Failure behaviour

No command decides this rule; a reviewer does, and a change that violates it is not merged. Where a behavioural case covers part of it, that case is named below.

# Verification

Review. test/run.sh; a case that writes into ROOT is a bug the derived-artifacts case would report.