analyze

package
v0.12.0 Latest Latest
Warning

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

 Go to latest Published: Jul 19, 2026 License: MIT Imports: 2 Imported by: 0

Documentation

Overview

@index Consumer-owned outbound ports shared by graph analysis use cases.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type AffectedFlow 

type AffectedFlow struct {
	ID            uint
	Name          string
	AffectedNodes []uint
}

AffectedFlow is a stored flow and the changed node IDs that touch it. @intent carry change-to-flow overlap facts from analysis persistence to application consumers.

type ChangeRepository 

type ChangeRepository interface {
	NodesByFiles(ctx context.Context, filePaths []string) ([]graph.Node, error)
	OutgoingEdgeCounts(ctx context.Context, nodeIDs []uint) (map[uint]int64, error)
}

ChangeRepository supplies graph facts used by git-diff overlap and risk policy. @intent isolate namespace-scoped node and outgoing-edge queries from change analysis algorithms.

type EdgeDirection 

type EdgeDirection string

EdgeDirection selects which endpoint of a relationship query becomes the result node. @intent express incoming and outgoing graph queries without leaking SQL join details. 

const (
	EdgeDirectionIncoming EdgeDirection = "incoming"
	EdgeDirectionOutgoing EdgeDirection = "outgoing"
)

type FlowRebuildStore 

type FlowRebuildStore interface {
	GetEdgesFromNodes(ctx context.Context, nodeIDs []uint) ([]graph.Edge, error)
	GetNodeByID(ctx context.Context, id uint) (*graph.Node, error)
	DeleteFlows(ctx context.Context) error
	FindFlowEntrypoints(ctx context.Context) ([]graph.Node, error)
	CreateFlow(ctx context.Context, flow *graph.Flow) error
}

FlowRebuildStore is the transaction-scoped graph and flow persistence surface used by a rebuild. @intent let flow application policy trace and replace flows without importing a database adapter.

type FlowSummary 

type FlowSummary struct {
	ID          uint
	Name        string
	Description string
	NodeCount   int
}

FlowSummary is one stored flow with its member count. @intent carry bounded stored-flow facts independently of persistence rows.

type FlowUnitOfWork 

type FlowUnitOfWork interface {
	WithinFlowRebuild(ctx context.Context, fn func(FlowRebuildStore) error) error
}

FlowUnitOfWork owns the atomic boundary for replacing persisted flows. @intent ensure stale-flow deletion and every replacement flow commit or roll back together.

type GraphLookup 

type GraphLookup interface {
	GetNode(ctx context.Context, qualifiedName string) (*graph.Node, error)
	GetAnnotation(ctx context.Context, nodeID uint) (*graph.Annotation, error)
}

GraphLookup supplies the exact node and annotation reads used by graph-facing inbound tools. @intent keep MCP graph lookups on an application-owned port instead of a global storage contract.

type GraphReadRepository 

type GraphReadRepository interface {
	NamespacesPage(ctx context.Context, limit, offset int) ([]NamespaceSummary, bool, error)
	FlowsPage(ctx context.Context, sortBy string, limit, offset int) ([]FlowSummary, bool, error)
	CallEdges(ctx context.Context, anchorID uint, peerIDs []uint, direction EdgeDirection) (map[uint]graph.Edge, error)
	AffectedFlowsPage(ctx context.Context, changedNodeIDs []uint, limit, offset int) ([]AffectedFlow, bool, error)
	UntestedCount(ctx context.Context, nodeIDs []uint) (int, error)
	TopCommunities(ctx context.Context, limit int) ([]NamedCount, error)
	TopFlows(ctx context.Context, limit int) ([]NamedCount, error)
}

GraphReadRepository supplies bounded graph summaries used by analysis-oriented inbound surfaces. @intent centralize namespace-safe aggregate and evidence queries without exposing GORM to handlers.

type GraphStatistics 

type GraphStatistics struct {
	NodeCount       int64
	EdgeCount       int64
	FileCount       int64
	NodesByKind     map[string]int64
	NodesByLanguage map[string]int64
	EdgesByKind     map[string]int64
	StrictCalls     int64
	FallbackCalls   int64
	NodeKinds       []KindCount
	EdgeKinds       []KindCount
}

GraphStatistics is the namespace-scoped graph health snapshot consumed by operator and protocol surfaces. @intent keep graph totals and grouped distributions independent of database query types.

type KindCount 

type KindCount struct {
	Kind  string
	Count int64
}

KindCount is one stable grouped aggregate row. @intent preserve database aggregate row ordering for CLI-compatible rendering.

type NamedCount 

type NamedCount struct {
	Name  string
	Count int64
}

NamedCount is a ranked community or flow label and its member count. @intent represent ranked membership aggregates without exposing SQL scan structs.

type NamespaceSummary 

type NamespaceSummary struct {
	Namespace string
	NodeCount int64
}

NamespaceSummary is one globally discoverable graph namespace and its node count. @intent carry namespace discovery results independently of MCP response types.

type QueryRepository 

type QueryRepository interface {
	RelatedNodes(ctx context.Context, request RelatedNodesRequest) (RelatedNodesPage, error)
	NodesByFile(ctx context.Context, filePath string) ([]graph.Node, error)
	NodesByExactName(ctx context.Context, name string, limit int) ([]graph.Node, error)
}

QueryRepository supplies persistence operations required by predefined graph-query policy. @intent keep query defaults and response mapping in app code while isolating database joins and filters.

type RelatedNodesPage 

type RelatedNodesPage struct {
	Nodes      []graph.Node
	TotalCount int
}

RelatedNodesPage returns one relationship page and its unpaginated distinct count. @intent keep pagination totals coupled to the same namespace-scoped relationship query.

type RelatedNodesRequest 

type RelatedNodesRequest struct {
	NodeID    uint
	EdgeKinds []graph.EdgeKind
	Direction EdgeDirection
	Limit     int
	Offset    int
}

RelatedNodesRequest describes one deterministic relationship page lookup. @intent carry graph-query scope and pagination from application policy to persistence.

type StatisticsReader 

type StatisticsReader interface {
	GraphStatistics(ctx context.Context) (GraphStatistics, error)
}

StatisticsReader supplies one consistent namespace-scoped graph statistics snapshot. @intent let CLI and MCP status surfaces share typed graph facts without receiving a database handle.

Source Files

View all Source files

Directories

Path Synopsis
@index Application git-diff overlap and deterministic change-risk policy.
 @index Application git-diff overlap and deterministic change-risk policy.
@index Persisted flow rebuild service for namespace-scoped stored flows.
 @index Persisted flow rebuild service for namespace-scoped stored flows.
@index Application BFS blast-radius analysis with depth and node-count bounds.
 @index Application BFS blast-radius analysis with depth and node-count bounds.
@index Application graph-query policy for callers, imports, inheritance, summaries, and exact-name fallback.
 @index Application graph-query policy for callers, imports, inheritance, summaries, and exact-name fallback.

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.