{
  "markdown": "# ⚠️ ARCHIVED — this repo's surviving pieces live in HealthClaw Guardrails\n\n**Archived 2026-07-19.** SmartHealthConnect was the patient-facing surface of\nthe HealthClaw platform. Its good parts were salvaged into the engine repo and\nthis repo is now read-only history:\n\n- **The 6 patient skills** (`skills/*/SKILL.md`) live on as **CareAgents\n  advisor definitions** — engine-backed by construction, so every clinical\n  claim routes through the guardrails\n  ([HealthClawGuardrails#175](https://github.com/aks129/HealthClawGuardrails/issues/175)).\n- **The care-gaps MCP-App view** was rebuilt on the engine's own `$care-gaps`\n  operation at `/r6/fhir/mcp-apps/care-gaps/`\n  ([HealthClawGuardrails#176](https://github.com/aks129/HealthClawGuardrails/issues/176)\n  has the full 7-view decision table).\n- **The engine/surface contract** (`.health-context.yaml`) survives as the\n  pattern — with [CareAgents](https://github.com/aks129/HealthClawGuardrails/tree/main/careagents)\n  as the consumer surface.\n\n**Why archived** (recorded honestly in\n[#12](https://github.com/aks129/SmartHealthConnect/issues/12)): ~39 of the ~40\nMCP tools here bypassed the HealthClaw engine, contradicting the one claim the\nplatform is built on — guardrails live server-side, in one place. The ideas\nwere right; maintaining two data planes with one maintainer was not.\n\nThe Claude-plugin skills installed from this repo\n(`smarthealthconnect@healthclaw-marketplace`) remain installable — archived\nrepos stay clonable — but are frozen at v1.2.0. New capability lands in\nCareAgents.\n\n---\n\n# SmartHealthConnect (Liara AI Health)\n\nThe patient-facing surface of the HealthClaw platform.\n\n**v1.2.0** — now reads wearable signals (Garmin, Oura, Polar, Suunto, Whoop, Fitbit, Strava) sourced from [HealthClaw Guardrails](https://github.com/aks129/HealthClawGuardrails) v1.3.0. Still routes through the Compiled Truth engine from v1.1.0.\n\n## New in v1.2.0 — Wearable signals\n\nWhen HealthClaw's `OPEN_WEARABLES_URL` is configured, wearable data arrives as FHIR Observations with LOINC codes and device Provenance. The existing `healthy-habits`, `diet-exercise`, and `medication-refills` skills read them through the same `fhir_search` they already use — no new tools in this repo. Each skill's `SKILL.md` now lists the LOINC codes worth knowing.\n\n## Engine / surface contract\n\nSmartHealthConnect **does not** own data, policy, or the canonical record.\n\n- **Engine** — [HealthClaw Guardrails](https://github.com/aks129/HealthClawGuardrails) owns the FHIR store, PHI redaction, audit trail, step-up auth, tenant isolation, and the **Compiled Truth** primitive (current state + Provenance timeline for every resource).\n- **Surface** — this repo owns the 6 patient skills (`healthy-habits`, `care-completion`, `medication-refills`, `diet-exercise`, `kids-health`, `research-monitor`), the React client, and the conversational patterns.\n\nEvery skill that makes a resource-specific claim to the patient must call the `get_compiled_truth` MCP tool first — it proxies to HealthClaw's `fhir_compiled_truth` and returns the current redacted resource + an append-only evidence timeline. See each skill's `SKILL.md` for the rule. Configure with `HEALTHCLAW_MCP_URL=http://localhost:3001/mcp/rpc` (or your deployed URL).\n\n`.health-context.yaml` at the repo root declares `role: surface` and names HealthClaw as the engine. Mirrored in the engine repo.\n\n## Overview\n\nSmartHealthConnect enables patients to connect their healthcare providers and view their complete health records in one secure platform. The application uses SMART on FHIR standards for interoperability and delegates guardrail enforcement to HealthClaw.\n\n## Features\n\n- **SMART on FHIR Integration** - Connect to Epic, Cerner, and other FHIR-enabled healthcare systems\n- **Unified Health Dashboard** - View conditions, medications, lab results, and vital signs in one place\n- **AI Health Insights** - Get personalized health recommendations and care gap identification\n- **Trend Visualization** - Track vital signs over time with interactive charts\n- **White-Label Ready** - Enterprise solution with customizable branding\n\n## Tech Stack\n\n- **Frontend**: React 18, TypeScript, Vite, Tailwind CSS, shadcn/ui\n- **Backend**: Express.js, TypeScript\n- **Database**: PostgreSQL with Drizzle ORM\n- **Authentication**: Passport.js with session management\n- **FHIR**: SMART on FHIR R4 protocol\n\n## Getting Started\n\n### Prerequisites\n\n- Node.js 18+\n- PostgreSQL database\n\n### Installation\n\n```bash\n# Install dependencies\nnpm install\n\n# Set up environment variables\ncp .env.example .env\n# Edit .env with your DATABASE_URL and other config\n\n# Push database schema\nnpm run db:push\n\n# Start development server\nnpm run dev\n```\n\n### Environment Variables\n\n- `DATABASE_URL` - PostgreSQL connection string\n- `OPENAI_API_KEY` - OpenAI API key for AI features (optional)\n\n## Development\n\n```bash\n# Run development server\nnpm run dev\n\n# Type check\nnpm run check\n\n# Build for production\nnpm run build\n\n# Start production server\nnpm start\n```\n\n## Production Deployment\n\nThe application can be deployed to any Node.js hosting platform:\n\n```bash\n# Build production assets\nnpm run build\n\n# Set environment variables\nexport DATABASE_URL=\"postgresql://...\"\nexport OPENAI_API_KEY=\"sk-...\"  # Optional\nexport NODE_ENV=\"production\"\n\n# Start server\nnpm start\n```\n\nThe server runs on port 5000 by default and serves both the API and static frontend assets.\n\n## Project Structure\n\n```\n├── client/           # React frontend\n│   └── src/\n│       ├── components/   # UI components by feature\n│       ├── pages/        # Route components\n│       ├── hooks/        # Custom React hooks\n│       └── lib/          # Utilities and config\n├── server/           # Express backend\n│   ├── routes.ts         # API routes\n│   ├── fhir-client.ts    # SMART on FHIR integration\n│   └── ai-service.ts     # OpenAI integration\n├── shared/           # Shared types and schemas\n└── migrations/       # Database migrations\n```\n\n## Contributing\n\nWe're actively looking for:\n\n- **Beta Testers** - Help us refine the user experience\n- **Collaborators** - Developers, designers, and healthcare professionals\n- **Health System Partners** - Enterprise deployments and integrations\n\n## License\n\nProprietary - All rights reserved.\n\n## Contact\n\nFor partnership inquiries or to join the beta program, please reach out through the platform.\n",
  "bytes": 6392,
  "sha": "61bce633223ca95fdecd440e0127cea6608c56e10adbeda389e147752ae09d60",
  "repo_slug": "aks129/smarthealthconnect",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_aks129_smarthealthconnect_smarthealthcon_28fbb9d5/readme"
}