workspace

Aug 30, 2026

Changes in this version

+ var ErrWorkspaceExists = errors.New("workspace already exists")

Aug 30, 2026

Changes in this version

+ const CurrentManifestVersion

+ var ErrInvalidManifest = errors.New("workspace manifest is invalid")

+ var ErrInvalidRepositoryID = errors.New("repository identity is invalid")

+ var ErrManifestConflict = errors.New("workspace manifest binds a different workspace")

+ var ErrManifestNotFound = errors.New("workspace manifest was not found")

+ func ManifestPath(repositoryRoot string) (string, error)

+ func WriteManifest(repositoryRoot string, manifest Manifest) (err error)

+ type Manifest struct

+ FormatVersion int

+ RepositoryID string

+ WorkspaceID ID

+ func DiscoverManifest(workingDirectory string) (repositoryRoot string, manifest Manifest, found bool, err error)

+ func (manifest Manifest) Validate() error

type WorkspaceMatch

+ func FindWorkspaceByID(root string, id ID) (WorkspaceMatch, error)

Aug 22, 2026

Changes in this version

+ const CurrentRegistryVersion

+ var ErrInvalidCurrentWorkspace = errors.New("current workspace preference is invalid")

+ var ErrInvalidID = errors.New("workspace identity is invalid")

+ var ErrInvalidName = errors.New("workspace name is invalid")

+ var ErrInvalidRegistry = errors.New("workspace registry is invalid")

+ var ErrInvalidStorageRoot = errors.New("workspace storage root is invalid")

+ var ErrInvalidWorkspace = errors.New("workspace is invalid")

+ var ErrPathAlreadyAttached = errors.New("repository path is already attached to another workspace")

+ var ErrStorageRootUnavailable = errors.New("workspace storage root is unavailable")

+ var ErrWorkspaceNotFound = errors.New("no workspace matches working directory")

+ var ErrWorkspaceNotRegistered = errors.New("workspace is not registered")

+ func AttachPath(root string, workspaceName Name, path string) error

+ func CanonicalPath(path string) (string, error)

+ func CanonicalStoredPath(path string) (string, error)

+ func ClearCurrentWorkspace(root string) error

+ func RegistryLockPath(root string) (string, error)

+ func RegistryPath(root string) (string, error)

+ func RepositoryPath(storageRoot string, id ID) (string, error)

+ func SetCurrentWorkspace(root string, name Name) error

+ func StorageRoot() (string, error)

+ func UpdateRegistry(root string, mutate func(*Registry) error) error

+ type CreateLocation struct

+ ID ID

+ StateDir string

+ StorageRoot string

+ func ResolveCreateLocation(request CreateRequest) (CreateLocation, error)

+ type CreateRequest struct

+ ID ID

+ Name Name

+ func NewCreateRequest(name Name) (CreateRequest, error)

+ func (request CreateRequest) Validate() error

+ type ID string

+ func NewID() (ID, error)

+ func ParseID(value string) (ID, error)

+ func (id ID) Validate() error

+ type Name string

+ func CurrentWorkspaceName(root string) (name Name, ok bool, err error)

+ func ParseName(value string) (Name, error)

+ func (name Name) Validate() error

+ type Registry struct

+ Version int

+ Workspaces map[Name]Workspace

+ func LoadRegistry(root string) (registry Registry, err error)

+ func NewRegistry() Registry

+ type Workspace struct

+ CreatedAt time.Time

+ ID ID

+ Name string

+ Paths []string

+ StateDir string

+ func (workspace Workspace) Validate() error

+ type WorkspaceMatch struct

+ Name Name

+ Workspace Workspace

+ func FindWorkspace(root, workingDirectory string) (WorkspaceMatch, error)