Nordshrift Complete Edition
Nordshrift Complete is the application-and-service authoring edition of Nordshrift. It provides the .sst control surface and the SLeeLa-Complete base-class vocabulary needed to specify an application, service, server, tool, library, desktop interface, network program, data system, scientific program, or telephony application before selecting native/platform implementations.
Nordshrift Complete does not replace native implementation layers. It composes the designer-facing classes with the Nordshrift build/transpilation pipeline.
1. Complete authoring model
ProjectSpecification
|
v
ModuleSpecification
|
+--> ClassSpecification
| +--> FieldSpecification
| +--> MethodSpecification
| +--> ParameterSpecification
|
+--> InterfaceSpecification
+--> TypeSpecification / EnumSpecification
+--> EventSpecification
+--> DependencySpecification
+--> CapabilitySpecification
|
+--> PlatformSpecification
| +--> BackendSpecification
| +--> AdapterSpecification
| +--> ConnectorSpecification
|
+--> Security / Network / Data / UI / Runtime
|
+--> BuildSpecification / TestSpecification
|
v
SST control sheet
|
v
Nordshrift pipeline
|
+--> Sleela
+--> C
+--> Java
A Nordshrift Complete project therefore has an explicit application model before native code is selected.
2. Application and service module catalog
The following surfaces are the reusable base classes for application or service construction.
| Module | Base application/service classes |
|---|---|
| Core / runtime | ProjectSpecification, ModuleSpecification, ClassSpecification, Component, Configuration, Result, EventBus, Thread, Timer, Lock |
| API / type contracts | TypeSpecification, InterfaceSpecification, MethodSpecification, FieldSpecification, ParameterSpecification, EnumSpecification, EventSpecification |
| Platform | PlatformSpecification, BackendSpecification, AdapterSpecification, ConnectorSpecification, BuildSpecification, TestSpecification |
| Network | NetworkEndpoint, UdpTransport, TcpTransport, DnsResolver, SecureChannel, Credential |
| Security | Credential, SecureChannel, Certificate, SecuritySpecification, CapabilitySpecification |
| Data | DataSet, Query, DataModelSpecification, DataService, ServiceSpecification |
| Database | DatabaseConnection, Query, DataSet, ServiceSpecification |
| HTTP / web | HttpService, Server, Router, Listener, NetworkEndpoint |
| Server / service | Server, ServiceSpecification, Router, Listener, EndpointSpecification |
| I/O | File, Stream, MessageSpecification |
| Synchronization | Thread, Lock, Timer, EventBus |
| UI / application | Window, Widget, Component, EventBus |
| XML | XmlDocument, XmlElement |
| EmailService, MessageSpecification, EndpointSpecification | |
| Media | MediaStream, Stream, AudioInput, AudioOutput, AudioDevice |
| Telephony / VoIP | Call, SipTransaction, RtpStream, MediaStream, VoIPApplication, VoIPAccount, SipEndpoint, SipCall, VoIPSession |
| Memory management | MemoryManager, MemoryBlock, MemoryStructure, StructMemory, Leech, MemoryFlow, MemoryCondition, MemoryPolicy, MemoryTelemetry, MemoryAllocator, MemoryArena, MemoryPool, MemoryGuard, MemoryValidation |
| Reflection | ReflectionRegistry, TypeInfo, FieldInfo, MethodInfo, ParameterInfo, EnumInfo, BaseTypeInfo, AttributeInfo, ConstructorInfo, PropertyInfo, Invocation, Serializer |
| AI / inference | Model, Inference, KnowledgeUnit, DataSet |
| Analytics | DataSet, Query, DataModelSpecification, WorkflowSpecification |
| Regex / text | Pattern |
| Domain / science | Subject, KnowledgeUnit, DataModelSpecification, Quantity, Assumption, Relation, Transformation, Evidence, Explanation, Todo |
| Terminal | Terminal, Stream, Configuration |
| Decompiler / tooling | Decompiler, ToolSpecification, BuildSpecification, TestSpecification |
| Native implementation | BackendSpecification, AdapterSpecification, ConnectorSpecification, BuildSpecification, TestSpecification |
3. Subject and scientific applications
Nordshrift Complete carries the existing Subject Library architecture as application-ready semantic modules:
- Math
- Physics
- Chemistry
- Economics
- Finance / Financial
- Inference
- Data Analytics
- Astrophysics
- Sociology
Each subject remains responsible for its own domain semantics. The common Nordshrift chain is:
Subject → Quantity → Unit → Assumption → Relation → Formula → Transformation → Result → ComparativeNorm → Evidence → Explanation → Validation
4. Application archetypes
The Complete edition provides reusable foundations for desktop applications, command-line applications, background services, network services, HTTP/web servers, database-backed applications, email services, data-processing applications, scientific and mathematical applications, AI/inference applications, media applications, telephony and VoIP applications, security-aware applications, XML/data interchange applications, developer and compiler tools, terminal applications, and multi-platform applications.
These are construction surfaces, not claims that every resulting application is automatically production-ready. Production readiness still requires implementation, testing, security review, platform validation, and deployment-specific configuration.
5. Memory Manager and Reflection integration
Nordshrift Complete now treats the native Memory Manager and Reflection packages as first-class application infrastructure.
Memory
The application model can describe ownership, allocation policy, structures and structs, Leech observation relationships, memory pressure, telemetry, abstract voltage/current/flow, deterministic memory/program condition, and validation/guard policy.
The voltage/current/flow vocabulary is a software-state model. It does not represent physical electrical measurements of RAM.
Reflection
The application model can describe types, fields, methods, parameters, constructors, properties, enums, base types, attributes, serialization, invocation contracts, and native ABI interoperability.
The C++ reflection registry remains the native substrate; metadata does not by itself imply arbitrary safe dynamic invocation.
6. Sleela-Complete source of base classes
The canonical designer-facing class definitions remain under api/sleela-complete/.
Nordshrift Complete consumes these as the reusable authoring vocabulary rather than maintaining an unrelated duplicate class system.
The corresponding module matrix is api/sleela-complete/MODULE-MATRIX.md.
The native implementation foundations include api/native/memory/ and api/native/reflection/.
7. Completeness rule
A module is Complete at the authoring level when its public application/service surface can be specified through the base classes, including identity; classes and interfaces; fields and methods; parameters and types; events and lifecycle; dependencies; platform/backend adapters; network and security boundaries where applicable; memory/ownership requirements where applicable; build target; tests and validation; and documentation/examples.
A module is implementation-complete only when the corresponding native/platform implementation, tests, diagnostics, packaging, and deployment requirements have also been satisfied.
This distinction keeps Nordshrift Complete useful as a genuine application-construction system without falsely treating a specification or stub as a finished implementation.
8. Edition relationship
| Edition | Role |
|---|---|
| Nordshrift 1.x | Legacy .sst control and compatibility surface |
| Nordshrift 2.0 | Semantic .sst control, subject models, validated input objects, and triplet transpilation |
| Nordshrift Complete | 2.x application/service authoring surface using the SLeeLa-Complete base classes and native integration contracts |
Nordshrift Complete is an extension of the existing Nordshrift architecture, not a separate compiler or second application model.