Psionic Framework-Core Acceptance Matrix

April 3, 2026 ยท View on GitHub

Status: canonical framework-core acceptance doc, updated 2026-03-16 after widening scripts/release/check-psionic-framework-core-acceptance.sh from a representative runner into the full PLIB-107 broad-coverage gate with a machine-readable JSON report contract in docs/framework_core_acceptance_report.schema.json.

Psionic can now make several higher-level claims:

  • it has local and clustered serving acceptance matrices
  • it has typed train benchmark acceptance
  • it has substantial runtime, cluster, datastream, sandbox, and train substrate

Those claims are real, but they are not the same thing as saying Psionic is close to Tinygrad-class ML framework completion on the actual framework core.

This document defines that narrower bar.

It is about crates/psionic-* only. It does not widen MVP product scope in docs/MVP.md, and it does not move ownership boundaries out of docs/OWNERSHIP.md.

Canonical Runner

Run the framework-core matrix from the repo root:

scripts/release/check-psionic-framework-core-acceptance.sh

Write the machine-readable acceptance artifact for release or CI attachment:

scripts/release/check-psionic-framework-core-acceptance.sh \
  --report /tmp/psionic-framework-core-acceptance.json

Targeted entrypoints:

scripts/release/check-psionic-framework-core-acceptance.sh --only tensor-semantics
scripts/release/check-psionic-framework-core-acceptance.sh --only autodiff-optimizer
scripts/release/check-psionic-framework-core-acceptance.sh --only model-state-io
scripts/release/check-psionic-framework-core-acceptance.sh --only compiler-realize
scripts/release/check-psionic-framework-core-acceptance.sh --only memory-cache
scripts/release/check-psionic-framework-core-acceptance.sh --only replay-identity
scripts/release/check-psionic-framework-core-acceptance.sh --only local-multi-device

The runner is intentionally honest about remaining boundaries:

  • it executes the full documented validation hooks for each category rather than one representative proof
  • it prints explicit refusal or implemented-early notes when a category is real but still intentionally bounded
  • it can emit a machine-readable JSON report whose shape is fixed by docs/framework_core_acceptance_report.schema.json
  • it does not treat serving or train acceptance as a substitute for framework-core closure

Why This Matrix Exists

The current acceptance program already distinguishes:

  • product-class serving acceptance
  • serving-topology acceptance
  • train benchmark acceptance

What was missing was a separate answer to:

what does Psionic need before reviewers can claim it is approaching Tinygrad-class completeness on the core tensor/compiler/runtime framework, independent of product serving or train orchestration?

That answer has to name both the shipped foundations and the still-open holes.

Claim Split

Claim familyWhat it answersWhat it does not answer
Framework-core acceptancewhether Psionic has the core tensor/compiler/IO/replay/runtime substrate needed to be called a serious ML frameworkit does not prove serving product closure or train product closure
Product-class serving acceptancewhether Psionic can honestly claim portability, throughput-serving, or structured-agent serving envelopesit does not prove framework-core autodiff, reusable optimizer, or local multi-device closure
Train benchmark acceptancewhether the current train substrate meets typed performance thresholdsit does not prove general framework-core completeness or full autodiff closure

If a future issue tries to close one of these claim families with evidence from another, that issue is wrong by definition and should update this document first.

Status Legend

  • implemented_early: there is a real foundation with runnable validation hooks, but the category is not broad enough yet to justify a sweeping parity claim.
  • partial: some of the category is real, but one or more central framework pieces remain open and must stay explicit.

Cross-library refusal truth is now explicit too: psionic-core owns the canonical PsionicRefusal taxonomy, and graph, autodiff, runtime, topology, and sandbox seams now adapt into that shared type instead of inventing new shadow refusal records for the same unsupported families.

Matrix

CategoryCurrent statusWhat a green category would meanCurrent repo truthCanonical hooksOpen gap / refusal discipline
Tensor semanticsimplemented_earlytyped tensor identity, shape/layout transforms, alias-preserving view rules, storage identity and view posture contracts, broadcast-compatible binary shape semantics, reduction shape rules, bounded advanced-dtype promotion/cast/backend-capability semantics, bounded autocast-style precision-policy semantics, bounded quantization capability semantics, and quantized payload containers behave deterministically enough to anchor compiler and IO layerspsionic-core now owns explicit broadcast, dtype-promotion, dtype-class, quantized-logical-storage, layout storage-span, alias/view-semantic rules, a bounded advanced-dtype semantics report above the compact runtime-core subset, one bounded autocast precision-policy matrix with backend-aware numerics diagnostics and typed refusal posture, and one bounded quantization capability matrix that separates PTQ, QAT, compiler, export-aware, and runtime-execution semantics from raw decode; psionic-runtime now exposes a backend-visible BufferStorageContract, and psionic-ir lowers broadcasted binary ops through explicit expand views instead of backend-only coincidencepsionic-core, psionic-runtime, psionic-ir, and psionic-backend-cpu tensor-semantics testsKeep the category honest: the shared semantics are now explicit, but this is still not a blanket claim that every backend already executes every advanced dtype, mixed-precision policy, quantization workflow, or advanced storage family
Autodiff and optimizer behaviorimplemented_earlyreverse-mode autodiff, detach semantics, training-mode gradient rules, broad current primitive-family coverage, reusable optimizer families, and bounded mixed-precision gradient-scaling behavior are all machine-checkable and not hidden inside one training looppsionic-ir now owns autodiff-aware graph construction, an explicit gradient-support matrix, symbolic backward plans, dense reference materialization, full current primitive-family gradient regression tests, and typed refusal across current backend-extension families, while psionic-train owns the reusable optimizer, distributed-optimizer contracts, and a bounded gradient-scaling semantics report for fp16 overflow/underflow handling plus bf16 no-scaling posturepsionic-ir autodiff tests plus psionic-train integration, optimizer, distributed-optimizer, and gradient-scaling testsKeep the category honest: the current primitive-family surface is broadly covered, but backend-extension gradients still refuse explicitly, mixed-precision training remains bounded to seeded fp16/bf16 cases, and later operator families remain outside this runner
Model and state IOimplemented_earlymodel weights, optimizer state, adapter deltas, tokenizer bindings, manifest receipts, local data-ingress contracts, bounded distributed data-feed contracts, and graph-first deployment artifacts roundtrip through stable formats without losing role or spec truthpsionic-train::model_io already owns safetensors export/import, GGUF import, tensor-role manifests, and typed artifact receipts, psionic-data now owns bounded local and distributed data-feed semantics, psionic-ir now owns exportable graph contracts, and psionic-compiler now owns bounded deployment artifact contracts over execution-plan and topology-aware bundlespsionic-train model-IO roundtrip and GGUF inventory tests plus psionic-data data-ingress and distributed data-feed tests, psionic-ir export-contract tests, and psionic-compiler deployment-artifact testsDo not treat a serving-family loader alone as full model-state IO closure; broader elastic distributed feed, state-dict, optimizer-state, and checkpoint migration roundtrip must stay explicit
Compiler lowering and realize pathimplemented_earlycompile lowering is deterministic, topology-sensitive, extension-aware, schema-backed, fake- or meta-executable, transform-safe enough for later rewrites/export, and replayable from named fixtures instead of being only an internal implementation detailpsionic-ir now publishes a built-in plus extensible operator registry with explicit built-in/custom schema registration, backend-kernel registration, dispatch resolution, transform-safety analysis, a bounded extension-contract report for custom ops, kernels, autograd, backends, and quantizers, a bounded advanced-operator program matrix over linalg, signal, and attention families plus explicit refusal for distribution and special-function families, a bounded program-transform capability matrix over symbolic rewrites and export-safe graphs, dense plus non-dense meta-tensor family contracts, shape-only graph/plan execution, and capability-gated refusal behavior, while psionic-compiler now owns deterministic lowering plus explicit schedule formation, fusion-policy realization, alias-aware memory planning, plan-cache identity, compile-cache evidence, and fixture-backed replay above that IR surfacepsionic-ir operator-registry, extensible-registry, advanced-operator, extension-contracts, transform-safety, program-transform, non-dense meta-tensor, and meta-execution tests plus psionic-compiler compile-graph, compiler-artifact, plan-cache, and process_replay testsDo not claim framework-core closure if lowering stays green only on one happy-path fixture while operator schemas, extension registration, dispatch resolution, transform barriers, higher-order transform refusal, extension-contract refusal, non-dense meta contracts, fake execution, schedule/memory/cache identity, graph identity, or topology sensitivity drift
Memory planning and cache behaviorimplemented_earlymodel admission, compiler memory planning, allocator/cache budgets, KV/prefix cache state, and runtime resource reports stay explicit and bounded instead of being hidden behind backend heuristicspsionic-compiler now owns compile-time tensor lifetime intervals, alias-aware slot reuse, stable plan-cache identity, and cold-vs-warm compile-cache evidence, while psionic-runtime still owns model-admission planning, runtime resource reports, and prefix/KV cache contractspsionic-compiler compiler-artifact and plan-cache tests plus psionic-runtime admission, budget, KV cache, and prefix-cache testsDo not collapse compile-time or runtime cache truth into product throughput headlines; framework-core acceptance cares about explicit policy and refusal behavior too
Process replay and program identityimplemented_earlyreviewers can tell whether a compiled or trained path is the same program, the same replay contract, and the same tool/environment posturepsionic-compiler fixture replay and psionic-train replay-truth receipts already existpsionic-compiler replay fixtures plus psionic-train replay-truth testsDo not treat request receipts or serving-route provenance alone as framework replay closure
Same-type local multi-device behaviorimplemented_earlyone same-host same-backend runner can realize a plan across multiple devices with explicit topology, sharding policy, refusal reasons, honest staged-output posture, and explicit handoff transport truthpsionic-runtime now owns a same-type local multi-device runner, explicit LocalShardingPolicy contracts, one stable LocalMultiDeviceRefusalReason taxonomy across contract validation plus runner-level topology gaps, one bounded dense split path that can execute ordered layer shards and return final outputs, and one direct worker-to-worker handoff path with host fallback and per-stage transport evidence, while psionic-models publishes one representative decoder-family tensor-parallel sharding contract with runtime-owned policy identityrepresentative decoder-family sharding-contract test, policy serialization and refusal tests, local multi-device runner execution/refusal tests, plus topology-sensitive compiler digest testKeep local serving acceptance honest: the lower-level runtime runner is real, but TOPOLOGY_ACCEPTANCE_MATRIX.md still keeps local tensor/pipeline/layer/replica serving unsupported until a served lane adopts it

Category Mapping

1. Tensor semantics

This category is about the tensor and layout substrate itself, not about model quality or serving throughput.

Current shipped foundation:

  • TensorSpec keeps device and dtype explicit
  • layout expand/permute/slice/select rules are deterministic and can be checked as alias-preserving transforms over the source storage span
  • layout storage spans, view posture, and alias relations are machine-legible rather than backend-only convention
  • broadcast-compatible binary shape rules are explicit in psionic-core and realized in psionic-ir through inserted expand views
  • mixed I8/F16/BF16/F32 binary ops use an explicit small promotion table
  • a bounded ExtendedDType vocabulary now makes richer promotion, cast, and backend-capability rules machine-legible without pretending the current runtime-core DType subset already covers those families
  • dtype class and quantized logical-storage eligibility are explicit in psionic-core
  • quantized tensor payload containers exist as typed data, not log-only blobs
  • backend-visible storage identity is explicit in psionic-runtime and the CPU reference backend preserves it through dense views and allocator reuse
  • graph/autodiff/runtime/topology/sandbox seams now share one canonical refusal taxonomy for unsupported op, gradient, layout, capability, serialization, and policy-denial boundaries

Canonical hooks:

  • cargo test -p psionic-core tests::tensor_spec_retains_device_and_dtype -- --exact
  • cargo test -p psionic-core tests::shape_broadcast_merges_trailing_singleton_axes -- --exact
  • cargo test -p psionic-core tests::dtype_promotion_prefers_widest_supported_representation -- --exact
  • cargo test -p psionic-core tests::dtype_contracts_mark_current_quantized_and_dense_surface -- --exact
  • cargo test -p psionic-core tests::advanced_dtype_semantics_report_tracks_seeded_promotion_cast_and_backend_cases -- --exact
  • cargo test -p psionic-core tests::derived_views_remain_alias_preserving_transforms -- --exact
  • cargo test -p psionic-core tests::layout_alias_relation_tracks_dense_and_broadcast_views -- --exact
  • cargo test -p psionic-core tests::psionic_refusal_builder_keeps_code_scope_and_subject -- --exact
  • cargo test -p psionic-core tests::layout_expand_uses_zero_strides -- --exact
  • cargo test -p psionic-core tests::layout_permute_updates_shape_and_strides -- --exact
  • cargo test -p psionic-backend-cpu --lib tests::cpu_buffer_views_preserve_storage_identity_and_view_semantics -- --exact
  • cargo test -p psionic-backend-cpu --lib tests::cpu_allocator_pool_reuses_dense_storage_identity -- --exact
  • cargo test -p psionic-ir --lib tests::graph_error_refusal_taxonomy_maps_layout_capability_and_serialization_boundaries -- --exact
  • cargo test -p psionic-ir --lib autodiff::tests::autodiff_refusal_taxonomy_maps_unsupported_gradient_family -- --exact
  • cargo test -p psionic-ir --lib tests::binary_ops_broadcast_inputs_through_explicit_expand_views -- --exact
  • cargo test -p psionic-backend-cpu --lib tests::cpu_backend_executes_broadcast_add_over_index_views -- --exact
  • cargo test -p psionic-runtime --lib tests::runtime_refusal_taxonomy_maps_capability_and_serialization_boundaries -- --exact
  • cargo test -p psionic-runtime --lib local_multi_device::tests::local_sharding_contract_refusal_taxonomy_surfaces_topology_mismatch -- --exact
  • cargo test -p psionic-sandbox --lib execution::tests::policy_rejection_receipt_maps_into_refusal_taxonomy -- --exact

2. Autodiff and optimizer behavior

This category is now implemented_early.

Current shipped foundation:

  • autodiff-aware IR graph construction with explicit detach
  • training/evaluation plus no-grad gradient semantics
  • symbolic backward plans and dense reference gradient materialization for the full current primitive op family
  • trainer-step integration proof that autodiff gradients feed the fixed-budget training core
  • explicit-gradient trainer steps with typed telemetry
  • reusable SGD, Adam, AdamW, LARS, and LAMB primitives outside one trainer loop
  • typed per-group optimizer state plus distributed optimizer contracts

Implemented-early boundary:

  • unsupported backend-extension gradients must still refuse through typed paths
  • later operator families outside the current primitive/core extension surface remain outside the current hook set

Canonical hooks:

  • cargo test -p psionic-ir --lib autodiff::tests::reverse_mode_autodiff_materializes_matmul_chain_gradients -- --exact
  • cargo test -p psionic-ir --lib autodiff::tests::reverse_mode_autodiff_accumulates_shared_paths_and_honors_detach -- --exact
  • cargo test -p psionic-ir --lib autodiff::tests::reverse_mode_autodiff_covers_select_concat_and_reshape_primitives -- --exact
  • cargo test -p psionic-ir --lib autodiff::tests::reverse_mode_autodiff_accepts_non_scalar_axis_seed -- --exact
  • cargo test -p psionic-ir --lib autodiff::tests::autodiff_context_makes_training_and_no_grad_behavior_explicit -- --exact
  • cargo test -p psionic-ir --lib autodiff::tests::autodiff_support_matrix_marks_primitives_and_backend_extensions_explicitly -- --exact
  • cargo test -p psionic-ir --lib autodiff::tests::unsupported_gradient_backend_extensions_refuse_per_op_label -- --exact
  • cargo test -p psionic-ir --lib autodiff::tests::unsupported_gradient_ops_refuse_through_typed_error -- --exact
  • cargo test -p psionic-train --lib core_loop::tests::autodiff_gradients_compose_with_fixed_budget_training_core -- --exact
  • cargo test -p psionic-train --lib core_loop::tests::fixed_budget_training_loop_applies_updates_and_tracks_telemetry -- --exact
  • cargo test -p psionic-train --lib optimizer::tests::reusable_optimizer_surface_advances_small_model_with_sgd_and_adam -- --exact
  • cargo test -p psionic-train --lib optimizer::tests::reusable_optimizer_surface_supports_all_declared_optimizer_families -- --exact
  • cargo test -p psionic-train --lib optimizer::tests::reusable_optimizer_surface_refuses_state_kind_mismatch -- --exact
  • cargo test -p psionic-train --lib distributed_optimizer::tests::distributed_optimizer_contract_surfaces_precision_and_memory_truth -- --exact
  • cargo test -p psionic-train --lib distributed_optimizer::tests::distributed_optimizer_contract_refuses_incomplete_shard_coverage -- --exact

3. Model and state IO

This category is about whether framework state can be exported, imported, verified, and replayed without losing semantic meaning.

Canonical hooks:

  • cargo test -p psionic-train --lib model_io::tests::portable_model_bundle_roundtrips_through_safetensors_manifest -- --exact
  • cargo test -p psionic-train --lib model_io::tests::gguf_import_surfaces_tokenizer_binding_and_tensor_inventory -- --exact

4. Compiler lowering and realize path

This category is about deterministic lowering and identity, not only about one successful runtime execution.

Current shipped foundation:

  • psionic-ir now exposes one built-in operator registry with stable schemas for source, composite, backend-kernel, and backend-extension ops
  • the registry carries a visible split between implementation family and meta-execution posture rather than leaving that boundary implicit in one backend
  • psionic-ir now also exposes an extensible registry contract seeded from the built-ins so custom schemas, backend-kernel registrations, and dispatch resolution stay on one typed registry surface instead of forking into per-backend shadow maps
  • psionic-ir now exposes transform-safety analysis and policy-gated functionalization so alias roots and export barriers are explicit IR facts rather than later passes guessing which graphs are rewrite-safe
  • psionic-ir now exposes typed sparse, nested, masked, and storage-aware meta-tensor families plus capability checks so non-dense families can enter through explicit meta-execution contracts before full runtime semantics land
  • execution plans can be revalidated against the built-in registry, and graphs or plans can now run through fake/meta execution without material tensor data
  • fake execution can refuse explicit backend-kernel capability gaps, which lets compatibility harnesses stay honest about what a target surface claims to support
  • psionic-compiler now publishes deterministic schedule formation, explicit fusion groups, alias-aware memory intervals and slot reuse, stable plan-cache identity, and cold-versus-warm compile-cache evidence rather than leaving those compiler surfaces implicit inside one backend
  • compiler replay fixtures now snapshot the richer compiler artifact contract, not only the lowered plan signature

Canonical hooks:

  • cargo test -p psionic-ir --lib tests::builtin_operator_registry_exposes_kernel_composite_and_meta_surfaces -- --exact
  • cargo test -p psionic-ir --lib tests::extensible_operator_registry_seeds_builtin_dispatch_contracts -- --exact
  • cargo test -p psionic-ir --lib tests::extensible_operator_registry_accepts_custom_schema_and_backend_dispatch -- --exact
  • cargo test -p psionic-ir --lib tests::extensible_operator_registry_refuses_shadowing_duplicates_and_missing_output -- --exact
  • cargo test -p psionic-ir --lib tests::transform_safety_report_tracks_alias_roots_and_export_barriers -- --exact
  • cargo test -p psionic-ir --lib tests::functionalize_export_safe_graph_preserves_alias_metadata -- --exact
  • cargo test -p psionic-ir --lib tests::functionalize_export_safe_policy_refuses_opaque_backend_extensions -- --exact
  • cargo test -p psionic-ir --lib tests::custom_meta_tensor_contract_accepts_non_dense_and_storage_aware_families -- --exact
  • cargo test -p psionic-ir --lib tests::meta_capability_profile_refuses_unsupported_non_dense_family_contract -- --exact
  • cargo test -p psionic-ir --lib tests::operator_registry_validates_execution_plan_specs -- --exact
  • cargo test -p psionic-ir --lib tests::meta_executor_runs_graph_without_real_tensor_data -- --exact
  • cargo test -p psionic-ir --lib tests::meta_executor_refuses_missing_backend_kernel_capability -- --exact
  • cargo test -p psionic-compiler --lib tests::compile_graph_lists_expected_steps -- --exact
  • cargo test -p psionic-compiler --lib tests::compile_graph_plan_can_run_through_meta_execution_without_tensor_data -- --exact
  • cargo test -p psionic-compiler --lib tests::compile_graph_preserves_deterministic_digest -- --exact
  • cargo test -p psionic-compiler --lib tests::compile_graph_artifacts_surface_schedule_fusion_and_memory_contracts -- --exact
  • cargo test -p psionic-compiler --lib tests::compile_graph_artifacts_cache_identity_tracks_topology_and_contract_changes -- --exact
  • cargo test -p psionic-compiler --lib tests::compiler_plan_cache_emits_cold_compile_then_warm_reuse_evidence -- --exact
  • cargo test -p psionic-compiler --test process_replay matmul_add_replay_fixture_matches -- --exact
  • cargo test -p psionic-compiler --test process_replay attention_backend_extension_tensor_sharded_replay_fixture_matches -- --exact

5. Memory planning and cache behavior

This category is about explicit planning, budget, and reuse truth.

Current shipped foundation:

  • psionic-compiler now exposes compile-time tensor lifetime intervals, alias-aware slot reuse, and stable plan-cache identity/evidence instead of leaving those decisions implicit inside a backend-specific compile path
  • psionic-runtime still owns runtime admission budgets, runtime resource reports, and prefix/KV cache contracts for realized execution paths

Canonical hooks:

  • cargo test -p psionic-compiler --lib tests::compile_graph_artifacts_surface_schedule_fusion_and_memory_contracts -- --exact
  • cargo test -p psionic-compiler --lib tests::compile_graph_artifacts_cache_identity_tracks_topology_and_contract_changes -- --exact
  • cargo test -p psionic-compiler --lib tests::compiler_plan_cache_emits_cold_compile_then_warm_reuse_evidence -- --exact
  • cargo test -p psionic-runtime --lib tests::model_admission_can_evict_oldest_idle_model_to_fit_budget -- --exact
  • cargo test -p psionic-runtime --lib tests::model_admission_refuses_when_only_active_models_block_the_budget -- --exact
  • cargo test -p psionic-runtime --lib tests::prefix_cache_identity_and_policy_serialize_stably -- --exact
  • cargo test -p psionic-runtime --lib tests::kv_cache_state_and_growth_serialize_stably -- --exact

6. Process replay and program identity

This category is about proving that "the same thing ran again" is a typed claim with stable receipts and fixture identity.

Current shipped foundation:

  • psionic-runtime now owns a serializable determinism contract with explicit mode and deterministic-algorithm posture rather than treating seeded replay as one ad hoc sampler flag
  • psionic-train now projects assignment, trainer, and eval seeds into those runtime determinism contracts and publishes one machine-readable reproducibility report across runtime, local-device, distributed-rank, and checkpoint-restore seams
  • replayable generator state can now be exported from TokenSampler, checkpointed alongside runtime state, restored later, and resumed without silently resetting the RNG stream
  • local-device and distributed-rank generator derivation are stable and machine-checkable instead of being left to lane-local seed math

Canonical hooks:

  • cargo test -p psionic-train --lib replay_truth::tests::replay_truth_receipt_is_machine_legible_and_verifiable -- --exact
  • cargo test -p psionic-train --lib replay_truth::tests::replay_truth_verification_detects_seed_tool_and_order_drift -- --exact
  • cargo test -p psionic-train --lib replay_truth::tests::reproducibility_semantics_report_tracks_seeded_runtime_and_replay_cases -- --exact
  • cargo test -p psionic-core --lib tests::autocast_policy_matrix_tracks_seeded_backend_rules_and_diagnostics -- --exact
  • cargo test -p psionic-compiler --test process_replay matmul_add_replay_fixture_matches -- --exact
  • cargo test -p psionic-runtime --lib tests::strict_determinism_contract_refuses_missing_generator_state -- --exact
  • cargo test -p psionic-runtime --lib tests::runtime_determinism_contract_derives_stable_local_and_distributed_generators -- --exact
  • cargo test -p psionic-runtime --lib tests::token_sampler_generator_state_restores_after_checkpoint -- --exact

7. Same-type local multi-device behavior

This category is now implemented_early.

Current shipped foundation:

  • multi-device topology identity and inventory qualifiers
  • topology-sensitive compile digests
  • one same-host same-backend local plan runner with explicit local multi-device refusal taxonomy
  • explicit local sharding policies with stable digest, version, partition-mode, collective-boundary, and outcome posture
  • one bounded dense split runtime path that accepts ordered pipeline topologies, binds explicit layer-shard artifacts, performs host-mediated stage handoff, and returns final outputs from the last stage
  • the same dense split runtime path now also prefers direct worker-to-worker handoff between adjacent shard runtimes when both sides support it, while preserving host fallback and per-stage transport evidence
  • one representative GGUF decoder-family tensor-parallel sharding contract with inspectable weight-class rules plus a runtime-owned policy digest
  • explicit local-serving unsupported-scope language in the serving-topology matrix so the framework runner is not mistaken for a served product lane

Canonical hooks:

  • cargo test -p psionic-models --lib sharding::tests::gguf_decoder_family_tensor_parallel_contract_is_declarative_and_inspectable -- --exact
  • cargo test -p psionic-runtime --lib local_multi_device::tests::local_sharding_policy_defaults_are_serializable_and_metrics_only -- --exact
  • cargo test -p psionic-runtime --lib local_multi_device::tests::layer_sharding_policy_defaults_surface_host_handoff_and_final_outputs -- --exact
  • cargo test -p psionic-runtime --lib local_multi_device::tests::local_sharding_policy_refuses_invalid_layout_execution_pair -- --exact
  • cargo test -p psionic-runtime --lib local_multi_device::tests::local_multi_device_plan_runner_executes_tensor_sharded_workload_without_cluster_truth -- --exact
  • cargo test -p psionic-runtime --lib local_multi_device::tests::local_multi_device_plan_runner_executes_pipeline_sharded_workload_with_host_handoff -- --exact
  • cargo test -p psionic-runtime --lib local_multi_device::tests::local_multi_device_plan_runner_prefers_direct_stage_handoff_when_adjacent_runtimes_support_it -- --exact
  • cargo test -p psionic-runtime --lib local_multi_device::tests::local_sharding_contract_refuses_backend_memory_and_device_count_mismatches -- --exact
  • cargo test -p psionic-runtime --lib local_multi_device::tests::local_sharding_contract_policy_refuses_partition_kind_mismatch -- --exact
  • cargo test -p psionic-runtime --lib local_multi_device::tests::local_multi_device_plan_runner_refuses_missing_runtime_for_selected_device -- --exact
  • cargo test -p psionic-runtime --lib local_multi_device::tests::local_multi_device_execution_refusal_taxonomy_surfaces_missing_topology_and_layout_mismatch -- --exact
  • cargo test -p psionic-compiler --lib tests::compile_graph_with_topology_changes_digest_when_sharding_changes -- --exact

Current Closure Summary

As of this matrix:

  • Psionic has real framework-core foundations for tensor/layout semantics, autodiff or optimizer behavior, model-state IO, compiler identity, memory/cache policy, replay truth, and same-type local multi-device execution contracts.
  • Psionic still keeps representative-coverage boundaries explicit: unsupported gradient families refuse cleanly, and the current hooks are not a claim that every future op family already has full reverse-mode coverage.
  • A green serving or train acceptance result must not be cited as evidence that those framework-core gaps are closed.

That is the minimum honesty bar for any future Tinygrad-parity claim.