Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
51 commits
Select commit Hold shift + click to select a range
7bfb1f9
Implement persistent CalDAV, accounts and embedded client authorization
albert-gee Oct 27, 2026
a1aff30
Record embedded DAV and public OAuth integration risk evidence
albert-gee Oct 27, 2026
864b140
Package deployment, recovery and real-browser qualification workflows
albert-gee Oct 27, 2026
8da74b8
Implement group sharing and qualify calendar access semantics
albert-gee Oct 27, 2026
1ebff28
Enforce HTTP date conditions under calendar mutation locks
albert-gee Oct 27, 2026
3931b44
Automate reproducible client authorization and restoration qualification
albert-gee Oct 27, 2026
b959575
Measure calendar resource queries without client expansion
albert-gee Oct 27, 2026
223b366
Accept the standard saved-request marker after recovery login
albert-gee Oct 27, 2026
495989d
Record completed server qualification and operating guidance
albert-gee Oct 27, 2026
69c0614
License BusyStack distributions under Apache 2.0
albert-gee Oct 27, 2026
b24baae
Bound DAV synchronization, XML work and namespace mutations
albert-gee Oct 27, 2026
d2e1344
Qualify default clients, licensed artifacts and recovery boundaries
albert-gee Oct 27, 2026
b8080d9
Separate query candidate work from generated recurrence limits
albert-gee Oct 28, 2026
47b3543
Retain bounded health and migration diagnostics on startup failures
albert-gee Oct 28, 2026
923ecac
Record qualified artifacts, capacity measurements and recovery evidence
albert-gee Oct 28, 2026
00bedd0
Enforce calendar constraints and chronological timezone interpretation
albert-gee Oct 28, 2026
4161cdd
Bind passkey ceremonies and persist verified authenticator state
albert-gee Oct 28, 2026
46d8687
Correct DAV extensibility, privileges, properties and error contracts
albert-gee Oct 28, 2026
5e15eb6
Prepare traceable standards requalification and packaged recovery corpus
albert-gee Oct 28, 2026
279ae33
Apply calendar constraints to timezone property and report admission
albert-gee Oct 28, 2026
028bcd5
Validate query timezones before enumerating calendar members
albert-gee Oct 28, 2026
58f279a
Use legal weekdays in bounded timezone coverage fixture
albert-gee Oct 28, 2026
f64ce37
Record standards corrections and fresh packaged verification evidence
albert-gee Oct 28, 2026
1328727
Align recorded ACL conflict status with executed HTTP evidence
albert-gee Oct 28, 2026
3038a6c
Validate original calendar grammar before typed normalization
albert-gee Oct 29, 2026
11d06b4
Treat empty public OAuth client secrets as omitted
albert-gee Oct 29, 2026
e6e42bb
Record independent residual baselines and verified corrections
albert-gee Oct 29, 2026
a919d63
Refresh official Java image for blocking OS advisory
albert-gee Oct 29, 2026
8b023f3
Finalize version and distribution metadata for 0.0.1
albert-gee Oct 29, 2026
c298c06
Document and qualify 0.0.1 installation and client profiles
albert-gee Oct 29, 2026
b00644a
Retain first release CI failure and verification scope
albert-gee Oct 29, 2026
2eb4b0d
Repair local timezone observance UNTILs at calendar admission
albert-gee Oct 31, 2026
8c8cbd8
Qualify regional-timezone client workflows and restored corrected data
albert-gee Oct 31, 2026
e094e9b
Align publication note with verified timezone repair
albert-gee Oct 31, 2026
27f8145
Replace copied iCal4j implementations with official parser integration
albert-gee Nov 1, 2026
9635587
Prepare exact-artifact release staging and portable deployment bundle
albert-gee Nov 1, 2026
5fca16d
Qualify official-dependency candidate and harden release promotion
albert-gee Nov 1, 2026
d6d7009
Retain verification attempts and diagnose upstream login timeouts
albert-gee Nov 1, 2026
bf91d60
Merge pull request #1 from busystack/release/v0.0.1
albert-gee Nov 1, 2026
8896516
Qualify restoration independently of extracted deployment paths
albert-gee Nov 1, 2026
45269fb
Merge pull request #2 from busystack/release/v0.0.1
albert-gee Nov 1, 2026
1b8bee3
Keep installation documentation focused on product behavior
albert-gee Nov 1, 2026
180cdb8
Use readable release-candidate tags for staged images
albert-gee Nov 1, 2026
40b6829
Merge pull request #3 from busystack/release/v0.0.1
albert-gee Nov 1, 2026
e29e01b
Resume verified releases through draft-aware controller recovery
albert-gee Nov 1, 2026
49f62fa
Merge pull request #4 from busystack/release/v0.0.1
albert-gee Nov 1, 2026
aca2e59
Derive release identity from qualified Maven source and retain exact …
albert-gee Nov 1, 2026
5d09ecb
Retain raw Git blobs in source snapshots and tighten candidate valida…
albert-gee Nov 1, 2026
bbdacd9
Preserve canonical image identity and promote exact staged manifests
albert-gee Nov 2, 2026
f3ba60d
Record v0.1.0 qualification and enforce exact loaded runtime configur…
albert-gee Nov 2, 2026
d390503
Prepare clean public source and publication-ready v0.1.0 documentation
albert-gee Nov 2, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
17 changes: 17 additions & 0 deletions .dockerignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
.git
.github
.idea
.vscode
target
investigation
docs
scripts
*.log
.env
.env.*
secrets
backups

.client-tools/

.client-venv/
11 changes: 11 additions & 0 deletions .gitattributes
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
* text=auto eol=lf
mvnw.cmd text eol=crlf
# Calendar fixtures retain the accepted/client-emitted representation byte for byte.
src/test/resources/calendar/**/*.ics -text whitespace=cr-at-eol
src/test/resources/calendar/*.ics -text whitespace=cr-at-eol

# Deliver upstream license texts verbatim, including their original trailing whitespace.
licenses/EPL-2.0.txt -text -whitespace
licenses/LGPL-2.1.txt -text
licenses/logback-LICENSE.txt -text -whitespace
licenses/asm-9.7.1-copyright-and-license.txt -text
178 changes: 178 additions & 0 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,178 @@
name: verify

on:
push:
pull_request:
workflow_dispatch:

permissions:
contents: read

defaults:
run:
shell: bash

concurrency:
group: verify-${{ github.ref }}
cancel-in-progress: true

jobs:
release-tools:
runs-on: ubuntu-24.04
timeout-minutes: 10
steps:
- uses: actions/checkout@1af3b93b6815bc44a9784bd300feb67ff0d1eeb3 # v6.0.0
with:
persist-credentials: false
fetch-depth: 0
- name: Validate release helpers and rejection paths before qualification
run: |
python3 -m unittest discover -s qualification/release -p 'test_*.py'
python3 -m unittest discover -s qualification/distribution -p 'test_*.py'
python3 -m py_compile scripts/*.py
for script in scripts/*.sh; do bash -n "$script"; done
bash scripts/validate-workflows.sh

application:
needs: release-tools
runs-on: ubuntu-24.04
timeout-minutes: 90
steps:
- uses: actions/checkout@1af3b93b6815bc44a9784bd300feb67ff0d1eeb3 # v6.0.0
with:
persist-credentials: false
fetch-depth: 0
- name: Install the exact pinned Temurin JDK
run: bash scripts/install-ci-jdk.sh
- name: Install pinned independent CalDAV client test dependencies
run: |
python3 -m venv .client-venv
.client-venv/bin/python -m pip install --disable-pip-version-check --no-cache-dir -r qualification/clients/requirements.txt -r qualification/clients/desktop-requirements.txt
bash qualification/clients/install-thunderbird.sh .client-tools
- name: Require Docker and run unit and integration suites
env:
BUSYSTACK_CLIENT_PYTHON: ${{ github.workspace }}/.client-venv/bin/python
BUSYSTACK_THUNDERBIRD_BINARY: ${{ github.workspace }}/.client-tools/thunderbird/thunderbird
run: |
docker info > /dev/null
./mvnw --batch-mode --no-transfer-progress clean verify
./mvnw --batch-mode --no-transfer-progress -f investigation/protocol/pom.xml -s investigation/protocol/settings.xml test
./mvnw --batch-mode --no-transfer-progress -f investigation/oauth/pom.xml test
- name: Resolve qualified Maven identity
id: identity
run: echo "jar=$(python3 scripts/release_version.py --source-sha "$GITHUB_SHA" --format jar)" >> "$GITHUB_OUTPUT"
- name: Build deployable container
run: |
jar=$(python3 scripts/release_version.py --source-sha "$GITHUB_SHA" --format jar)
python3 scripts/build-image.py --image busystack-caldav:ci --jar "target/$jar"
docker image inspect --format '{{.Id}}' busystack-caldav:ci | tee target/application-image-id.txt
sha256sum "target/$jar" | cut -d ' ' -f 1 > target/application-jar-sha256.txt
- name: Inspect actual source, JAR and container license delivery
run: |
python3 -m unittest discover -s qualification/distribution -p 'test_*.py'
python3 scripts/verify-distribution.py --image busystack-caldav:ci
- name: Scan final container OS packages with a pinned scanner and current database
run: python3 scripts/check-container-advisories.py --image busystack-caldav:ci
- name: Verify packaged startup, restart, and database recovery
run: python3 scripts/verify-operations.py --image busystack-caldav:ci | tee target/operations-qualification.txt
- name: Verify qualification refresh and private snapshot bookkeeping
run: python3 -m unittest discover -s qualification/passkeys -p 'test_*.py'
- name: Build isolated browser qualification image
run: docker build --tag busystack-passkey-browser:qualification qualification/passkeys
- name: Verify browser WebAuthn and MFA over trusted test TLS
run: python3 qualification/passkeys/run.py --application-image busystack-caldav:ci --groups | tee target/browser-qualification.txt
- name: Verify explicit strict synchronization override over real HTTPS
run: python3 qualification/passkeys/run.py --application-image busystack-caldav:ci --groups --strict-sync-depth | tee target/strict-browser-qualification.txt
- name: Verify HTTPS reverse proxy with preserved servlet path
run: python3 qualification/passkeys/run.py --application-image busystack-caldav:ci --proxy --groups | tee target/proxy-qualification.txt
- name: Build disposable real Keycloak browser fixture
run: docker build --tag busystack-keycloak-browser:26.8.1 qualification/keycloak
- name: Verify cross-site organization login and local passkey MFA
run: python3 qualification/passkeys/run.py --application-image busystack-caldav:ci --oidc --groups | tee target/oidc-browser-qualification.txt
- name: Verify HTTPS local account recovery after restoring an older database
run: python3 qualification/passkeys/run.py --application-image busystack-caldav:ci --proxy --groups --restore --clients | tee target/https-restore-qualification.txt
- name: Verify HTTPS federated recovery against the same real upstream provider
run: python3 qualification/passkeys/run.py --application-image busystack-caldav:ci --oidc --groups --restore | tee target/oidc-restore-qualification.txt
- name: Retain exact tested publication candidate only after successful qualification
run: python3 scripts/release-candidate.py --output target/release-candidate --image busystack-caldav:ci
- name: Upload successful candidate separately from failure evidence
uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
with:
name: verified-candidate-${{ github.run_id }}-${{ github.run_attempt }}
path: target/release-candidate/
retention-days: 30
compression-level: 0
if-no-files-found: error
- name: Retain qualification evidence
if: always()
uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
with:
name: application-evidence-${{ github.run_attempt }}
retention-days: 14
path: |
target/surefire-reports/
target/failsafe-reports/
target/classes/META-INF/sbom/application.cdx.json
target/${{ steps.identity.outputs.jar }}
target/*.cdx.json
target/*-qualification.txt
target/application-image-id.txt
target/application-jar-sha256.txt
target/container-os-advisories*.json
target/qualification/
investigation/*/target/surefire-reports/
if-no-files-found: error

dependency-audit:
needs: release-tools
runs-on: ubuntu-24.04
timeout-minutes: 40
steps:
- uses: actions/checkout@1af3b93b6815bc44a9784bd300feb67ff0d1eeb3 # v6.0.0
with:
persist-credentials: false
fetch-depth: 0
- name: Install the exact pinned Temurin JDK
run: bash scripts/install-ci-jdk.sh
- name: Generate runtime inventory and verify advisory gate failure behavior
run: |
./mvnw --batch-mode --no-transfer-progress -DskipTests package
python3 -m unittest discover -s qualification/security -p 'test_*.py'
- name: Verify known-vulnerable package is detected
run: |
if python3 scripts/check-advisories.py --sbom qualification/security/positive-control.cdx.json --output target/osv-positive-control.json; then
echo 'Advisory positive control incorrectly reported success.' >&2
exit 1
else
audit_status=$?
test "$audit_status" -eq 1
fi
python3 - <<'PY'
import json
from pathlib import Path
result = json.loads(Path('target/osv-positive-control.json').read_text())
assert result['status'] == 'advisories-returned'
assert result['affectedPackageCount'] == 1
assert any(item['id'] == 'GHSA-jfh8-c2jp-5v3q' for package in result['packages'] for item in package['advisories'])
PY
- name: Check runtime dependencies against current OSV advisories
run: python3 scripts/check-advisories.py
- name: Additional NVD audit when feed credential is configured
env:
NVD_API_KEY: ${{ secrets.NVD_API_KEY }}
run: |
if [[ -n "${NVD_API_KEY:-}" ]]; then
./mvnw --batch-mode --no-transfer-progress org.owasp:dependency-check-maven:13.0.0:check -DnvdApiKeyEnvironmentVariable=NVD_API_KEY -DfailBuildOnCVSS=7 -DfailOnError=true -DossIndexAnalyzerEnabled=false -Dformats=HTML,JSON
else
echo 'Additional NVD audit unexecuted: no NVD_API_KEY configured. The required OSV check ran above.'
fi
- name: Retain dependency audit
if: always()
uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
with:
name: dependency-audit-${{ github.run_attempt }}
retention-days: 14
path: |
target/osv-*.json
target/dependency-check-report.*
if-no-files-found: error
135 changes: 135 additions & 0 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,135 @@
name: release

on:
workflow_dispatch:
inputs:
version:
description: Exact release version
type: string
required: true
verification_run:
description: Exact successful main verification run ID
type: string
required: true
source_sha:
description: Exact qualified main commit (40 hex characters)
type: string
required: true
phase:
description: Stage and qualify first; publish consumes the successful staging run
type: choice
options: [stage, publish]
required: true
candidate_version:
description: Maven version followed by -rc.N; required when staging
type: string
required: false
immutability_confirmed:
description: Admin checked immutable-releases enabled via gh API immediately before publish
type: boolean
default: false
required: true
stage_run:
description: Successful staging run ID (required for publish)
type: string
required: false

permissions:
contents: read

concurrency:
group: release-${{ inputs.version }}
cancel-in-progress: false

defaults:
run:
shell: bash

jobs:
promote:
if: github.repository == 'busystack/caldav-server' && github.ref == 'refs/heads/main'
runs-on: ubuntu-24.04
timeout-minutes: 90
permissions:
contents: write
actions: read
packages: write
steps:
- uses: actions/checkout@1af3b93b6815bc44a9784bd300feb67ff0d1eeb3 # v6.0.0
with:
persist-credentials: false
fetch-depth: 0
- name: Validate dispatch and release tooling
env:
RELEASE_VERSION: ${{ inputs.version }}
RELEASE_SHA: ${{ inputs.source_sha }}
RELEASE_RUN: ${{ inputs.verification_run }}
RELEASE_STAGE_RUN: ${{ inputs.stage_run }}
RELEASE_PHASE: ${{ inputs.phase }}
RELEASE_CANDIDATE_VERSION: ${{ inputs.candidate_version }}
run: |
[[ "$RELEASE_SHA" =~ ^[0-9a-f]{40}$ ]]
test "$(git rev-parse HEAD)" = "$GITHUB_SHA"
[[ "$RELEASE_RUN" =~ ^[0-9]+$ ]]
[[ -z "$RELEASE_STAGE_RUN" || "$RELEASE_STAGE_RUN" =~ ^[0-9]+$ ]]
if [[ "$RELEASE_PHASE" == stage ]]; then
test "$RELEASE_SHA" = "$GITHUB_SHA"
python3 scripts/release_version.py --source-sha "$RELEASE_SHA" --requested "$RELEASE_VERSION" --candidate "$RELEASE_CANDIDATE_VERSION"
else
git merge-base --is-ancestor "$RELEASE_SHA" HEAD
fi
python3 scripts/release_version.py --source-sha "$RELEASE_SHA" --requested "$RELEASE_VERSION"
python3 -m unittest discover -s qualification/release -p 'test_*.py'
- name: Install isolated official release-attestation CLI
run: bash scripts/install-release-gh.sh
- name: Install selected JDK for downloaded JAR qualification
run: bash scripts/install-ci-jdk.sh
- name: Build browser fixture (application is promoted without rebuilding)
run: docker build --tag busystack-passkey-browser:qualification qualification/passkeys
- name: Authenticate repository-associated GHCR publication with ephemeral workflow token
env:
GH_TOKEN: ${{ github.token }}
run: printf '%s' "$GH_TOKEN" | docker login ghcr.io --username "$GITHUB_ACTOR" --password-stdin
- name: Validate verification, promote and qualify exact artifacts
env:
GH_TOKEN: ${{ github.token }}
RELEASE_VERSION: ${{ inputs.version }}
RELEASE_RUN: ${{ inputs.verification_run }}
RELEASE_SHA: ${{ inputs.source_sha }}
RELEASE_PHASE: ${{ inputs.phase }}
IMMUTABILITY_CONFIRMED: ${{ inputs.immutability_confirmed }}
RELEASE_STAGE_RUN: ${{ inputs.stage_run }}
RELEASE_CANDIDATE_VERSION: ${{ inputs.candidate_version }}
run: |
arguments=(--version "$RELEASE_VERSION" --verification-run "$RELEASE_RUN" --source-sha "$RELEASE_SHA" --phase "$RELEASE_PHASE" --work "$RUNNER_TEMP/release-work")
if [[ "$RELEASE_PHASE" == stage ]]; then arguments+=(--candidate-version "$RELEASE_CANDIDATE_VERSION"); fi
if [[ -n "$RELEASE_STAGE_RUN" ]]; then arguments+=(--stage-run "$RELEASE_STAGE_RUN"); fi
if [[ "$IMMUTABILITY_CONFIRMED" == true ]]; then arguments+=(--immutability-confirmed); fi
python3 scripts/publish-release.py "${arguments[@]}"
- name: Retain successful staging assets
if: success() && inputs.phase == 'stage'
uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
with:
name: release-stage-${{ github.run_id }}-${{ github.run_attempt }}
path: |
${{ runner.temp }}/release-work/assets/
${{ runner.temp }}/release-work/stage.json
${{ runner.temp }}/release-work/installation.json
${{ runner.temp }}/release-work/release-notes.md
compression-level: 0
retention-days: 30
if-no-files-found: error
- name: Retain operation journal and qualification results on every attempt
if: always()
uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
with:
name: release-operations-${{ github.run_id }}-${{ github.run_attempt }}
path: |
${{ runner.temp }}/release-work/release-attestation.json
${{ runner.temp }}/release-work/operations.jsonl
${{ runner.temp }}/release-work/*installation.json
retention-days: 90
if-no-files-found: warn
- name: Remove ephemeral registry login
if: always()
run: docker logout ghcr.io
16 changes: 16 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
target/
**/target/
.idea/
*.iml
.env
.env.*
!.env.example
backups/
*.log
__pycache__/
**/node_modules/
.attach_pid*

.client-venv/

.client-tools/
1 change: 1 addition & 0 deletions .mvn/jvm.config
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
-Duser.timezone=UTC
4 changes: 4 additions & 0 deletions .mvn/wrapper/maven-wrapper.properties
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
wrapperVersion=3.3.4
distributionType=only-script
distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.12/apache-maven-3.9.12-bin.zip
distributionSha256Sum=305773a68d6ddfd413df58c82b3f8050e89778e777f3a745c8e5b8cbea4018ef
19 changes: 19 additions & 0 deletions Dockerfile
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# Use python3 scripts/build-image.py to supply the verified Maven artifact.
FROM eclipse-temurin:25-jdk@sha256:3ab7fc8d0b4ade8fef96903fb36767c1dbb4fd1535dcfad85b59c17afbbb5857 AS runtime
ARG APPLICATION_VERSION
ARG SOURCE_REVISION
WORKDIR /opt/busystack
RUN ["/bin/bash", "-ec", "[[ ${APPLICATION_VERSION:-} =~ ^(0|[1-9][0-9]*)[.](0|[1-9][0-9]*)[.](0|[1-9][0-9]*)$ && ${SOURCE_REVISION:-} =~ ^[0-9a-f]{40}$ ]] || { echo 'Build with python3 scripts/build-image.py: valid Maven version and Git revision are required' >&2; exit 1; }"]
COPY .image-input/ /tmp/busystack-image-input/
RUN ["/bin/bash", "-ec", "cd /tmp/busystack-image-input; [[ ${APPLICATION_VERSION:-} =~ ^(0|[1-9][0-9]*)[.](0|[1-9][0-9]*)[.](0|[1-9][0-9]*)$ && ${SOURCE_REVISION:-} =~ ^[0-9a-f]{40}$ ]] || { echo 'Build with python3 scripts/build-image.py: valid Maven version and Git revision are required' >&2; exit 1; }; test \"$(cat version)\" = \"$APPLICATION_VERSION\"; test \"$(cat revision)\" = \"$SOURCE_REVISION\"; sha256sum --check SHA256SUMS; mkdir extracted; cd extracted; jar xf ../application.jar META-INF/MANIFEST.MF META-INF/maven/org.busystack/caldav-server/pom.properties; tr -d '\\r' < META-INF/MANIFEST.MF | grep -Fx \"Implementation-Version: $APPLICATION_VERSION\"; grep -Fx \"version=$APPLICATION_VERSION\" META-INF/maven/org.busystack/caldav-server/pom.properties; grep -Fx 'groupId=org.busystack' META-INF/maven/org.busystack/caldav-server/pom.properties; grep -Fx 'artifactId=caldav-server' META-INF/maven/org.busystack/caldav-server/pom.properties; cd ..; mv application.jar /opt/busystack/application.jar; mkdir /opt/busystack/licenses; mv LICENSE NOTICE THIRD-PARTY-NOTICES runtime-dependency-inventory.json third-party /opt/busystack/licenses/; rm -rf /tmp/busystack-image-input"]
LABEL org.opencontainers.image.title="BusyStack CalDAV Server" \
org.opencontainers.image.description="Independent calendar and task server" \
org.opencontainers.image.version="${APPLICATION_VERSION}" \
org.opencontainers.image.licenses="Apache-2.0" \
org.opencontainers.image.source="https://github.com/busystack/caldav-server" \
org.opencontainers.image.revision="${SOURCE_REVISION}"
ENV SERVER_ADDRESS=0.0.0.0
RUN groupadd --gid 10001 busystack && useradd --uid 10001 --gid 10001 --no-create-home --home-dir /nonexistent --shell /usr/sbin/nologin busystack && chown -R 10001:10001 /opt/busystack
USER 10001:10001
EXPOSE 8080
ENTRYPOINT ["java", "-XX:MaxRAMPercentage=70.0", "-Djava.io.tmpdir=/tmp", "-jar", "/opt/busystack/application.jar"]
Loading
Loading