wdeldaybytebuster/bytebuster-neurosyncos

1. Overall shape

NeuroSync Sovereign OS is a local, TypeScript-based control system with three main planes: a Hono server API, a React/Vite UI, and a set of core orchestration services under src/core. Runtime state is persisted in a local SQLite database in .data/, alongside a master key for crypto-backed storage.

2. Persistence and security boundary: BaseVault

src/core/basevault is the system’s storage foundation. It owns the SQLite schema, DB access, crypto, auth, and a write queue to serialize persistence operations. Other subsystems depend on this layer for durable state rather than talking to storage directly.

3. Execution boundary: CoreExec

src/core/coreexec is the task/DAG execution engine. It includes DAG validation, scheduler, worker pool, sandbox, dispatch, queueing, path validation, and memory sweep logic. This is the main “do work” subsystem and is clearly separated from routing/governance concerns.

4. Model governance and routing: RouteSwitch

src/core/routeswitch decides which model/provider should handle a request and how much autonomy is allowed. Its internal pieces include governor, council, triage, interceptor, router, discovery, and engine. Provider adapters target both OpenAI-compatible endpoints and llama.cpp, so model access is provider-agnostic.

5. Task intake and safety: ScopeLogic

src/core/scopelogic handles structured intake, validation, and risk handling for requests before they are executed. It contains interview, validator, schemas, and risk modules. Architecturally, this is the “policy gate” that constrains what gets promoted into execution or routing.

6. Background daemon and source sync: ScoutDaemon

src/core/scoutdaemon is the always-on background layer. It provides SSE streaming, idle detection, DB sync, parsing, and a GitNexus worker integration. This subsystem bridges filesystem/project activity into the rest of the OS and pushes live updates outward.

7. Analysis and adaptive routing: ScoutLogic

src/core/scoutlogic provides higher-level classification and benchmarking via classifier, dynamic router, and benchmarker modules. It appears to support system adaptation: determining how projects/tasks should be interpreted and which path they should follow through the OS.

8. Long-term memory: Cerebro

src/core/memory/cerebro is the memory subsystem, with vector retrieval, reflection, and habituation. It is the system’s persistence-backed learning/memory layer and likely feeds both decision-making and user-facing memory views.

9. API gateway

src/server/index.ts is the HTTP entrypoint, and src/server/routes exposes subsystem-facing endpoints such as cerebro, coreexec-router, llm, models, projects, scheduler-list, system, and todos. The server is the integration layer that turns internal services into consumable APIs for the UI and external callers.

10. UI as operational cockpit

src/ui is not a generic app shell; it is an operations dashboard for the OS. There are dedicated views for BaseVault, Cerebro, CoreExec, RouteSwitch, ScopeLogic, ScoutDaemon, and a UnifiedMasterDashboard. Components like approval queues, autonomy dials, routing dials, run history, and health widgets indicate the UI is meant for supervising and intervening in system behavior, not just displaying data.

11. Cross-cutting data flow

Typical flow is: intake in the UI or API → policy/risk gating in ScopeLogic → model routing in RouteSwitch or classification in ScoutLogic → execution in CoreExec → persistence through BaseVault → live status streamed via ScoutDaemon/SSE back to the UI. Memory updates in Cerebro can influence future routing and responses, while BaseVault provides the durable source of truth.

12. Tooling and governance layer

The docs/ tree is unusually important: it contains the architecture reference, operating rules, phase plans, schemas, and review templates. This documentation is treated as a living control plane for implementation decisions, while scripts/, tests, and the grammar files support validation of DAG behavior, crypto, and end-to-end flows.