Help us shape the future of Go! Take the 2026 Go Developer Survey

forge

package
v1.12.1 Latest Latest
Warning

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

 Go to latest Published: Sep 14, 2026 License: MIT Imports: 21 Imported by: 0

Documentation

Overview

Package forge implements configured, guarded issue imports and upstream drift checks for local UI workflows.

Index

Constants

View Source 
const ImportFetchTimeout = importFetchTimeout

ImportFetchTimeout bounds one forge selection independently of an AI run.

View Source 
const (
	// SkillRunDeadline bounds an assistant run shared by local interfaces.
	SkillRunDeadline = 4 * time.Minute
)

Variables

View Source 
var ErrUpstreamChanged = errors.New("upstream changed; check again")

ErrUpstreamChanged is returned when a baseline revision no longer names the current upstream snapshot.

Functions

func BaselineRevision 

func BaselineRevision(baseline store.ImportBaseline) string

BaselineRevision identifies one accepted upstream snapshot for compare-and-swap.

func IssueADR 

func IssueADR(issue Issue) string

IssueADR renders one bounded forge issue for ADR splitting.

func NewHTTPClient 

func NewHTTPClient() *http.Client

NewHTTPClient returns the guarded forge client shared by every caller.

func StripLinkTags 

func StripLinkTags(tags []string) []string

StripLinkTags removes model-proposed forge identity tags before the local import path appends authorized provenance.

func ValidRevision 

func ValidRevision(revision string) bool

ValidRevision reports whether a drift revision is a canonical digest.

func ValidSourceName 

func ValidSourceName(name string) bool

ValidSourceName reports whether a source name is safe for persisted lookup.

Types

type Draft 

type Draft struct {
	ai.Draft
	Link        string
	ExternalKey string
	URL         string
	SourceName  string
	Baseline    store.ImportBaseline
	Duplicate   *Duplicate
}

Draft is one import proposal with its forge provenance and duplicate hint.

type Drift 

type Drift struct {
	State         string
	Link          string
	URL           string
	TitleChanged  *bool
	UpstreamTitle string
	BaselineTitle string
	BaselineAt    string
	CheckedAt     string
	Summary       string
	Revision      string
}

type Duplicate 

type Duplicate struct {
	ID    string
	Title string
	Via   string
}

type Error 

type Error struct {
	Code    int
	Message string
	Cause   error
}

Error is a caller-safe failure category for local UI workflows. Cause is retained for errors.Is/As and logs, never display.

func (*Error) Error 

func (e *Error) Error() string

func (*Error) Unwrap 

func (e *Error) Unwrap() error

type ForgeProbeConfig 

type ForgeProbeConfig struct {
	Name    string
	Kind    string
	BaseURL string
	Project string
	Token   string
	Saved   bool
}

ForgeProbeConfig is one connection test candidate. Saved selects whether blank endpoint credentials may fall back to the named stored integration; drafts set it false and are tested entirely from these unsaved values. Project is probe-only and is never persisted with the integration.

type ForgeProber 

type ForgeProber struct {
	// contains filtered or unexported fields
}

ForgeProber tests stored or draft forge integration values. Local UI flows share its guarded client, credential-origin rule, endpoint derivation, and response handling.

func NewForgeProber 

func NewForgeProber(st *store.Store) *ForgeProber

NewForgeProber constructs a direct-store forge connection prober.

func NewForgeProberWithClient 

func NewForgeProberWithClient(st *store.Store, client *http.Client) *ForgeProber

func (*ForgeProber) Probe 

func (p *ForgeProber) Probe(ctx context.Context, user string, config ForgeProbeConfig) error

Probe tests one unsaved candidate. Persisted rows may retain blank stored endpoint values; drafts never touch the store. A stored token is never sent to a supplied origin that differs from the saved one.

type Issue 

type Issue = forgeIssue

Issue is one bounded upstream forge issue.

type LinkInput 

type LinkInput struct {
	ExternalKey string               `json:"external_key"`
	Link        string               `json:"link"`
	URL         string               `json:"url"`
	Title       string               `json:"title"`
	Baseline    store.ImportBaseline `json:"baseline"`
}

type Preview 

type Preview struct {
	Kind      string
	TotalHint int
	Fetched   int
	Truncated bool
	Note      string
	Drafts    []Draft
}

type PreviewRequest 

type PreviewRequest struct {
	Source string
	Ref    string
	Max    int
}

type Ref 

type Ref struct {
	Source    store.ForgeSource
	Kind      string
	Project   string
	Issue     int
	Milestone int
	// contains filtered or unexported fields
}

Ref is a parsed configured forge selection. Its credential remains private.

type Service 

type Service struct {
	// contains filtered or unexported fields
}

Service owns the guarded forge path used by the TUI.

func New 

func New(st *store.Store, runner *ai.Runner, client *http.Client) *Service

New constructs the direct-store forge service. Nil collaborators select the guarded production clients.

func (*Service) AcceptDrift 

func (s *Service) AcceptDrift(ctx context.Context, user, source, externalKey, revision string) (string, error)

func (*Service) CheckDrift 

func (s *Service) CheckDrift(ctx context.Context, user, source, externalKey string) (Drift, error)

func (*Service) CreateTask 

func (s *Service) CreateTask(user, sourceName string, task board.Task, item LinkInput) (board.Task, error)

CreateTask atomically creates one selected card, its provenance, and the upstream baseline captured by the preview.

func (*Service) DeleteSource 

func (s *Service) DeleteSource(user, name string) error

func (*Service) Preview 

func (s *Service) Preview(ctx context.Context, user string, request PreviewRequest) (Preview, error)

Preview fetches, classifies and transforms one configured selection. It is read-only: third-party forge text cannot receive write or fetch tools.

func (*Service) Probe 

func (s *Service) Probe(ctx context.Context, user string, config ForgeProbeConfig) error

func (*Service) Provenance 

func (s *Service) Provenance(user, link string) ([]store.ImportLink, error)
func (s *Service) RecordLinks(user, sourceName string, items []LinkInput) error

RecordLinks journals provenance for compatibility clients that already created their cards. The TUI uses CreateTask for an atomic write.

func (*Service) ResolveIssueDocument 

func (s *Service) ResolveIssueDocument(ctx context.Context, user, source, raw string) (Issue, string, string, error)

ResolveIssueDocument authorizes and fetches one configured issue for a local ADR split flow.

func (*Service) SaveSource 

func (s *Service) SaveSource(user, name, kind string, baseURL, token *string) (bool, error)

SaveSource validates and persists one configured forge source.

func (*Service) Sources 

func (s *Service) Sources(user string) ([]store.ForgeSource, error)

Source Files

View all Source files

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.