How anoor3/crosswalk works
Crosswalk’s intended product workflow is to discover an unfamiliar API, profile its sample data, map fields to a canonical model, validate and review proposals, generate and test an adapter, then monitor for drift and propose repairs. The implemented runtime evidence here covers canonical models, OpenAPI discovery, profiling, and mock claims APIs; mapping and later lifecycle stages are documented but not implemented in the sampled source, so those links reflect documentation rather than inspected calls.
Main entry points: analyzer.py OpenAPI Discovery · engine.py Value Profiling · mapping Field Mapping · catalog.py API Catalog
Components 20
API Inputs
- Mock Claims APIs
apps/mock_apis/src/crosswalk_mock_apis - Seed Claims
apps/mock_apis/src/crosswalk_mock_apis/seed_data.py
Discovery and Profiling
- OpenAPI Discovery
packages/discovery/src/crosswalk_discovery/analyzer.py - Reference Resolution
packages/discovery/src/crosswalk_discovery/refs.py - Schema Flattening
packages/discovery/src/crosswalk_discovery/flatten.py - API Catalog
packages/discovery/src/crosswalk_discovery/catalog.py - Value Profiling
packages/profiler/src/crosswalk_profiler/engine.py - Value Extraction
packages/profiler/src/crosswalk_profiler/extract.py - Field Profiles
packages/profiler/src/crosswalk_profiler/profile.py
Mapping and Review
- Canonical Model
packages/canonical/src/crosswalk_canonical - Field Mapping
packages/mapping - Candidate Validation
packages/mapping - Human Review
packages/mapping
Adapter Lifecycle
- Adapter Generation
packages/adapters - Sandbox Testing
packages/runtime - Integration Runtime
packages/runtime - Drift Detection
packages/drift - Repair Proposal
packages/drift
Other components
- Integration Engineer
- Customer API
Connections 24
- Seed Claims → Mock Claims APIs: supplies facts
- Integration Engineer → Customer API: provides API
- Customer API → OpenAPI Discovery: provides OpenAPI
- OpenAPI Discovery → Reference Resolution: resolves refs
- OpenAPI Discovery → Schema Flattening: flattens schemas
- OpenAPI Discovery → API Catalog: produces catalog
- Customer API → Value Profiling: provides samples
- API Catalog → Value Profiling: guides profiling
- Value Profiling → Value Extraction: extracts values
- Value Profiling → Field Profiles: produces profiles
- API Catalog → Field Mapping: documents fields
- Field Profiles → Field Mapping: supplies evidence
- Canonical Model → Field Mapping: defines targets
- Field Mapping → Candidate Validation: proposes candidates
- Field Profiles → Candidate Validation: checks against data
- Candidate Validation → Human Review: presents findings
- Integration Engineer → Human Review: confirms mapping
- Human Review → Adapter Generation: approves mapping
- Adapter Generation → Sandbox Testing: generates tests
- Sandbox Testing → Integration Runtime: clears for deployment
- Integration Runtime → Drift Detection: observes API
- Drift Detection → Repair Proposal: proposes repair
- Repair Proposal → Human Review: requests approval
- Mock Claims APIs → Customer API: simulates API