Runtime Surfaces System Design

C++ local

Python local

C++ remote

Python remote

source of truth живёт в engine semantics и domain model;

language wrappers адаптируют форму;

remote clients адаптируют тот же смысл к server boundary;

local и remote deliberately differ by boundary, а не по случайности.

есть canonical implementation в src/textfoundry_engine;

GUI/TUI работают поверх local engine;

public local SDK boundary ещё не выделен;

Python local отсутствует;

Prompt Server отсутствует;

remote SDK/clients отсутствуют.

local engine semantics экспонируется как public C++ local API;

тот же смысл экспонируется как Python local API;

published-only remote contract обслуживается Prompt Server;

поверх него существуют C++ remote client и Python remote client;

parity измеряется внутри local boundary и внутри remote boundary.

C++ Engine canonical implementation доменной модели, versioning и render logic

C++ local surface thin public contract поверх engine semantics

Python local surface bindings/wrapper поверх тех же local semantics

Prompt Server published-only remote boundary

C++ remote client typed client к server contract

Python remote client idiomatic Python client к тому же server contract

Parity governance layer tests, fixtures, compatibility policy и release rules

local vs remote

C++ vs Python

сначала выбирается boundary;

потом внутри неё обеспечивается parity между языками.

C++ local и Python local должны быть близки по capability;

C++ remote и Python remote должны быть близки по capability;

local и remote не обязаны быть одинаковыми.

загрузка Draft и Published сущностей;

lifecycle operations;

deterministic render;

version-aware access;

explicit AI workflows там, где они реально являются частью engine/workbench model.

наличие GUI/TUI не делает их частью local API;

local surface не должна наследовать UI-specific semantics;

public local API должен быть уже, чем полный внутренний код GUI.

registry lookup published assets;

resolve published composition;

render with params;

version selection and metadata;

error semantics для not-found, validation и version mismatch.

draft lifecycle;

authoring mutations;

GUI/TUI-specific semantics;

hidden AI rewrite behavior.

local parity между C++ local и Python local

remote parity между C++ remote и Python remote

naming differences;

Result<T> vs exceptions;

sync/async wrapper differences;

typed-model differences.

разные lifecycle semantics;

разные version-selection rules;

разные render results при одинаковом supported contract;

разные error categories без явной документированной причины.

domain entities;

lifecycle rules;

deterministic render behavior;

server-side published-only contract.

случайная форма одного из wrappers;

удобство конкретного binding tool;

текущая реализация GUI view-model.

deterministic behavior для одинакового входа;

testable parity;

explicit version compatibility;

отсутствие draft leakage в remote;

прозрачность supported/unsupported operations;

возможность поэтапного rollout без обещания лишнего.

concrete binding technology для Python local;

packaging strategy для local SDK;

transport technology для remote clients;

compatibility/versioning scheme для public API и SDK.