Interface Breaking Change Check v0.1.2

This document fixes the v0.1.2 canonical interface review result before the 0.1.2 package line is published. The review covered AIKernel.Core, AIKernel.Control, AIKernel.Providers, AIKernel.Tools, AIKernel.Wasm, and AIKernel.Doom as source repositories, but only contract-level surfaces were eligible for AIKernel.NET.

Result

No breaking change is required for the stable v0.1.1 AIKernel.NET public API.

The v0.1.2 canonical surface is added laterally:

• Existing v0.1.1 public type names remain present.
• Existing v0.1.1 method signatures are not intentionally changed by this

review.

• New cognition, Topos, CTG carrier, runtime, provider, and scenario contracts

are new public types.

• Doom-specific and browser-specific implementation contracts stay outside the

canonical AIKernel.NET surface.

One pre-release naming consolidation was applied before publication:

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

This is not a stable v0.1.1 breaking change because the all-caps names existed only in the local v0.1.2 development surface.

Review Method

• Compared the current AIKernel.NET public type set against the v0.1.1 tag.
• Verified that candidate removals from the mechanical scan were parser

artifacts caused by positional record formatting; the corresponding source records are still present.

• Reviewed cross-repository implementation-specific interfaces and mapped them

to canonical abstractions only when the vocabulary was scenario-neutral.

• Kept implementation logic, old inventory Category C logic, WebGPU/WebAudio

details, Doom route names, and provider implementation details out of AIKernel.NET.

Interface Decision List

Cognition Pipeline

Topos / Triadic Vectors

CTG Carrier Surface

Provider Surface

Runtime Surface

Scenario Surface

DTO / Snapshot / Carrier Decision List

Migration Guide: Pre-release CTG Casing Consolidation

Why

The all-caps ICTG* interface names did not match the existing codebase style, which uses Ctg for type names such as CtgDecisionGateRequest, CtgDecisionGateResult, and ICtgGovernanceService. Keeping both spellings would create needless canonical debt.

What Changed

Migration Steps

1. Replace all ICTGCanon references with ICtgCanon.
2. Replace all ICTGRuleset references with ICtgRuleset.
3. Replace all ICTGDecisionGate references with ICtgDecisionGate.
4. Keep method calls and DTO usage unchanged.

Before / After

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

Migration Guide: Doom Prompt Names to Scenario-Neutral Contracts

Why

The v0.1.2 canonical interface package must not contain Doom-specific names. Scenario-specific vocabulary belongs in AIKernel.Doom. The canonical surface uses scenario-neutral contracts that other demos can also implement.

What Changed

Migration Steps

1. Keep Doom-specific detection and route labels in AIKernel.Doom.
2. Project Doom state into ScenarioPerceptionSnapshot,

ScenarioActionRequest, ScenarioRuntimeStatus, and ScenarioHudState.

3. Implement the scenario-neutral interfaces only at the 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}

Stability Reasons

• The canonical additions are opt-in and do not require existing implementations

to add members.

• Result-like records use optional failure envelope fields only in the new

v0.1.2 carrier surface.

• New enums use Unknown = 0 and do not rename or delete existing enum values.
• Providers remain capability adapters; SDK wrappers and scenario runtimes stay

out of AIKernel.NET.

• Control and Core retain their implementation responsibility: AIKernel.NET

defines contracts only.