First commit.

Author: jakesciotto

.claude/CLAUDE.md

@@ -0,0 +1,77 @@
+# Oracle OCI AnyCost Adaptor Project
+
+## Project Overview
+This project is an adaptation of the CloudZero AnyCost Stream example specifically for Oracle OCI (Oracle Cloud Infrastructure). The goal is to create an adaptor that can retrieve cost data from Oracle OCI and transform it into CloudZero's Common Bill Format (CBF) for ingestion into CloudZero's platform.
+
+## What We've Done
+
+### Initial Setup (2025-08-26)
+1. **Repository Creation**: 
+   - Cloned the original CloudZero anycost example from https://github.com/jakesciotto/cloudzero-anycost-example
+   - Created local repository at `/Users/jake.sciotto/Documents/github/oracle-oci-anycost-adaptor`
+
+2. **Codebase Analysis**:
+   - Examined the main adaptor script (`anycost_example.py`) - 322 lines of Python code
+   - Reviewed the README.md documentation 
+   - Analyzed example data structure in `example_cloud_provider_data/`
+   - Current implementation processes CSV files for:
+     - Usage data (`cloud_usage.csv`)
+     - Purchase commitments (`cloud_purchase_commitments.csv`) 
+     - Discounts (`cloud_discounts.csv`)
+
+3. **Project Planning**:
+   - Created comprehensive todo list with 7 tasks
+   - Identified high-priority tasks: OCI API integration, data processing adaptation
+   - Medium priority: documentation updates, example data creation, testing
+   - Low priority: git repository initialization
+
+## Current Repository Structure
+```
+oracle-oci-anycost-adaptor/
+├── .claude/                    # Project memory (new)
+├── .github/                    # GitHub workflows
+├── anycost_example.py         # Main adaptor script (to be adapted for OCI)
+├── cbf/                       # CBF output directory
+├── example_cloud_provider_data/  # Sample data files
+│   ├── cloud_usage.csv
+│   ├── cloud_purchase_commitments.csv
+│   └── cloud_discounts.csv
+├── tests/                     # Test suite
+├── README.md                  # Documentation (needs OCI updates)
+└── other files...
+```
+
+## Next Steps (Todo List)
+1. **High Priority**:
+   - Research Oracle OCI cost data structure and API endpoints
+   - Update script to integrate with Oracle OCI SDK for cost data retrieval
+   - Adapt data processing functions for OCI cost data format
+
+2. **Medium Priority**:
+   - Update README documentation for OCI-specific setup and usage
+   - Create OCI-specific example data files
+   - Update tests for OCI-specific functionality
+
+3. **Low Priority**:
+   - Initialize new git repository with OCI-specific changes
+
+## Key Technical Details
+
+### Current Implementation
+- **Language**: Python 3.9+
+- **Dependencies**: requests, csv, json modules
+- **Data Flow**: CSV files → CBF transformation → CloudZero API upload
+- **Supported Operations**: replace_drop, replace_hourly, sum
+- **Batch Processing**: Supports multiple months upload
+
+### OCI Adaptation Requirements
+- **API Integration**: Need to integrate Oracle OCI SDK for Python
+- **Authentication**: OCI config file and API key management
+- **Cost Data Sources**: Usage reports, billing data from OCI
+- **Data Mapping**: Transform OCI cost structure to CBF format
+
+## Project Context
+- **Original Source**: CloudZero anycost stream example
+- **Target Cloud**: Oracle OCI
+- **Purpose**: Cost data integration with CloudZero platform
+- **Scope**: Complete adaptor for OCI cost management

requirements.txt

@@ -0,0 +1,3 @@
+requests>=2.25.0
+oci>=2.129.0
+python-dateutil>=2.8.0