Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

intelligence

package

Go to main page

Versions in this module

v1

v1.1.0

Sep 7, 2026

Changes in this version

+ const FocusSchemaVersion

+ func FocusSummary(result FocusResult) string

type CallEdge

+ CallSites []Location

type Capabilities

+ FocusRefresh string

+ FocusRelations []string

+ FocusSchema string

+ FocusSelectors []string

type Core

+ func (c *Core) Focus(ctx context.Context, request FocusRequest) (FocusResult, error)

+ type EvidenceState struct

+ Facet string

+ Reason string

+ State string

+ type FocusCallSite struct

+ Caller SymbolMatch

+ Location Location

+ Reason string

+ type FocusContext struct

+ CallSites []FocusCallSite

+ Candidates []SymbolMatch

+ EvidenceStates []EvidenceState

+ Excerpts []SourceExcerpt

+ Reasons []string

+ Selection FocusSelection

+ Symbol *SymbolContext

+ TestDeclarations []SymbolMatch

+ Truncated bool

+ TypedEvidence *TypedEvidence

+ Uncertainties []Uncertainty

+ type FocusRefresh struct

+ Message string

+ PreviousPackID string

+ Status string

+ type FocusRequest struct

+ Base string

+ ExpectedSnapshotID string

+ FailOn verification.FailOn

+ FocusFile string

+ FocusPackage string

+ MaxBytes int

+ MaxPackages int

+ MinChangedCoverage *float64

+ Position *SourcePosition

+ PreviousPackID string

+ Query string

+ Race bool

+ Scope string

+ SymbolRef SymbolRef

+ type FocusResult struct

+ Change verification.Change

+ Complete bool

+ Context *FocusContext

+ Impact verification.Impact

+ ObservedPackages int

+ PackID string

+ Provider Provider

+ Refresh *FocusRefresh

+ Risks []verification.RiskArea

+ SchemaVersion string

+ Snapshot SnapshotRef

+ Uncertainties []verification.Uncertainty

+ Verification VerificationApplicability

+ type FocusSelection struct

+ File string

+ Package string

+ Position *SourcePosition

+ Query string

+ SymbolRef SymbolRef

+ type GoRelationship struct

+ Availability string

+ Build BuildConfig

+ Evidence string

+ Kind string

+ Limits []string

+ Location Location

+ Object string

+ Subject string

type Service

+ Focus func(context.Context, FocusRequest) (FocusResult, error)

+ type SourceExcerpt struct

+ Location Location

+ Text string

+ type TypedEvidence struct

+ Complete bool

+ Relationships []GoRelationship

+ Truncated bool

+ Uncertainties []Uncertainty

+ type VerificationApplicability struct

+ Applicable bool

+ NextAction string

+ Outcome verification.ResultStatus

+ Present bool

+ Reasons []string

+ ReportID string

v1.0.0

Aug 30, 2026

Changes in this version

+ const ChangeSchemaVersion

+ const ContextSchemaVersion

+ const DefaultBriefBytes

+ const DefaultSearchLimit

+ const DefaultSymbolBytes

+ const MaxArtifactChunkBytes

+ const MaximumSearchLimit

+ const RefactorFixAll

+ const RefactorFormat

+ const RefactorOrganizeImports

+ const RefactorRecoveryClean

+ const RefactorRecoveryRecovered

+ const RefactorRecoveryRequired

+ const RefactorRename

+ var ErrArtifactCorrupt = errors.New("artifact corrupt")

+ var ErrArtifactLimit = errors.New("invalid artifact chunk limit")

+ var ErrArtifactMismatch = errors.New("artifact binding mismatch")

+ var ErrArtifactNotFound = errors.New("artifact not found")

+ var ErrArtifactOffset = errors.New("artifact offset out of range")

+ var ErrContractCorrupt = errors.New("change contract is corrupt")

+ var ErrContractNotFound = errors.New("change contract not found")

+ var ErrCursorInvalid = errors.New("invalid artifact cursor")

+ var ErrSnapshotChanged = errors.New("workspace snapshot changed")

+ var ErrVerificationCorrupt = errors.New("verification report is corrupt")

+ var ErrVerificationNotFound = errors.New("verification report not found")

+ func EncodeArtifactCursor(id string, offset int64) (string, error)

+ type Artifact struct

+ ID string

+ Key string

+ Payload []byte

+ SnapshotID string

+ type ArtifactChunk struct

+ Complete bool

+ ID string

+ NextCursor string

+ Offset int64

+ SnapshotID string

+ Text string

+ TotalBytes int64

+ type ArtifactCursor struct

+ ID string

+ Offset int64

+ func DecodeArtifactCursor(cursor, expectedID string) (ArtifactCursor, error)

+ type ArtifactStore struct

+ func NewArtifactStore(root string) (*ArtifactStore, error)

+ func (s *ArtifactStore) Get(id, expectedSnapshotID, expectedKey string) (Artifact, error)

+ func (s *ArtifactStore) Put(snapshotID, key string, payload []byte) (Artifact, error)

+ func (s *ArtifactStore) ReadChunk(ctx context.Context, id, cursor string, offset, limit int64) (ArtifactChunk, error)

+ type BeginRequest struct

+ AllowedPaths []string

+ Base string

+ FocusedPackages []string

+ FocusedPaths []string

+ FocusedSymbols []SymbolRef

+ Goal string

+ Policies StructuralPolicies

+ Scope string

+ type BriefRequest struct

+ Base string

+ ExpectedSnapshotID string

+ MaxBytes int

+ Scope string

+ type BuildConfig struct

+ CGOEnabled bool

+ GOARCH string

+ GOFLAGS string

+ GOOS string

+ Tags []string

+ Workspace string

+ type CallEdge struct

+ Direction string

+ Symbol SymbolMatch

+ type CallSet struct

+ Items []CallEdge

+ Total int

+ Truncated bool

+ type Capabilities struct

+ ArtifactMaximum int64

+ BriefBytes int

+ ContextSchema string

+ Provider Provider

+ SearchDefault int

+ SearchMaximum int

+ Semantic CapabilityManifest

+ SymbolBytes int

+ type CapabilityManifest struct

+ CallHierarchy bool

+ CodeAction bool

+ Definition bool

+ Diagnostics bool

+ DocumentSymbol bool

+ Formatting bool

+ Hover bool

+ Implementation bool

+ References bool

+ Rename bool

+ TypeDefinition bool

+ WorkspaceSymbol bool

+ type ChangeContext struct

+ Complete bool

+ Declarations []string

+ DeclarationsTotal int

+ DirectUnits []string

+ DirectUnitsTotal int

+ Files []string

+ FilesTotal int

+ ObservedUnits int

+ ReverseDependents []string

+ ReverseDependentsTotal int

+ Truncated bool

+ type ChangeContract struct

+ Active bool

+ AllowedPaths []string

+ Base string

+ Checkpoints []CheckpointRef

+ CreatedAt time.Time

+ Decisions []Decision

+ FocusedPackages []string

+ FocusedPaths []string

+ FocusedSymbols []SymbolRef

+ Goal string

+ ID string

+ InitialSnapshot SnapshotRef

+ LatestSnapshot SnapshotRef

+ LatestVerification string

+ Policies StructuralPolicies

+ RepositoryID string

+ SchemaVersion string

+ Scope string

+ UnresolvedQuestions []string

+ UpdatedAt time.Time

+ type Checkpoint struct

+ AffectedPackages []string

+ AffectedTotal int

+ AffectedTruncated bool

+ Complete bool

+ ContractID string

+ Current SnapshotRef

+ Diagnostics []Diagnostic

+ ID string

+ Previous SnapshotRef

+ RecordedAt time.Time

+ Uncertainties []Uncertainty

+ Violations []PolicyViolation

+ type CheckpointRef struct

+ CurrentSnapshotID string

+ ID string

+ PreviousSnapshotID string

+ RecordedAt time.Time

+ type CheckpointRequest struct

+ ContractID string

+ Decisions []string

+ ExpectedSnapshot string

+ UnresolvedQuestions []string

+ type ContextPack struct

+ Change *ChangeContext

+ Diagnostics []Diagnostic

+ Guidance []GuidanceRef

+ Modules []ModuleSummary

+ NextCursor string

+ Packages []PackageSummary

+ Provider Provider

+ Risks []RiskArea

+ SchemaVersion string

+ Snapshot SnapshotRef

+ Symbols []SymbolMatch

+ Totals ContextTotals

+ Truncated bool

+ Uncertainties []Uncertainty

+ type ContextTotals struct

+ Diagnostics int

+ Guidance int

+ Modules int

+ Packages int

+ Risks int

+ Symbols int

+ Uncertainties int

+ type ContractExport struct

+ ContractID string

+ Digest string

+ Path string

+ SnapshotID string

+ func ExportChangeContract(ctx context.Context, ws *workspace.Workspace, runner *execution.Runner, ...) (ContractExport, error)

+ type ContractExportRequest struct

+ ContractID string

+ Destination string

+ type ContractStore struct

+ func NewContractStore(root string) (*ContractStore, error)

+ func (s *ContractStore) Current(ctx context.Context, repositoryID string) (ChangeContract, error)

+ func (s *ContractStore) Load(ctx context.Context, repositoryID, contractID string) (ChangeContract, error)

+ func (s *ContractStore) Save(ctx context.Context, contract ChangeContract) error

+ type Core struct

+ func NewCore(ws *workspace.Workspace, runner *execution.Runner, manager *gopls.Manager, ...) (*Core, error)

+ func (c *Core) Begin(ctx context.Context, request BeginRequest) (ChangeContract, error)

+ func (c *Core) Brief(ctx context.Context, request BriefRequest) (ContextPack, error)

+ func (c *Core) Capabilities() Capabilities

+ func (c *Core) Checkpoint(ctx context.Context, request CheckpointRequest) (Checkpoint, error)

+ func (c *Core) CurrentChangeContract(ctx context.Context) (ChangeContract, error)

+ func (c *Core) CurrentVerification(ctx context.Context) (verification.Report, error)

+ func (c *Core) ReadArtifact(ctx context.Context, cursor string, limit int64) (ArtifactChunk, error)

+ func (c *Core) Refactor(ctx context.Context, request RefactorRequest) (RefactorResult, error)

+ func (c *Core) Search(ctx context.Context, request SearchRequest) (SearchResult, error)

+ func (c *Core) Symbol(ctx context.Context, request SymbolRequest) (SymbolContext, error)

+ func (c *Core) Verify(ctx context.Context, request verification.Request) (verification.Report, error)

+ type Decision struct

+ CreatedAt time.Time

+ Text string

+ type Diagnostic struct

+ Code string

+ Location Location

+ Message string

+ Severity string

+ Source string

+ type GuidanceRef struct

+ Digest string

+ File string

+ type Location struct

+ Column int

+ EndColumn int

+ EndLine int

+ File string

+ Line int

+ type LocationSet struct

+ Items []Location

+ Total int

+ Truncated bool

+ type ModuleSummary struct

+ GoVersion string

+ Path string

+ Workspace string

+ type PackageSummary struct

+ Cgo bool

+ Constrained bool

+ Directory string

+ Exported []string

+ Generated bool

+ ID string

+ Imports int

+ Kind string

+ Module string

+ Name string

+ Tests int

+ type PolicyMode string

+ const PolicyAllow

+ const PolicyForbid

+ const PolicyWarn

+ type PolicyViolation struct

+ Code string

+ Locations []Location

+ Message string

+ Policy PolicyMode

+ type Position struct

+ Character int

+ Line int

+ type Provider struct

+ Name string

+ Version string

+ type RefactorPreimage struct

+ Digest string

+ Path string

+ type RefactorRecoveryResult struct

+ RecoveredFiles int

+ Status string

+ func RecoverGuardedRefactor(ctx context.Context, ws *workspace.Workspace, runner *execution.Runner, ...) (RefactorRecoveryResult, error)

+ type RefactorRequest struct

+ Apply bool

+ ExpectedSnapshotID string

+ Files []string

+ NewName string

+ Operation string

+ PlanID string

+ Ref SymbolRef

+ type RefactorResult struct

+ AffectedFiles []string

+ Applied bool

+ Diff string

+ Operation string

+ PlanID string

+ Preimages []RefactorPreimage

+ Risks []RiskArea

+ Snapshot SnapshotRef

+ Uncertainties []Uncertainty

+ type RefactorStore struct

+ func NewRefactorStore(root string) (*RefactorStore, error)

+ type RiskArea struct

+ Code string

+ Guidance string

+ Locations []Location

+ Summary string

+ type SearchRequest struct

+ Cursor string

+ ExpectedSnapshotID string

+ Limit int

+ Query string

+ Scope string

+ type SearchResult struct

+ Matches []SymbolMatch

+ NextCursor string

+ Provider Provider

+ SchemaVersion string

+ Snapshot SnapshotRef

+ Total int

+ Truncated bool

+ Uncertainties []Uncertainty

+ type SemanticIdentity struct

+ Capabilities CapabilityManifest

+ Version string

+ type Service interface

+ Begin func(context.Context, BeginRequest) (ChangeContract, error)

+ Brief func(context.Context, BriefRequest) (ContextPack, error)

+ Checkpoint func(context.Context, CheckpointRequest) (Checkpoint, error)

+ Refactor func(context.Context, RefactorRequest) (RefactorResult, error)

+ Search func(context.Context, SearchRequest) (SearchResult, error)

+ Symbol func(context.Context, SymbolRequest) (SymbolContext, error)

+ Verify func(context.Context, verification.Request) (verification.Report, error)

+ type SnapshotRef struct

+ BaseCommit string

+ Build BuildConfig

+ Capabilities CapabilityManifest

+ ContentDigest string

+ GoVersion string

+ GoplsVersion string

+ HeadCommit string

+ ID string

+ MergeBaseCommit string

+ RepositoryID string

+ RequestedBase string

+ Scope string

+ Workspace string

+ type SnapshotRequest struct

+ Base string

+ Scope string

+ Semantic SemanticIdentity

+ type Snapshotter struct

+ func NewSnapshotter(ws *workspace.Workspace, runner *execution.Runner) (*Snapshotter, error)

+ func (s *Snapshotter) Capture(ctx context.Context, request SnapshotRequest) (SnapshotRef, error)

+ func (s *Snapshotter) Validate(ctx context.Context, expected SnapshotRef) (SnapshotRef, error)

+ type SourcePosition struct

+ Column int

+ File string

+ Line int

+ type StructuralPolicies struct

+ CrossModule PolicyMode

+ Dependency PolicyMode

+ ExportedAPI PolicyMode

+ GeneratedFile PolicyMode

+ OutsideAllowedPaths PolicyMode

+ OutsideFocus PolicyMode

+ TestDeletion PolicyMode

+ func DefaultStructuralPolicies() StructuralPolicies

+ type SymbolContext struct

+ Calls CallSet

+ Definitions LocationSet

+ Diagnostics []Diagnostic

+ DiagnosticsTotal int

+ Hover string

+ Implementations SymbolSet

+ NextCursor string

+ Provider Provider

+ References LocationSet

+ RelatedTests LocationSet

+ SchemaVersion string

+ Snapshot SnapshotRef

+ Symbol SymbolMatch

+ Truncated bool

+ TypeDefinitions LocationSet

+ Uncertainties []Uncertainty

+ type SymbolFacets struct

+ CallHierarchy bool

+ TypeDefinition bool

+ type SymbolMatch struct

+ Kind string

+ Location Location

+ Name string

+ Package string

+ Qualified string

+ Ref SymbolRef

+ type SymbolRef string

+ type SymbolRequest struct

+ ExpectedSnapshotID string

+ Facets SymbolFacets

+ MaxBytes int

+ Position *SourcePosition

+ Ref SymbolRef

+ type SymbolSet struct

+ Items []SymbolMatch

+ Total int

+ Truncated bool

+ type Uncertainty struct

+ Code string

+ Locations []Location

+ Message string

+ type VerificationStore struct

+ func NewVerificationStore(root string) (*VerificationStore, error)

+ func (s *VerificationStore) Current(ctx context.Context, repositoryID string) (verification.Report, error)

+ func (s *VerificationStore) Save(ctx context.Context, repositoryID string, report verification.Report) error