npm package: @rhart696/framework
Description: Canadian Healthcare Equity Value Framework - Mathematical Foundation Fixed
Latest version: 1.1.0

# @rhart696/framework

Healthcare equity value assessment framework for Canadian healthcare enterprises.

## Overview

The CHEEV Framework is a comprehensive assessment and strategy generation toolkit designed for consulting teams working with healthcare organizations. It provides standardized schemas, validation logic, and AI-powered analytics for evaluating and improving equity value.

## Features

###  Currently Implemented (v1.1.0)

- **Assessment Schemas**: Zod-based validation schemas for healthcare assessments
- **Data Types**: TypeScript types for assessments, roadmaps, and strategy planning
- **Market Position Constants**: Standardized market position categorization
- **Roadmap Types**: Type-safe roadmap and task structures
- **AI Insights**: Genkit-powered document analysis and insight generation
- **File Utilities**: Helper functions for file handling and data URI conversion

### =� Planned for Future Releases

- **Assessment Scoring**: Multi-category scoring algorithms with industry benchmarks
- **Strategy Generation**: Recommendation engine based on assessment results
- **Analytics Engine**: Advanced calculations and progress tracking
- **PDF Export**: Generate client-facing reports and deliverables
- **Template System**: Pre-built assessment and roadmap templates

## Installation

```bash
npm install @rhart696/framework
```

## Usage

### Assessment Schema

```typescript
import { assessmentFormSchema, type AssessmentFormInput } from "@rhart696/framework";

// Validate assessment data
const assessmentData: AssessmentFormInput = {
  companyName: "Healthcare Corp",
  financialHealth: 7,
  operationalEfficiency: 8,
  marketPosition: "challenger",
  growthStrategy: "Geographic expansion into underserved markets"
};

const result = assessmentFormSchema.safeParse(assessmentData);
```

### AI Insights

```typescript
import { generateInsights, fileToDataURI } from "@rhart696/framework";
import { ai } from "./your-genkit-config";

// Convert file to data URI
const file = await fetch("/path/to/document.pdf").then(r => r.blob());
const dataUri = await fileToDataURI(file as File);

// Generate insights
const insights = await generateInsights(
  {
    documentDataUri: dataUri,
    query: "What are the key financial metrics in this assessment?"
  },
  ai
);

console.log(insights.insights);
```

### Roadmap Types

```typescript
import { type RoadmapColumn, defaultRoadmapColumns } from "@rhart696/framework";

// Use default roadmap structure
const roadmap: RoadmapColumn[] = defaultRoadmapColumns;

// Or create custom columns
const customRoadmap: RoadmapColumn[] = [
  {
    id: "planning",
    title: "Planning",
    tasks: [
      { id: "1", content: "Stakeholder interviews" }
    ]
  },
  // ... more columns
];
```

## Project Structure

```
src/
 assessment/
    scoring.ts              # Scoring algorithms (planned)
    validation.ts           # Validation schemas
    analytics.ts            # AI-powered insights
 strategy/
    roadmap-builder.ts      # Roadmap types and defaults
    recommendation-engine.ts # Strategy generation (planned)
 data/
    types.ts                # Core TypeScript types and schemas
    schemas/                # Additional schema definitions
 export/
    pdf-generator.ts        # PDF export utilities (planned)
    templates/              # Export templates
 index.ts                    # Main package exports
```

## Dependencies

- `zod` (^3.24.2) - Schema validation
- `genkit` (optional) - AI flow integration

## Development Status

**Version**: 1.1.0
**Status**: Early Development

This package is in active development. Core types and schemas are stable, but scoring algorithms and strategy generation features are planned for future releases.

## Roadmap

### Phase 1: Foundation (v1.0-1.1) 
- Core type definitions
- Assessment and roadmap schemas
- AI insights integration

### Phase 2: Scoring Engine (v1.2-1.3) =�
- Multi-category scoring algorithms
- Industry benchmark data
- Progress tracking comparisons

### Phase 3: Strategy Generation (v1.4-1.5) =�
- Recommendation engine
- Task prioritization logic
- Template system

### Phase 4: Export & Analytics (v1.6-1.7) =�
- PDF generation
- Advanced analytics
- Custom report templates

## Contributing

This is an internal framework under active development. Core implementations should be validated with real client data before being added to the package.

## License

See LICENSE file for details.

## Support

For questions or issues, please contact the CHEEV Framework development team.