Skip to content
Merged
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
2 changes: 1 addition & 1 deletion .machine_readable/REGISTRY.a2ml
Original file line number Diff line number Diff line change
Expand Up @@ -216,7 +216,7 @@ name = "RSR — Rhodium Standard Repositories"
stream = "governance"
home = "rhodium-standard-repositories/"
canonical_doc = "rhodium-standard-repositories/README.adoc"
source_hash = "sha256:87c5f1efdbd12b2621f5ec1cc9cde7d5f47c98b23db8534c308ab1068772b431"
source_hash = "sha256:96d4457b9fdd01e02bb89bf95aaca2dea002f18062342507d8b4f81af6ae79fb"
route = "the repository-compliance standard every repo is graded against"

[[spec]]
Expand Down
19 changes: 19 additions & 0 deletions .well-known/ai.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# SPDX-License-Identifier: MPL-2.0
# AI usage & training policy for hyperpolymath/standards.
# Informal, robots-style directives for AI/ML agents and crawlers.
# The estate maintains a machine-readable bot-exclusion registry at
# .machine_readable/bot_exclusion_registry.a2ml and an AI-gatekeeper
# protocol under 0-ai-gatekeeper-protocol/; this file is the summary.

User-Agent: *

# Training: do not use this repository's content to train models without
# attribution under the repository licence.
Disallow-Training: /

# Reference/indexing for search and developer assistance is permitted,
# provided attribution and licence terms (see LICENSE, humans.txt) are kept.
Allow: /

Contact: https://github.com/hyperpolymath/standards/security/advisories/new
Policy: https://github.com/hyperpolymath/standards/blob/main/.claude/CLAUDE.md
15 changes: 15 additions & 0 deletions .well-known/humans.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
# SPDX-License-Identifier: MPL-2.0
# humanstxt.org — the humans responsible for this repository.

/* TEAM */
Maintainer: Jonathan D.A. Jewell
Contact: 6759885+hyperpolymath [at] users.noreply.github.com
Site: https://github.com/hyperpolymath

/* SITE */
Standard: Rhodium Standard Repository (RSR) framework + estate standards
Components: A2ML, K9, contractiles, readiness grades (ARG/FRG/CRG/TRG),
protocols (avow, axel, overlay, consent-aware-http, k9-coordination)
Build/tooling: Nix, Guix, Deno, just (Justfile)
Licence: MPL-2.0 (sole-owner estate default) — see LICENSE
Standards: RFC 9116 (security.txt), Schema.org, IndieWeb (webmention)
9 changes: 9 additions & 0 deletions .well-known/security.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
# SPDX-License-Identifier: MPL-2.0
# Security contact information for hyperpolymath/standards (RFC 9116).
# Full policy: ../SECURITY.md
Contact: https://github.com/hyperpolymath/standards/security/advisories/new
Contact: mailto:6759885+hyperpolymath@users.noreply.github.com
Expires: 2027-06-18T00:00:00.000Z
Preferred-Languages: en
Canonical: https://github.com/hyperpolymath/standards/blob/main/.well-known/security.txt
Policy: https://github.com/hyperpolymath/standards/blob/main/SECURITY.md
6 changes: 6 additions & 0 deletions Justfile
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,12 @@ topology: registry
registry-check:
@bash scripts/build-registry.sh --check

# Aggregate compliance gate: registry drift (hard dep) + RSR self-audit (informational)
validate: registry-check
@echo "=== validate: RSR compliance gate ==="
@bash rhodium-standard-repositories/rsr-audit.sh . text || true
@echo "=== validate: done (see rsr-audit output above) ==="

# Print role-appropriate LLM warm-up context (machine front door)
llm-context role="dev":
@echo "# Front door: 0-AI-MANIFEST.a2ml (machine) + README.adoc (human)"
Expand Down
50 changes: 44 additions & 6 deletions rhodium-standard-repositories/rsr-audit.sh
Original file line number Diff line number Diff line change
Expand Up @@ -108,7 +108,26 @@ check() {
check_file_exists() {
local file="$1"
local description="${2:-File exists: $file}"
check "$description" "test -f '$REPO_PATH/$file'"
# Estate-tolerant: credit documented format/case variants — .adoc docs
# (estate docs policy mandates AsciiDoc), `Justfile` case, bare `LICENSE`.
# Licence *content* checks are separate and unchanged (owner-gated).
local candidates=("$file")
case "$file" in
*.md) candidates+=("${file%.md}.adoc") ;;
LICENSE.txt) candidates+=("LICENSE") ;;
justfile) candidates+=("Justfile") ;;
esac
TOTAL_CHECKS=$((TOTAL_CHECKS + 1))
local f
for f in "${candidates[@]}"; do
if [[ -f "$REPO_PATH/$f" ]]; then
PASSED_CHECKS=$((PASSED_CHECKS + 1))
log_success "$description"
return 0
fi
done
log_error "$description"
return 1
}

check_dir_exists() {
Expand All @@ -121,7 +140,25 @@ check_file_contains() {
local file="$1"
local pattern="$2"
local description="${3:-$file contains: $pattern}"
check "$description" "grep -q '$pattern' '$REPO_PATH/$file' 2>/dev/null"
# Estate-tolerant: also search documented format/case variants.
local candidates=("$file")
case "$file" in
*.md) candidates+=("${file%.md}.adoc") ;;
justfile) candidates+=("Justfile") ;;
esac
local existing=()
local f
for f in "${candidates[@]}"; do
[[ -f "$REPO_PATH/$f" ]] && existing+=("$REPO_PATH/$f")
done
TOTAL_CHECKS=$((TOTAL_CHECKS + 1))
if [[ ${#existing[@]} -gt 0 ]] && grep -q "$pattern" "${existing[@]}" 2>/dev/null; then
PASSED_CHECKS=$((PASSED_CHECKS + 1))
log_success "$description"
return 0
fi
log_error "$description"
return 1
}

check_command_exists() {
Expand All @@ -148,11 +185,12 @@ audit_category_1_infrastructure() {
check_file_contains "justfile" "test" "Justfile has test recipe"
check_file_contains "justfile" "validate" "Justfile has validate recipe"

# GitLab CI/CD (or GitHub Actions as fallback)
if check_file_exists ".gitlab-ci.yml" "GitLab CI/CD configuration"; then
# CI/CD: GitLab CI or GitHub Actions (the estate runs on GitHub; both count)
check "CI/CD configuration present" "test -f '$REPO_PATH/.gitlab-ci.yml' || ls '$REPO_PATH'/.github/workflows/*.y*ml >/dev/null 2>&1"
if [[ -f "$REPO_PATH/.gitlab-ci.yml" ]]; then
check_file_contains ".gitlab-ci.yml" "stages:" "GitLab CI has stages defined"
elif check_file_exists ".github/workflows/ci.yml" "GitHub Actions workflow"; then
log_warning "Using GitHub Actions instead of GitLab CI (GitLab preferred)"
else
check "CI/CD has workflows defined" "ls '$REPO_PATH'/.github/workflows/*.y*ml >/dev/null 2>&1"
fi

# Podman (optional for CLI tools, required for web services)
Expand Down
Loading