workspace

type LifecycleHook map[string][]string

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

type LookupOptions struct {
	ConfigDir string // explicit devcontainer config directory (from --config or .cribrc)
	Dir       string // explicit project directory (from --dir)
	Cwd       string // working directory fallback when ConfigDir and Dir are both empty
	Version   string // crib binary version recorded in the workspace CribVersion field
	Create    bool   // create the workspace if it does not exist in the store
}

type ResolveResult struct {
	// ProjectRoot is the absolute path to the project root directory.
	ProjectRoot string

	// ConfigPath is the absolute path to the devcontainer.json file.
	ConfigPath string

	// RelativeConfigPath is the config path relative to ProjectRoot.
	RelativeConfigPath string

	// WorkspaceID is the derived workspace identifier.
	WorkspaceID string
}

type Result struct {
	// ContainerID is the Docker/Podman container ID.
	ContainerID string `json:"containerID"`

	// ImageName is the name of the built/pulled image.
	ImageName string `json:"imageName"`

	// MergedConfig is the devcontainer config after merging with image metadata.
	// Stored as raw JSON to avoid a dependency on the config package.
	MergedConfig json.RawMessage `json:"mergedConfig"`

	// WorkspaceFolder is the path inside the container where the project is mounted.
	WorkspaceFolder string `json:"workspaceFolder"`

	// RemoteEnv holds the resolved remoteEnv variables from devcontainer.json.
	// ${containerEnv:VAR} references are already substituted.
	// These should be injected via -e flags when running docker/podman exec.
	RemoteEnv map[string]string `json:"remoteEnv,omitempty"`

	// RemoteUser is the user to run commands as inside the container.
	// Passed as -u to docker/podman exec.
	RemoteUser string `json:"remoteUser,omitempty"`

	// SnapshotImage is the name of the snapshot image created after create-time
	// hooks completed. Used by restart to skip re-running those hooks.
	SnapshotImage string `json:"snapshotImage,omitempty"`

	// SnapshotHookHash is a hash of the create-time hook definitions at the time
	// the snapshot was taken. If hooks change, the snapshot is stale.
	SnapshotHookHash string `json:"snapshotHookHash,omitempty"`

	// HasFeatureEntrypoints is true when the image was built with features
	// that declare entrypoints (e.g. docker-in-docker). Used by restart
	// paths to know whether to override the container entrypoint.
	HasFeatureEntrypoints bool `json:"hasFeatureEntrypoints,omitempty"`

	// ComposeFilesHash is a short fingerprint (truncated SHA-256) of the
	// compose file contents at the time the result was saved. Used by restart
	// to detect changes inside compose files (volumes, ports, etc.) that are
	// invisible to devcontainer.json config comparison.
	ComposeFilesHash string `json:"composeFilesHash,omitempty"`

	// Feature lifecycle hooks, stored so the resume/restart path can dispatch
	// them without re-resolving features from OCI registries. These are the
	// hooks declared in devcontainer-feature.json files, NOT the user's hooks
	// from devcontainer.json. Per the spec, feature hooks run before user hooks.
	FeatureOnCreateCommands      []LifecycleHook `json:"featureOnCreateCommands,omitempty"`
	FeatureUpdateContentCommands []LifecycleHook `json:"featureUpdateContentCommands,omitempty"`
	FeaturePostCreateCommands    []LifecycleHook `json:"featurePostCreateCommands,omitempty"`
	FeaturePostStartCommands     []LifecycleHook `json:"featurePostStartCommands,omitempty"`
	FeaturePostAttachCommands    []LifecycleHook `json:"featurePostAttachCommands,omitempty"`
}

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

type Workspace struct {
	// ID is the workspace identifier, derived from the project directory name.
	ID string `json:"id"`

	// Source is the absolute path to the project root directory.
	Source string `json:"source"`

	// DevContainerPath is the relative path to the devcontainer config
	// from the project root (e.g., ".devcontainer/devcontainer.json").
	DevContainerPath string `json:"devContainerPath,omitempty"`

	// CribVersion is the version of crib that last touched this workspace.
	CribVersion string `json:"cribVersion,omitempty"`

	// CreatedAt is when this workspace was first created.
	CreatedAt time.Time `json:"createdAt"`

	// LastUsedAt is when this workspace was last accessed.
	LastUsedAt time.Time `json:"lastUsedAt"`
}