مرجع واجهة البرمجة

تُجمَّع واجهة البرمجة العامة بحسب التوزيعة. استورد من أضيق نطاق أسماء يملك السلوك المطلوب. القوائم أدناه تعكس صادرات نطاق الأسماء العام الحالية حتى يتمكن القارئ من مراجعة سطح الاستيراد المدعوم دون قراءة ملفات __init__.py الخاصة بالحزم.

📦 التوزيعة الجذرية

استخدم dispatchatlas.version للحصول على سطح إصدار الحزمة الجذرية الخفيف:

• __version__

🧱 النواة

dispatchatlas.core هي حدّ الحزمة الداخلي. تصدّر كائنات المجال، والتحقق، وأصل المنشأ، والتسلسل، والبذرة، ونظام الملفات، والتسجيل، وعقود البروتوكول.

عقود التهيئة:

• FoundationConfig
• SeedPolicy
• SerializationFormat
• ValidationMode

عقود الأخطاء:

• DataQualityError
• DispatchAtlasError
• DomainValidationError
• InfeasibleScheduleError
• MissingOptionalDependencyError
• ProvenanceError
• ScheduleValidationError
• SeedDerivationError
• SerializationContractError
• UnsupportedCapabilityError
• require_finite — يُرجع القيمة بعد تحويلها إلى عدد عشري منتهٍ أو يرفع عقد الخطأ المعطى عندما تكون NaN أو لا نهائية.
• require_non_negative_int — يُرجع العدد الصحيح أو يرفع عقد الخطأ المعطى عندما يكون سالبًا.
• require_positive_int — يُرجع العدد الصحيح أو يرفع عقد الخطأ المعطى عندما لا يكون موجبًا.
• require_text — يُرجع النص بعد إزالة الفراغات أو يرفع عقد الخطأ المعطى عندما يكون فارغًا.

مساعدات نظام الملفات:

• read_text_resilient
• safe_child_directory
• safe_directory_name
• safe_namespaced_id
• write_json_artifact
• write_json_artifact_atomic
• write_text_artifact
• write_text_artifact_atomic

إمكانية المراقبة (التسجيل المركزي):

• get_logger
• make_formatter
• console_handler
• file_handler
• scoped_logging
• configure_root_logging
• MESSAGE_FORMAT
• CONSOLE_FORMAT
• STRUCTURED_FORMAT
• DEFAULT_DATEFMT
• ROOT_LOGGER_NAME

عقود بيان الحملة:

• CampaignCheckpointManifest
• CampaignFailureRecord
• CampaignRunRecord
• campaign_checkpoint_from_jsonable
• campaign_checkpoint_to_jsonable
• campaign_failure_record_from_jsonable
• campaign_failure_record_to_jsonable
• campaign_run_record_from_jsonable
• campaign_run_record_to_jsonable

عقود نموذج الجدولة:

• Assignment
• Constraint
• ConstraintKind
• Dependency
• DependencyKind
• Duration
• Metadata
• Objective
• ObjectiveSense
• ObjectiveValue
• ParityBasis
• ProblemId
• ProblemSpec
• ResourceAmount
• ResourceId
• ResourceRequirement
• ResourceSpec
• Schedule
• ScheduleResult
• ScheduleStatus
• TaskId
• TaskMode
• TaskSpec
• TimePoint
• metadata_items

بروتوكولات التكامل:

• AnalysisExporter
• BenchmarkDescriptor
• BenchmarkProvider
• DisclosureLabel
• DisclosurePolicy
• ExperimentPlan
• ExperimentResult
• ExperimentRunner
• ResultRepository
• Solver
• SolverDescriptor
• SolverRun

عقود أصل المنشأ:

• ArtifactHash
• CitationStatus
• EnvironmentStamp
• EvidenceClass
• PackageRecord
• Provenance
• QualityGateStatus
• SeedLineage
• SourceReference
• hash_bytes
• utc_now

عقود البذرة:

• MAX_SEED
• SEED_DOMAIN_SEPARATOR
• Seed
• SeedStream
• derive_seed

عقود التسلسل:

• ArtifactEnvelope
• canonical_json_bytes
• dumps_envelope
• envelope_artifact
• envelope_from_jsonable
• envelope_to_jsonable
• environment_from_jsonable
• environment_to_jsonable
• loads_envelope
• problem_from_jsonable
• problem_to_jsonable
• provenance_from_jsonable
• provenance_to_jsonable
• schedule_from_jsonable
• schedule_to_jsonable

عقود التحقق:

• ValidatedProblem
• ValidationIssue
• ValidationReport
• ValidationSeverity
• ValidationStamp
• collect_problem_issues
• collect_schedule_issues
• validate_problem
• validate_schedule

ثوابت تحجيم النواة:

• DEFAULT_CPU_RESERVE — وحدات المعالجة المحجوزة عن مجمّع العمال افتراضيًا.
• DEFAULT_MEMORY_RESERVE_FRACTION — نسبة ذاكرة النظام المحفوظة احتياطيًا افتراضيًا.
• OBJECTIVE_FAMILY — السجل الذي يربط كل نوع هدف بتعريفه القانوني.

تزامن المضيف:

• available_cpu_count / available_system_memory_bytes — وحدات المعالجة المتاحة لهذه العملية وأفضل تقدير لذاكرة النظام المتاحة.
• maximal_safe_worker_count — أقصى عدد آمن من العمال المتوازين للمضيف.

نموذج المتصل (الحافة–الضباب–السحابة):

• ComputeTier — طبقة حوسبة متصلة (الحافة، الضباب، السحابة) مع سعتها الإجمالية.
• NetworkTopology / NetworkLink — نسيج الاتصال وروابطه الموجَّهة بين الطبقات.
• Bandwidth / DataVolume — إنتاجية رابط موجبة بالبايت في الثانية وبيانات قابلة للنقل غير سالبة بالبايت.
• PlacementAffinity — تفضيل مهمة لهدف وضع على المتصل.

نموذج التكلفة (R||Cmax، الاتصال، التنفيذ المعتمد على الحمل، الإعداد المعتمد على التسلسل):

• CostModel / cost_model_from_jsonable / cost_model_to_jsonable — حزمة نموذج التكلفة المرتبطة بمسألة عبر معرّف، وتسلسلها.
• ExecutionTimeMatrix / ExecutionTimeEntry / execution_matrix_from_iterable — مصفوفة زمن التنفيذ للآلات غير المترابطة (p_ij).
• CompatibilityMask — مجموعة أهلية المهمة-للآلة الصريحة.
• CommunicationModel / CommunicationLink — جزاءات الاتصال عبر الموارد على رسم بياني متناثر.
• LoadModel / LoadModelKind / LoadBreakpoint — منحنى التنفيذ المعتمد على الحمل واستيفاؤه بين نقاط الانكسار.
• SetupMatrix / SetupEntry / SetupReferenceKind — أزمنة الإعداد المعتمدة على التسلسل المفهرسة بالانتقال والآلة.

عائلة الأهداف:

• ObjectiveKind / ObjectiveDefinition / objective_definition — أهداف الجدولة المسماة وبياناتها الوصفية القانونية.
• ObjectiveReduction / VectorObjectiveValue — قاعدة التحويل إلى قيمة قياسية ومتجه متعدد الأهداف مقيس مع بيانات وصفية للإفصاح.
• vector_objective_from_jsonable / vector_objective_to_jsonable — تسلسل المتجه متعدد الأهداف.

تقييم الأهداف:

• evaluate_objective / evaluate_objectives / ObjectiveEvaluation — تقييم هدف مسمى واحد أو كل هدف على جدول.
• MultiObjectiveOutcome / computed_vector / multi_objective_outcome_from_jsonable — الأهداف القياسية والمتجهية إضافةً إلى الجدوى لجدول واحد.
• EvaluationStatus / objective_sense — ما إذا حُسبت قيمة أو أُجِّلت، واتجاه تحسين الهدف.

الجدوى والقيود:

• FeasibilityReport / build_feasibility_report — صفوف الانتهاكات الصارمة إضافةً إلى محاسبة جزاءات القيود اللينة.
• InfeasibleRow / SoftConstraintPenalty — انتهاك صارم واحد مرئي للمراجع وجزاء قيد لين موزون واحد.
• ServiceLevelConstraint / ServiceLevelOutcome / evaluate_service_level / evaluate_service_level_over_schedule / resolve_metric — قيود مستوى خدمة مسماة على مقياس جدول وتقييمها.
• ConstraintViolationSummary / summarize_constraints — محاسبة مجمّعة للقيود الصارمة واللينة وقيود مستوى الخدمة.

جبهة باريتو ومؤشرات الجودة:

• dominates / to_minimization — هيمنة باريتو تحت التصغير والتحويل بين الاتجاهات المختلطة.
• fast_non_dominated_sort / non_dominated_front / non_dominated_indices — الترتيب غير المهيمَن لـ NSGA-II والمجموعة غير المهيمَنة.
• FrontierPoint / LabelledPoint / frontier_data — متجهات الأهداف الموسومة والسجلات الجاهزة للجبهة.
• hypervolume / igd_plus / additive_epsilon_indicator / spread — مؤشرات الجودة الأربعة: الحجم الزائد، وIGD+، وإبسيلون الجمعي، وانتشار أقرب الجيران.
• QualityIndicatorReport / quality_indicator_report — المؤشرات الأربعة جميعها لجبهة واحدة مقابل مجموعة مرجعية.

المتانة:

• PerturbationScenario / PerturbationSet — سيناريوهات اضطراب مسماة لهدف واحد.
• RobustnessAggregation / RobustnessValue / evaluate_robustness — كيفية تجميع مجموعة اضطراب في رقم متانة مع أساسها المذكور.

بيانات التشغيل:

• RunTiming / ResourceUsage / SolverCounters — توقيت زمن الساعة والتوقيت اللحظي، وذروة استخدام الموارد، وعدّادات جهد الحلّال لتشغيل واحد.
• ConvergenceSample / TimedObjectiveSample — قيم الأهداف المرصودة عند عدد تكرار وعند إزاحة زمن ساعة.

الإنهاء:

• TerminationPolicy — سياسة إيقاف حلّال متعددة المعايير وقابلة للتركيب.

أمان نظام الملفات:

• safe_path_under_root — مسار يُرجَع فقط عندما يُحلّ تحت جذر مُصرَّح به.

تسلسل المتصل:

• bandwidth_from_jsonable / bandwidth_to_jsonable
• compute_tier_from_jsonable / compute_tier_to_jsonable
• data_volume_from_jsonable / data_volume_to_jsonable
• network_link_from_jsonable / network_link_to_jsonable
• network_topology_from_jsonable / network_topology_to_jsonable
• placement_affinity_from_jsonable / placement_affinity_to_jsonable

🧪 المعايير القياسية

dispatchatlas.bench تصدّر كتالوجات المعايير القياسية، ومولّدات العائلات العامة والمتصلة، والبيانات الوصفية للمولّد، والتجسيد، والتحقق من الاستشهادات، والتوصيف، ومقاييس الصعوبة ومسافة التوزيع، والانتقاء، والتنزيل، وعقود التصنيف.

عقود الكتالوج:

• StaticBenchmarkProvider
• benchmark_provider_for_selectors
• build_feasibility_diagnostic_catalog
• build_full_catalog
• build_smoke_catalog
• full_benchmark_provider
• full_catalog_configs
• smoke_benchmark_provider
• smoke_catalog_configs

عقود التوصيف:

• CharacterizationMetrics
• CharacterizationReport
• characterize_problem

عقود الاستشهاد:

• CitationClaim
• CitationMatrix
• SourceKind
• default_citation_matrix
• validate_citation_matrix

عقود المولّد:

• BenchmarkGenerator
• DagWorkflowGenerator
• GeneratorRegistry
• IndependentTaskGenerator
• cloud_edge_profile
• default_registry
• workflow_profile

عقود التجسيد:

• BenchmarkInstance
• BenchmarkInstanceSet
• CatalogManifest
• CatalogManifestEntry
• config_to_jsonable
• manifest_to_jsonable
• materialize_benchmark
• materialize_with_generator
• write_instance_set

عقود البيانات الوصفية:

• BenchmarkConfig
• DomainProfile
• GeneratorMetadata
• ScaleSpec

عقود العائلة العامة:

• CostModelGenerator
• GenericFamilyGenerator
• flexible_job_shop_generator
• flow_shop_generator
• generic_family_full_configs
• generic_family_generators
• generic_family_smoke_configs
• job_shop_generator
• machine_scheduling_generator
• rcpsp_generator
• setup_flow_shop_generator

عقود العائلة المتصلة:

• ContinuumFamilyGenerator
• ContinuumFamilySpec
• ContinuumScenario
• ContinuumStratum
• DistinctivenessRecord
• build_continuum_catalog
• build_continuum_full_catalog
• continuum_family_distinctiveness
• continuum_family_full_configs
• continuum_family_generators
• continuum_family_smoke_configs
• continuum_family_specs

عقود الصعوبة:

• HardnessAxis
• HardnessSpec
• hardness_axis
• hardness_axis_registry
• measured_communication_compute_ratio
• measured_deadline_slack_ratio
• measured_dependency_density
• measured_duration_cv
• measured_fabric_churn
• measured_offload_deception
• measured_release_stagger

عقود مسافة التوزيع:

• MAX_DISTRIBUTION_DISTANCE
• DistributionDistanceBridge
• DistributionDistanceScore
• DistributionDistanceStatus
• default_distribution_distance_bridges
• metrics_from_instance_set
• per_feature_wasserstein
• distribution_distance_score
• validate_distribution_distance_bridge

عقود الانتقاء:

• DifficultyStratum
• SubsetCriteria
• difficulty_score
• difficulty_stratum
• instance_family
• instance_profile_class
• select_benchmark_subset
• stratify_instances

عقود البيانات الوصفية للكتالوج والتنزيل:

• CATALOG_SCALAR_COLUMNS
• CatalogInstanceMetadata
• DownloadFormat
• catalog_instance_metadata
• catalog_instance_to_jsonable
• catalog_instance_to_row
• catalog_metadata_for_instances
• catalog_metadata_for_sets
• catalog_subset_from_bundle
• catalog_subset_from_csv
• catalog_subset_from_json
• catalog_subset_to_bundle
• catalog_subset_to_csv
• catalog_subset_to_json
• select_catalog_metadata
• serialize_catalog_subset

عقود التصنيف:

• DEFAULT_TAXONOMY
• BenchmarkTaxonomy
• BenchmarkTier
• ConstraintFeature
• DynamismFeature
• EnvironmentDomain
• InfrastructureRealism
• ObjectiveFeature
• ProfileClass
• SchedulingFamily
• SchedulingStructure
• UncertaintyFeature

عقود سجلّ طقم النسخ المرجعية:

• InstanceCountStatus
• ReferenceSuite
• SuiteFormat
• default_reference_suites
• reference_suite
• validate_reference_suites

عقود الحل الأفضل-المعروف:

• BestKnownIngest
• BestKnownKind
• BestKnownRegistry
• BestKnownValue
• load_best_known
• load_best_known_registry

عقود استيعاب النسخة المعيارية:

• SUPPORTED_FORMATS
• ParseContext
• ParsedInstance
• ReferenceSuiteGenerator
• load_reference_suite
• parse_fjs
• parse_standard_jsp
• parse_taillard_pfsp
• parse_wfformat_json
• reference_suite_config
• reference_suite_distribution_distance_bridge

🧮 الحلّالات

dispatchatlas.solve تصدّر البيانات الوصفية للحلّال، والسجلات، والأسس البنّاءة، وما وراء الاستدلال، ومتغيرات NDSO، والعوامل، والمحوّلات الاختيارية، ومساعدات التحليل الزمني.

عقود الأساس والتنفيذ:

• DispatchRule
• DispatchingSolver
• OrderRunRequest
• TerminationTracker — المُقيِّم ذو الحالة، الأول-في-الإطلاق، الذي يطوي تقدّم حلقة البحث في TerminationPolicy ويُبلّغ عن المعيار الذي أوقف التشغيل.
• baseline_solvers
• neh_order — ترتيب البناء بالإدراج NEH (Nawaz–Enscore–Ham).

عقود البيانات الوصفية للحلّال:

• DependencyRequirement
• SolverCapability
• SolverDescriptorSpec
• SolverFamily
• SolverMetadata
• Stochasticity

عقود ما وراء الاستدلال:

• MetaheuristicKind
• PermutationMetaheuristicSolver
• PermutationSearchConfig
• metaheuristic_solvers

عقود جدولة القوائم القائمة على الرتبة:

• ListSchedulingRank
• ListSchedulingSolver
• list_scheduling_solvers
• heft_profile — جدولة قوائم بالرتبة الصاعدة (HEFT).
• cpop_profile — جدولة قوائم بالرتبة الصاعدة+الهابطة المجموعة (CPOP).
• peft_profile — جدولة قوائم بجدول التكلفة المتفائل (PEFT).

عقود قاعدة التخطيط لمجموعة-الجاهزية:

• MappingRule
• MappingRuleSolver
• mapping_rule_profile
• mapping_rule_solvers — قواعد الدفعة min-min وmax-min وsufferage.

عقود المنافس متعدد الأهداف بجبهة باريتو:

• NSGA2Config
• NSGA2Solver
• MOEADConfig
• MOEADSolver
• nsga2_profile
• moead_profile
• multi_objective_solvers
• crowding_distances — مقدّر كثافة مسافة-الازدحام لـ NSGA-II.
• nsga2_environmental_selection — بقاء نخبوي بالرتبة-ثم-الازدحام.
• tchebycheff — دالة التقييس Tchebycheff لـ MOEA/D.

عقود الجشع المتكرر:

• ITERATED_GREEDY_RS_CITATION
• IteratedGreedyRSConfig
• IteratedGreedyRSSolver — تهيئة الهدم–البناء المعيارية لورش التدفق الترتيبية.
• iterated_greedy_rs_profile
• iterated_greedy_rs_solvers

عقود تابو المسار الحرج:

• CriticalPathTabuConfig
• CriticalPathTabuSolver
• critical_path_tabu_profile
• critical_path_tabu_solvers
• critical_pairs — مولّد جوار الأزواج المتجاورة للمسار الحرج.

عقود جدولة المشاريع (SGS التسلسلي):

• SerialSGSJustificationSolver — توليد جدول تسلسلي بتسويغ مزدوج لجدولة المشاريع المقيّدة بالموارد.
• serial_sgs_justification_profile
• serial_sgs_justification_solvers
• double_justified_order — مرور التسويغ الخلفي–الأمامي.
• latest_finish_order — ترتيب أولوية أحدث-زمن-إنهاء.

عقود NDSO:

• NDSOAblation
• NDSOMechanisms
• NDSOSolver
• NDSOVariant
• ndso_ablation_catalog
• ndso_solvers

عقود عوامل الجدولة:

• BatchScoreResult
• ScheduleMetrics
• adjacent_swap_neighbor
• batch_score_orders
• construct_schedule
• earliest_finish_task_order
• local_search_order
• normalize_task_order
• objective_values_for
• random_topological_task_order
• repair_schedule
• schedule_metrics
• score_order
• score_schedule
• topological_task_order

عقود المحوّل الاختياري:

• OptionalExactSolver
• optional_solvers
• ortools_dependency

عقود الأداء:

• BatchScoringProfile
• ProfiledResult
• profile_call

عقود السجل:

• ProfiledSolver
• SolverRegistry
• default_solver_registry

ثوابت ضبط الحلّال:

• NATIVE_EXACT_TASK_CAP — سقف عدد المهام الذي يفشل فوقه الحلّال الدقيق الأصلي فشلًا مغلقًا.
• RUN_COUNT_FLOOR — الحد الأدنى لعدد التشغيلات المتكررة الذي تتطلبه المقارنة العادلة.
• VELOCITY_WINDOW — نافذة سرعة التحسّن التي يراقبها المتحكم اللحظي.
• IMPROVEMENT_FLOOR — الحد الأدنى للتحسّن النسبي الذي يُحتسب تقدّمًا.
• FEATURE_ORIGIN — مقياس منصة المعايير القياسية الذي تُشتق منه كل سمة انتقاء.

عائلات التوزيع الأساسية:

• DispatchingFamilySpec — عائلة توزيع مسماة مرتبطة بقاعدة أولوية حتمية.
• RetiredFamily / RetirementReason / retired_dispatching_families — عائلات مسماة نُحّيت عمدًا، كلٌّ مع مسوّغها.

المنافسون المنوّعون (حقل ما وراء الاستدلال المسمى):

• CompetitorKind / CompetitorSolver / CompetitorConfig — منافسون مسمّون مع معاملات بحث مقيّدة مشتركة.
• competitor_solvers / diversified_competitors — مجموعة المنافسين المنوّعة والمدركة للإفصاح.
• post_2020_currency_anchor — مراجع مرتكز الحداثة لما بعد 2020 للحقل.
• recent_peer_strength_bar — النظراء الحديثون المحتفظ بهم تحت عتبة قوة المكان.

المُحسِّنات المتصلة (المفكوكة على الترتيب المنفصل):

• clpso_optimize / CLPSOConfig — تحسين سرب الجسيمات بالتعلّم الشامل.
• lshade_optimize / LSHADEConfig — تطور تفاضلي تكيّفي بسجل النجاح مع تقليص خطّي للمجتمع.
• EncodedSolverKind / EncodedAdapterSolver / encoded_adapter_solvers — العائلة المتصلة المرتبطة بمحوّل ترميز منفصل.
• ContinuousResult / SearchBudget — نتيجة تشغيل متصل وميزانيته من حيث التكرار والعشوائية وزمن الساعة.

الترميز من المتصل إلى المنفصل:

• EncodingAdapter / encoding_adapter / encoding_adapter_catalog — ترميزات مسماة من المتصل إلى المنفصل مع إصلاح صريح.
• DecodeRule / DecodeOutcome — القاعدة التي تحوّل متجه مفاتيح محوَّلًا إلى ترتيب مهام، ونتيجتها المُصلَحة.
• RepairPolicy — السياسة التي تستعيد جدوى الأسبقية بعد فك الترميز.
• TransferFunction — دالة الضغط التي تربط مكونًا متصلًا بإشارة انتقاء.

الحلّالات الدقيقة:

• ExactMethod / ExactSolver — طرائق دقيقة مسماة ومحوّل يفشل فشلًا مغلقًا عند غياب الخلفية أو الإدخال المفرط الحجم.
• ExactAdapterSpec / exact_adapter_specs / exact_solvers — عقود محوّل الحلّال الدقيق المجمّعة.

المنافس متعدد الأهداف الكثيف (NSGA-III):

• NSGA3Solver / NSGA3Config / nsga3_solvers / nsga3_profile — منافس NSGA-III على ترتيبات آمنة الأسبقية.
• nsga3_reference_points — نقاط Das & Dennis المرجعية المنظَّمة على المُبسَّط الوحدوي.
• nsga3_environmental_selection — انتقاء التنحية بنقاط NSGA-III المرجعية.

متغيرات الجدولة العلمية:

• SchedulingVariantKind / PermutationSchedulingVariantSolver / SchedulingVariantConfig — متغيرات هجينة علمية مسماة على ترميز الترتيب المنفصل.
• scheduling_variant_solvers — أسس متغيرات الجدولة من الدرجة الأولى.

انتقاء الخوارزمية:

• RuleBasedSelector — أساس على المعايير القياسية فقط يرتّب المرشحين من البيانات الوصفية وحدها.
• SupervisedSelector — مُنتقٍ متعلَّم حتمي بأقرب جار موزون بالمسافة.
• SelectionFeature / SelectionFeatures / feature_origin — سمات التوصيف المسماة التي يستهلكها المُنتقي وأصلها.
• SelectionLabel / SolverRecommendation / RecommendationSource — أمثلة تدريب موسومة وتوصيات مرتبة مع الثقة والحدود.

التحقق المتبادل للمُنتقي (تعميم خالٍ من التسرّب):

• cross_validate / GeneralizationReport — تعميم على بيانات محتجزة بترك-عائلة-واحدة على مجموعة بيانات.
• leave_one_family_out / partition_by_families / TrainTestSplit — تقسيمات تدريب/اختبار منفصلة العائلات.
• held_out_generalization — التدريب على نصف التدريب من التقسيم والإبلاغ عن دقة المرتبة-الأولى على نصف اختباره.
• leakage_report / LeakageReport — التداخلات في النسخة والعائلة وسجل التوصيف التي يجب أن يبقيها التقسيم الخالي من التسرّب فارغة.
• validated_supervised_selector — مُنتقٍ تعكس ثقته تعميمه على البيانات المحتجزة.

واجهات التعلّم والهجينة (اختيارية، تفشل فشلًا مغلقًا):

• LearningInterfaceKind / LearningInterface / learning_interface / learning_interface_catalog — واجهات تعلّم وهجينة مسماة مع الحالة والسياسة والاحتياط.
• InterfaceStatus / LearningEvidencePolicy — حالة دورة الحياة وعقد الأدلة الذي يعلنه كل سطح من هذه الأسطح.
• ConfidenceLabel / confidence_rank — الثقة التي قد تحملها التوصية وقوتها الرتبية.
• learning_backend_available / learning_dependency / require_learning_backend — خلفية التعلّم الاختيارية (إضافة، لا افتراض أبدًا) وخطأ الاعتماد المفقود المُنمَّط الخاص بها.

البيانات الوصفية للحلّال والاستشهادات:

• Citation / CitationStatus — مرجع تأسيسي قانوني (أو مسوّغ صريح لعدم الانطباق) وما إذا كانت العائلة تحمل واحدًا.
• SolverEncoding — ترميز الحل الذي يبحث فيه الحلّال أو يبني عليه.
• SUMMIT_EVIDENCE_LABEL — وسم سياق الإفصاح للبيانات الوصفية والأدلة والصادرات.

سطح عائلة NDSO:

• NDSOFamilySolver — السطح المشترك لكل حلّال من عائلة NDSO، سربًا واحدًا كان أم مجلسًا.
• fast_mechanisms — مجموعة الآليات الثابتة للتركيب السريع.

آليات NDSO (البناء بالصلاحية-بالتصميم):

• PrecedenceIndex / precedence_index — مجموعات السوابق وترتيب مهام مستقر يستخدمه كل بنّاء.
• GuidanceSource / GuidanceContext / select_guidance — مصادر التوجيه الثلاثية الثلاثة ومدخلات البناء المشتركة للمرشح.
• guided_construction — بناء مرشح مجدٍ من ترتيب توجيهي.
• confidence_weighted_elite — صياغة النخبة بالتصويت الموزون بالثقة.
• ConfidenceMatrix / consolidate_confidence / latent_archive — الثقة المتعلَّمة لكل خلية، وتوحيدها عبر الأسراب، والخلايا الواثقة التي هجرتها النخبة.
• quality_guidance / quantity_update / BetaSchedule — قاعدتا الجودة والكمية لـ والمعامل التكيّفي الموحّد.
• rank_reward — مكافأة مشتقة من الرتبة في [0, 1].

مجلس NDSO بين-الأسراب:

• NDSOSummitSolver / summit_solver / summit_profile / SummitConfig — المجلس بين-الأسراب، تركيب الجودة للعائلة.
• CouncilTopology — طوبولوجيا التبادل بين-الأسراب التي تصل أسراب المجلس.
• SummitDiagnostics — ملخص تنسيق المجلس غير القابل للتغيير المرفق بتشغيل.

عزل آلية NDSO:

• AblationEntry / ablation_map — عزل واحد منفصل لكل آلية قانونية.
• build_ablation_solver / run_ablation_suite / AblationRunResult — بناء وتشغيل كل عزل منفصل مقيّد بالجدوى.
• ABLATION_STATISTICAL_PLAN / StatisticalTestPlan — الاختبارات الإحصائية المسماة في طبقة التحليل التي تستخدمها مقارنة العزل.

تحكم NDSO اللحظي:

• AnytimeController / AnytimeReport — متحكم الإنهاء المبكر بسرعة التحسّن وسجل نشاطه.

تشخيصات NDSO:

• DiagnosticsCollector / DiagnosticsSnapshot — مسجّل تقارب اختياري عديم العبء-عند-التعطيل وملخصه.
• IterationTrace — سجل تقارب تكرار واحد.
• population_diversity — متوسط عدم-اتفاق المواقع الزوجي في [0, 1].

إفصاح NDSO (بوّابة آلية تفشل فشلًا مغلقًا):

• MechanismDescriptor / mechanism_descriptor / mechanism_catalog — آليات مسماة وأرضية الإفصاح التي تنتمي إليها كل منها.
• DisclosureFilter / DisclosureViolationError — البوابة التي تفشل فشلًا مغلقًا على أي الآليات قد يكشفها نطاق تقرير.
• ReportScope / EvidenceProgram — نطاقات تقرير مرحلية وبرامج الأدلة المرحلية الأربعة المربوطة بأرضية إفصاح.
• base_disclosure_filter / program_disclosure_filter — مرشحات النطاق-الأساس ولكل-برنامج التي تفشل فشلًا مغلقًا.
• blocks_summit_evidence — ما إذا كان مرشح برنامج يحجب أرضية الجودة الخاصة-بالمجلس.

🚀 الحملات

dispatchatlas.lab تصدّر تهيئة الحملة القابلة للتكرار، والميزانية، والبيئة، والمستودع، والفشل، وعقود التنفيذ.

عقود الميزانية:

• CampaignBudgetReport
• dry_run_campaign

عقود التهيئة:

• FULL_CAMPAIGN_BLOCKER
• BudgetScaling
• CampaignConfig
• CampaignPlan
• CampaignRunSpec
• CampaignStage
• ExecutionMode
• FailureCategory
• OutputPolicy
• ResourceBudget
• RetryPolicy
• campaign_config_hash
• config_to_jsonable
• plan_to_jsonable

عقود البيئة:

• capture_campaign_environment

عقود الأخطاء:

• BudgetEstimationError
• CampaignConfigError
• CampaignExecutionError
• CheckpointRecoveryError
• EnvironmentCaptureError

عقود المستودع:

• CampaignResultIndex
• CheckpointManifest
• FailureRecord
• FileResultRepository
• RunRecord

عقود المُشغِّل:

• CampaignRunner
• classify_failure
• default_campaign_runner
• resume_campaign
• run_campaign
• validate_campaign

تهيئة الحملة:

• CampaignKind — صنف تصميم التجربة الذي تحققه الحملة.
• StoppingProtocol / StoppingProtocolKind — بروتوكول إيقاف مسمى قابل للإبلاغ عنه باستقلال لتقرير حلّال عشوائي.
• RunCountPolicy / STATISTICAL_POWER_FLOOR — سياسة عدد التشغيلات وأدنى عدد مكررات يُعلَّم تحته تشغيل الحلّال بأنه ناقص القوة.
• TuningBudget — ميزانية الضبط المتساوية لكل خوارزمية التي تُبقي المقارنة عادلة.
• campaign_config_from_jsonable — إعادة ترطيب تهيئة حملة مُتحقَّق منها من بيانات متوافقة مع JSON.

تحليل عدد التشغيلات:

• ReplicateResolution / resolve_replicates — عدد المكررات المُحلّ لحلّال، مع أي علم ناقص-القوة، تحت سياسة عدد التشغيلات.

ثابت المقارنة العادلة:

• assert_fair_comparison — التحقق من الشروط البنيوية المسبقة لثابت المقارنة العادلة.
• fair_comparison_manifest — صفوف البيان التي تسجّل ضمان المقارنة العادلة.

إعدادات المحرّك (تحليل من أربع طبقات مختوم بأصل المنشأ):

• EngineSettings / resolve_engine_settings — مقابض المحرّك المُحلّة عبر طبقات التهيئة الأربع، كل حقل مختوم بأصل منشئه.
• ResolvedSetting / SettingSource — قيمة إعداد واحد مقترنة بالطبقة التي زوّدتها.
• apply_environment_overrides — تركيب طبقة البيئة فوق تهيئة حملة من ملف أو من موضع الاستدعاء.

طوبولوجيا العمال والتجميع:

• WorkerTopology / topology_for_plan / probe_capacity — طوبولوجيا العمال المحترمة للميزانية المختارة لحملة بعد سبر سعة المضيف.
• AggregateManifest / merge_only_aggregation — تجميع حتمي بالدمج-فقط لسجلات التشغيل المكتملة في تجزئة حملة واحدة مستقرة البتّات.

أطلس التجارب:

• ExperimentAtlas / default_experiment_atlas — أطلس مدرك للإفصاح من مسارات الأدلة المملوكة.
• EvidenceTrack — شريحة أدلة مملوكة واحدة في أطلس التجارب.

مصفوفة انطباق عائلة-المعايير-القياسية على الحلّال:

• ApplicabilityMatrix / default_applicability_matrix — مصفوفة انطباق عائلة-المعايير-القياسية على الحلّال الكاملة، مشتقّة من السجلات الحيّة ثم مُعلَّقة بجدول التجاوز.
• ApplicabilityCell — بيان انطباق (benchmark family, solver) واحد يحمل حالته ومسوّغه ومؤشّر دليل اختياري.
• ApplicabilityStatus — تعداد حالة كل-خلية: مُتحقَّق / تقريبي / غير-منطبق.
• ApplicabilityEvidence / ApplicabilityEvidenceKind — مؤشّر دليل آمن-للبوابة (حملة أو استشهاد أو اختبار) وصنف أصله.
• ApplicabilityOverride / default_applicability_overrides — ترقية يدوية واحدة قابلة للمراجعة لخلية مشتقّة، وجدول التجاوز داخل-الشيفرة حيث تعيش الخلايا المُتحقَّقة.
• SchedulingFamilyCell — تجميع عائلة-جدولة على الحلّال واحد يجمع خلايا عائلة-المعايير-القياسية المكوّنة.
• derive_applicability_cell — اشتقاق خلية تقريبية-أو-غير-منطبقة واحدة من بيانات وصفية مُعلَنة.
• constraint_capability_bridge — الجسر المُنمَّط من ميزة-القيد إلى وسم-القدرة (مصدر حقيقة واحد).
• ApplicabilityScreen / screen_campaign_applicability — فحص جداء حملة مخطّطة إزاء المصفوفة، مع الإبلاغ عن الأزواج المحجوبة والتقريبية والمُتحقَّقة.

📊 التحليل

dispatchatlas.analytica تصدّر تصفية الإفصاح، والاستيعاب، والملخصات الإحصائية، وكتّاب جداول Markdown الحتميين، وست عشرة عائلة رسم بياني كلٌّ منها مُصيَّر بصيغة مزدوجة (SVG قابل للتنسيق وPGFPlots .tex قابل للتحرير)، وحزم الأدلة، ومجموعات بيانات البوابة.

عقود الإفصاح:

• DisclosureExclusion
• DisclosureFilterResult
• DisclosurePolicy
• EvidenceTier
• default_disclosure_policy
• ensure_dataset_allowed
• filter_dataset

عقود التصدير:

• ExportBundle
• evidence_bundle_directory
• write_evidence_bundle
• write_portal_dataset

عقود الاستيعاب:

• PlanRunFacts
• load_campaign_dataset
• load_result_dataset

عقود النموذج:

• AnalysisConfig
• AnalysisDataset
• AnalysisSummary
• CampaignManifest
• CorrectionMethod
• ExportSurface
• FailureObservation
• ObjectiveObservation
• PairwiseComparison
• RankEntry
• RunObservation
• SolverSummary

العقود الإحصائية:

• bootstrap_mean_interval
• cliffs_delta
• cohens_d
• paired_cohens_dz
• paired_observation_counts
• summarize_dataset
• two_sided_sign_test

عقود الجداول:

• ablation_table_markdown
• arpd_markdown
• benchmark_table_markdown
• constraints_table_markdown
• ensure_effect_sizes_beside_p_values
• infeasible_rows_markdown
• multiobjective_indicators_markdown
• optimality_gap_table_markdown
• pairwise_comparison_markdown
• portal_csv
• ranking_markdown
• sensitivity_table_markdown
• solver_summary_markdown

عقود التصوير (تُصيَّر كل عائلة رسم بياني بصيغة SVG قابلة للتنسيق وPGFPlots .tex قابلة للتحرير):

• ablation_svg · ablation_tex
• characterization_svg · characterization_tex
• convergence_svg · convergence_tex
• critical_difference_svg · critical_difference_tex
• data_profile_svg · data_profile_tex
• ecdf_svg · ecdf_tex
• exploration_exploitation_svg · exploration_exploitation_tex
• frontier_svg · frontier_tex
• performance_profile_svg · performance_profile_tex
• ranking_svg · ranking_tex
• robustness_svg · robustness_tex
• run_order_trend_svg · run_order_trend_tex
• runtime_quality_svg · runtime_quality_tex
• scalability_svg · scalability_tex
• sensitivity_svg · sensitivity_tex
• stability_svg · stability_tex

عقود المقارنة:

• ComplexityRow
• EvidenceCaveat
• EvidenceCaveatScope
• HeadToHeadComparison
• HeadToHeadRow
• complexity_table_markdown
• evidence_caveats_markdown
• head_to_head_comparison

الاستدلال وأحجام الأثر (اختبار دلالة حتمي خالٍ من الاعتماديات):

• friedman_test / FriedmanResult — اختبار Friedman الشامل للرتب على خوارزميات متعددة.
• FriedmanOutcome — اختبار Friedman الشامل للرتب على كامل حقل الحلّالات.
• nemenyi_critical_difference / CriticalDifference — فرق Nemenyi الحرج لكل الأزواج لمتوسط الرتب.
• wilcoxon_signed_rank / WilcoxonResult — اختبار Wilcoxon ذو الرتب الموقّعة ثنائي الجانب للفروق المزدوجة.
• bayesian_sign_test / BayesianSignTestResult — اختبار الإشارة البييزي مع منطقة التكافؤ العملي على الفروق المزدوجة.
• bayesian_signed_rank_test / BayesianSignedRankResult — اختبار الرتب الموقّعة البايزي بعملية Dirichlet مُبذَّرة مع منطقة التكافؤ العملي على الفروق المزدوجة.
• vargha_delaney_a12 / interpret_a12 — حجم أثر Vargha-Delaney A12 ووسم مقداره.
• bca_bootstrap_interval / BootstrapInterval — فترة ثقة التمهيد المصحَّحة-بالانحياز والمسرَّعة.
• standard_normal_cdf / standard_normal_ppf — دالة التوزيع التراكمي ودالة الكمّ للتوزيع الطبيعي القياسي.
• chi_square_sf — احتمال الذيل العلوي (البقاء) لمربع كاي.
• detectable_effect_size / required_paired_count / PowerAssessment — أصغر أثر مزدوج معياري قابل للكشف عند عدد تشغيلات، ومعكوسه.
• ArpdRow / arpd_rows — متوسّط الانحراف بالنسبة المئوية لكل حلّال إزاء قيم مرجعية أفضل-معروفة يُورِّدها المُستدعي بأصل صريح.
• ensure_equal_budgets — تحقّق يفشل إلى الإغلاق من بروتوكول الميزانية-المتساوية المُقاسة-بالحجم.

سجل طرائق التحليل (انتقاء طريقة يفشل فشلًا مغلقًا):

• AnalysisMethod / method_registry / method_by_id — طرائق مسماة مع افتراضاتها وأرضيات إفصاحها.
• AnalysisFamily / methods_in_family — عائلات الطرائق وعضويتها.
• MethodSupport / evaluate_support — حكم الدعم الذي يفشل فشلًا مغلقًا لطريقة على حجم عينة معطى.
• MethodLimitation — طريقة مسماة غير مدعومة موجَّهة إلى سطح الحدود.
• STATISTICAL_POWER_FLOOR — الحد الأدنى لحجم العينة الذي تفشل تحته الطرائق ناقصة القوة فشلًا مغلقًا.

أطر التحليل (أطر الصفوف والسلاسل المساعدة التي يصيّرها مستهلك شكل أو جدول):

• AnalysisFrames — حزمة الأطر المساعدة لمجموعة بيانات واحدة.
• BenchmarkRow / benchmark_rows — تغطية كل-نسخة-معيار-قياسي عبر حقل الحلّالات.
• CharacterizationRow / characterization_rows — واصفات صعوبة كل-مسألة من الانتشار المرصود.
• ConstraintRow — صف محاسبة قيد واحد على مجموعة البيانات.
• ConvergenceSeries / convergence_series — آثار أفضل-هدف لكل حلّال بحسب التكرار.
• DataProfileSeries / data_profile_series — حصّة الخلايا المحلولة إلى دقّة هدف ضمن ميزانية مجموعات-التقييم لكل حلّال لشكل ملمح-البيانات.
• DiversitySeries / diversity_series — آثار تنوّع-المجتمع لكل حلّال بحسب التكرار لشكل توازن الاستكشاف-الاستغلال.
• InfeasibleRunRow / infeasible_rows — التشغيلات المكتملة غير المجدية والفشل المسجّل الموجَّهة إلى الملاحق.
• OptimalityGapRow / optimality_gap_rows — فجوات الأمثلية لكل (مسألة، حلّال) مقابل الحدود المرجعية.
• RobustnessPoint / robustness_points — مخاطر الذيل CVaR + أسوأ-حالة لكل حلّال على مجموعة الأهداف لشكل المتانة.
• RuntimeQualityPoint / runtime_quality_points — رصدات زمن-التشغيل-الجودة لشكل زمن-التشغيل-الجودة.
• ScalabilitySeries / scalability_series — آثار متوسط-زمن-التشغيل-بحسب-مقياس-النسخة لكل حلّال لشكل قابلية التوسّع.
• SensitivityPoint — متوسط مستوى-معامل واحد لمسح حساسية.
• StabilityPoint / stability_points — استقرار-البذرة لكل حلّال (متوسط معامل التباين) لشكل الاستقرار.
• AblationRow — نتيجة عزل-آلية واحدة مقابل التهيئة الكاملة.

مؤشرات متعددة الأهداف:

• MultiObjectiveIndicatorRow / multiobjective_indicators — مؤشرات الجودة المسماة الأربعة لجبهة تقريب كل حلّال.
• MultiObjectiveIndicatorReport / multiobjective_indicator_report — صفوف المؤشّرات إلى جانب النقطة المرجعية المشتركة المؤرشَفة التي أنتجتها.
• ReferencePointRule / ReferencePointRecord — قواعد اشتقاق النقطة المرجعية والسجل المؤرشَف بمفردات أصله التي تفشل إلى الإغلاق.
• ensure_shared_reference_points — فحص يفشل إلى الإغلاق أن المُنتَجات المُقارَنة تشترك في نقطة مرجعية مؤرشَفة واحدة.
• quality_indicator_method_ids — معرّفات طرائق السجل التي يحسبها هذا السطح من البداية إلى النهاية.

مقارنة المنصات (أدلة القدرة ومسافة التوزيع):

• PlatformComparison / platform_comparison_markdown — مجموعات صفوف مقارنة المنصات الأربع وMarkdown الخاص بها.
• RivalFrameworkRow / rival_framework_markdown — مقارنة القدرة مقابل إطار منافس.
• FeatureRichnessRow / feature_richness_markdown — مصفوفة تغطية الميزات.
• DistributionDistanceRow / distribution_distance_markdown — تقييم جسر مسافة التوزيع لكل عائلة معايير قياسية.
• ArtifactInspectionRow / artifact_inspection_markdown — أدلة فحص القطع الناتجة في البوابة.
• EvidenceSource — كيفية دعم ادعاء صف مقارنة المنصات.

سقالة التقارير وبوابات الادعاء والتنقيح:

• ReportScaffold / ReportScaffoldSpec / ReportProfile / ReportSection / CANONICAL_SECTION_ORDER / write_report_scaffold — سقالات تقارير حتمية، مرتبطة بالمصدر، ومصفّاة بالإفصاح.
• ClaimGate / ClaimGateKind / ClaimGateState / ClaimGateOutcome / evaluate_claim_gate — ادعاءات تقرير مبوّبة بالأدلة وأحكام ترقيتها.
• ContributionMatrix / ContributionRow / ContributionOverlap / contribution_partition — تقسيم مساهمات عديم التداخل عبر طبقات الأدلة.
• RedactionFinding / redaction_report / assert_redaction_clean — مسح سطح عام مرشح بحثًا عن المصطلحات المحظورة وتسرّبات عبر-الطبقات.
• ReproducibilityBadge — هدف شارة قابلية التكرار وكيفية إيفاء فهرس القطع الناتجة به.
• MaintenanceLedgerEntry / maintenance_ledger_markdown — أسطح التوسعة المستقبلية التي يجب ألا تُضعف حدّ الإفصاح.

بيان قابلية التكرار:

• ReproducibilityManifest / build_reproducibility_manifest / reproducibility_manifest_markdown — حقائق قابلية التكرار لكل تشغيل ومستند Markdown الخاص بها.
• FIGURE_GENERATORS — سجل مولّدات الأشكال التي يسجّلها البيان.

مسرد الحلّالات (سطح تسمية خالٍ من الاستعارة):

• SOLVER_OPERATIONAL_DESCRIPTIONS / solver_operational_description — الوصف التشغيلي الخالي من الاستعارة لكل حلّال.
• SOLVER_EQUIVALENCE_NOTES / solver_equivalence_note — ملاحظة التكافؤ مع الخوارزمية المعروفة لكل حلّال.
• INSPIRATION_DOMAIN_TERMS / metaphor_terms_in — جرد مصطلحات مجال الإلهام والكشف عنها.

سجلات أسماء العرض:

• BENCHMARK_DISPLAY_NAMES / benchmark_display_name — أسماء العرض المسجّلة لمعرّفات المعايير القياسية.
• SOLVER_DISPLAY_NAMES / solver_display_name — أسماء العرض المسجّلة لمعرّفات الحلّالات.
• ABLATION_DISPLAY_NAMES / ablation_display_name — أسماء العرض لمتغيرات عزل-الآلية.
• benchmark_instance_label — وسم عرض يُبقي هوية النسخة مرئية.
• UnknownDisplayNameError — يُرفع عندما لا يكون لمعرّف اسم عرض مسجّل.

طبقات الأدلة:

• Tier / tier / TIER_REGISTRY — طبقات الأدلة العامة وأين قد تظهر أدلة كل طبقة.
• UnknownTierError — يُرفع عندما لا يكون لمعرّف طبقة مدخل سجل.

سمة الأشكال:

• FigureTheme / DEFAULT_THEME — الألوان وأنماط الخطوط وعرض اللوحة القابلة للتحكم خارجيًا والمشتركة عبر كل عائلة رسم بياني.