Developers

A protocol MVP built to be inspected

SYNS is not just a narrative site. The repository already exposes a real MVP surface: protocol primitives, deterministic scenarios, simulation logic, public endpoints, and developer-facing documentation.

View GitHub Read Litepaper

Release

v0.1.0

MVP surface: typed primitives, deterministic scenarios, simulation engine, and public JSON endpoints.

CI · lint · typecheck · build

01 · Repository

Repository overview

The current repository is structured to make the protocol thesis legible in code. It separates presentation, protocol modeling, deterministic scenario inputs, simulation logic, and public API access.

tree

app/
  homepage, lab, docs, and public routes

components/
  reusable UI and simulator components

lib/syns/
  protocol types, scenarios, and emergence engine

docs/
  architecture, glossary, and MVP limitations

.github/
  CI workflow and collaboration templates

02 · Modules

Core protocol modules

01
Protocol types
SignalEvent, SynapticNode, SignalImpact, EmergenceSnapshot, and EmergenceRun define the core protocol vocabulary.
02
Scenario library
Deterministic scenarios provide reproducible signal timelines for inspection, demos, and future testing.
03
Simulation engine
The engine evaluates node affinity, threshold activation, convergence, and final emergence scoring.
04
Public API surface
The MVP exposes nodes, scenarios, and simulation results through simple JSON endpoints.

03 · Local

Run locally

shell

git clone https://github.com/propooblob403/SYNS.git
cd SYNS
npm install
npm run dev

04 · Verification

Verification commands

shell

npm run lint
npm run typecheck
npm run build

05 · API

API surface

GET
/api/nodes
Returns the active synaptic node registry used by the MVP.
json
GET
/api/scenarios
Returns scenario summaries and their current emergence metrics.
json
GET
/api/scenarios/[slug]
Returns a full deterministic scenario plus simulation output.
json
GET
/api/simulate?scenario=<slug>&maxSignals=<n>
Runs the simulation engine for replay, testing, and inspection workflows.
json

06 · Status

Current engineering status

Lint configured
Typecheck configured
Production build verified
GitHub Actions CI enabled
Issue and PR templates enabled
Release flow established

07 · Boundaries

Current boundaries

The current system is still an MVP. It does not yet include live blockchain ingestion, persistent swarm memory, production calibration, or distributed agent execution. The point of this repository is to make the protocol thesis inspectable before the full protocol exists.

08 · Contribution

Contribution focus

The most valuable next contributions are protocol clarity, scenario quality, simulation realism, UI polish, developer ergonomics, and stronger diagnostics.

Improve scenario realism
Expand protocol docs
Refine simulator inspection tools
Improve traceability and observability
Prepare future signal adapters

Build on the protocol surface.

Review the repository, inspect the simulation engine, and help shape the next phase of the SYNS MVP.