Skip to content

Latest commit

 

History

History
222 lines (196 loc) · 16.8 KB

README.md

File metadata and controls

222 lines (196 loc) · 16.8 KB

SOMA Java 项目入口

类型:Project Entry

状态:V1 implementation COMPLETED;G1–G10 PASS;Canonical IR/Execution M1 S1-S6_COMPLETED / NO_ACTIVE_IMPLEMENTATION_SLICE;Vectorized Pipeline扩展 VP1-VP3_COMPLETED / FORMALLY_PROMOTED / NO_ACTIVE_IMPLEMENTATION_SLICE;Physical Execution Engine M2 FORMALLY_PROMOTED / IMPLEMENTATION_FULFILLED / P1-P6_COMPLETED / NO_ACTIVE_IMPLEMENTATION_SLICE;publication NOT_AUTHORIZED

Owner:SOMA Java 当前项目事实与内部文档路由

最后审查日期:2026-08-13

当前结论

SOMA(Scheme-Oriented Memory Architecture)已经在 clean-slate V1 Blueprint 下完成 I0–I8 implementation 与 qualification:

  • 正式 Blueprint、九个 Design Owner、I0–I8 Engineering Plan 和 G1–G10 Gate 已生效;
  • Java 8 下的两项 production artifact、generated API、chunked storage、Key/Index、query/optimizer、 mutation、GroupBy/Join、parallel、compression/metadata、三个 reference application 和本地交付链已建立;
  • G1–G10 当前为 PASS;百万行证据是同机 qualification,不是一亿行承诺或跨硬件 SLA;
  • Canonical Logical IR与执行引擎M1责任调整已经完成 正式晋升、Baseline Freeze与实施准入审查, Product Owner已于2026-08-11授权完整实施;S1资格 、S2资格、 S3资格与 S4资格与 S5资格和 S6最终资格均已PASS;S1-S6已经 COMPLETED,当前没有active implementation slice; 大范围优化后全局完整性与回归审查 已PASS,operation provenance、Index allocation admission与正式Owner状态漂移均已闭合; Scheduling性能治理已PASS,标准100K FJSP纯dispatch在固定主机降至fresh约0.6秒、warm约0.51秒; 32位结构域与即时增量Key/Index维护资格 已PASS:Table-local结构域统一为int,累计域保持long,Key/Index仅保留 singleton-inline / ordered int[]一套membership truth;
  • 性能与正确性联合治理已PASS,长期 benchmark、相对回归判定与当前最佳实践已经建立;
  • 四维性能架构治理已PASS, Design、Execution、Memory、CPU因果模型与本轮GroupBy/Relation优化已经闭合;
  • Operator × Type × Distribution 性能资格 已PASS,类型/分布 kernel、cost-aware RLE、Bound cardinality 与 Field materialization 已闭合;
  • 内存归因与低分配执行治理已PASS, retained、temporary reservation、Java allocation、heap/RSS 已分责归因,正常路径低分配优化已闭合;
  • 全面性能前沿资格已PASS,Table、Field、 IndexSelection 与主要派生 operation 在 10K/1M/10M 下完成固定主机资格,三轮 profile-driven 优化、最终 memory attribution、reference application 与 composed journey 已闭合;
  • Scheduling reference application治理 已PASS:标准100K FJSP使用四张runtime Table和自然waiting point add/remove完成FCFS + SPT, fixed slot与application frontier workaround已退出;
  • 开发阶段采用准备与防退化治理已PASS: 既有本地 Maven/generated/packaged consumer 闭环重放通过,benchmarks/建立fixed M5 Pro、Java 8、 10K/1M machine-readable ratchet;GitHub 增加 Bug/Performance 反馈入口并启用Dependency Graph/ Dependabot Alerts。该结论不外推为真实项目、Java多版本、生产或发布资格;
  • 工程系统一致性、可重复性与反馈效率治理 已PASS / E0-E4_COMPLETED / TEMPORARY_RETIRED:四个稳定入口、BuildSession候选绑定、两artifact POM一致性与开发阶段CI分责已经闭合;
  • Grassing Simulation reference application治理 已PASS:两张runtime Table、五阶段tick、UI/headless、deterministic validation、Application JFR/A-B 与source/package delivery闭合;
  • Selection mutation write-set治理 已PASS:PLAIN Selection update/remove退出touched-Chunk全leaf copy,使用columnar write set、 dense move plan和final-locator sidecar projection,同时保持encoded candidate与zero-publication;
  • Vectorized Physical Pipeline第一阶段正式晋升 已PASS:finite primitive Chunk kernel、PhysicalPlan单次decision、shared ordinal-work lifecycle与 Chunk-morsel partial已纳入production baseline; 扩展治理也已PASS:VP1 encoded-native integral与VP2 ordered long[] sequential/parallel路径完成资格,VP3已关闭正式Owner 晋升、全仓qualification与Temporary replacement closure;当前没有active implementation slice;
  • Physical Execution Engine M2正式晋升与实施准入 已PASS:Pipeline/Segment/Breaker/Kernel/Frame/Morsel责任已进入正式Owner,P1-P6 Baseline冻结且 Product Owner已授权完整实施;P1资格、 P2资格与 P3资格与 P4资格和 P5资格与 P6最终资格均已PASS;P1-P6已完成, Candidate Temporary已退役,当前没有active implementation slice;
  • GitHub Release/Package、Maven publication、签名和正式 release 声明仍未授权。

根 README 是 Library user 入口。本目录集中服务 Product Owner/维护者和 Codex/Agent,不向普通使用者投射完整设计与实施过程。

三个角色的入口

角色 首要入口 目的
Library user Root README、Examples 了解、构建和使用 SOMA
Codex/Agent AGENTS.md 当前约束、Owner、验证与 Git 边界
Product Owner/维护者 本页、Conformance 产品状态、裁决、证据和 release boundary

正式事实地图

问题 唯一入口
产品目标、用户模型、边界和成功标准 V1 Blueprint
Design Owner 与权威关系 Design 总览
核心抽象、叙事、不变量和变更协议 核心抽象与叙事
实施顺序与 slice exit V1 Implementation Plan
Canonical IR/Execution S1-S6替换顺序与证据 Canonical IR/Execution Plan
工程状态与入口 Engineering
G1–G10 定义 V1 Implementation Gates
当前实现与 Design 的一致程度 Conformance
大范围优化后的全局完整性、资源与回归审查 Post-governance global review
I0–I8 历史实施资格 Conformance records
仓库交付结构治理 Delivery-centered governance
性能、正确性与长期 benchmark 治理 Performance and correctness governance
千万行组合负载、资源与优化证据 Ten-million composed workload governance
Design/Execution/Memory/CPU 四维归因与优化 Four-dimensional performance architecture governance
Operator × Type × Distribution 性能资格 Type and distribution performance qualification
内存归因与低分配执行资格 Memory attribution and low-allocation governance
全面性能前沿、10K/1M/10M、Profile 与剩余边界 Performance frontier qualification
32位结构域、即时增量 Key/Index 与 mutation A/B Incremental structural mutation qualification
标准100K FJSP、Solver架构与自然waiting mutation回归 Scheduling reference governance
Grassing空间仿真、UI/headless与Application性能治理 Grassing simulation governance
Selection mutation write-set、原位提交与A/B Selection mutation governance
Finite primitive Chunk kernel与morsel partial正式晋升 Vectorized physical pipeline phase 1
Encoded integral、ordered long[]与VP1-VP3扩展资格 Vectorized pipeline expansion governance
Physical Pipeline/Segment/Breaker/Kernel/Frame/Morsel实施与资格 Physical Execution Engine M2 P6最终资格
Production Core质量检查方法的价值、成本与采用裁决 Quality inspection method feasibility
Post-M2 Relation、GroupBy、dense remove与construction T1–T4治理 Post-M2 performance optimization governance
开发阶段本地消费、10K/1M ratchet与GitHub反馈入口 Development adoption and regression governance
工程入口、BuildSession、POM与CI治理 Engineering system governance
安全、支持、品牌和许可 SECURITY、SUPPORT、NOTICE、LICENSE

精确 schema、storage、logical API、generated signature、planning、execution、failure 和 artifact 合同由 design/ 中的分责 Owner 拥有,本页不复制正文。

Executable fact 的位置

Blueprint
    -> Design
        -> code / build-support / tests
            -> Conformance
                -> README / Examples / future user docs
  • soma-runtime/、soma-processor/:恰好两项 production artifact;
  • soma-examples/:三个真实下游 reference application;
  • tests/:按长期 capability 组织的跨 artifact executable evidence;
  • build-support/:linkage、codegen、qualification 和 delivery machinery;
  • scripts/:check、qualify、benchmark、package-local 四个稳定入口;
  • docs/:仅占位,等待独立用户文档专题;
  • benchmarks/:reference application、type-kernel 与 performance-frontier 的长期非 production 证据;
  • conformance/:资格和 claim boundary;
  • temp/:只服务bounded topic或明确标记的queued intent;当前没有active bounded governance topic。 工程系统专题已由 正式Conformance记录完成E0-E4与Temporary closure。 Production Core质量检查方法探索已由 正式Conformance记录 完成Q0-Q2、采用裁决与Temporary closure,没有建立稳定脚本、CI或质量门。 Physical Execution Engine M2已由 最终P6资格完成Temporary replacement closure; Vectorized Physical Pipeline扩展已经由 正式Conformance记录接管并完成 Temporary replacement closure;Grassing治理已由 正式Conformance记录接管并退役Temporary; Post-M2 T1–T4已由 正式Conformance记录接管并完成 Temporary replacement closure; SOMA Engine产品构思只是未来产品intent,不是Design或 implementation input。 开发阶段采用准备与防退化专题已由 正式Conformance记录接管并完成 Temporary replacement closure。

日常检查使用:

./scripts/check.sh

完整 non-publishing qualification 使用:

./scripts/qualify.sh

固定产品身份

  • 品牌:SOMA(Scheme-Oriented Memory Architecture);
  • repository:somaruntime/soma-java;
  • copyright owner / maintainer / publishing identity:ArthurFeng;
  • Java package / Maven group:io.github.somaruntime.soma;
  • 语言:Java 8;
  • License:Apache License 2.0。

这些身份事实不证明远端 artifact、compatibility、performance 或 release 已成立。

Clean-slate 与 Temporary

Predecessor 仅由 Git ref archive/pre-product-reset-2026-07-31 保存,不能复制、cherry-pick、包装 或通过 compatibility layer 恢复。历史记录只用于 provenance,不能覆盖 current Blueprint、 Design、code 或 Conformance。

当前没有active bounded governance topic。工程系统治理已由 正式Conformance记录完成E0-E4、正式Owner晋升与 Temporary replacement closure。Production Core质量方法探索已由 正式Conformance记录完成;Physical Execution Engine M2已由 最终P6资格完成P1-P6、正式Owner与 Temporary replacement closure;冻结Candidate fingerprint仍由 晋升记录保存。 Vectorized Physical Pipeline第一阶段由 正式晋升记录接管,后续VP1-VP3由 扩展治理记录完成正式Owner晋升、 qualification与Temporary replacement closure。Grassing治理已由 正式Conformance记录接管并完成 Temporary replacement closure。Canonical IR与执行引擎治理已由 正式Conformance记录完成Owner晋升、 Baseline Freeze、readiness与Temporary replacement closure;production implementation与S1–S6 qualification 均已完成,当前没有active implementation slice。 SOMA Engine产品构思独立保留为queued intent。 Post-M2性能优化治理已完成T1–T4、 资格与Temporary replacement closure;未授权T5–T7没有形成current backlog或Design。 Scheduling性能治理 已完成正式Owner晋升、Conformance与replacement closure。此前 32位结构域与即时增量Key/Index维护 已完成正式Owner晋升、Conformance与replacement closure;候选Design与交接材料不作为平行历史 档案保留。