Interface Breaking Change Check v0.1.2

この文書は、0.1.2 package line を公開する前に、v0.1.2 正典 interface の 破壊的変更判定を固定するためのものです。参照対象は AIKernel.Core、 AIKernel.Control、AIKernel.Providers、AIKernel.Tools、AIKernel.Wasm、 AIKernel.Doom ですが、AIKernel.NET に昇格する対象は contract-level surface だけです。

結論

安定版 v0.1.1 の AIKernel.NET public API に対して、破壊的変更は不要です。

v0.1.2 の正典 surface は横追加です。

• 既存 v0.1.1 public type 名は維持します。
• 既存 v0.1.1 method signature はこの review では変更しません。
• cognition、Topos、CTG carrier、runtime、provider、scenario contract は新規 public type として追加します。
• Doom 固有、browser 固有の implementation contract は AIKernel.NET 正典 surface に入れません。

公開前の pre-release 命名整理として、次の統一だけを行いました。

• ICTGCanon -> ICtgCanon
• ICTGRuleset -> ICtgRuleset
• ICTGDecisionGate -> ICtgDecisionGate

これは all-caps 名が local v0.1.2 development surface にのみ存在していたため、 安定版 v0.1.1 に対する破壊的変更ではありません。

判定方法

• 現在の AIKernel.NET public type set を v0.1.1 tag と比較しました。
• 機械 scan で出た削除候補は、positional record の整形に起因する parser artifact であり、該当 source record は現行 tree に残っていることを確認しました。
• 実装リポジトリ横断の implementation-specific interface を確認し、scenario-neutral な語彙だけを正典抽象へ写像しました。
• implementation logic、棚卸し Category C の旧 logic、WebGPU/WebAudio details、Doom route 名、provider 実装詳細は AIKernel.NET から除外しました。

Interface ごとの判定

Cognition Pipeline

Topos / Triadic Vector

CTG Carrier Surface

Provider Surface

Runtime Surface

Scenario Surface

DTO / Snapshot / Carrier 判定

Migration Guide: pre-release CTG casing 統一

Why

all-caps の ICTG* interface 名は、既存の CtgDecisionGateRequest、 CtgDecisionGateResult、ICtgGovernanceService などの Ctg naming と 一致していませんでした。両方を残すと正典 debt になるため、公開前に統一します。

What Changed

Migration Steps

1. ICTGCanon を ICtgCanon に置換します。
2. ICTGRuleset を ICtgRuleset に置換します。
3. ICTGDecisionGate を ICtgDecisionGate に置換します。
4. method call と DTO usage は変更しません。

Before / After

// Before\npublic sealed class CanonReader : ICTGCanon\n{\n}\n\n// After\npublic sealed class CanonReader : ICtgCanon\n{\n}

Migration Guide: Doom prompt 名から scenario-neutral contract へ

Why

v0.1.2 正典 interface package には Doom 固有名を入れません。 scenario-specific vocabulary は AIKernel.Doom の責務です。正典 surface は他の demo でも実装できる scenario-neutral contract にします。

What Changed

Migration Steps

1. Doom-specific detection と route label は AIKernel.Doom に閉じます。
2. Doom state を ScenarioPerceptionSnapshot、ScenarioActionRequest、

ScenarioRuntimeStatus、ScenarioHudState へ project します。

3. scenario-neutral interface は adapter boundary だけで実装します。

Before / After

// Before\npublic interface IDoomPerception\n{\n    ValueTask<DoomPerceptionSnapshot> SenseAsync(CancellationToken cancellationToken);\n}\n\n// After\npublic sealed class DoomScenarioPerceptionAdapter : IScenarioPerception\n{\n    public ValueTask<ScenarioPerceptionSnapshot> CaptureAsync(\n        ScenarioPerceptionRequest request,\n        CancellationToken cancellationToken);\n}

安定理由

• 正典追加は opt-in であり、既存実装に member 追加を要求しません。
• result-like record の optional failure envelope は v0.1.2 の新規 carrier surface に閉じます。
• 新規 enum は Unknown = 0 を持ち、既存 enum value を rename / delete しません。
• Provider は capability adapter として維持し、SDK wrapper や scenario runtime は AIKernel.NET に入れません。
• Core / Control の実装責務は維持し、AIKernel.NET は contract のみを定義します。