From ab9d07fdb8354bb8a8704596c5dbc2f391aadcff Mon Sep 17 00:00:00 2001 From: Claudiu Schuster Date: Sun, 30 Aug 2026 16:33:13 +0200 Subject: [PATCH] Prepare repository for public release --- .github/dependabot.yml | 7 ++++++ BRANDING.md | 14 ++++++++++++ CONTRIBUTING.md | 26 +++++++++++++++++++++++ LICENSE | 21 ++++++++++++++++++ README.md | 22 ++++++++++++++++--- design/prototypes/signal-observatory.html | 2 +- docs/brand-inputs.md | 2 +- docs/hosting.md | 2 +- scripts/check-repository.sh | 2 +- 9 files changed, 91 insertions(+), 7 deletions(-) create mode 100644 .github/dependabot.yml create mode 100644 BRANDING.md create mode 100644 CONTRIBUTING.md create mode 100644 LICENSE diff --git a/.github/dependabot.yml b/.github/dependabot.yml new file mode 100644 index 0000000..8004983 --- /dev/null +++ b/.github/dependabot.yml @@ -0,0 +1,7 @@ +version: 2 +updates: + - package-ecosystem: github-actions + directory: / + schedule: + interval: weekly + open-pull-requests-limit: 5 diff --git a/BRANDING.md b/BRANDING.md new file mode 100644 index 0000000..f14ea03 --- /dev/null +++ b/BRANDING.md @@ -0,0 +1,14 @@ +# Brand and visual assets + +The MIT License in [LICENSE](LICENSE) covers the source code and technical documentation in this repository unless a file states otherwise. + +It does not grant rights to the OSS Singularity name, logos, trade dress, or other brand identifiers. The following visual assets are also excluded from the MIT License: + +- `site/assets/brand/` +- `site/assets/social/` +- `site/assets/projects/` +- `docs/assets/` + +Those assets may be viewed and redistributed unmodified as part of this repository or one of its forks, provided that their origin and ownership are not misrepresented. Any other use requires permission from the applicable rights holder. Product screenshots remain subject to the rights and licenses of their respective source projects. + +This separation is intended to keep the implementation genuinely reusable without suggesting endorsement or transferring the project's identity. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..8bb2015 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,26 @@ +# Contributing + +Thanks for taking the time to improve the OSS Singularity website. Small, focused pull requests are easiest to review. + +## Before opening a pull request + +1. Keep the site dependency-free and preserve the authored HTML, CSS, and progressive-enhancement approach. +2. Do not add analytics, cookies, storage, third-party runtime assets, automatic network requests, credentials, private infrastructure details, or account-specific screenshots. +3. Preserve keyboard access, reduced-motion behavior, responsive layouts, semantic structure, and the budgets in `docs/product-requirements.md`. +4. Build and validate the complete production tree: + + ```sh + ./scripts/check-repository.sh + ``` + +5. Describe behavior and visual verification in the pull request. Include public-safe screenshots when a visible change benefits from them. + +Generated `dist/` output is intentionally ignored. Change the authored files in `site/`, then let the repository check rebuild and validate the production tree. + +## Security + +Do not disclose vulnerabilities, credentials, private paths, hosting account details, or complete infrastructure exports in an issue or pull request. Follow [SECURITY.md](SECURITY.md) for private reporting. + +## Production boundary + +Merging source does not authorize a production deployment. Deployment credentials stay outside the repository, and production changes follow the separately documented review, backup, allowlist, and rollback gates. diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..a9ee09b --- /dev/null +++ b/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2026 OSS Singularity contributors + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/README.md b/README.md index 29da015..e6737d9 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,19 @@ # OSS Singularity Website +[![Repository checks](https://github.com/oss-singularity/website/actions/workflows/repository-checks.yml/badge.svg)](https://github.com/oss-singularity/website/actions/workflows/repository-checks.yml) + Source repository for [oss-singularity.io](https://oss-singularity.io/). Launch Pad is a dependency-free static site shaped around the “Signal Observatory” visual direction: a precise cosmic shell, an adaptive pointer-reactive signal field, authentic project interfaces, and an intentionally human open-source voice. GitHub remains canonical; `dist/` is a reproducible, allowlisted production artifact. +## Why inspect the source? + +- Authored HTML and CSS with one small, dependency-free Canvas enhancement +- No framework, package install, analytics, cookies, storage, third-party runtime assets, or automatic network requests +- Deterministic allowlisted builds with an exact SHA-256 production manifest +- Repository checks for accessibility structure, metadata, links, security policy, immutable assets, privacy boundaries, and explicit performance budgets +- Real design exploration and decisions preserved in `design/` and `docs/`, not hidden behind a generated theme + ## Development Build and validate the complete site with: @@ -30,14 +40,20 @@ See [docs/hosting.md](docs/hosting.md) for the verified baseline, safety boundar See [docs/brand-inputs.md](docs/brand-inputs.md) for the verified identity and messaging sources that will inform the design process. +## Contributing + +Thoughtful fixes and improvements are welcome. Read [CONTRIBUTING.md](CONTRIBUTING.md) for the repository boundaries and local verification command. Please report security-sensitive findings privately as described in [SECURITY.md](SECURITY.md). + +## License + +Source code and technical documentation are available under the [MIT License](LICENSE). The OSS Singularity identity and visual assets are excluded as described in [BRANDING.md](BRANDING.md). + ## Status - Hosting access baseline: verified -- Repository security baseline: verified +- Repository security baseline: verified; public-repository protections tracked separately from source checks - Existing brand inputs: inventoried; canonical vector avatar source located and preserved - Requirements, architecture, visual direction, and static technology stack: selected and documented - Launch Pad v0: live and production-verified at [oss-singularity.io](https://oss-singularity.io/) - Canonical host: apex only; no published URL uses `www` - Open hosting follow-up: reissue TLS with the `www` SAN after Namecheap/SSL.com issuance error `1010` clears, then verify the redirect-only alias - -Security-sensitive findings should be reported privately as described in [SECURITY.md](SECURITY.md). diff --git a/design/prototypes/signal-observatory.html b/design/prototypes/signal-observatory.html index 0e6df0f..3bd70d5 100644 --- a/design/prototypes/signal-observatory.html +++ b/design/prototypes/signal-observatory.html @@ -1 +1 @@ -Signal Observatory direction
OSS Singularity

Open transmission · Berlin orbit

Engineering for what comes next.

Privacy-minded tools and experiments built in the open — precise enough for real systems, human enough for the people using them.

Explore the workOpen GitHub ↗
PDrive Control CenterReliable Proton Drive workflows for Linux.
ChatGPT UsageUsage signals, directly in Cinnamon.
Desktop SystemsSmall tools. Observable behavior. Open source.
+Signal Observatory direction
OSS Singularity

Open transmission · Signal 001

Engineering for what comes next.

Privacy-minded tools and experiments built in the open — precise enough for real systems, human enough for the people using them.

Explore the workOpen GitHub ↗
PDrive Control CenterReliable Proton Drive workflows for Linux.
ChatGPT UsageUsage signals, directly in Cinnamon.
Desktop SystemsSmall tools. Observable behavior. Open source.
diff --git a/docs/brand-inputs.md b/docs/brand-inputs.md index ed3bf46..a7624a2 100644 --- a/docs/brand-inputs.md +++ b/docs/brand-inputs.md @@ -28,7 +28,7 @@ The organization Sponsors listing is not active yet. Until activation is verifie - Primary audiences, journeys, content hierarchy, calls to action and the relationship to GitHub are specified in `docs/product-requirements.md`. - “Signal Observatory” is the selected visual direction; the comparison and source prototypes are in `docs/design-directions.md` and `design/prototypes/`. - The canonical mark keeps its cyan/magenta event-horizon geometry. The website uses a deep observatory palette, system typography, restrained motion, and authentic project screenshots. -- The launch target is WCAG 2.2 AA with explicit performance and privacy budgets. No analytics, cookies, tracking, third-party runtime requests, or executable client-side JavaScript ship in v0. +- The launch target is WCAG 2.2 AA with explicit performance and privacy budgets. The only executable client-side JavaScript is a small, dependency-free decorative Canvas enhancement; it performs no analytics, tracking, storage, or third-party runtime requests and is removed for reduced-motion users. - GitHub remains canonical for repositories, releases, documentation and issues. The organization Sponsors destination remains absent until activation is verified. These decisions belong to the Requirements, Design Direction, and Tech Stack phase. Existing sources constrain authenticity, not creativity. diff --git a/docs/hosting.md b/docs/hosting.md index c2ef432..cb6ea63 100644 --- a/docs/hosting.md +++ b/docs/hosting.md @@ -38,7 +38,7 @@ Namecheap's jailed shell exposes `/usr/local/cpanel/bin/uapi`, but the command c ## GitHub controls and deployment access -The source repository remains private by explicit owner choice. The available private-repository controls are accepted for this project: squash-only merges, branch cleanup, selected Actions, read-only workflow permissions, Dependabot alerts, and automated security updates. +The source repository is published for transparent inspection and contribution. Repository policy keeps squash-only merges, branch cleanup, selected Actions, read-only workflow permissions, automated dependency updates, private vulnerability reporting, secret scanning with push protection, CodeQL, and a protected linear `main` branch with required repository checks. Public source does not widen the production credential or deployment boundary. The OSS Singularity organization currently disables deploy keys across its repositories. A repo-specific cPanel deploy key was therefore not retained, no broader personal access token or account key was installed on the shared host, and no cPanel mirror was created. The preferred low-complexity path is an initial reviewed release over the already verified local SSH connection, followed by a GitHub Actions push deployment after successful changes to `main`. The workflow must transfer only the declared build output, serialize production deployments, verify the live result, and retain a rollback target. A repository-scoped GitHub App is reserved for a future requirement that genuinely needs server-initiated pulls; do not add its token-rotation and private-key machinery without that need. diff --git a/scripts/check-repository.sh b/scripts/check-repository.sh index a6e9168..fea21ab 100755 --- a/scripts/check-repository.sh +++ b/scripts/check-repository.sh @@ -11,7 +11,7 @@ cd "$repo_root" git diff --check git diff --cached --check -for required in README.md SECURITY.md docs/hosting.md docs/brand-inputs.md docs/product-requirements.md docs/design-directions.md; do +for required in README.md CONTRIBUTING.md LICENSE BRANDING.md SECURITY.md docs/hosting.md docs/brand-inputs.md docs/product-requirements.md docs/design-directions.md; do if [ ! -s "$required" ]; then printf 'missing required repository baseline: %s\n' "$required" >&2 exit 1