workspace

type LocalSource struct {
	// Path is the raw path as supplied by the caller (may be host-side).
	Path string
	// Mappings is the PATH_MAPPINGS translation table. May be nil.
	Mappings []analyze.PathMapping
}

type RemoteSource struct {
	// Slug is the "owner/repo" identifier (resolved via forge.ExtractSlug).
	Slug string
	// RepoInput is the original user-supplied identifier (URL or slug).
	// Used for forge detection so that GitLab and other forges are handled
	// correctly. If empty, the resolver assumes GitHub forge — GitLab/Bitbucket
	// callers MUST set this from the unnormalized input.
	RepoInput string
	// Ref is the optional git ref (branch, tag, commit) to check out.
	Ref string
	// DestDir is the workspace directory for temporary clones.
	DestDir string
	// TokenFunc returns an authentication token for the clone; may be nil.
	TokenFunc func(ctx context.Context) (string, error)
	// StaticToken is used when TokenFunc is nil. May be empty.
	StaticToken string
}

type Source interface {
	// Root returns an absolute on-disk path to the repo's source tree, along
	// with a cleanup function (no-op for non-temporary sources). Callers must
	// call cleanup() when done even if err is non-nil.
	Root(ctx context.Context) (path string, cleanup func(), err error)
}

type WPSource struct {
	// Slug is the WordPress.org plugin slug (e.g. "woocommerce").
	Slug string
	// DestDir is the workspace directory for the downloaded plugin.
	DestDir string
}