Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 14 additions & 5 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
@@ -1,11 +1,20 @@
name: CI

# This workflow runs tests, formatting checks, and the fspec tool.
# To require passing CI for merges to master/main:
# 1. Go to Settings > Branches in your GitHub repository
# 2. Add a branch protection rule for master/main
# 3. Enable "Require status checks to pass before merging"
# 4. Select "Test Suite" as the required status check
#
# To set up branch protection for master/main (require reviews and passing CI):
# 1. Go to your repository on GitHub
# 2. Navigate to Settings > Branches
# 3. Click "Add branch protection rule" or edit existing rule for master/main
# 4. Enable the following options:
# - "Require a pull request before merging"
# - Enable "Require approvals" (set to 1 or more)
# - Optionally enable "Dismiss stale pull request approvals when new commits are pushed"
# - "Require status checks to pass before merging"
# - Select "Test Suite" as the required status check
# - Optionally: "Require conversation resolution before merging"
# - Optionally: "Do not allow bypassing the above settings" (prevents admins from bypassing)
# 5. Click "Create" or "Save changes"
#
# Note: Branch protection cannot be configured via files alone - it requires
# repository settings access. However, this workflow will fail if tests don't pass,
Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# fspec — Declarative Filesystem Specifications

![CI](https://github.com/USERNAME/REPO/actions/workflows/ci.yml/badge.svg)
![CI](https://github.com/johnoneil/fspec/actions/workflows/ci.yml/badge.svg)

fspec is an experimental, declarative filesystem specification and validation tool, suitable for CI pipelines, auditing, and long-lived project structure enforcement. It provides a way to formally describe expected filesystem structure (directories, files, naming conventions, style, and invariants) in a way that is:

Expand Down