internal/

Package admin parses admin command flags and boots the operator service.

Package ai parses AI command flags and launches the AI control-plane service.

Package aieval parses CLI flags and runs one live AI GM evaluation lane for Promptfoo.

Package auth parses auth service startup flags and hands off to the app server.

Package discovery parses discovery service flags and launches the service.

Package game parses game command flags and starts the domain runtime.

Package invite parses invite service flags and launches the service.

Package notifications parses notifications command flags and launches the service.

Package play parses play command flags and composes transport entrypoints.

Package scenario parses scenario command flags and executes scripted runs.

Package seed parses seed command flags and executes fixture / generation workflows.

Package social parses social service flags and launches the service.

Package status parses status service flags and launches the service.

Package userhub parses userhub command flags and launches the userhub runtime.

Package web parses command inputs and boots the browser-facing web service.

Package worker parses worker command flags and launches the worker runtime.

Package errors provides structured error handling with i18n support.

Package i18n provides internationalization support for error messages.

Package grpc provides shared gRPC helpers for service wiring.

Package pagination provides shared gRPC pagination helpers.

Package grpcmeta provides shared gRPC metadata headers, context helpers, and request-correlation interceptors for internal services.

Package i18n provides locale helpers for the platform.

Package catalog loads and registers shared localization catalogs.

Package icons defines core icon identifiers shared across the platform.

Package id provides utilities for generating URL-safe identifiers.

Package otel provides opt-in OpenTelemetry distributed tracing for Fracturing Space services.

Package serviceaddr centralizes internal service-address conventions.

Package status provides a platform library for pushing capability health to the status service.

Package sqliteutil provides shared helper functions for SQLite storage packages.

Package timeouts defines shared timeout constants used across services.

Package admin implements the operator control surface for the platform.

Package admintest provides runtime-backed test helpers for the admin service.

Package app composes admin module mounts into one root handler.

Package composition wires admin service dependencies into module registry input.

Package module defines the feature contract used by admin composition.

Package modules defines admin module registry helpers.

Package eventview provides shared helpers for formatting and filtering domain events across admin modules.

Package errors provides admin-specific error helpers built on top of the shared httperrors package.

Package modulehandler provides shared transport helpers for admin modules.

File campaigns.go defines view data for campaign templates.

Package ai contains the AI orchestration boundary.

Package accessrequest models owner-gated approval of AI agent invocations.

Package agent models user-owned AI runtime personalities.

Package ai provides the AI service gRPC transport layer.

Package server is the AI service composition root and runtime lifecycle.

Package auditevent owns append-only AI audit-event vocabulary and storage seams for shared-access and invocation audit history.

Package campaignartifact owns campaign-scoped AI GM artifact vocabulary and storage seams shared by campaign context, tools, and transport.

Package campaigncontext owns campaign artifact defaults and path policy for AI orchestration.

Package instructionset owns AI instruction-file loading and composition for campaign orchestration.

Package memorydoc owns structured reads and edits for the AI campaign memory markdown document.

Package referencecorpus owns the read-only game-system reference corpus used by AI rules lookups.

Package credential models BYO LLM provider credentials for AI operations.

Package debugtrace defines AI GM turn-trace records and lifecycle values.

Package gamebridge owns AI-to-game collaborator policy.

Package openviking owns the optional OpenViking HTTP integration used to augment non-authoritative campaign context and sync completed turns into OpenViking sessions.

Package orchestration owns the runtime policy for campaign AI turns.

Package daggerheart provides Daggerheart game-system context sources for campaign turn orchestration prompts.

Package daggerhearttools owns Daggerheart-specific AI tool and resource execution that is no longer part of the generic gametools runtime shell.

Package gametools implements the orchestration.Session and orchestration.Dialer interfaces for direct game-service execution.

Package provider defines the shared AI provider vocabulary.

Package anthropic implements the concrete Anthropic provider adapters used by the AI runtime.

Package openai provides the concrete OpenAI adapters used by the AI service.

Package providercatalog owns provider runtime bundle registration and capability lookup for the AI service.

Package providerconnect models one provider OAuth connect-session lifecycle.

Package providergrant owns the provider-grant domain model and lifecycle.

Package provideroauth owns provider-side OAuth handshake contracts used by provider-grant connect, exchange, refresh, and optional upstream revoke workflows.

Package secret defines the encryption seam for AI service secrets.

Package service implements use-case orchestration for the AI service.

Package storage defines persistence contracts for AI aggregates.

Package sqlite provides the SQLite-backed AI persistence adapter.

Package migrations embeds SQL migration files for the AI SQLite store.

Package auth defines the identity boundary used across the platform.

Package auth implements the auth.v1 gRPC service.

Package server composes and runs the auth process boundary.

Package authtest provides auth-service-owned test helpers for bootstrapping durable auth state without pushing raw storage details into generic testkits.

Package oauth implements the auth service's first-party OAuth authorization server.

templ: version: v0.3.977

Package passkey configures WebAuthn passkey support.

Package recoverycode generates and verifies offline single-use recovery codes.

Package storage defines persistence contracts for identity assets.

Package sqlite provides SQLite-backed auth persistence.

Package migrations embeds SQL migrations for the auth SQLite store.

Package user defines the auth user model used as the shared identity anchor.

Package username canonicalizes and validates auth usernames.

Package server wires the discovery runtime and gRPC lifecycle.

Package catalog provides embedded starter discovery content that ships with the discovery service binary.

Package storage defines persistence contracts for discovery service state.

Package sqlite provides a SQLite-backed discovery storage implementation.

Package migrations embeds SQL migration files for the discovery SQLite store.

Package api contains service API implementations.

Package grpc contains gRPC service implementations and middleware.

Package game provides root transport concern builders, domain-layer adapters, and a small set of infrastructure-level gRPC services (integration, statistics, system) for the game service.

Package authorizationtransport owns the authorization gRPC service implementation, delegating policy evaluation to the authz package.

Package authz provides authorization policy enforcement, actor resolution, and telemetry for the game gRPC transport layer.

Package campaigntransport owns the campaign gRPC service implementations, application logic, protobuf mapping, and enum conversions for the campaign transport slice.

Package aitransport implements the CampaignAIService gRPC API, handling AI session grant issuance, binding usage queries, and auth state resolution.

Package readinesstransport evaluates campaign session-start readiness, aggregating participant, character, and game-system state into localized blocker reports.

Package charactertransport owns protobuf mapping and Daggerheart transport conversions for character-facing game transport flows.

Package characterworkflow defines the shared character-creation workflow contracts between the core game character transport and system-specific workflow providers.

Package eventtransport implements the gRPC transport layer for the event entity.

Package forktransport implements the gRPC transport layer for the fork entity.

Package gametest provides shared core store fakes and record fixtures for the game gRPC service and its entity-scoped subpackages.

Package handler provides shared handler utilities for the game gRPC transport layer: domain write helpers, pagination constants, actor mapping, command/event type identifiers, and social profile resolution.

Package social provides social-profile loading and snapshot synchronization for game transport handlers.

Package interactiontransport owns the scene-phase interaction gRPC transport surface including active-scene management, participant phases, OOC flow, and GM authority assignment.

Package participanttransport owns protobuf mapping and enum conversions for participant-facing transport code.

Package requestctx provides request-metadata test helpers for the game gRPC transport.

Package runtimekit provides deterministic runtime/bootstrap helpers for game gRPC transport tests.

Package scenetransport implements the gRPC transport layer for the scene entity.

Package sessiontransport owns gRPC-facing session protobuf conversions.

Package snapshottransport implements the gRPC transport layer for the snapshot entity.

Package testclients provides shared narrow RPC client doubles for game transport tests.

Package interceptors provides gRPC middleware for game services.

Package systems contains system-specific gRPC transport packages.

Package daggerheart provides the root Daggerheart gRPC service boundary.

Package adversarytransport owns Daggerheart adversary CRUD and read transport.

Package charactermutationtransport owns the Daggerheart character-scoped progression and inventory write endpoints.

Package conditiontransport owns the Daggerheart condition and life-state mutation transport surface.

Package contenttransport owns Daggerheart content and catalog read handlers.

Package countdowntransport owns the Daggerheart countdown transport surface.

Package creationworkflow implements the Daggerheart side of the shared game character-creation workflow contract.

Package damagetransport owns the Daggerheart damage-application transport surface.

Package environmenttransport owns Daggerheart environment-entity CRUD and read transport.

Package gameplaystores owns the Daggerheart gameplay service's read/write dependency bundle.

Package gmconsequence centralizes the shared gate and spotlight repair logic used when a Daggerheart GM consequence needs to surface immediately from either roll outcomes or direct GM move spends.

Package gmmovetransport owns the Daggerheart GM-move mutation transport surface.

Package guard provides shared transport-level guard contracts and helper functions for Daggerheart system handlers including campaign/session reads, campaign system validation, and session gate precondition checks.

Package mechanicstransport owns Daggerheart deterministic mechanics and read-only roll helpers.

Package outcometransport owns the Daggerheart transport handlers that derive durable roll outcomes from already-resolved roll events.

Package recoverytransport owns the Daggerheart recovery and life-state mutation transport endpoints.

Package sessionflowtransport owns the high-level Daggerheart session gameplay flow handlers that compose lower-level roll, outcome, and damage operations.

Package sessionrolltransport owns the low-level Daggerheart session gameplay roll transport surface.

Package statetransport owns shared Daggerheart gameplay-state protobuf mapping used by multiple root transport wrappers.

Package statmodifiertransport owns the Daggerheart stat modifier mutation transport surface.

Package daggerhearttestkit provides Daggerheart-owned test helpers for transport and system package tests that need Daggerheart-specific fixtures.

Package workfloweffects owns shared Daggerheart workflow side effects that are reused across multiple transport slices.

Package workflowruntime owns the shared Daggerheart workflow write/runtime support used by multiple sibling transport packages.

Package workflowtransport owns the shared helper layer for Daggerheart gameplay workflows.

Package workflowwrite owns shared Daggerheart transport write-path helpers.

Package app composes application services for the game gRPC entrypoint.

Package core provides generic RPG mechanics primitives.

Package check provides generic difficulty check primitives.

Package dice provides generic dice rolling primitives.

Package encoding provides content addressing utilities for event sourcing.

Package filter parses AIP-160 filters into SQL predicates.

Package naming normalizes and validates stable domain identifier and label naming rules.

Package random provides cryptographic seed generation helpers.

Package domain is the root of the game service's event-sourced write model.

Package action captures gameplay action signals that are usually system-owned.

Package aggregate composes aggregate folds across domain areas for replay and command execution.

Package authz defines the campaign authorization policy matrix.

Package campaign defines the campaign aggregate boundary.

Package campaignbootstrap owns the one intentional campaign bootstrap workflow that emits events across aggregate boundaries.

Package character models character entities inside a campaign.

Package checkpoint provides replay checkpoint storage implementations.

Package command defines the canonical command envelope and contract used across the write path.

Package commandids declares the canonical command type identifiers shared across transport, domain deciders, and engine validation.

Package coredomain defines the package-owned contract surface core domain packages expose to aggregate replay and engine bootstrap.

Package decide contains reusable decision-flow helpers for command deciders.

Package engine wires command validation, gate checks, lifecycle policy, decision routing, event append, and replay-backed state loading for domain command execution.

Package event defines the canonical event envelope and event-type registry used by the game domain write path.

Package fold defines the canonical Folder interface and registration-based fold routing for core domain folds.

Package fork defines campaign fork domain contracts and command/event helpers.

Package ids defines typed string newtypes for entity identifiers, providing compile-time safety against cross-entity aliasing errors.

Package contracts provides shared test contracts for architecture and domain guard assertions.

Package journal models immutable event journal metadata and utility helpers.

Package module defines the pluggable game-system layer for the write model.

Package testkit provides reusable test helpers for validating system module conformance and write-path architecture guards.

Package normalize provides generic string and ID normalization helpers, centralizing whitespace trimming so callers use a single vocabulary instead of scattered strings.TrimSpace calls.

Package participant models campaign membership and control rights.

Package readiness evaluates campaign/session readiness invariants that gate session start decisions and owns the cross-aggregate session-start workflow that consumes those invariants.

Package replay provides deterministic state reconstruction from the event log.

Package scene implements the scene domain aggregate for the game service.

Package session models the session aggregate.

Package gate implements the session gate workflow engine: workflow types, progress computation, and projection helpers.

Package systems provides the projection-side adapter registry and the API metadata registry for pluggable game systems.

Package daggerheart defines the reference Daggerheart system module.

Package filter provides AIP-160 filter parsing for Daggerheart content lists.

Package contentstore defines Daggerheart-owned content/catalog persistence contracts.

Package countdowns owns countdown-specific mutation helpers that combine pure countdown rules with canonical payload assembly.

Package dhids defines Daggerheart-specific domain entity identifier newtypes.

Package domain contains the core Daggerheart mechanics.

Package mechanics contains pure Daggerheart mechanics calculations and state transitions.

Package payload contains all Daggerheart command and event payload contracts plus the system event type constants that pair with those payloads.

Package profile applies Daggerheart profile normalization and readiness helpers.

Package projectionstore defines Daggerheart-owned projection-state persistence contracts.

Structured Daggerheart conditions are shared across transport and snapshot packages.

Package state contains the Daggerheart campaign snapshot aggregate state and all supporting value types: SnapshotState, CharacterProfile, character class/subclass/companion runtime state, adversary/environment/ countdown state, subclass track progression helpers, and factory functions.

Package manifest declares the built-in game-system descriptors used by startup.

Package i18n contains game-specific i18n message catalogs and translation helpers.

Package integration defines internal game-to-worker integration contracts.

Package observability provides observability infrastructure for the game service, including structured audit event emission and telemetry hooks.

Package audit contains durable in-product audit writes for game service operations.

Package events defines canonical game audit event names.

Package projection builds read models from immutable event history.

Package testevent defines test-only projection event fixtures used by applier and replay tests.

Package storage defines the persistence contracts for both write-side event storage and read-model materialization.

Package integrity provides event hash and signing helpers used to protect the event journal's tamper-evident chain.

Package sqlite contains SQLite persistence implementations for the game service: the event journal, read-model projections, content catalog, and outbox queues used for reliable async processing.

Package coreprojection implements the shared SQLite projection backend for the game service.

Package daggerheartcontent implements the SQLite backend for Daggerheart catalog/content persistence.

Package daggerheartprojection provides the SQLite-backed Daggerheart gameplay projection backend.

Package db contains SQLC-generated query models and interfaces for game SQLite storage.

Package eventjournal implements the SQLite-backed game event journal.

Package integrationoutbox implements the SQLite backend for durable game-owned integration outbox work.

Package migrations embeds SQL migration scripts used by SQLite backends.

Package projectionapplyoutbox implements the SQLite backend for durable projection-apply outbox queue state stored alongside the event journal.

Package invite implements the invite.v1.InviteService gRPC transport.

Package app wires the invite runtime and gRPC lifecycle.

Package storage defines the invite service storage contracts.

Package sqlite provides a SQLite-backed invite storage implementation.

Package migrations embeds SQLite schema migrations for the invite service.

Package notifications implements the notifications.v1 gRPC surface.

Package server wires notifications runtime dependencies and server lifecycle.

Package storage defines persistence contracts for notifications service state.

Package sqlite provides SQLite persistence for notifications service state.

Package migrations embeds notifications SQLite schema migrations.

Package app hosts the browser-facing play transport for the play service.

Package playtest provides runtime-backed test helpers for the play service.

Package protocol defines the browser-facing HTTP and websocket contracts for the play service.

Package daggerheart defines the Daggerheart game-system-specific browser contract types and proto-to-protocol mappers for character cards and sheets.

Package sqlite provides SQLite-backed transcript storage for the play service.

Package migrations exposes embedded SQLite migrations for play transcript data.

Package transcript defines play-owned human transcript storage contracts.

Package transcripttest provides reusable transcript store contract tests for concrete adapters.

Package httperrors provides typed HTTP application errors with gRPC error classification and consistent status mapping shared across services.

Package httpx provides shared HTTP middleware used by web and admin services.

Package i18nmessages ensures shared message catalogs are registered.

Package mcpbridge defines the session context shared by AI orchestration components.

Package modulecompose provides shared validation for HTTP module composition.

templ: version: v0.3.977

Package server wires the social runtime and gRPC lifecycle.

Package profile validates and normalizes user profile inputs.

Package storage defines persistence contracts for social service state.

Package sqlite provides a SQLite-backed social storage implementation.

Package migrations embeds SQLite schema migrations for the social service.

Package username canonicalizes and validates social usernames.

Package status implements the StatusService gRPC handler.

Package server wires the status service runtime and gRPC lifecycle.

Package domain implements in-memory capability status aggregation with staleness detection and operator override merging.

Package sqlite provides SQLite-backed override persistence for the status service.

Package userhub contains the internal service boundary for user-level experience aggregation.

Package domain contains userhub aggregation logic for user-facing dashboard summaries.

Package web owns the browser-facing service root.

Package app owns root HTTP composition policy.

Package module defines the narrow contract shared between root web assembly and area-owned modules.

Package modules owns registry composition for area modules.

Package campaigns owns authenticated campaign workspace transport routes.

Package app contains campaigns domain contracts and orchestration logic.

Package characters owns campaign character transport routes, including the dedicated character-creation workflow surface.

Package detail owns shared campaign workspace-shell transport support.

Package gateway contains campaigns transport adapters.

Package invites owns campaign invite transport routes.

Package overview owns campaign overview, campaign settings, and AI-binding transport routes.

Package participants owns campaign participant transport routes.

templ: version: v0.3.977

Package sessions owns campaign session transport routes, including the play launcher handoff.

Package workflow defines transport-owned character creation workflow seams.

Package daggerheart implements the Daggerheart-specific character-creation workflow behind the workflow.CharacterCreation contract.

Package dashboard owns authenticated dashboard transport routes.

Package app contains dashboard domain contracts and orchestration logic.

Package gateway contains dashboard transport adapters.

Package discovery owns unauthenticated discovery transport routes and the module-facing seam into discovery page orchestration.

Package app owns discovery-page orchestration and degraded-mode policy.

Package gateway owns discovery backend protocol mapping for the web module.

Package invite serves the public invitation landing flow.

Package app defines invite landing orchestration for the public invite module.

Package gateway contains transport adapters for the public invite module.

Package notifications owns authenticated notifications transport routes.

Package app contains notification domain contracts and orchestration logic.

Package gateway contains notifications transport adapters.

Package profile owns public profile transport routes.

Package app owns profile domain contracts and orchestration.

Package gateway maps external protocols into profile app contracts.

Package publicauth owns unauthenticated shell, auth, and passkey routes.

Package app owns publicauth domain contracts and orchestration.

Package gateway maps external protocols into publicauth app contracts.

Package redirectpath validates safe first-party continuation targets used by public-auth login, signup, and recovery flows.

Package settings owns authenticated user settings transport routes.

Package app contains settings domain contracts and orchestration logic.

Package gateway contains settings transport adapters.

Package platform provides shared transport and rendering utilities for the web service.

Package authctx provides web authentication seams.

Package dashboardsync owns the shared cross-module dashboard refresh policy used by web mutations.

Package errors provides web-specific typed application errors built on top of the shared httperrors package.

Package flash provides one-time web notices persisted across redirects.

Package grpcpaging provides helpers for collecting paginated gRPC results.

Package httpx provides shared HTTP request, response, and input helpers used by web modules.

Package i18n provides web-specific localization helpers.

Package modulehandler provides a composable base for protected web module handlers.

Package modulehandlertest provides test fixtures for module handler bases.

Package observability provides request middleware for web telemetry.

Package pagerender centralizes shared full-page rendering behavior.

Package publichandler provides a shared base for unauthenticated web module handlers.

Package requestmeta provides normalized request metadata helpers.

Package sessioncookie centralizes web session cookie behavior.

Package userid centralizes authenticated user-id validation for web services.

Package weberror renders shared localized error responses for web transport.

Package principal owns request-scoped identity, viewer chrome, language resolution, and the shared request-state contracts used by the browser-facing web service.

Package routepath stores canonical HTTP paths for web modules.

Package static embeds browser assets served by the web service.

templ: version: v0.3.977

Package testast provides shared AST assertion helpers for guardrail tests across the web service.

Package webtest provides runtime-backed test helpers for the web service.

Package aieval defines the shared scenario registry and JSON contract used by the AI GM evaluation CLI and Promptfoo pilot.

Package grpcassert provides shared gRPC assertion helpers for tests.

Package aifakes provides capability-specific in-memory seams for AI service tests.

Package gamefakes provides in-memory stores used by game service tests.

Package invitefakes provides lightweight in-memory fakes for the invite service storage interfaces so that transport-level tests can exercise handler logic without requiring SQLite.

Package testkit provides shared runtime-test helpers so scenario and integration suites use the same DB, content, and auth-user setup paths.

Package cli provides shared helpers for tool CLIs.

Package main checks and ratchets package-level coverage floors.

Package main generates and validates the working audit inventory used to compare the Daggerheart implementation against the extracted reference corpus.

Package main generates documentation catalogs for domain events and commands.

Package main validates shared i18n catalogs for consistency and safety.

Package main renders translator-friendly i18n status artifacts.

Package main generates the icon catalog from the shared icon registry.

Package maintenance contains event/replay tooling entrypoints for projection and outbox recovery operations.

Package scenario provides a Lua-driven scenario runner for local testing.

Package script loads scenario Lua scripts into step-oriented scenario models.

Package seed provides fixture expansion and scenario loading for local development data seeding via the declarative gRPC runner.

Package declarative provides idempotent, manifest-driven local data seeding.

Package generator produces dynamic seed data through the game gRPC APIs.

Package worldbuilder generates themed names and prompts for seed data.

Package main summarizes go test JSON output into runtime reports and live status artifacts.

Package main generates topology-derived runtime routing and compose fragments.

Package main enforces documentation comment quality rules for web packages.

Package main bootstraps auth users and session ids for web smoke workflows.