From cb22553a9f41483154299c4ec2f70bb6eedace05 Mon Sep 17 00:00:00 2001 From: Erik LaBianca Date: Mon, 2 Nov 2026 12:38:18 -0500 Subject: [PATCH] License Concourse under MIT OR Apache-2.0 and prepare qualified preview releases --- .github/workflows/test.yml | 31 ++++ LICENSE-APACHE | 202 ++++++++++++++++++++++++++ LICENSE-MIT | 21 +++ README.md | 4 +- docs/helix/00-discover/owner-input.md | 8 +- docs/helix/01-frame/prd.md | 8 +- docs/helix/05-deploy/release-0.1.0.md | 63 ++++++++ package.json | 3 +- scripts/package-release.py | 35 +++++ 9 files changed, 367 insertions(+), 8 deletions(-) create mode 100644 LICENSE-APACHE create mode 100644 LICENSE-MIT create mode 100644 docs/helix/05-deploy/release-0.1.0.md create mode 100644 scripts/package-release.py diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml index bca742a..6286723 100644 --- a/.github/workflows/test.yml +++ b/.github/workflows/test.yml @@ -1,7 +1,12 @@ name: Concourse checks on: push: + branches: [main] + tags: ['v*'] pull_request: +concurrency: + group: concourse-${{ github.workflow }}-${{ github.ref }} + cancel-in-progress: ${{ !startsWith(github.ref, 'refs/tags/') }} permissions: contents: read jobs: @@ -40,3 +45,29 @@ jobs: with: name: concourse-local-proof path: test-results/ + - uses: actions/upload-artifact@v4 + if: startsWith(github.ref, 'refs/tags/') + with: + name: concourse-dist + path: dist/ + if-no-files-found: error + release: + if: startsWith(github.ref, 'refs/tags/') + needs: [infrastructure, verify] + runs-on: ubuntu-24.04 + permissions: + contents: write + steps: + - uses: actions/checkout@v4 + - uses: actions/download-artifact@v4 + with: + name: concourse-dist + path: dist/ + - run: python3 scripts/package-release.py + - name: Publish qualified preview + env: + GH_TOKEN: ${{ github.token }} + run: >- + gh release create "$GITHUB_REF_NAME" release/* --verify-tag --prerelease + --title "Concourse ${GITHUB_REF_NAME#v} — local qualification preview" + --notes-file docs/helix/05-deploy/release-0.1.0.md diff --git a/LICENSE-APACHE b/LICENSE-APACHE new file mode 100644 index 0000000..d645695 --- /dev/null +++ b/LICENSE-APACHE @@ -0,0 +1,202 @@ + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. diff --git a/LICENSE-MIT b/LICENSE-MIT new file mode 100644 index 0000000..68ac2d1 --- /dev/null +++ b/LICENSE-MIT @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2026 Synaptiq + +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 a1bb1e7..2475c04 100644 --- a/README.md +++ b/README.md @@ -48,5 +48,5 @@ Use the installed HELIX catalog; methodology templates are not vendored here. ## License -Source/package licensing requires an owner decision before code distribution. -Repository visibility alone does not grant a software license. +Concourse is available under `MIT OR Apache-2.0`, at your option. See +[MIT](LICENSE-MIT) and [Apache-2.0](LICENSE-APACHE). diff --git a/docs/helix/00-discover/owner-input.md b/docs/helix/00-discover/owner-input.md index a050c56..8728b0c 100644 --- a/docs/helix/00-discover/owner-input.md +++ b/docs/helix/00-discover/owner-input.md @@ -28,7 +28,7 @@ for review, not claims of existing Concourse behavior. First audience/site; account-linking rules; Microsoft account types; permission and revocation timing; moderation and retention policy; data residency; database; -UI/component owner; operational budget; license; deployment account/domain; +UI/component owner; operational budget; deployment account/domain; public-site login experience; production acceptance profile. ## Evidence boundary @@ -58,3 +58,9 @@ reusable Terraform module that can be consumed by Synaptiq infrastructure. Application deployment must be repeatable and explicitly reviewed. Shared infrastructure stays with its existing owner; preparing this package does not authorize applying infrastructure, reading credentials or running migrations. + +## Software license — 2026-11-02 + +The owner selected `MIT OR Apache-2.0`, matching the UMF family. This authorizes +source and package distribution under either license. Production deployment, +secret access and migrations remain separately authorized operations. diff --git a/docs/helix/01-frame/prd.md b/docs/helix/01-frame/prd.md index db3bb7b..b338c12 100644 --- a/docs/helix/01-frame/prd.md +++ b/docs/helix/01-frame/prd.md @@ -179,8 +179,8 @@ serverless executor, D1 binding or Concourse production qualification. ### Constraints Public source repository; no publication of credentials or private reader data. -No budget, deadline, residency region, traffic profile or software license has -been selected. The owner authorized implementation on 2026-10-29: reusable protected publishing +Software is licensed `MIT OR Apache-2.0` by owner decision on 2026-11-02. +No budget, deadline, residency region or traffic profile has been selected. The owner authorized implementation on 2026-10-29: reusable protected publishing first, then inline comments on HELIX microsites. Production deployment is a separate operation. @@ -216,8 +216,8 @@ references are external sources, not invented HELIX graph edges. authorization acceptance and meaningful logout/revocation tests. - What are data retention, deletion, export and moderation-history rules? Owner; blocks production data admission and destructive operations. -- What datastore, UI/component owner, host topology, region, budget and software - license apply? Owner/design; blocks corresponding implementation/release choices. +- What datastore, UI/component owner, host topology, region and budget + apply? Owner/design; blocks corresponding implementation/release choices. - Which structured action and exact UMF profile? UMF/Concourse maintainers; blocks FR-8 design, without blocking protected comments discovery. diff --git a/docs/helix/05-deploy/release-0.1.0.md b/docs/helix/05-deploy/release-0.1.0.md new file mode 100644 index 0000000..b9f5e65 --- /dev/null +++ b/docs/helix/05-deploy/release-0.1.0.md @@ -0,0 +1,63 @@ +--- +ddx: + id: concourse.release.0.1.0 + type: release-notes + activity: deploy + authoring: + home: repo + links: + - id: CONTRACT-001 + kind: informed_by +--- + +# Concourse 0.1.0 — local qualification preview + +## Release Scope + +First source and asset prerelease of protected publication and inline section +comments. The owner selected `MIT OR Apache-2.0` on 2026-11-02. GitHub's source +archive and the built asset bundle carry that license choice. + +## Audience and Channels + +Site integrators receive browser JavaScript/CSS, a Hugo partial, Worker bundle, +SQL migrations, example deployment profile and infrastructure sources through +GitHub Releases. The private npm package is not published to a registry. + +## Highlights + +Signed-in readers can post comments and replies, reload discussion and recover +an interrupted write without duplication. Server identity and site scope govern +access. Generic publication protection preserves existing infrastructure ownership. + +## Changes and Fixes + +The local release gate passes strict TypeScript, Biome, module boundaries, +builds and 17 tests with 148 assertions. Native workerd/D1 and real Chromium +journeys pass. Hosted Linux repeats these checks before publishing the exact +built bytes; the release receipt records source, run and hashes. + +## Breaking Changes and Required Actions + +This is the first release. Verify SHA256SUMS, pin the source and review the +[deployment procedure](first-slices.md). Supply an explicit installation profile +and prepare/review a bound release before any authorized deployment. + +## Migration or Rollback Guidance + +This release does not apply SQL or infrastructure. Those operations require +separate review and authorization. Retain previous code and data independently; +application rollback does not reverse database or infrastructure changes. + +## Known Issues and Support + +Qualification uses synthetic signed identity and local storage/runtime evidence. +Live provider login, production Access admission, retention/export/restore, +moderation, Batten/Databricks hosting and structured action profiles remain open. +This preview does not qualify a deployed service or real private reader data. + +## References + +- [First-slices deployment procedure](first-slices.md) +- [Execution plan](../04-build/first-slices-plan.md) +- [Owner decisions](../00-discover/owner-input.md) diff --git a/package.json b/package.json index ce82e03..f22e56a 100644 --- a/package.json +++ b/package.json @@ -29,5 +29,6 @@ "miniflare": "4.20260730.0", "typescript": "7.0.2", "wrangler": "4.156.0" - } + }, + "license": "MIT OR Apache-2.0" } diff --git a/scripts/package-release.py b/scripts/package-release.py new file mode 100644 index 0000000..85b1bd3 --- /dev/null +++ b/scripts/package-release.py @@ -0,0 +1,35 @@ +"""Package the exact hosted build; performs no deployment or credential access.""" +import hashlib +import json +import os +from pathlib import Path +import shutil +import subprocess +import tarfile + +root = Path(__file__).resolve().parents[1] +version = json.loads((root / "package.json").read_text())["version"] +tag = os.environ["GITHUB_REF_NAME"] +if tag != f"v{version}": + raise SystemExit("Release tag differs from package version") +commit = subprocess.check_output(["git", "rev-parse", "HEAD"], text=True).strip() +if subprocess.check_output(["git", "rev-parse", f"{tag}^{{commit}}"], text=True).strip() != commit: + raise SystemExit("Release source differs from tag") +output = root / "release" +output.mkdir() +stage = output / f"concourse-{version}" +stage.mkdir() +for name in ["dist", "migrations", "integrations", "deploy", "infra", "README.md", "LICENSE-MIT", "LICENSE-APACHE"]: + source = root / name + if source.is_dir(): + shutil.copytree(source, stage / name, ignore=shutil.ignore_patterns(".terraform", "*.tfstate*", "*.tfplan")) + else: + shutil.copy2(source, stage / name) +files = {str(f.relative_to(stage)): hashlib.sha256(f.read_bytes()).hexdigest() for f in sorted(stage.rglob("*")) if f.is_file()} +receipt = {"tag": tag, "sourceCommit": commit, "workflowRun": os.environ.get("GITHUB_RUN_ID"), + "license": "MIT OR Apache-2.0", "scope": "Local qualification preview; no live login, deployment, production data, Batten host or broad action-profile qualification", "files": files} +(output / "release-receipt.json").write_text(json.dumps(receipt, indent=2) + "\n") +with tarfile.open(output / f"concourse-{version}.tar.gz", "w:gz") as archive: + archive.add(stage, arcname=stage.name) +shutil.rmtree(stage) +(output / "SHA256SUMS").write_text("".join(f"{hashlib.sha256(f.read_bytes()).hexdigest()} {f.name}\n" for f in sorted(output.iterdir()) if f.is_file()))