Implementation module map
Generated from module docstrings and public definitions. The three scientific stages remain independently callable; CLI/orchestration only compose them.
| Module | Responsibility | Public functions and classes |
|---|---|---|
| adapters | Local mock transport and an honest, unavailable external MESA boundary. | AccessClient, MESAClient, MockMESAClient |
| agents | Bounded, deterministic local stand-ins for future OpenClaw workers. | DiscoveryAgent, SemanticAgent, HarmonizationAgent, QAAgent |
| asset_registry | Local immutable metadata index and content-addressed representation blobs. | AssetRegistry, restore_snapshot |
| cli | CLI for reproducible fixture runs, independent stages, schema and review. | main |
| consensus | Bounded specialist dialogue over metadata; no source-data reader is accepted. | negotiate |
| contracts | Immutable, validated inter-module contracts. JSON schemas are exportable. | digest, Contract, EvidenceKind, SemanticEvidence, ConceptCandidate, SourceSemantics, Support, Rights, Variable, Metadata, ScientificRequest, SourceResource, DiscoveryCandidate, DiscoveryResult, SemanticMapping, Operation, Proposal, AgentReview, recipe_content_digest, BackendOperation, HarmonizationRecipe, QAReport, HumanDecision, RawObservation, ProvenanceRecord, HarmonizedObservation, Representation, TrackConfig |
| cube_contracts | Backend-neutral cube metadata contracts; external arrays never serialize here. | ResourceGuards, CubeInput, CubeConfiguration, TransformationChanges, TransformationResult, TransformationBackend, CubeOption, CubeCapabilitySpace |
| cube_demo | Generated Sentinel-like windows → reviewed harmonization → real CubeDynamics → MOSAIKS. | context, patches, run, alignment_example |
| cube_ir | Closed CubeDynamics selections reuse the existing decision IR and scientific recipe. | capabilities, selection_schema, compile_decision |
| cube_specs | Inspected external capabilities; metadata only, no CubeDynamics import or code copy. | definitions |
| cubedynamics_backend | Bounded adapter to external ESIIL CubeDynamics; never accepts Python from a model. | CubeError, CubeProduct, context_digest, validate_step, CubeDynamicsBackend, transform_raster_window, require_frozen_consensus |
| decision_experiment | Inert decision experiments. Model outputs are never executable or approvals. | InertProse, Decision, decision_schema, scientific_evaluate, evaluate_response, summarize |
| decision_ir | Declarative model decisions over caller-frozen capabilities; no source-data access. | SelectDecision, ParameterizeDecision, SemanticMappingProposal, RecipeDecision, ModelDecisionProvenance, ExecutionResult, CapabilityOption, CapabilitySpace, build_capabilities, decision_schema, resolve_decision, compile_decision, process_output, execute_approved, FixtureDecisionModel, DecisionBindingProposal, DecisionRecipeDraft, binding_capabilities, validate_mapping_proposal, draft_schema, request_model_decision |
| discovery | Discovery knows requirements and source contracts, never encoders. | relevant, run |
| embedding_dataset | Streaming MOSAIKS dataset publication and bounded downstream verification. | write_dataset, verify_dataset, predict_vectors |
| harmonization | Scientific review and allow-listed deterministic execution, independent of MESA. | assess, authorize, run, transformed_uncertainty |
| harmonized_rasters | Bounded raster assembly from immutable harmonization outputs, never raw DN. | RasterContext, authorize_context, assemble_patch, harmonize_window |
| management | Compose scientific artifacts, local release prototypes, resource plans and recovery. | import_dataset, prepare_release, record_feedback, seed_management, unresolved_review, scale_probe, export_metadata, demo |
| management_contracts | Operational metadata contracts; registration never grants scientific authority. | BlobReference, ArtifactRecord, ProductDefinition, ServiceDefinition, AllocationPlan, WorkspaceDefinition, UsageMeasurement, FeedbackIssue, DatasetEntry, ReleaseEntry, PreservationResult, ScaleProbe |
| model_agents | Real model-backed bounded roles. Models see evidence and emit JSON only. | source_evidence, CandidateChoice, SemanticJudgment, RecipePlan, Critique, AgentTrace, OllamaBackend, ModelDiscoveryAgent, ModelSemanticAgent, ModelHarmonizationAgent, ModelQAAgent, propose_snapshot |
| mosaiks | MOSAIKS empirical random convolutional features over harmonized raster outputs. | MOSAIKSSpec, HarmonizedRasterPatch, file_digest, array_digest, validate_patch, target_schema_digest, MOSAIKSEncoder |
| mosaiks_pipeline | Thin composition: approved harmonization stream → MOSAIKS → dataset. | RasterLayout, encoder_contract, plan_rasters, run, demo |
| neon | Authenticated official NEON data-file access, without guessing sensor support. | NEONClient |
| network | Bounded HTTP transport; no credential values in persisted request evidence. | AccessError, CredentialRedirectGuard, request_bytes, request_json |
| openclaw_backend | OpenClaw llm-task transport using the isolated Verde runtime. | OpenClawBackend |
| openclaw_runtime | Isolated, version-matched OpenClaw + Verde runtime management. | read_verde_settings, runtime_config, start_runtime, stop_runtime, runtime_status |
| operation_demo | Explicit synthetic end-to-end trust-boundary demonstration; no live inference/access. | run |
| operations | Closed, versioned operation library. No model code, imports or expressions execute. | OperationDefinition, OperationRegistry, execution_identity, convert, execute_check |
| orchestration | Thin composition of discovery, harmonization and representation modules. | load_track, write, run |
| provenance | PROV-inspired JSON-LD 1.1 export; no graph service or network resolution. | export |
| real_data | Actual STAC discovery/windowed Sentinel reads and auditable local snapshots. | EvidenceFile, Snapshot, save_snapshot, SnapshotClient, acquire_sentinel, read_sentinel_pixel |
| representations | Local modality-specific scalar encoders with explicit preprocessing. | run, batches |
| review | Deterministic synthesis of evidence-bound specialist findings. | source_set_digest, synthesize, validate_qa_references |
| review_contracts | Versioned evidence-first review contracts, separate from legacy dialogue votes. | Domain, Status, Evidence, ReviewFinding, SpecialistReview, ReviewReport, RunManifest |
| science | A descriptive fixture comparison, never evidence of predictive performance. | summarize |
| scientific_validation | Offline scientific metadata experiments; no execution/approval authority. | validate_assertion, breadth, coverage_benchmark, graph_metrics, resource_edges, dataset_diagnostics |
| scoped_review | Independently callable metadata review; the backend has no source-access tools. | ReviewBundle, QASynthesis, review_metadata |
| semantic_benchmark | Bounded, offline metadata diagnostics; never scientific equivalence or ontology adoption. | BenchmarkConfig, read_metadata_json, compute, run |
| semantic_discovery | Module 1: preserve declared semantics and retrieve candidates; never approve mappings. | source_metadata_digest, normalized_evidence, stac_evidence, enrich |
| semantic_resources | Validated landscape inventory and portal-independent concept-candidate retrieval. | SemanticResource, AssessmentContent, ResourceAssessment, load_inventory, load_assessments, NamespaceBinding, ConceptRecord, SemanticResolver, SemanticResourceRegistry |
| storage | Content-addressed immutable JSON artifacts shared safely between tracks. | cached |
| stream_contracts | Metadata control plane and bounded streaming data plane contracts. | StreamBinding, EncoderSpec, StreamPlan, StreamSample, AgentMessage, SpecialistFinding, ReviewVote, RecipeBindingProposal, RecipeDraft, ConsensusReport |
| stream_rasters | Upstream native raster access → reviewed harmonization output stream. | sentinel_harmonized_tiles |
| stream_sources | Metadata-only Sentinel planning and lazy native-pixel access without snapshots. | validate_assets, plan_sentinel, validated_native, sentinel_samples |
| streaming | Backpressured window → harmonization → encoder → JSONL sink. | preflight, stream_embed |
| workbench | Loopback-only operator workbench; no model execution, approvals or remote writes. | feature_rows, api, byte_range, server, serve |
Start with the architecture and audit for stage boundaries, live versus mocked status and concrete debt.