internal/

directory
v0.0.0-...-64c266f Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jul 1, 2026 License: MIT

Directories

Path Synopsis
adapter
bd
Package bd wraps the `bd` CLI.
 Package bd wraps the `bd` CLI.
dolt
Package dolt implements the core.WorkPlane adaptor by opening a direct MySQL connection to a Dolt server that hosts a beads database (gm-0fd / milestone M1).
 Package dolt implements the core.WorkPlane adaptor by opening a direct MySQL connection to a Dolt server that hosts a beads database (gm-0fd / milestone M1).
dolt/supervisor
Package supervisor spawns and supervises an embedded `dolt sql-server` subprocess for the single-user OSS core (gm-o9t8.1.2.3).
 Package supervisor spawns and supervises an embedded `dolt sql-server` subprocess for the single-user OSS core (gm-o9t8.1.2.3).
firecracker
Package firecracker — runtime egress enforcement entry points (gm-o9t8.3.6.2).
 Package firecracker — runtime egress enforcement entry points (gm-o9t8.3.6.2).
fs
Package fs provides low-latency reads of workspace runtime state files that rarely change and don't need a CLI round-trip.
 Package fs provides low-latency reads of workspace runtime state files that rarely change and don't need a CLI round-trip.
gc
Package gc wraps the `gc` CLI for Gas City workspaces.
 Package gc wraps the `gc` CLI for Gas City workspaces.
gitnexus/codeanalysis
Package codeanalysis is the GitNexus reference backend for the codeanalysis.Provider interface defined in internal/core/codeanalysis (gm-1ak).
 Package codeanalysis is the GitNexus reference backend for the codeanalysis.Provider interface defined in internal/core/codeanalysis (gm-1ak).
gt
Package gt wraps the `gt` CLI for Gas Town v1.0 workspaces.
 Package gt wraps the `gt` CLI for Gas Town v1.0 workspaces.
mock
native
Package native implements core.OrchestrationPlaneAdaptor by talking directly to shell sessions on the operator's host (tmux panes, iTerm2 tabs, Terminal.app tabs).
 Package native implements core.OrchestrationPlaneAdaptor by talking directly to shell sessions on the operator's host (tmux panes, iTerm2 tabs, Terminal.app tabs).
native/agents
Package agents loads the operator-authored .gemba/agents.toml, which lists the agent types the native adaptor can spawn (Claude Code, shell-only, future types like Codex).
 Package agents loads the operator-authored .gemba/agents.toml, which lists the agent types the native adaptor can spawn (Claude Code, shell-only, future types like Codex).
native/backend
Package backend defines the abstraction the native orchestrator adaptor calls to enumerate sessions, spawn new ones, inject keystrokes, capture output, and kill.
 Package backend defines the abstraction the native orchestrator adaptor calls to enumerate sessions, spawn new ones, inject keystrokes, capture output, and kill.
native/bridge
Package bridge parses the jsonl files gemba-bridge writes and translates each frame into a core.OrchestrationEvent.
 Package bridge parses the jsonl files gemba-bridge writes and translates each frame into a core.OrchestrationEvent.
native/claudemd
Package claudemd is the leaf utility that owns sentinel-bracketed writes to a workspace's CLAUDE.md.
 Package claudemd is the leaf utility that owns sentinel-bracketed writes to a workspace's CLAUDE.md.
native/dod
Package dod synthesizes a default DefinitionOfDone when a bead doesn't have one declared (gm-native.11).
 Package dod synthesizes a default DefinitionOfDone when a bead doesn't have one declared (gm-native.11).
native/install
native/preamble
Package preamble composes the project / workspace / work-item context layers (gm-native.10) into the format the operator's chosen agent type expects.
 Package preamble composes the project / workspace / work-item context layers (gm-native.10) into the format the operator's chosen agent type expects.
native/worktrees
Package worktrees provisions git worktrees for native-adaptor sessions (gm-native.9).
 Package worktrees provisions git worktrees for native-adaptor sessions (gm-native.9).
noop
Package noop provides minimal in-memory WorkPlane and OrchestrationPlaneAdaptor implementations used by the conformance harness (testing/) as a self-test, and by transports that need a valid zero-state adaptor while the real backend is being wired.
 Package noop provides minimal in-memory WorkPlane and OrchestrationPlaneAdaptor implementations used by the conformance harness (testing/) as a self-test, and by transports that need a valid zero-state adaptor while the real backend is being wired.
registry
Package registry holds the process-wide list of adaptors gemba can use.
 Package registry holds the process-wide list of adaptors gemba can use.
Package agentprofile implements the persistent agent profile (gm-v5z2.2, work-planning.md §4 Layer 1.2).
 Package agentprofile implements the persistent agent profile (gm-v5z2.2, work-planning.md §4 Layer 1.2).
Package auth implements authentication and authorization for the HTTP surface: token auth, TLS, and (post-v1) OIDC.
 Package auth implements authentication and authorization for the HTTP surface: token auth, TLS, and (post-v1) OIDC.
credstore
Package credstore is the client-side credential store for the gemba CLI.
 Package credstore is the client-side credential store for the gemba CLI.
oauth
Package oauth implements the GitHub OAuth device-flow integration for the gemba control plane (gm-o9t8.3.5).
 Package oauth implements the GitHub OAuth device-flow integration for the gemba control plane (gm-o9t8.3.5).
Package billing aggregates per-tenant resource usage from the audit event stream so operators can surface metering data on the productization surface (gm-o9t8.4.2 Workstream B slice b).
 Package billing aggregates per-tenant resource usage from the audit event stream so operators can surface metering data on the productization surface (gm-o9t8.4.2 Workstream B slice b).
cli
Package cli builds the Cobra command tree for the gemba binary.
 Package cli builds the Cobra command tree for the gemba binary.
serverconfig
Package serverconfig resolves the gemba server URL for CLI verbs.
 Package serverconfig resolves the gemba server URL for CLI verbs.
Package client is the typed Go HTTP client for the gemba server API (gm-o9t8.1.1.4).
 Package client is the typed Go HTTP client for the gemba server API (gm-o9t8.1.1.4).
gen
Package gen provides primitives to interact with the openapi HTTP API.
 Package gen provides primitives to interact with the openapi HTTP API.
Package concepts owns the controlled-vocabulary half of the gm-s47n two-axis planner (see docs/design/work-planning.md §6).
 Package concepts owns the controlled-vocabulary half of the gm-s47n two-axis planner (see docs/design/work-planning.md §6).
Package config: see doc.go for the overview.
 Package config: see doc.go for the overview.
core
codeanalysis
Package codeanalysis is the core typed surface for Gemba's agentic code-analysis capability (gm-l1i, design docs/design/code-analysis.md).
 Package codeanalysis is the core typed surface for Gemba's agentic code-analysis capability (gm-l1i, design docs/design/code-analysis.md).
persona
Package persona is the parsed-config layer for Gemba personas (gm-57b / gm-518).
 Package persona is the parsed-config layer for Gemba personas (gm-57b / gm-518).
phase
Package phase implements the project-level Phase primitive (gm-jt9, design docs/design/persona-pppp.md §3 + invariants #29–30).
 Package phase implements the project-level Phase primitive (gm-jt9, design docs/design/persona-pppp.md §3 + invariants #29–30).
projectshape
Package projectshape introduces named, shared understandings of the implementation pattern a workspace follows — the "architectural archetype" the project lives under (gm-4uso).
 Package projectshape introduces named, shared understandings of the implementation pattern a workspace follows — the "architectural archetype" the project lives under (gm-4uso).
prompt
Package prompt holds PromptEnvelope — the cross-cutting composition layer that produces every persona/skill invocation's final prompt from separately-owned pieces.
 Package prompt holds PromptEnvelope — the cross-cutting composition layer that produces every persona/skill invocation's final prompt from separately-owned pieces.
promptctx
Package promptctx: see doc.go for the overview.
 Package promptctx: see doc.go for the overview.
promptctx/providers
Package providers: see doc.go for the overview.
 Package providers: see doc.go for the overview.
promptctx/providers/codeanalysis
Package codeanalysis provides four prompt-ctx providers that adapt a codeanalysis.Provider (the typed knowledge-graph surface from gm-1ak) into context-provider Result fragments the persona prompt envelope splices in (gm-bro).
 Package codeanalysis provides four prompt-ctx providers that adapt a codeanalysis.Provider (the typed knowledge-graph surface from gm-1ak) into context-provider Result fragments the persona prompt envelope splices in (gm-bro).
Package dispatch defines the runtime-strategy seam between Gemba's classic native (tmux-backed) dispatch path and the new microVM (Firecracker) dispatch path landing in gm-o9t8.3.2.*.
 Package dispatch defines the runtime-strategy seam between Gemba's classic native (tmux-backed) dispatch path and the new microVM (Firecracker) dispatch path landing in gm-o9t8.3.2.*.
Package egress is the per-workspace egress-policy storage layer (gm-o9t8.3.6.1).
 Package egress is the per-workspace egress-policy storage layer (gm-o9t8.3.6.1).
Package enrichment owns the Enrichment data type the gm-s47n.1 epic adds to every WorkItem (targets[] glob patterns + concepts[] vocabulary tags) plus the Store interface the CLI / planner / future LLM-extraction path read and write through.
 Package enrichment owns the Enrichment data type the gm-s47n.1 epic adds to every WorkItem (targets[] glob patterns + concepts[] vocabulary tags) plus the Store interface the CLI / planner / future LLM-extraction path read and write through.
log
Package log is the append-only NDJSON event log with rotation, retention, and post-rotate archival.
 Package log is the append-only NDJSON event log with rotation, retention, and post-rotate archival.
Package evidence implements the shared evidence-synthesis library (gm-e11.6, resolves DD-13).
 Package evidence implements the shared evidence-synthesis library (gm-e11.6, resolves DD-13).
Package model defines the shared domain types used across adapters, the API layer, and (via codegen) the TypeScript frontend.
 Package model defines the shared domain types used across adapters, the API layer, and (via codegen) the TypeScript frontend.
Package persona is the runtime invocation layer for personas.
 Package persona is the runtime invocation layer for personas.
purviewgate
Package purviewgate binds a Persona's corepersona.Purview to the Manager-mutation path (gm-3on, follow-up to gm-9rv).
 Package purviewgate binds a Persona's corepersona.Purview to the Manager-mutation path (gm-3on, follow-up to gm-9rv).
personas
onboarder
Package onboarder implements the Onboarder persona — the transient, single-skill host for the newproject skill (gm-root.17.10).
 Package onboarder implements the Onboarder persona — the transient, single-skill host for the newproject skill (gm-root.17.10).
Package planner is the home of the two-axis work planning and dispatch subsystem (gm-s47n, docs/design/work-planning.md).
 Package planner is the home of the two-axis work planning and dispatch subsystem (gm-s47n, docs/design/work-planning.md).
autodispatch
Package autodispatch implements the auto-dispatch daemon (gm-s47n.6.3, work-planning.md §4 Layer 5.2).
 Package autodispatch implements the auto-dispatch daemon (gm-s47n.6.3, work-planning.md §4 Layer 5.2).
claims
Package claims implements the per-rig owner-claim cross-check (gm-v5z2.6, work-planning.md §4 Layer 5.1 inputs + §4 Layer 5.2 gate 2).
 Package claims implements the per-rig owner-claim cross-check (gm-v5z2.6, work-planning.md §4 Layer 5.1 inputs + §4 Layer 5.2 gate 2).
conflicts
Package conflicts is the bead-set conflict scorer (gm-s47n.4.3).
 Package conflicts is the bead-set conflict scorer (gm-s47n.4.3).
dispatch
Package dispatch persists dispatch decisions — the moment a coach (or, later, the auto-dispatch daemon) picks a bead for a session (gm-s47n.6.2, work-planning.md §5 Layer 5).
 Package dispatch persists dispatch decisions — the moment a coach (or, later, the auto-dispatch daemon) picks a bead for a session (gm-s47n.6.2, work-planning.md §5 Layer 5).
intent
Package intent implements the operator-pinned session focus directive (gm-v5z2.3, work-planning.md §4 Layer 1.3).
 Package intent implements the operator-pinned session focus directive (gm-v5z2.3, work-planning.md §4 Layer 1.3).
retro
Package retro implements the turn-retrospective comparator (gm-s47n.8.1, work-planning.md §7).
 Package retro implements the turn-retrospective comparator (gm-s47n.8.1, work-planning.md §7).
runway
Package runway implements the per-session runway estimator (gm-v5z2.4, work-planning.md §4 Layer 5.1).
 Package runway implements the per-session runway estimator (gm-v5z2.4, work-planning.md §4 Layer 5.1).
scanscheduler
Package scanscheduler owns scheduling re-indexing of the source analysis tool (gm-s47n.9, work-planning.md §8).
 Package scanscheduler owns scheduling re-indexing of the source analysis tool (gm-s47n.9, work-planning.md §8).
scoring
Package scoring implements the WP2.0 score components Selection (gm-v5z2.7) composes:
 Package scoring implements the WP2.0 score components Selection (gm-v5z2.7) composes:
selection
Package selection implements the WP2.0 Layer 5 Selection step (gm-v5z2.7, work-planning.md §4 Layer 5).
 Package selection implements the WP2.0 Layer 5 Selection step (gm-v5z2.7, work-planning.md §4 Layer 5).
semantic
Package semantic implements the gm-s47n.4.2 SemanticDetector for the conflicts package: two beads conflict semantically when one bead's targets are dependents of the other bead's targets in the SourceAnalysis index.
 Package semantic implements the gm-s47n.4.2 SemanticDetector for the conflicts package: two beads conflict semantically when one bead's targets are dependents of the other bead's targets in the SourceAnalysis index.
sizecalibration
Package sizecalibration implements the bead-size calibration loop (gm-v5z2.8 part b, work-planning.md §7.6).
 Package sizecalibration implements the bead-size calibration loop (gm-v5z2.8 part b, work-planning.md §7.6).
targets
Package targets implements the target-overlap glob algorithm (gm-s47n.4.1) — given two WorkItems' target glob sets, decides whether they could touch the same concrete file path.
 Package targets implements the target-overlap glob algorithm (gm-s47n.4.1) — given two WorkItems' target glob sets, decides whether they could touch the same concrete file path.
qa
linters
Package linters models the QA persona's configurable lint and style catalog.
 Package linters models the QA persona's configurable lint and style catalog.
regression
Package regression seeds the QA persona's regression-suite registry.
 Package regression seeds the QA persona's regression-suite registry.
Package quota implements a per-tenant token-bucket rate limiter for gemba's control-plane mutating routes (gm-o9t8.4.x — workstream B slice a).
 Package quota implements a per-tenant token-bucket rate limiter for gemba's control-plane mutating routes (gm-o9t8.4.x — workstream B slice a).
Package server wires the HTTP surface: chi router, SPA fallback, JSON API, and the SSE hub.
 Package server wires the HTTP surface: chi router, SPA fallback, JSON API, and the SSE hub.
audit
Package audit is an append-only, hash-chained, signed audit log for agent actions on gemba-server.
 Package audit is an append-only, hash-chained, signed audit log for agent actions on gemba-server.
dispatch
Package dispatch holds the server-side routing policy that decides whether a new bead should co-locate in an existing intra-parallel session or trigger a fresh pane spawn (gm-root.16.4).
 Package dispatch holds the server-side routing policy that decides whether a new bead should co-locate in an existing intra-parallel session or trigger a fresh pane spawn (gm-root.16.4).
dolthub
Package dolthub wraps server-side Dolt remote push/pull for a workspace's project state.
 Package dolthub wraps server-side Dolt remote push/pull for a workspace's project state.
gitops
Package gitops wraps server-side git operations against the workspace checkout.
 Package gitops wraps server-side git operations against the workspace checkout.
httperr
Package httperr is the single place every gemba data handler goes to turn a Go error into the wire-stable JSON error envelope.
 Package httperr is the single place every gemba data handler goes to turn a Go error into the wire-stable JSON error envelope.
metrics
Package metrics binds the GembaEvent stream to a Prometheus /metrics endpoint so operators can scrape adaptor health, session activity, escalation pressure, and budget posture without standing up an OTEL collector.
 Package metrics binds the GembaEvent stream to a Prometheus /metrics endpoint so operators can scrape adaptor health, session activity, escalation pressure, and budget posture without standing up an OTEL collector.
middleware
gm-o9t8.4.2.1 — tier-aware quota + rate-limit middleware.
 gm-o9t8.4.2.1 — tier-aware quota + rate-limit middleware.
restore
Package restore implements gemba-server's "reconstruct from remotes" flow: given a git remote (canonical source) and an optional Dolt remote (canonical project state), reproduce a workable workspace on a fresh machine.
 Package restore implements gemba-server's "reconstruct from remotes" flow: given a git remote (canonical source) and an optional Dolt remote (canonical project state), reproduce a workable workspace on a fresh machine.
secrets
Package secrets provides a per-workspace encrypted-at-rest secret vault for gemba-server.
 Package secrets provides a per-workspace encrypted-at-rest secret vault for gemba-server.
workspacelayout
Package workspacelayout owns the on-disk layout for a single Gemba workspace's per-workspace data tree (gm-o9t8.1.2.4).
 Package workspacelayout owns the on-disk layout for a single Gemba workspace's per-workspace data tree (gm-o9t8.1.2.4).
gastown
skills
bootstrap_review
epic_order
Package epic_order implements the Project Manager's first Skill: rank a set of candidate Epics for staging into a sprint.
 Package epic_order implements the Project Manager's first Skill: rank a set of candidate Epics for staging into a sprint.
escalation_handoff
Package escalation_handoff implements the dispatcher skill behind the EscalationsPage Hand-off action (gm-e11.8.7).
 Package escalation_handoff implements the dispatcher skill behind the EscalationsPage Hand-off action (gm-e11.8.7).
newproject
Package newproject implements the Onboarder persona's bundled conversational skill (gm-root.17.5).
 Package newproject implements the Onboarder persona's bundled conversational skill (gm-root.17.5).
walk_summary
Package walk_summary implements the Documentarian persona's walk-end artifact skill (gm-77u).
 Package walk_summary implements the Documentarian persona's walk-end artifact skill (gm-77u).
Package sourceanalysis defines the abstract code-analysis surface the planner consumes when computing semantic conflicts (gm-s47n.3, docs/design/work-planning.md §4 Layer 2).
 Package sourceanalysis defines the abstract code-analysis surface the planner consumes when computing semantic conflicts (gm-s47n.3, docs/design/work-planning.md §4 Layer 2).
Package spec hosts the ASDD interception layer: templates, constitution parsing, hook handlers, and the project scaffolding that ships with `gemba init --asdd` and `gemba spec new --kit`.
 Package spec hosts the ASDD interception layer: templates, constitution parsing, hook handlers, and the project scaffolding that ships with `gemba init --asdd` and `gemba spec new --kit`.
analyzer
Package analyzer converts a rejected tasks.md / todo.md payload into a structured Proposal of beads (milestones / epics / stories) that the caller can review and optionally materialize via `bd create`.
 Package analyzer converts a rejected tasks.md / todo.md payload into a structured Proposal of beads (milestones / epics / stories) that the caller can review and optionally materialize via `bd create`.
apply
Package apply executes a reconcile.Plan against bd, gated by the spec's nonce.
 Package apply executes a reconcile.Plan against bd, gated by the spec's nonce.
constitution
Package constitution parses the project constitution document.
 Package constitution parses the project constitution document.
hook
Package hook implements the PreToolUse hook handlers that reject writes to tasks.md / todo.md in ASDD-strict projects.
 Package hook implements the PreToolUse hook handlers that reject writes to tasks.md / todo.md in ASDD-strict projects.
hooks
Package hooks implements operator-facing safety gates that wrap bd lifecycle events with spec-awareness.
 Package hooks implements operator-facing safety gates that wrap bd lifecycle events with spec-awareness.
lint
Package lint implements constitution-driven lint rules.
 Package lint implements constitution-driven lint rules.
lockfile
Package lockfile defines the spec ↔ bead mapping file written next to a spec.md.
 Package lockfile defines the spec ↔ bead mapping file written next to a spec.md.
parser
Package parser provides parsing for the canonical ASDD Phase 2 spec.md format: YAML frontmatter followed by sectioned markdown.
 Package parser provides parsing for the canonical ASDD Phase 2 spec.md format: YAML frontmatter followed by sectioned markdown.
preflight
Package preflight implements `gemba spec preflight --slug <slug>`: the safety check the gemba-shipped /implement slash command runs before working a bead.
 Package preflight implements `gemba spec preflight --slug <slug>`: the safety check the gemba-shipped /implement slash command runs before working a bead.
promote
Package promote provides decision-promotion plumbing for ASDD: bd mail threads tagged spec-decision:<slug> can be surfaced to a human as a PR-style unified diff that appends a new entry under a spec's `## Decisions` section.
 Package promote provides decision-promotion plumbing for ASDD: bd mail threads tagged spec-decision:<slug> can be surfaced to a human as a PR-style unified diff that appends a new entry under a spec's `## Decisions` section.
reconcile
Package reconcile is the pure planner for the ASDD interception layer.
 Package reconcile is the pure planner for the ASDD interception layer.
scaffold
Package scaffold writes ASDD project artifacts (slash commands, hooks, constitution, CLAUDE.md stanza) into a target project root.
 Package scaffold writes ASDD project artifacts (slash commands, hooks, constitution, CLAUDE.md stanza) into a target project root.
snapshot
Package snapshot writes content-addressed, frozen copies of a spec.md.
 Package snapshot writes content-addressed, frozen copies of a spec.md.
Package speckit reads Spec Kit planning artifacts and projects them onto Gemba work items.
 Package speckit reads Spec Kit planning artifacts and projects them onto Gemba work items.
Package sse implements a minimal Server-Sent Events consumer.
 Package sse implements a minimal Server-Sent Events consumer.
Package tenant defines the canonical tenant + workspace identifier types for the multi-tenant control plane (gm-o9t8.3.9).
 Package tenant defines the canonical tenant + workspace identifier types for the multi-tenant control plane (gm-o9t8.3.9).
Package transport hosts the three wire shims (api, jsonl, mcp) that bind adaptors to the core.
 Package transport hosts the three wire shims (api, jsonl, mcp) that bind adaptors to the core.
api
Package api is the JSON-over-HTTP transport shim.
 Package api is the JSON-over-HTTP transport shim.
jsonl
Package jsonl is the newline-delimited JSON transport shim, used by streaming surfaces (SSE event hubs, log tails, watcher pipelines) and by stdio-dispatched in-process adaptors.
 Package jsonl is the newline-delimited JSON transport shim, used by streaming surfaces (SSE event hubs, log tails, watcher pipelines) and by stdio-dispatched in-process adaptors.
mcp
Package mcp is the Model Context Protocol transport shim, exposing Gemba's read surface to MCP-aware clients (Claude Desktop, IDE plugins).
 Package mcp is the Model Context Protocol transport shim, exposing Gemba's read surface to MCP-aware clients (Claude Desktop, IDE plugins).
testadaptors
Package testadaptors provides lightweight fake adaptors used by the transport host tests and the adaptor-register CLI tests.
 Package testadaptors provides lightweight fake adaptors used by the transport host tests and the adaptor-register CLI tests.
Package vault is the local-only secrets vault that backs Gemba Remote M3 (gm-o9t8.3.7).
 Package vault is the local-only secrets vault that backs Gemba Remote M3 (gm-o9t8.3.7).
Package walk implements the Gemba walk core (gm-rfy, design docs/design/gemba-walk.md).
 Package walk implements the Gemba walk core (gm-rfy, design docs/design/gemba-walk.md).
sources
Package sources contains the live wiring between Gemba's data planes (OrchestrationPlane today; Witness, Refinery, Beads-degraded, Budget, Adaptor-degraded later) and the gm-rfy walk agenda aggregator.
 Package sources contains the live wiring between Gemba's data planes (OrchestrationPlane today; Witness, Refinery, Beads-degraded, Budget, Adaptor-degraded later) and the gm-rfy walk agenda aggregator.
Package workflow wraps the bd CLI's formula + mol surfaces behind a thin Go client (gm-e12.22.2).
 Package workflow wraps the bd CLI's formula + mol surfaces behind a thin Go client (gm-e12.22.2).
Package workspaces is the multi-tenant workspace registry (gm-o9t8.2.4).
 Package workspaces is the multi-tenant workspace registry (gm-o9t8.2.4).

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.