use std/io use std/vec.Vec struct Counter { value: i32 } blocking func main(): i32! { var counters = Vec [Counter { value: 1 }, Counter { value: 2 }, Counter { value: 3 }] for counter in &+counters { counter.value += 10 } var borrowed_total: i32 = 0 for counter in &counters { borrowed_total += counter.value } var moved_total: i32 = 0 for counter in move counters { moved_total += counter.value } let message = "borrowed: ${borrowed_total}, moved: ${moved_total}\n" io.print(&message)? return 0 }

func main(): i32 { let value = load_value() catch failure { fallback_for(failure.message()) } if value == 42 { return 0 } return 1 } func load_value(): i32! { return error.new("example.unavailable", "the primary value is unavailable") } func fallback_for(message: &str): i32 { return 42 }

use std/task use std/time use std/time.Duration async func delayed(value: i32): i32 { await time.sleep(Duration.from_milliseconds(1)) return value } async func main(): i32! { let (left, right) = await task.join(delayed(20), delayed(22)) if left + right != 42 { return error.new("example.unexpected_total", "joined tasks returned the wrong total") } return 0 }

use std/io use std/url.Url blocking func main(): i32! { let url = Url.parse("HTTP://Example.COM:80/a/../status?q=ready#fragment")? let canonical = url.to_string() let authority = url.authority() let target = url.request_target() io.println(&canonical)? io.println(&authority)? io.println(&target)? return 0 }

nocter-language-server

Responsibility

Own LSP process lifecycle, document events, workspace orchestration, and projection of typed analysis results into protocol responses.

Contract

The server consumes nocter-lsp messages, updates workspace documents, requests nocter-workspace-analysis generations, and maps protocol-independent query results to LSP. It cannot name checking, declaration, target-program, syntax-tree, or source-index storage.

Internal Responsibilities

initialize/shutdown and JSON-RPC request routing
document open/change/save/close handling
watched-file and workspace configuration handling
selection of the language-owned Nocter source glob supplied to the protocol registration builder
semantic feature response projection
atomic workspace-diagnostic projection
workspace edit version projection

Production request routing stays in server.rs; semantic request projection stays in server/semantic_requests.rs. Their integration tests live in sibling test modules under server/ so test setup and protocol transcripts do not obscure either production responsibility.

Invariants

Feature handlers do not implement semantic fallback or lookup.
Expected unavailability is an ordinary result; only integrity failure becomes an internal error.
One response uses one current immutable generation.
Diagnostics use one complete post-transition workspace view. Contributions from shared physical sources are merged and deduplicated before one URI-global replacement notification is emitted.
Removing one analysis scope cannot clear a diagnostic still contributed by another active scope.
Protocol edits preserve analysis-validated grouping and accepted document versions.

nocter-language-server#

Responsibility#

Contract#

Internal Responsibilities#

Invariants#

nocter-language-server

Responsibility

Contract

Internal Responsibilities

Invariants