IOTA-1 architecture

Protocol 5 JustAnIota Bidirectional Semantic Converter

The C# version of JustAnIota IOTA-1 (ɩ≃1) converts English to public-symbol candidates, IOTA-1 symbols back to English candidates, and English through an IOTA-1 round trip. It now includes a public seed registry and deterministic database-only path, while remaining intentionally approximate: it reports the best gist, not exact translation.

Hosted demo

Database-only semantic conversion

Loading public seed registry status...
Ready.

Output

Waiting for conversion.

Ranked candidates

No candidates yet.

Trace evidence

No trace yet.

Embedding comparison

Semantic similarity

Waiting for comparison.

Hard rules

What IOTA-1 is allowed to be

Approximate
IOTA-1 compares conceptual weights. Results are ranked semantic neighbors, not exact translations or lossless conversions.
Public symbols
Use assigned ISO/IEC 10646 / Unicode characters and public standard sequences. Private-use areas are prohibited.
No secret map
No proprietary dictionary, hidden bilingual table, or private codebook may become the conversion authority.
Research filter
Discard claims that reject the project because exact conversion is impossible. Keep evidence about security, Unicode processing, and vector limits.

Implementation status

Current Protocol5-hosted capability map.

The hosted demo is deliberately split between read-only public endpoints and local-only mutation tooling. That keeps website exploration useful while preserving the rule that embedding population happens off the public web host.

Public demoDatabase-only seed conversion

The page can convert, round-trip, compare semantic neighbors, and expose trace evidence without requiring live AI.

Status endpoint
Read-only APICategory corpus search

Search endpoints are read-only surfaces over stored public vectors or caller-supplied embeddings, with optional local LM Studio text embedding when configured.

Search endpoint
Local toolingEmbeddingDesktop population

Vector population belongs in the local WPF desktop runner and scripts, not in public web mutation routes.

Code standards

Facade

One stable C# entry point

Consumer projects use IJustAnIotaConverterFacade for conversion, meaning queries, and round trips. The included factory can create a database-only converter from the public seed registry or wire an LM Studio embedding provider.

Logic layer

Approximate semantic engine

The logic layer owns NFC normalization, System.Text.Rune scalar handling, grapheme grouping, token-by-token conversion, candidate ranking, approximation labels, and private-use rejection.

Repository

ADO.NET over SQL Server vectors

Repository interfaces stay persistence-agnostic. The SQL Server implementation stores English anchors and public symbol embeddings in vector columns and uses VECTOR_DISTANCE, VECTOR_SEARCH, and DiskANN indexes where available.

Local AI

LM Studio is optional

LM Studio can generate embeddings, rerank candidates, and verbalize results. After the database is populated, DatabaseOnly mode must still return a basic gist without live AI.

Pipeline

Public metadata to approximate meaning

StepOwnerRule
Build symbol atlasUnicode ingestion workerUse UCD, CLDR, Unihan, emoji data, source versions, and public provenance.
Generate embeddingsDeterministic seed builder or LM Studio adapterUse descriptor text, anchors, code-point evidence, and source provenance, not bare code point numbers as the only semantic evidence.
Store vectorsADO.NET SQL repositoryPersist dimensions, model, prompt profile, public source, and private-use exclusion state.
Query gistLogic layerCompose stored English or symbol vectors when live AI is unavailable.
Return evidenceFacadeAlways include mode, approximate status, ranked candidates, scores, and provenance.

Developer path

Use it without SQL Server first

The current package can run immediately from its public seed registry. This is enough for deterministic smoke tests, UI prototypes, and API wiring before a populated SQL Server vector store is available.

IJustAnIotaConverterFacade converter = JustAnIotaConverterFactory.CreateDefaultDatabaseOnly();
ConversionResponse response = await converter.ConvertAsync(new ConversionRequest
{
    Input = "good help",
    Direction = ConversionDirection.EnglishToIota,
    Mode = ConversionMode.DatabaseOnly,
    ResultLimit = 3
});

// response.Output is "好救"; response.Trace exposes concept IDs, scores, code points, and provenance.

Implementation status

Current C# slice

The repository now contains a usable Protocol5.JustAnIota package slice: facade and logic interfaces, a public seed registry, deterministic descriptor embeddings, token-by-token database-only conversion, semantic similarity comparison, public Unicode safety checks, an optional LM Studio embedding adapter, SQL Server vector repository primitives, a hosted Protocol5 demo API, and MSTest contract coverage. Future work adds SQL integration tests against a vector-capable SQL Server instance.

UAIX boundary: this page documents a Protocol5/JustAnIota implementation experiment. It does not define or modify the normative UAI standard.