Skip to content

Add the 22-factor app manifesto - #9

Merged
ORESoftware merged 13 commits into
mainfrom
feat/22-factor-app
Aug 22, 2026
Merged

Add the 22-factor app manifesto#9
ORESoftware merged 13 commits into
mainfrom
feat/22-factor-app

Conversation

@ORESoftware

@ORESoftware ORESoftware commented Aug 21, 2026

Copy link
Copy Markdown
Owner

Summary

  • publish a first-class /22-factor-app/ route that preserves the original twelve factors and defines Factors XIII–XXII as an independent ORESoftware extension
  • codify encrypted configuration in tracked env/enc/*.env.enc, disposable ignored plaintext in env/dec/*.env, and a deliberately tiny one-or-two-secret Fiducia Cloud bootstrap boundary
  • add OCI-without-Docker packaging, risk-matched virtualized isolation, immutable machine images, recoverable TCP/WebSocket sessions, tag-based releases, accountable human approval, code-review discipline, and a rebase private; merge shared history policy
  • feature the manifesto in global navigation and on the homepage
  • retain the exact CI-verified static artifact for review and publication
  • add static contract validation and Playwright coverage across desktop, tablet, and mobile

Positioning

This is explicitly presented as an extension, not an official replacement for the Twelve-Factor App. The page links the original project, the current modernization repository, the ORESoftware SOPS standard, and primary standards or documentation for OCI, isolation, immutable infrastructure, connection lifecycle, Git policy, and code review.

Publication model

The initial publication is a one-time, explicit bootstrap from a merge commit carrying [bootstrap-22-factor]. The trusted post-merge job downloads the exact artifact produced after validation and browser tests, then commits only the generated Pages paths. It cannot run on pull-request code.

After bootstrap, ordinary branch and main pushes validate but do not publish. Subsequent releases publish only from an annotated site-v* tag on the current reviewed main commit, using the same artifact-promotion model.

Testing

  • structured-data checks: exactly 22 factors, sequence I–XXII, 12 foundations, 10 extensions, unique anchors, and complete operating contracts
  • Astro static build including /22-factor-app/index.html
  • Playwright desktop, tablet, and mobile regression coverage
  • overflow, navigation, accessibility, encrypted-configuration, Fiducia Cloud boundary, OCI, and Git-history assertions

@ORESoftware
ORESoftware marked this pull request as ready for review August 21, 2026 22:14
@linear-code

linear-code Bot commented Aug 22, 2026

Copy link
Copy Markdown

DEN-3872

@ORESoftware
ORESoftware merged commit 97e49a3 into main Aug 22, 2026
3 checks passed

Copy link
Copy Markdown
Owner Author

Publication evidence

The reviewed merge commit 97e49a32d001cbd87b9ba2cfb650c98d40d0f6a0 triggered the trusted one-time bootstrap. GitHub Actions committed the exact verified Pages snapshot as 03ebcd09674d07b93b04cfb71f103d8c96691774.

Live route: https://oresoftware.github.io/22-factor-app/

The separate hostname https://22-factor-apps.github.io/ still requires a GitHub user or organization named 22-factor-apps; the current ORESoftware account cannot claim another account's root github.io hostname.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant