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). |
|
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. |
|
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/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. |
|
Package cli builds the Cobra command tree for the gemba binary.
|
Package cli builds the Cobra command tree for the gemba binary. |
|
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 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 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. |
|
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). |
|
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. |
|
skills
|
|
|
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 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 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 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). |
Click to show internal directories.
Click to hide internal directories.