Skip to content
Documentation
Developers

Developers

LUNA is two halves in one repository (org-runink/luna):

  • grpc/: the Go backend. It is the module github.com/org-runink/luna, with a Cobra CLI, one cmd/*_server.go per service, and the API in api/proto/luna/v1/luna.proto (package luna.v1).
  • flutter/: the app. It uses Riverpod and has no router: the app body is the login screen, the avatar picker, or the home screen, depending on auth state. Android and iOS (org.runink.luna) and the debug-only web build all come from this one tree.
Architecture
Services, the request pipeline, the AI harness, memory and judging.
Build and run locally
Build, test, run the backend headless, regenerate protos, release builds.
API reference
Every luna.v1 service and RPC, taken from the proto.
LUNA is proprietary (LicenseRef-Runink-Proprietary) and is never made public. Every file’s licence is recorded in REUSE.toml. A new file starts with an SPDX header (SPDX-License-Identifier: LicenseRef-Runink-Proprietary and SPDX-FileCopyrightText: 2026 Runink) in its own comment syntax. CI’s licence job rejects new GPL, LGPL, AGPL, SSPL, BUSL, CC-BY-NC or unreadable-licence dependencies, and any MPL-2.0 dependency that isn’t on the allowlist.