Skip to content

Commit 2f25d48

Browse files
authored
Release 0.1.1: Align Semantic OS boundary (#19)
## Summary - Aligns the AIKernel.NET 0.1.1 abstraction, contract, DTO, and enum surface. - Updates release documentation for Kernel Sync Day, June 10th, 2026. - Finalizes the public Semantic OS boundary for downstream 0.1.1 packages. ## Validation - Release build passed. - Test suite passed.
1 parent dd23857 commit 2f25d48

25 files changed

Lines changed: 1886 additions & 62 deletions

Directory.Build.props

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
<Project>
22
<PropertyGroup>
3-
<Version>0.1.0</Version>
4-
<AssemblyVersion>0.1.0</AssemblyVersion>
5-
<FileVersion>0.1.0</FileVersion>
6-
<InformationalVersion>0.1.0</InformationalVersion>
3+
<Version>0.1.1</Version>
4+
<AssemblyVersion>0.1.1</AssemblyVersion>
5+
<FileVersion>0.1.1</FileVersion>
6+
<InformationalVersion>0.1.1</InformationalVersion>
77
<GenerateDocumentationFile>true</GenerateDocumentationFile>
88
<Authors>Takuya Sogawa</Authors>
99
<Company>AIKernel-NET</Company>
@@ -14,9 +14,9 @@
1414
<PackageTags>aikernel;aikernel-core;ai-os;architecture;category-separation;context-isolation;contract-driven;governance;admissibility;preprocessing;semantic-context-os;semantic-compilation;deterministic-replay;fail-closed;rom;canonicalization;pdp;signed-prompt;interface-contracts;dto;enum;capability-modules;dynamicslm;seedslm;hatl</PackageTags>
1515
<PackageReleaseNotes>
1616
<![CDATA[
17-
AIKernel.NET v0.1.0 — First Stable Contract Baseline
17+
AIKernel.NET v0.1.1 — First Stable Contract Baseline
1818
19-
• Promotes the AIKernel.NET contract packages to the first 0.1.0 baseline.
19+
• Promotes the AIKernel.NET contract packages to the first 0.1.1 baseline.
2020
• Adds MemoryRegion / MemoryMapper contracts for Native Capability modules.
2121
• Adds Control Plane contracts under AIKernel.Abstractions.Control and AIKernel.Dtos.Control.
2222
• Adds pure routing decision DTOs under AIKernel.Dtos.Routing so Core can keep routing behavior as runtime extensions.
@@ -26,9 +26,9 @@ AIKernel.NET v0.1.0 — First Stable Contract Baseline
2626
• Keeps Result/ResultStep/LINQ composition and runtime adapters outside AIKernel.NET.
2727
• Documents migration from Core provisional Memory APIs to AIKernel.NET contract packages.
2828
29-
AIKernel.NET v0.1.0 — First Stable Contract Baseline
29+
AIKernel.NET v0.1.1 — First Stable Contract Baseline
3030
31-
• AIKernel.NET contract package を最初の 0.1.0 baseline に昇格。
31+
• AIKernel.NET contract package を最初の 0.1.1 baseline に昇格。
3232
• Native Capability module 向け MemoryRegion / MemoryMapper contract を追加。
3333
• Control Plane contract を AIKernel.Abstractions.Control / AIKernel.Dtos.Control に追加。
3434
• routing behavior を Core runtime extension に残すため、AIKernel.Dtos.Routing に純 DTO を追加。

README-jp.md

Lines changed: 57 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
updated: 2026-06-07
33
published: 2026-05-16
4-
version: "0.1.0"
4+
version: "0.1.1"
55
edition: "Release"
66
status: "Released"
77
issuer: ai-kernel@aikernel.net
@@ -21,6 +21,57 @@ AIKernel は、機能そのものを定義しません。
2121

2222
AIKernel.NET は、LLM を API ではなく、能力(Capability)を持つプロセスとして扱う Contract-First な基盤です。
2323

24+
AIOS SDK において、AIKernel.NET は契約語彙のレイヤーです。安定した
25+
interface、DTO、enum、境界型を定義し、他の AIKernel layer がそれらを
26+
組み合わせて AI Operating System distribution を構築できるようにします。
27+
28+
AIKernel には、公式 AIOS ディストリビューションである **AIKernel.Monolith** もあります。
29+
Monolith は 0.1.x 系 SDK の安定化後に、SDK の各 layer を統合する標準 AIOS
30+
として開発が開始されています。
31+
32+
---
33+
34+
## 最初に読む場所
35+
36+
AIKernel が初めての場合、この repository は contract と vocabulary の入口として使い、
37+
実際に動かしたい内容に応じて runtime repository へ進んでください。
38+
39+
| やりたいこと | 入口 |
40+
| --- | --- |
41+
| 安定した interface、DTO、enum を参照する | `AIKernel.Abstractions`, `AIKernel.Contracts`, `AIKernel.Dtos`, `AIKernel.Enums` |
42+
| .NET host / service を構築する | [AIKernel.Core](https://github.com/AIKernel-NET/AIKernel.Core) |
43+
| 公式 Provider / OS driver を追加する | [AIKernel.Providers](https://github.com/AIKernel-NET/AIKernel.Providers) |
44+
| 物理実行エンジンを使う | [AIKernel.Control](https://github.com/AIKernel-NET/AIKernel.Control) |
45+
| `aik` CLI や replay / inspection tool を使う | [AIKernel.Tools](https://github.com/AIKernel-NET/AIKernel.Tools) |
46+
| browser / WebAssembly workload を扱う | [AIKernel.Wasm](https://github.com/AIKernel-NET/AIKernel.Wasm) |
47+
| runnable example から学ぶ | [AIKernel.Demo](https://github.com/AIKernel-NET/AIKernel.Demo) |
48+
49+
contract package は同じ version family でまとめて導入してください。
50+
51+
```bash
52+
dotnet add package AIKernel.Abstractions --version 0.1.1
53+
dotnet add package AIKernel.Contracts --version 0.1.1
54+
dotnet add package AIKernel.Dtos --version 0.1.1
55+
dotnet add package AIKernel.Enums --version 0.1.1
56+
```
57+
58+
異なる version family の AIKernel contract package を混在させないでください。
59+
60+
---
61+
62+
## 0.1.1 公開パッケージライン
63+
64+
0.0.x の design / implementation phase と 0.1.0 prototype validation baseline は完了しました。
65+
現在の public package line は 0.1.1 です。
66+
67+
0.1.1 では、契約 package に加えて、実行可能な Core、外部 Capability module、
68+
WASM runtime package、Tools、Demo / Control repository を公開 package family として
69+
扱います。
70+
71+
過去の architecture document には元の 0.0.x / 0.1.0 front matter や prototype note が
72+
残る場合があります。利用者向けの package installation example は、現行の 0.1.1
73+
package を使用してください。
74+
2475
---
2576

2677
## NuGet パッケージ一覧
@@ -116,7 +167,7 @@ app.Run();
116167
起動時には以下のシーケンスが実行されます。
117168

118169
```txt
119-
[KERNEL] Initializing AIKernel.NET v0.1.0...
170+
[KERNEL] Initializing AIKernel.NET v0.1.1...
120171
[KERNEL] Loading ISignatureTrustStore... [OK]
121172
[KERNEL] Mounting Vfs (Git: ./context)... [OK]
122173
[KERNEL] Verifying System Prompt Signature... [VALID]
@@ -432,6 +483,10 @@ Enterprise 拡張には以下が含まれます。
432483
- コントリビューションは PR ベースです。
433484
- Contracts と PromptRules の互換性を明示してください。
434485
- 破壊的変更には移行ガイドを添付してください。
486+
- コントリビュータは
487+
[AIKernel 開発ガイドライン](docs/guidelines/AIKERNEL_DEVELOPMENT_GUIDELINES-jp.md)
488+
および [AIKernel Development Guidelines](docs/guidelines/AIKERNEL_DEVELOPMENT_GUIDELINES.md)
489+
に従ってください。
435490

436491
---
437492

README.md

Lines changed: 55 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
---
22
updated: 2026-06-07
3-
published: 2026-06-09
4-
version: "0.1.0"
3+
published: 2026-06-10
4+
version: "0.1.1"
55
edition: "Release"
6-
status: "Release Candidate"
6+
status: "Release"
77
issuer: ai-kernel@aikernel.net
88
maintainer: "Takuya (AIKernel Project Maintainer)"
99
---
@@ -21,16 +21,53 @@ This repository manages the canonical contract set of AIKernel.
2121

2222
AIKernel.NET is a contract-first foundation that treats LLMs not as simple APIs, but as capability-bearing processes.
2323

24+
In the AIOS SDK, AIKernel.NET is the contract vocabulary layer. It defines the
25+
stable interfaces, DTOs, enums, and boundary types that other AIKernel layers
26+
compose into an AI Operating System distribution.
27+
28+
AIKernel also provides an official AIOS distribution, codenamed
29+
**AIKernel.Monolith**. Monolith has begun development as the standard AIOS that
30+
integrates the SDK layers into a unified reference system after the 0.1.x line
31+
stabilizes.
32+
33+
---
34+
35+
## Start Here
36+
37+
If you are new to AIKernel, use this repository for contracts and vocabulary,
38+
then move to the runtime repository that matches what you want to run.
39+
40+
| You want to... | Start with |
41+
| --- | --- |
42+
| Reference stable interfaces, DTOs, and enums | `AIKernel.Abstractions`, `AIKernel.Contracts`, `AIKernel.Dtos`, `AIKernel.Enums` |
43+
| Build a .NET host or service | [AIKernel.Core](https://github.com/AIKernel-NET/AIKernel.Core) |
44+
| Add official Providers or OS drivers | [AIKernel.Providers](https://github.com/AIKernel-NET/AIKernel.Providers) |
45+
| Run physical execution engines | [AIKernel.Control](https://github.com/AIKernel-NET/AIKernel.Control) |
46+
| Use the `aik` CLI or replay/inspection tools | [AIKernel.Tools](https://github.com/AIKernel-NET/AIKernel.Tools) |
47+
| Run browser/WebAssembly workloads | [AIKernel.Wasm](https://github.com/AIKernel-NET/AIKernel.Wasm) |
48+
| Learn through runnable examples | [AIKernel.Demo](https://github.com/AIKernel-NET/AIKernel.Demo) |
49+
50+
Install the contract packages together:
51+
52+
```bash
53+
dotnet add package AIKernel.Abstractions --version 0.1.1
54+
dotnet add package AIKernel.Contracts --version 0.1.1
55+
dotnet add package AIKernel.Dtos --version 0.1.1
56+
dotnet add package AIKernel.Enums --version 0.1.1
57+
```
58+
59+
Do not mix AIKernel contract packages from different version families.
60+
2461
---
2562

26-
## 0.1.0 Prototype Validation Phase
63+
## 0.1.1 Public Package Line
2764

28-
The 0.0.x design-implementation phase is complete. The 0.1.0 package family is
29-
the first prototype validation baseline, scheduled for publication on
30-
2026-06-09.
65+
The 0.0.x design-implementation phase and the 0.1.0 prototype validation
66+
baseline are complete. The current public package line is 0.1.1.
3167

32-
This phase validates the contract packages together with executable Core,
33-
external Capability modules, and demo/control repositories:
68+
The 0.1.1 line publishes the contract packages together with executable Core,
69+
external Capability modules, WASM runtime packages, tools, and demo/control
70+
repositories:
3471

3572
- `AIKernel.NET` - MIT contract packages: interfaces, DTOs, and enums.
3673
- `AIKernel.Core` - Apache-2.0 runtime, monads, DSL, Kernel, Hosting, and
@@ -41,9 +78,13 @@ external Capability modules, and demo/control repositories:
4178
- `AIKernel.Tools` - external Capability modules and developer tools.
4279
- `AIKernel.Control` - control-plane execution engines for CPU, GPU, emulator,
4380
Bonsai mapping, and diagnostics.
81+
- `AIKernel.Providers` - official extension Provider and standard OS driver
82+
packages.
83+
- `AIKernel.Wasm` - browser/WebAssembly runtime and WebGPU provider packages.
4484

4585
Historical architecture documents may retain their original 0.0.x front matter
46-
and changelog entries. The current public release line is 0.1.0.
86+
and 0.1.0 prototype notes. User-facing package installation examples should use
87+
the current 0.1.1 packages.
4788

4889
Release notes:
4990

@@ -142,7 +183,7 @@ app.Run();
142183
### Target Experience / Boot Log Example
143184

144185
```txt
145-
[KERNEL] Initializing AIKernel.NET v0.1.0...
186+
[KERNEL] Initializing AIKernel.NET v0.1.1...
146187
[KERNEL] Loading ISignatureTrustStore... [OK]
147188
[KERNEL] Mounting Vfs (Git: ./context)... [OK]
148189
[KERNEL] Verifying System Prompt Signature... [VALID]
@@ -458,6 +499,9 @@ Enterprise extensions may include:
458499
- Contributions are PR-based.
459500
- Compatibility for Contracts and PromptRules must be explicit.
460501
- Breaking changes must include migration guides.
502+
- Contributors must follow the full development discipline in
503+
[AIKernel Development Guidelines](docs/guidelines/AIKERNEL_DEVELOPMENT_GUIDELINES.md)
504+
and [AIKernel 開発ガイドライン](docs/guidelines/AIKERNEL_DEVELOPMENT_GUIDELINES-jp.md).
461505

462506
---
463507

RELEASE_NOTES-ja.md

Lines changed: 12 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2,18 +2,24 @@
22

33
[English](RELEASE_NOTES.md)
44

5-
## 0.1.0
5+
## 0.1.1
66

7-
> [EN] Crossing the 0.1.0 event horizon: the semantic runtime becomes observable, deterministic, and contract-led.
8-
>
9-
> [JA] 0.1.0 の事象の地平を越える──意味的ランタイムは可観測・決定論・契約駆動へと収束する。
7+
**June 10th, 2026 - Aligning the Semantic OS boundary.**
8+
**2026年6月10日--Semantic OS の境界を整列する。**
109

11-
AIKernel.NET 0.1.0 は、Semantic Runtime の Phase-1 contract baseline を完了します。
10+
Aligning the Semantic OS boundary: abstractions, contracts, and identifiers
11+
converge into the unified 0.1.1 surface. Semantic OS の境界整列--抽象・契約・
12+
識別子が 0.1.1 の統一面へ収束する。
13+
14+
AIKernel.NET 0.1.1 は、Semantic OS package family の同期された契約境界を
15+
確立します。
1216

1317
- Abstractions、DTO、Enum、contract-only surface の public contract boundary を固定します。
1418
- Control execution request、execution graph、snapshot、result、routing DTO、memory abstraction、DSL、History ROM、Capability ROM、DynamicSLM、SeedSLM、HATL、governance vocabulary を、必要な範囲で shared contract family へ昇格します。
1519
- `AIKernel.Abstractions``AIKernel.Contracts` の interface-only 原則を維持します。
1620
- 実装挙動は AIKernel.NET に置かず、AIKernel.Core、AIKernel.Control、AIKernel.Tools、AIKernel.Cuda13.0、AIKernel.Demo が runtime / tooling / demo 側を担います。
1721
- AIKernel.NET は実装を含まないため特許面のリスクがなく、MIT により標準化と相互運用性を最大化します。論文および研究文書は各 paper に明示された license に従います。
1822

19-
このリリースは「意味論の可視化フェーズ」の完成点です。決定論性、契約境界、Semantic State、可観測性、Governed Circuit が stable public concept として名前を持ちます。
23+
この release は 0.1.1 の semantic visibility boundary を同期します。決定論性、
24+
契約境界、Semantic State、可観測性、Governed Circuit が ecosystem 全体で
25+
stable public concept として名前を持ちます。

RELEASE_NOTES.md

Lines changed: 11 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -2,14 +2,17 @@
22

33
[日本語](RELEASE_NOTES-ja.md)
44

5-
## 0.1.0
5+
## 0.1.1
66

7-
> [EN] Crossing the 0.1.0 event horizon: the semantic runtime becomes observable, deterministic, and contract-led.
8-
>
9-
> [JA] 0.1.0 の事象の地平を越える──意味的ランタイムは可観測・決定論・契約駆動へと収束する。
7+
**June 10th, 2026 - Aligning the Semantic OS boundary.**
8+
**2026年6月10日--Semantic OS の境界を整列する。**
109

11-
AIKernel.NET 0.1.0 completes the Phase-1 contract baseline for the semantic
12-
runtime.
10+
Aligning the Semantic OS boundary: abstractions, contracts, and identifiers
11+
converge into the unified 0.1.1 surface. Semantic OS の境界整列--抽象・契約・
12+
識別子が 0.1.1 の統一面へ収束する。
13+
14+
AIKernel.NET 0.1.1 completes the synchronized contract boundary for the
15+
Semantic OS package family.
1316

1417
- Freeze the public contract boundary for Abstractions, DTOs, Enums, and
1518
contract-only surfaces.
@@ -26,6 +29,6 @@ runtime.
2629
no patent surface. Papers and research documents remain governed by the
2730
license attached to each paper.
2831

29-
This release marks the completion point of the semantic visibility phase:
32+
This release marks the synchronized 0.1.1 boundary for semantic visibility:
3033
determinism, contract boundaries, semantic state, observability, and governed
31-
circuits are now named as stable public concepts.
34+
circuits are named as stable public concepts across the ecosystem.

docs/CONTRIBUTING-jp.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,15 @@ signature: ""
2121
## Introduction
2222
AIKernel.NET は **Contract-Driven AI Runtime** であり、プロダクション品質の AI OS を目指します。このリポジトリは **.NET 10 / C# 14** を対象とします。本ガイドは、リポジトリ構造、PR ルール、CI 要件、コントリビューションのベストプラクティスを示します。
2323

24+
コントリビュータ向けの正式な開発規律は
25+
[`guidelines/AIKERNEL_DEVELOPMENT_GUIDELINES.md`](guidelines/AIKERNEL_DEVELOPMENT_GUIDELINES.md)
26+
および
27+
[`guidelines/AIKERNEL_DEVELOPMENT_GUIDELINES-jp.md`](guidelines/AIKERNEL_DEVELOPMENT_GUIDELINES-jp.md)
28+
に定義します。この詳細ガイドラインは、Interface Led Architecture、Provider-Observer-Operator
29+
の責務境界、DAG 実行、fail-closed monad、バージョニング、テスト、ドキュメント、
30+
ガバナンスをレビューする際の優先規約です。本 CONTRIBUTING は短い運用入口であり、
31+
アーキテクチャや実装判断では詳細ガイドラインを優先してください。
32+
2433
---
2534

2635
## Environment
@@ -99,6 +108,8 @@ CI は build と test を実行し、ベースライン品質を確認します
99108
- Contract/interface/DTO 変更に対して Issue がある
100109
- 破壊的変更に `[Breaking]` が付いている
101110
- Public API の XML ドキュメントがある
111+
- `guidelines/AIKERNEL_DEVELOPMENT_GUIDELINES.md` または
112+
`guidelines/AIKERNEL_DEVELOPMENT_GUIDELINES-jp.md` への適合を確認している
102113
- CI が成功している
103114
- AI 利用時はその旨を明示し、人手検証が完了している
104115

docs/CONTRIBUTING.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,16 @@ signature: ""
2121
## Introduction
2222
AIKernel.NET is a **Contract-Driven AI Runtime** and aims to be a production-grade AI OS. This repository targets **.NET 10 / C# 14**. This CONTRIBUTING guide explains repository structure, PR rules, CI expectations, and best practices for contributors.
2323

24+
The canonical contributor-facing development discipline is defined in
25+
[`guidelines/AIKERNEL_DEVELOPMENT_GUIDELINES.md`](guidelines/AIKERNEL_DEVELOPMENT_GUIDELINES.md)
26+
and
27+
[`guidelines/AIKERNEL_DEVELOPMENT_GUIDELINES-jp.md`](guidelines/AIKERNEL_DEVELOPMENT_GUIDELINES-jp.md).
28+
That guideline is normative for Interface Led Architecture, Provider-Observer-Operator
29+
responsibility boundaries, DAG execution, fail-closed monads, versioning, testing,
30+
documentation, and governance. This CONTRIBUTING guide is the short operational
31+
entry point; the detailed guideline takes precedence when reviewing architecture
32+
or implementation choices.
33+
2434
---
2535

2636
## Environment
@@ -99,6 +109,8 @@ CI runs build and tests to ensure baseline quality.
99109
- Create Issues for contract/interface/DTO changes
100110
- Mark breaking changes with `[Breaking]`
101111
- Provide XML docs for public APIs
112+
- Confirm compliance with `guidelines/AIKERNEL_DEVELOPMENT_GUIDELINES.md`
113+
or `guidelines/AIKERNEL_DEVELOPMENT_GUIDELINES-jp.md`
102114
- Ensure CI passes
103115
- If AI was used to generate content, note it and ensure human validation
104116

docs/architecture/interfaces/pipeline/IStructurePlanner-jp.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,6 @@ tags:
1717
---
1818

1919
英語版: [IStructurePlanner](../pipeline/IStructurePlanner.md)
20-
英語版: [IStructurePlanner](architecture/interfaces/pipeline/IStructurePlanner.md)
2120

2221
# IStructurePlanner
2322

0 commit comments

Comments
 (0)