Export merge operations and update roadmap

Add Phase 3 merge functionality to public API:
- Export MergeOptions, MergeResult, and related types
- Update README with merge operations in Phase 3
- Add merge example to Quick Start
- Mark index management as implemented

Phase 3 Progress:
- ✅ mergeNode() - Upsert nodes with conflict resolution
- ✅ mergeEdge() - Upsert edges with properties
- ✅ createIndex() - Custom index creation
- ✅ dropIndex() - Index removal
- ✅ listIndexes() - Index introspection
- 🚧 Tests needed for merge operations

Note: Merge operations are implemented but need comprehensive tests
before being marked production-ready.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

Author: michaeloboyle

README.md

@@ -62,6 +62,12 @@ const similarJobs = db.traverse(job.id)
 // Shortest path
 const path = db.traverse(job.id)
   .shortestPath(anotherJob.id);
+
+// Merge operations (upsert)
+const { node, created } = db.mergeNode('Company',
+  { name: 'TechCorp' },  // Match criteria
+  { industry: 'SaaS', size: 'Large' }  // Properties to set
+);
 ```
 
 ## Installation
@@ -148,11 +154,14 @@ See [SPARC-DEVELOPMENT.md](docs/SPARC-DEVELOPMENT.md) for detailed methodology d
 - [x] Path enumeration (paths() wrapper)
 - [x] Integration tests (13 integration tests)
 
-### Phase 3: Advanced Features
+### Phase 3: Advanced Features (In Progress)
+- [x] Merge operations (mergeNode, mergeEdge)
+- [x] Index management (createIndex, dropIndex, listIndexes)
+- [ ] Merge operation tests
 - [ ] All paths finding
 - [ ] Pattern matching
 - [ ] Bulk operations
-- [ ] Export/import
+- [x] Export/import (implemented in Phase 1)
 
 ### Phase 4: Documentation
 - [ ] API documentation

src/index.ts

@@ -40,6 +40,17 @@ export type {
   GraphExport
 } from './types';
 
+// Merge operation types
+export type {
+  MergeOptions,
+  EdgeMergeOptions,
+  MergeResult,
+  EdgeMergeResult,
+  MergeConflictError,
+  MergePerformanceWarning,
+  IndexInfo
+} from './types/merge';
+
 // Utility functions (for advanced usage)
 export { serialize, deserialize, timestampToDate, dateToTimestamp } from './utils/serialization';
 export {