Skip to main content

Module DevLog

Module DevLog 

Source
Expand description

§DevLog - Tag-filtered development logging for Grove

Controlled by LAND_DEV_LOG environment variable. The same tags work in both Mountain (Rust) and Wind/Sky (TypeScript).

§Usage

LAND_DEV_LOG=grove,wasm ./Grove          # only grove + WASM
LAND_DEV_LOG=all ./Grove                 # everything
LAND_DEV_LOG=short ./Grove              # everything, compressed + deduped
LAND_DEV_LOG=transport,grpc ./Grove     # transport + gRPC
./Grove                                  # nothing

§Short Mode

LAND_DEV_LOG=short enables all tags but compresses output:

  • Long app-data paths aliased to $APP
  • Consecutive duplicate messages counted ((x14) suffix)
  • Rust log targets compressed (D::Binary::Main::EntryEntry)

§Tags (Grove-specific tags plus shared tags)

TagScope
groveExtension host lifecycle: create, start, kill, exit
wasmWASM module loading, compilation, execution
transportIPC/gRPC/WASM transport strategy and routing
grpcgRPC/Vine: server, client, connections
extensionsExtension scanning, activation, management
lifecycleStartup, shutdown, phases, window events
configConfiguration get/set, env paths, workbench config
ipcIPC routing: invoke dispatch, channel calls
vfsFile stat, read, write, readdir, mkdir, delete, copy
storageStorage get/set/delete, items, optimize
commandsCommand registry: execute, getAll
exthostExtension host: create, start, kill, exit info
modelText model: open, close, get, updateContent
outputOutput channels: create, append, show
bootstrapEffect-TS bootstrap stages

Structs§

DedupState

Statics§

APP_DATA_PREFIX 🔒
DEDUP
ENABLED_TAGS 🔒
OTLP_AVAILABLE 🔒
OTLP_TRACE_ID 🔒
SHORT_MODE 🔒

Functions§

AliasPath
Replace the long app-data path with $APP in a string.
AppDataPrefix
Get the app-data path prefix for aliasing (cached).
DetectAppDataPrefix 🔒
EmitOTLPSpan
Emit an OTLP span to the local collector (Jaeger at 127.0.0.1:4318). Fire-and-forget on a background thread. Stops trying after first failure.
EnabledTags 🔒
FlushDedup
Flush the dedup buffer - prints the pending count if > 1.
GetTraceId 🔒
IsEnabled
Check if a tag is enabled.
IsShort
Whether LAND_DEV_LOG=short is active.
NowNano
rand_u64 🔒