docs: add personal-account consumer tier (doc 18 + example) - #66
Merged
Conversation
A repository owned by a personal GitHub account (not an organization) inherits the private-free posture but cannot reach an org-level self-hosted runner group — a platform gate, not a setting. It needs repo-level runner registration and a caller that routes every job to that label. - docs/18-personal-account-tier.md: the runner-registration procedure (org-runner vs repo-runner reachability), the inversion against private-free (same posture, different runner), and the 2000 min/month personal quota. - examples/personal/security-selfhosted.yml: private-free stack (gitleaks, actionlint, zizmor-no-SARIF) with runner: input on every call. - scripts/validate_catalog.py: whitelist the new aggregate example. - docs/00-overview.md: tier note + doc index entry. - CHANGELOG.md: [Unreleased] entry. No catalog/capabilities.yml or workflow file changed — the capability set is identical to private-free; only the runner differs.
Empirically verified on rldyourmnd/declaro-platform: cross-owner reusable workflows (this library called from a personal-account repo) do not resolve jobs for 'push' events to the default branch — the run hangs in pending with zero jobs indefinitely. pull_request resolves instantly. Documented the root cause, updated the example caller to pull_request+workflow_dispatch only, and expanded the CHANGELOG entry.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Personal-account repositories (e.g.
rldyourmnd/*) inherit private-free posture but need repo-level self-hosted runners — org runners are unreachable across account namespaces. Adds doc 18 + example + validator whitelist. All 18 checks pass (validate_all: OK).