forge_lib_git_allocation

type Allocation struct {
	// JobObjectKey is the Job retaining this checkout across its Executions.
	JobObjectKey string `json:"jobObjectKey,omitempty"`
	// PeerID is the external World identity authorized to operate a Job checkout.
	PeerID string `json:"peerId,omitempty"`
	// ExecutionObjectKey is the owning Forge Execution object key.
	ExecutionObjectKey string `json:"executionObjectKey,omitempty"`
	// PassObjectKey is the optional owning Forge Pass object key.
	PassObjectKey string `json:"passObjectKey,omitempty"`
	// RepoObjectKey is the Git Repo object key.
	RepoObjectKey string `json:"repoObjectKey,omitempty"`
	// WorktreeObjectKey is the allocated Git Worktree object key.
	WorktreeObjectKey string `json:"worktreeObjectKey,omitempty"`
	// WorkdirObjectKey is the mutable Workdir UnixFS object linked to the Worktree.
	WorkdirObjectKey string `json:"workdirObjectKey,omitempty"`
	// BaseCommitHash is the pinned base commit used for branch allocation.
	BaseCommitHash string `json:"baseCommitHash,omitempty"`
	// BranchRef is the branch/ref assigned to the allocation.
	BranchRef string `json:"branchRef,omitempty"`
	// PathFamily is the normalized visible path family that triggered allocation.
	PathFamily string `json:"pathFamily,omitempty"`
	// EvidenceObjectKey points at raw allocation Evidence when present.
	EvidenceObjectKey string `json:"evidenceObjectKey,omitempty"`
	// Status is the allocator lifecycle state.
	Status string `json:"status,omitempty"`
	// CollisionState records branch/key collision handling state.
	CollisionState string `json:"collisionState,omitempty"`
	// StaleBaseState records whether the pinned base is current for allocation.
	StaleBaseState string `json:"staleBaseState,omitempty"`
	// CleanupState records cleanup lifecycle for the allocated Worktree.
	CleanupState string `json:"cleanupState,omitempty"`
	// Cleanup records the terminal runtime cleanup receipt, set by RecordCleanup.
	Cleanup *forge_runtime.CleanupReceipt `json:"cleanup,omitempty"`
	// Timestamp is the allocation timestamp.
	Timestamp *timestamp.Timestamp `json:"timestamp,omitempty"`
}

type CreateArgs struct {
	// ObjectKey overrides the deterministic allocation identity.
	ObjectKey string
	// JobObjectKey retains the checkout for one Job.
	JobObjectKey string
	// PeerID authorizes Workdir writes for a Job allocation.
	PeerID string
	// ExecutionObjectKey selects the Execution owner, exclusive with JobObjectKey.
	ExecutionObjectKey string
	// PassObjectKey identifies the Pass containing the Execution.
	PassObjectKey string
	// RepoObjectKey identifies the shared Git object database.
	RepoObjectKey string
	// WorktreeObjectKey identifies the allocated checkout.
	WorktreeObjectKey string
	// WorkdirRequired requires a mutable Workdir identity.
	WorkdirRequired bool
	// WorkdirObjectKey identifies its mutable filesystem.
	WorkdirObjectKey string
	// BaseCommitHash pins the admitted base commit.
	BaseCommitHash string
	// BranchRef selects the branch, or is empty for a detached Job checkout.
	BranchRef string
	// PathFamily identifies the visible path family.
	PathFamily string
	// EvidenceObjectKey references allocation evidence.
	EvidenceObjectKey string
	// Status sets the allocation status, defaulting to allocated.
	Status string
	// CollisionState sets collision handling, defaulting to none.
	CollisionState string
	// StaleBaseState sets the base observation, defaulting to unchecked.
	StaleBaseState string
	// CleanupState sets cleanup state, defaulting to active.
	CleanupState string
	// Timestamp records creation time, defaulting to now.
	Timestamp *timestamp.Timestamp
}