IF Commons GitHub

AnyFS Git: conformance

0006Active

0006-git-conformance · owner if · domain commons

Requirements

FR-001checkpassing

The store of a branch (in a repository that is bare and in one that is not) and the store of a working tree MUST pass every case of the conformance suite of AnyFS that their capabilities name.

Enforced (check): .github: cd commons/anyfs-git && bun run verify — suite/conformance.test.ts

Proved by: anyfs-git/suite/conformance.test.ts

Tests: passed: suite/conformance.test.ts the store of a branch passes every case of the suite its capabilities name, in a bare repo

FR-002checkpassing

Every law of the bridge MUST hold between a store in memory or in a folder and the store of a branch, in both directions, and a sync from a store into the store of a branch applied atomically (the bridge's option that makes one batch of it) MUST be one commit however many files it changes.

Enforced (check): .github: cd commons/anyfs-git && bun run verify — suite/conformance.test.ts

Proved by: anyfs-git/suite/conformance.test.ts

Tests: passed: suite/conformance.test.ts a sync into the store of a branch applied atomically is one commit however many files it c; passed: suite/conformance.test.ts every law of the bridge holds between a store in memory or in a folder and the store of a

Acceptance scenarios

  1. Given a new repository, When the conformance suite is run on a branch of it, Then every case passes, per FR-001.
  2. Given twelve files in memory, When they are synced to a branch, Then the branch has one commit, and a second sync makes none, per FR-002.

Out of scope

Edge cases

  • A sync of nothing into a branch makes no commit (FR-002).

Assumptions

Open questions

  • None.

Key entities

  • Branch, Working tree, Revision, Identity.

Success criteria

SC-001success criterion

Every behaviour is tested in real repositories in temporary folders, with no network and no real time.

Review & acceptance checklist

  • [x] Every requirement is testable (MUST / MUST NOT), not aspirational
  • [x] No company fact is asserted here
  • [x] Every open item is marked, not silently decided

Titles, headings, exports, tables, columns and requirements. Esc closes.