Skip to content

docs: add legal readiness release gate#515

Merged
nash87 merged 11 commits into
mainfrom
t-6382-legal-readiness-php
May 21, 2026
Merged

docs: add legal readiness release gate#515
nash87 merged 11 commits into
mainfrom
t-6382-legal-readiness-php

Conversation

@nash87
Copy link
Copy Markdown
Owner

@nash87 nash87 commented May 20, 2026

Adds the ParkHub PHP legal-readiness release gate and operator evidence package
for German, EU, international, personal, and business deployment review.

Scope

  • Adds docs/legal-readiness.md as the operator-facing audit hub.
  • Adds docs/deployment-readiness-record.md for per-deployment jurisdiction,
    module/plugin, processor, CI/CD evidence, review status, and final human
    go-live signoff.
  • Adds docs/legal-readiness-parity.md to keep Rust/PHP legal-readiness gates,
    module/plugin review policy, and operator boundaries aligned.
  • Extends docs/release-checklist.md so legal-readiness, deployment-readiness,
    parity, and legal/module OpenAPI review are part of release review.
  • Adds/extends static guards:
    • scripts/tests/test-legal-readiness-wording.sh
    • scripts/tests/test-legal-openapi-contract.sh
  • Keeps fop legal catalog reference-only. Attorney review, citation
    verification, deployment-specific configuration review, human signoff, and
    final legal judgment remain required.

Verification

  • git diff --check: passed.
  • bash scripts/tests/test-legal-readiness-wording.sh: passed through fop.
  • bash scripts/tests/test-legal-openapi-contract.sh: passed through fop.
  • Local PR CI:
    .fop/reports/local-ci-pr-6a3db6981db1ef7c48e6a799888696ff34081b02.json
    passed.
  • GitHub checks are green on
    6a3db6981db1ef7c48e6a799888696ff34081b02.

Review Boundary

This PR improves engineering evidence, release gates, and operator-facing
review workflow. It does not assert that any deployment is legally compliant.
Production use still requires qualified review of the actual operator,
jurisdiction, enabled modules, processors, retention settings, accessibility
scope, AI/ML features, and final legal texts.

Rust parity work exists locally on t-6382-legal-readiness-rust and is waiting
for a green fop capacity window before the normal Rust pre-push path can run.

Copilot AI review requested due to automatic review settings May 20, 2026 04:24
@github-actions github-actions Bot added ci CI/CD pipeline docs labels May 20, 2026
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 85acdc2cc8

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread scripts/tests/test-legal-readiness-wording.sh Outdated
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Adds a “legal readiness” release gate by introducing static guard scripts and updating documentation to consistently avoid absolute compliance claims while pinning legal/module OpenAPI surfaces.

Changes:

  • Add shell/Node guard scripts to block absolute compliance wording and assert required OpenAPI endpoints exist in the snapshot.
  • Add a new operator-facing “Legal Readiness Hub” doc and wire it into the release checklist and README/feature docs.
  • Run the new guards as part of the local CI workflow.

Reviewed changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated 5 comments.

Show a summary per file
File Description
scripts/tests/test-legal-readiness-wording.sh Adds a ripgrep-based scan plus required-text assertions to prevent absolute compliance wording drift.
scripts/tests/test-legal-openapi-contract.sh Adds a Node-based contract check against the committed OpenAPI snapshot for required legal/module endpoints.
docs/release-checklist.md Adds a Legal readiness section and references the new guard scripts/hub.
docs/legal-readiness.md Introduces the operator-facing legal-readiness hub with evidence map and review flow.
docs/GDPR.md Softens absolute compliance language and adds a “Legal Readiness Checklist” framing.
docs/FEATURES.md Replaces absolute compliance claims and clarifies module risk/enablement expectations.
docs/COMPLIANCE.md Reframes compliance claims as “support/readiness” and updates checklists accordingly.
README.md Replaces absolute badges/text with readiness framing and links to the new hub/checklist.
.github/scripts/fop-local-ci.sh Runs the new legal-readiness wording and OpenAPI contract scripts in local CI.

Comment thread scripts/tests/test-legal-readiness-wording.sh Outdated
Comment thread scripts/tests/test-legal-readiness-wording.sh Outdated
Comment thread scripts/tests/test-legal-readiness-wording.sh
Comment thread scripts/tests/test-legal-openapi-contract.sh Outdated
Comment thread scripts/tests/test-legal-openapi-contract.sh Outdated
@github-actions github-actions Bot added the security Security related issues label May 20, 2026
@nash87 nash87 enabled auto-merge (squash) May 20, 2026 04:40
@nash87 nash87 merged commit 3316e17 into main May 21, 2026
28 of 29 checks passed
@nash87 nash87 deleted the t-6382-legal-readiness-php branch May 21, 2026 07:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ci CI/CD pipeline docs security Security related issues

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants