v0.2.0-beta: Peripheral Algorithms + Compiler-Governed Copy

ParkinSUM Companion v0.2.0-beta Release Notes

ParkinSUM Companion v0.2.0-beta is a public educational showcase release that
builds on v0.1.0-alpha by adding a layer of deterministic, review-only
peripheral support algorithms and a compiler-governed user-facing copy layer.

This release is not a clinical product. It must not be used for diagnosis,
treatment, medication timing, individualized dietary guidance, patient care, or
emergency support.

What This Beta Adds Over the Alpha

• Peripheral support algorithms (P1–P12) — twelve deterministic, auditable
  support modules, each with a command-line report artifact and unit tests:
  • P1 input quality gate, P2 catalog resolution engine, P3 source version
    drift checker, P4 local evidence graph builder, P5 synthetic scenario
    fuzzer, P6 explanation copy compiler + safe copy template registry, P7
    localization safety lint, P8 local privacy preflight, P9 source access
    contract checker, P10 public demo walkthrough generator, P11 contribution
    safety router, P12 release snapshot generator.
  • These are review-only tooling. They compose existing artifacts, never
    fabricate data, and are not wired into scoring.
• Compiler-governed copy layer — user-facing boundary/disclaimer copy and
  the legacy rule-finding lines now resolve through the compiler-validated
  ExplanationCopyService. Resolution is locale-strict: English output is
  byte-identical to the existing app_i18n source, and non-English translations
  are preserved via fallback. A parity drift guard pins each migrated template to
  its live i18n source so copy cannot silently diverge.
• Documentation — a capability matrix plus per-feature docs describing each
  peripheral module's scope, tests, safety boundary, and limitations.

App Status

• Release tag: v0.2.0-beta
• Flutter package: parkinsum_companion
• App version metadata: 0.2.0+2
• Release type: public beta showcase
• Default public-demo backend: local mode
• Firebase-backed paths: internal operator validation only
• Public contact: parkinsumservice@gmail.com

This beta is suitable for architecture review, educational demonstration,
portfolio review, and academic software-engineering discussion. It is not ready
for real user health-data collection or clinical deployment.

Safety Boundary

ParkinSUM Companion is educational software only.

• It does not diagnose, treat, monitor, prevent, or manage disease.
• It does not provide individualized medical, medication, dietary, clinical, or
  emergency advice.
• It has no patient-outcome validation.
• It is not reviewed, cleared, or approved as a medical device.
• The peripheral algorithms are deterministic report/governance tooling; they do
  not change the scoring engine and add no medical advice.
• Public demos must use synthetic or sample data only.

Do not enter real health information, symptoms, medication schedules, patient
identifiers, Firebase tokens, service-account credentials, private user exports,
or raw operator audit logs.

Known Limitations

• Rule coverage and peripheral algorithms are prototype-scoped and should be
  reviewed as software architecture, not clinical authority.
• Recommendation and conflict outputs are educational awareness text, not
  patient-specific guidance.
• The app has not undergone clinical, legal, privacy, regulatory, security, or
  accessibility sign-off for public health use.
• The peripheral report tools are deterministic but pattern-based and
  conservative; they are not compliance certifications or clinical validation.
• Firebase-backed flows require project access and are retained for internal
  operator validation rather than public-demo use.
• Android release signing is not configured for production distribution.

How To Run Locally

Install Flutter, Node.js, and npm, then run from the repository root:

flutter pub get
dart format --output=none --set-exit-if-changed .
flutter analyze
flutter test
npm ci
npm run public:preflight
npm run privacy:preflight
npm run copy:compile
npm run localization:lint
flutter run -d chrome

What Is Not Included

• Android signing keys, Play Store deployment, app-store deployment, Firebase
  deployment, or production release automation.
• Private keys, .env files, service-account files, Firebase admin credentials,
  production tokens, or operator secrets.
• Real patient records, real medication schedules, clinical screenshots, raw
  operator logs, or private Firebase exports.
• Claims of diagnosis, treatment, clinical validation, privacy certification,
  legal approval, regulatory clearance, or production patient-care readiness.

Related Release Files

• CHANGELOG.md
• docs/release/v0.1.0-alpha-notes.md
• docs/CAPABILITY_MATRIX.md
• docs/release/release-checklist.md
• docs/PUBLIC_DEMO_BOUNDARY.md
• docs/known_risks.md
• docs/RELEASE_EVIDENCE_INDEX.md

v0.1.0-alpha: Public Educational Prototype Showcase

ParkinSUM Companion v0.1.0-alpha Release Notes

ParkinSUM Companion v0.1.0-alpha is a public educational showcase release for
reviewing the prototype's architecture, local-first app flow, deterministic
rule-checking approach, and public-release guardrails.

This release is not a clinical product. It must not be used for diagnosis,
treatment, medication timing, individualized dietary guidance, patient care, or
emergency support.

What This Alpha Demonstrates

• A Flutter app prototype for Parkinson's disease diet-medication education.
• Local-first public-demo behavior with synthetic or sample data.
• Onboarding, meal logging, medication context, timeline, import, and
  recommendation-oriented screens.
• Deterministic food-drug interaction checks for educational awareness.
• Evidence-oriented explanations that show why a prototype rule fired.
• Conservative importer and rule architecture that keeps provenance and
  limitations visible.
• Public repository guardrails: disclaimer, security policy, contribution rules,
  CI checks, public preflight, and release checklist.

App Status

• Release tag: v0.1.0-alpha
• Flutter package: parkinsum_companion
• App version metadata: 0.1.0+1
• Release type: public alpha showcase
• Default public-demo backend: local mode
• Firebase-backed paths: internal operator validation only
• Public contact: parkinsumservice@gmail.com

This alpha is suitable for architecture review, educational demonstration,
portfolio review, and academic software-engineering discussion. It is not ready
for real user health-data collection or clinical deployment.

Safety Boundary

ParkinSUM Companion is educational software only.

• It does not diagnose, treat, monitor, prevent, or manage disease.
• It does not provide individualized medical, medication, dietary, clinical, or
  emergency advice.
• It has no patient-outcome validation.
• It is not reviewed, cleared, or approved as a medical device.
• Public demos must use synthetic or sample data only.

Do not enter real health information, symptoms, medication schedules, patient
identifiers, Firebase tokens, service-account credentials, private user exports,
or raw operator audit logs.

Known Limitations

• Rule coverage is prototype-scoped and should be reviewed as software
  architecture, not clinical authority.
• Recommendation and conflict outputs are educational awareness text, not
  patient-specific guidance.
• The app has not undergone clinical, legal, privacy, regulatory, security, or
  accessibility sign-off for public health use.
• README demo screenshots and a short GIF are committed from synthetic local
  demo data only.
• Firebase-backed flows require project access and are retained for internal
  operator validation rather than public-demo use.
• Android release signing is not configured for production distribution. Any
  debug APK produced for this alpha is a demo artifact only.

How To Run Locally

Install Flutter, Node.js, and npm, then run from the repository root:

flutter pub get
dart format --output=none --set-exit-if-changed .
flutter analyze
flutter test
npm ci
npm run public:preflight
npm run rules:contract
flutter run -d chrome

If Android tooling is available, a local debug demo APK can be generated with:

flutter build apk --debug

If copied for release-asset review, label it clearly as:

parkinsum-v0.1.0-alpha-demo-debug.apk

The debug APK is not production-signed and is not intended for app-store or
clinical distribution.

What Is Not Included

• Android signing keys, Play Store deployment, app-store deployment, Firebase
  deployment, or GitHub release publishing automation.
• Private keys, .env files, service-account files, Firebase admin credentials,
  production tokens, or operator secrets.
• Real patient records, real medication schedules, clinical screenshots, raw
  operator logs, or private Firebase exports.
• Claims of diagnosis, treatment, clinical validation, privacy certification,
  legal approval, regulatory clearance, or production patient-care readiness.

Related Release Files

• CHANGELOG.md
• docs/release/synthetic-demo-data.md
• docs/release/release-checklist.md
• docs/PUBLIC_DEMO_BOUNDARY.md
• docs/known_risks.md
• docs/RELEASE_EVIDENCE_INDEX.md

ParkinSUM public prototype showcase v0.1.0

ParkinSUM v0.1.0 public prototype showcase.

This release is a production-architecture prototype for educational and research showcase use. It demonstrates Firebase governance, Firestore rules contracts, provenance-first ingestion, CDSS-style explanation surfaces, and public repository preflight controls.

Boundaries:

• Not medical advice.
• Not a medical device.
• Not for diagnosis, treatment, medication timing, patient care, or clinical decision-making.
• Synthetic/sample data only. Do not submit personal health information, credentials, tokens, UID values, or real user records.
• No external clinical, legal, or privacy professional approval is claimed.

Validation evidence:

• GitHub Actions Public release preflight passed on commit f95121f.
• Apache-2.0 license, disclaimer, security policy, contribution guide, issue templates, and public preflight scanner are included.