Documentation
¶
Index ¶
- Constants
- Variables
- type AgentActivity
- type AtlassianCredentialRefs
- type Automation
- type AutomationAgent
- type AutomationCommand
- type Config
- type ConfluenceIntegration
- type Debug
- type DirtyScopeRecovery
- type DurableWorkflows
- type GeneratedArtifactVerification
- type GitOperations
- type GitOpsConventions
- type HarnessConfig
- type Ingestion
- type IntegrationConfig
- type IntegrationPolling
- type JiraIntegration
- type Logging
- type PostPRChecks
- type Project
- type SQLite
- type Verification
- type WorkPlanStatusTrigger
- type WorkflowChain
- type WorkflowChainStage
- type Workflows
- type Workspace
Constants ¶
View Source
const ( StorageEngineEmbedded = "embedded" StorageEngineOnline = "online" )
Variables ¶
View Source
var ErrNonLoopbackBind = errors.New("non_loopback_bind_attempt")
Functions ¶
This section is empty.
Types ¶
type AgentActivity ¶ added in v0.1.12
type AgentActivity struct {
RetainRawPayloads bool
}
type AtlassianCredentialRefs ¶
type Automation ¶ added in v0.1.19
type Automation struct {
Enabled bool
RunnerEnabled bool
RequireCodexWhenAvailable bool
AllowManualRunner bool
RunnerExecution string
QueueDepth int
PollInterval time.Duration
GlobalWorkerCount int
PerProjectWorkerLimit int
PerAgentWorkerLimit int
MaxParallelTasks int
DefaultMaxRuntime time.Duration
ExternalRunLeaseTTL time.Duration
DefaultMaxRetries int
RecoveryMaxReplacementRunsPerTask int
ReworkBudgetPerTask int
// ClaimFullReconcileCooldown bounds how often a runner performs a full
// reconciliation sweep during claim for a given project. Defaults to 30s.
ClaimFullReconcileCooldown time.Duration
// ClaimBroadReconcileTaskBatchLimit bounds project-wide ready/promotion work
// performed by the broad claim reconcile pass. Defaults to 32.
ClaimBroadReconcileTaskBatchLimit int
// ReviewGateTimeout is the max duration a task may stay in needs_review
// without a review ref before auto-exemption (when it has impl evidence).
// Default 0 = disabled.
ReviewGateTimeout time.Duration
// MaxFindingsPerAudit bounds confirmed high-confidence findings remediated
// per area-bug-audit run. Default defaultMaxFindingsPerAudit (10). The MCP
// max_findings override is clamped to MaxFindingsPerAuditCeiling (50).
MaxFindingsPerAudit int
ChainGitOpsRecoveryMaxAttempts int
ReconcilerGitOpsResets int
// ChainGitOpsAdvisoryProceedEnabled, when true (default), converts a
// verifier failure that has persisted through the full reconciler reset
// budget into an advisory proceed (draft PR with a verifier warning) instead
// of permanently terminal-blocking. Per policy, workflow gates are advisory
// by default; set false to require the verifier to pass (legacy hard-block).
ChainGitOpsAdvisoryProceedEnabled bool
CodexBinaryPath string
DefaultHarness string
Harnesses []HarnessConfig
Agents []AutomationAgent
WorkPlanStatusTrigger WorkPlanStatusTrigger
}
func (Automation) Validate ¶ added in v0.1.19
func (automation Automation) Validate() error
type AutomationAgent ¶ added in v0.1.19
type AutomationAgent struct {
ID string
DisplayName string
Purpose string
Enabled bool
AllowedSkills []string
AllowedTools []string
AllowedCommands []AutomationCommand
DeniedCommands []string
WorkspaceMode string
NetworkPolicy string
SecretPolicy string
LogPolicy string
MaxRuntime time.Duration
MaxRetries int
}
func (AutomationAgent) Validate ¶ added in v0.1.19
func (agent AutomationAgent) Validate() error
type AutomationCommand ¶ added in v0.1.19
type Config ¶
type Config struct {
ConfigPath string
CPUCount int
HTTPAddr string
StorageEngine string
LadybugPath string
SQLitePath string
SQLite SQLite
Debug Debug
Logging Logging
MaxRequestBytes int64
RequestTimeout time.Duration
ReadHeaderTimeout time.Duration
ShutdownTimeout time.Duration
Ingestion Ingestion
Workspace Workspace
Workflows Workflows
DurableWorkflows DurableWorkflows
AgentActivity AgentActivity
Automation Automation
GitOperations GitOperations
Verification Verification
Projects []Project
}
type ConfluenceIntegration ¶
type ConfluenceIntegration struct {
Enabled bool
SiteURL string
CloudID string
AuthMode string
CredentialRefs AtlassianCredentialRefs
ReadTimeout time.Duration
MaxResults int
Polling IntegrationPolling
SpaceKeys []string
BodyRepresentation string
IncludeBody bool
IncludeComments bool
IncludeLabels bool
IncludeProperties bool
RootPageIDs []string
CQLExtraFilter string
}
type DirtyScopeRecovery ¶ added in v0.2.4
type DirtyScopeRecovery struct {
AllowedSupportPathspecs []string
}
func (DirtyScopeRecovery) Validate ¶ added in v0.2.4
func (recovery DirtyScopeRecovery) Validate(prefix string) error
type DurableWorkflows ¶ added in v0.3.0
type DurableWorkflows struct {
Enabled bool
ShadowMode bool
Backend string
SQLitePath string
WorkerEnabled bool
MaxParallelRuns int
}
func (DurableWorkflows) Validate ¶ added in v0.3.0
func (durable DurableWorkflows) Validate() error
type GeneratedArtifactVerification ¶ added in v0.2.4
type GitOperations ¶ added in v0.2.3
type GitOperations struct {
Enabled bool
CommitAfterTask bool
PushAfterTask bool
DraftPRAfterPush bool
// MarkPRAfterFinalize defaults to true: flip the draft PR to "ready for
// review" (gh pr ready) after finalization creates it.
MarkPRAfterFinalize bool
RequireCleanBeforeTask bool
CleanupWorktreeAfterPlanDone bool
RemoteName string
// DefaultBranch is the project's default branch (main, master, develop, ...).
// Empty (the default) means resolve at runtime from the remote HEAD
// symbolic-ref, falling back to "main". When set, this wins over runtime
// resolution and is used as the fetch+rebase base before push (MASS-3997).
DefaultBranch string
BranchPrefix string
BranchNamePattern string
CommitAuthorName string
CommitAuthorEmailEnv string
CommitAuthorEmailFile string
SignCommits bool
SSHPrivateKeyPath string
SSHPublicKeyPath string
SSHKnownHostsPath string
GitHubTokenEnv string
GitHubTokenFile string
GitHubCLIPath string
GitHubAuthPreflight bool
// WhitespaceWarningOnDiffCheck converts `git diff --cached --check` failures
// (trailing whitespace, missing/extra final newline, blank lines at EOF) into
// soft warning evidence instead of a terminal block. Per the automation
// pipeline policy this whitespace/newline drift is a forbidden soft blocker.
// Defaults to true; opt out with `whitespace_warning_on_diff_check = false`.
WhitespaceWarningOnDiffCheck bool
// PushMaxAttempts bounds in-function retries for `git push` on transient
// network errors (5xx/timeout/rate-limit) before the failure surfaces to the
// chain-level retry budget. Defaults to 3; set to 1 to disable in-function retry.
PushMaxAttempts int
// PushBackoffBase is the base delay (exponential) for push transient retry.
// Defaults to 5s.
PushBackoffBase time.Duration
// PRCreateMaxAttempts bounds in-function retries for `gh pr create` on
// transient network errors. Defaults to 3; set to 1 to disable.
PRCreateMaxAttempts int
// PRCreateBackoffBase is the base delay (exponential) for pr-create retry.
// Defaults to 5s.
PRCreateBackoffBase time.Duration
// BypassRepoCommitHooks appends --no-verify to every automation git commit.
// Opt-in via MIVIA_GIT_OPS_BYPASS_REPO_COMMIT_HOOKS or TOML
// bypass_repo_commit_hooks. Default false. Enable for repos whose pre-commit
// hook breaks automation on internals (e.g. mass-monorepo Husky with
// set -euo pipefail running lint-staged that fails on pnpm warnings). The
// pipeline runs its own verifiers via runPostCommitVerification, so the repo
// hook is redundant double-validation when enabled.
BypassRepoCommitHooks bool
Conventions GitOpsConventions
DirtyScopeRecovery DirtyScopeRecovery
PostPRChecks PostPRChecks
}
func (GitOperations) Validate ¶ added in v0.2.3
func (gitops GitOperations) Validate() error
type GitOpsConventions ¶ added in v0.2.4
type GitOpsConventions struct {
CommitType string
CommitScope string
BranchTemplate string
RequireTicketRef bool
TicketRefPattern string
TicketURLTemplate string
AllowedTypes []string
DefaultChangeType string
CommitSummaryTemplate string
PullRequestTitleTemplate string
PullRequestBodyTemplate string
WhatChangedTemplate string
HowVerifiedTemplate string
TestsTemplate string
}
func (GitOpsConventions) Validate ¶ added in v0.2.4
func (conventions GitOpsConventions) Validate() error
type HarnessConfig ¶ added in v0.3.0
type HarnessConfig struct {
Name string
Adapter string
BinaryPath string
DefaultModel string
Provider string
}
HarnessConfig is a named, reusable harness profile declared under [[automation.harnesses]] in the server config. It bundles an adapter + binary path + optional default model/provider so workflow agents and runner pools can reference it by name instead of repeating raw values.
type Ingestion ¶
type Ingestion struct {
ContentGraphEnabled bool
LiveUpdatesEnabled bool
ASTExtractionEnabled bool
ExtractorCacheEnabled bool
DebounceInterval time.Duration
MaxFileBytes int64
MaxChunkBytes int
QueueDepth int
WorkerCount int
GlobalWorkerCount int
PerProjectWorkerLimit int
LivePathPriority bool
MaxWatchedDirectoryCount int
TaskWarnAfter time.Duration
FullScanBatchSize int
InitialScanOnStart bool
RestartRecoveryScan bool
SensitiveMarkerPolicy string
}
type IntegrationConfig ¶
type IntegrationConfig struct {
Jira *JiraIntegration
Confluence *ConfluenceIntegration
}
type IntegrationPolling ¶
type JiraIntegration ¶
type JiraIntegration struct {
Enabled bool
SiteURL string
CloudID string
AuthMode string
CredentialRefs AtlassianCredentialRefs
ReadTimeout time.Duration
MaxResults int
Polling IntegrationPolling
ProjectKeys []string
DefaultFields []string
AllowedFields []string
IncludeRichFields bool
IncludeComments bool
JQLExtraFilter string
}
type PostPRChecks ¶ added in v0.3.0
type Project ¶
type Project struct {
ID string
Aliases []string
DisplayName string
Description string
RootPath string
Enabled bool
// WorkflowsLocalEnabled controls whether the server imports the project's
// local workflow TOML files at startup. Default true: project-local
// workflow files are the single source of truth for that project's workflow
// definitions, mirroring the .agentic/skills/ and .agentic/policies/
// convention. Set false to force a project to use only the global
// [workflows] seed.
WorkflowsLocalEnabled bool
// WorkflowsLocalDir is the project-relative directory scanned for local
// workflow definitions. Default ".agentic/workflows". Override per-project
// when a repo stores its workflow TOMLs elsewhere.
WorkflowsLocalDir string
// WorkflowsLocalGlob is the filename glob applied inside WorkflowsLocalDir.
// Default "governed-*.toml". An empty glob skips the project (safe default;
// importing arbitrary *.toml is opt-in, never implicit).
WorkflowsLocalGlob string
Classification string
GraphNamespace string
GraphStorage string
DigestMode string
UpdatePolicy string
WorkspaceMode string
Include []string
Exclude []string
FollowSymlinks bool
MaxFileBytes int64
MaxChunkBytes int
SensitiveMarkerPolicy string
Integrations IntegrationConfig
GitOperations *GitOperations
Verification *Verification
WorkflowChains []WorkflowChain
}
type SQLite ¶
type Verification ¶ added in v0.2.4
type Verification struct {
BootstrapCommands []string
AlwaysBeforePR []string
AutofixCommands []string
GeneratedArtifacts []GeneratedArtifactVerification
Env map[string]string
}
func (Verification) Validate ¶ added in v0.2.4
func (verification Verification) Validate(prefix string) error
type WorkPlanStatusTrigger ¶ added in v0.2.1
func (WorkPlanStatusTrigger) Validate ¶ added in v0.2.1
func (trigger WorkPlanStatusTrigger) Validate() error
type WorkflowChain ¶ added in v0.2.5
type WorkflowChainStage ¶ added in v0.2.5
Click to show internal directories.
Click to hide internal directories.