projectworkspace

type API interface {
	GitAvailable(ctx context.Context, projectID string) (bool, error)
	GitStatus(ctx context.Context, projectID string, options GitStatusOptions) (GitStatus, error)
	GitDiff(ctx context.Context, projectID string, options GitDiffOptions) (GitDiff, error)
	GitCreateWorktree(ctx context.Context, projectID string, options GitCreateWorktreeOptions) (GitCreateWorktreeResult, error)
	ReadFile(ctx context.Context, projectID string, options ReadFileOptions) (WorkspaceFile, error)
	EditFile(ctx context.Context, projectID string, options EditFileOptions) (EditResult, error)
	CreateFile(ctx context.Context, projectID string, options CreateFileOptions) (CreateFileResult, error)
	DeleteFile(ctx context.Context, projectID string, options DeleteFileOptions) (DeleteFileResult, error)
}

type CreateFileOptions struct {
	RelativePath     string
	Text             string
	CreateParentDirs bool
	DryRun           bool
	WorktreeRef      string
}

type CreateFileResult struct {
	Applied        bool          `json:"applied"`
	File           WorkspaceFile `json:"file"`
	IngestionRunID string        `json:"ingestion_run_id,omitempty"`
	NewEditToken   string        `json:"new_edit_token,omitempty"`
}

type DeleteFileOptions struct {
	FileID       string
	RelativePath string
	EditToken    string
	DryRun       bool
	WorktreeRef  string
}

type DeleteFileResult struct {
	Deleted        bool   `json:"deleted"`
	ProjectID      string `json:"project_id"`
	RelativePath   string `json:"relative_path"`
	IngestionRunID string `json:"ingestion_run_id,omitempty"`
}

type DiffFile struct {
	RelativePath string `json:"relative_path"`
	Status       string `json:"status"`
	Additions    int    `json:"additions"`
	Deletions    int    `json:"deletions"`
	Diff         string `json:"diff"`
}

type DiffSkip struct {
	RelativePath string `json:"relative_path,omitempty"`
	Reason       string `json:"reason"`
}

type EditFileOptions struct {
	FileID       string
	RelativePath string
	EditToken    string
	DryRun       bool
	Edits        []ExactEdit
	WorktreeRef  string
}

type EditResult struct {
	Applied        bool          `json:"applied"`
	File           WorkspaceFile `json:"file"`
	DiffPreview    string        `json:"diff_preview,omitempty"`
	TextTruncated  bool          `json:"text_truncated"`
	IngestionRunID string        `json:"ingestion_run_id,omitempty"`
	NewEditToken   string        `json:"new_edit_token,omitempty"`
}

type ExactEdit struct {
	StartByte int    `json:"start_byte"`
	EndByte   int    `json:"end_byte"`
	OldText   string `json:"old_text"`
	NewText   string `json:"new_text"`
}

type GitCreateWorktreeOptions struct {
	WorktreeRef string
	BranchRef   string
	BaseRef     string
	DryRun      bool
}

type GitCreateWorktreeResult struct {
	Applied      bool   `json:"applied"`
	ProjectID    string `json:"project_id"`
	WorktreeRef  string `json:"worktree_ref"`
	BranchRef    string `json:"branch_ref"`
	BaseRef      string `json:"base_ref"`
	IsolationRef string `json:"isolation_ref"`
	// WorktreePath is the absolute, server-verified on-disk worktree directory.
	// It is internal transport metadata: it MUST NOT be serialized to agents or
	// appear in any MCP tool result. The json:"-" tag guarantees the shared result
	// struct never leaks it; only the runner-only REST handler copies it into
	// RunnerWorktreeCreateResponse for the automation runner. See
	// httpapi.workspaceGitCreateWorktreeHandler.
	WorktreePath string `json:"-"`
}

type GitDiff struct {
	ProjectID     string     `json:"project_id"`
	Scope         string     `json:"scope"`
	Files         []DiffFile `json:"files"`
	Skipped       []DiffSkip `json:"skipped,omitempty"`
	DiffTruncated bool       `json:"diff_truncated"`
	NextPageToken string     `json:"next_page_token,omitempty"`
}

type GitDiffOptions struct {
	Scope        string
	FileID       string
	RelativePath string
	PathPrefix   string
	ContextLines int
	MaxDiffBytes int
	PageToken    string
	WorktreeRef  string
}

type GitRunner interface {
	Run(ctx context.Context, root string, maxBytes int, args ...string) ([]byte, bool, error)
}

type GitStatus struct {
	ProjectID     string        `json:"project_id"`
	Branch        string        `json:"branch,omitempty"`
	HeadOIDShort  string        `json:"head_oid_short,omitempty"`
	Entries       []StatusEntry `json:"entries"`
	Truncated     bool          `json:"truncated"`
	NextPageToken string        `json:"next_page_token,omitempty"`
}

type GitStatusOptions struct {
	IncludeUntracked bool
	PathPrefix       string
	PageSize         int
	PageToken        string
	WorktreeRef      string
}

type Options struct {
	Enabled bool
}

type ReadFileOptions struct {
	FileID       string
	RelativePath string
	MaxBytes     int
	WorktreeRef  string
}

type RunnerWorktreeCreateResponse struct {
	Applied      bool   `json:"applied"`
	ProjectID    string `json:"project_id"`
	WorktreeRef  string `json:"worktree_ref"`
	BranchRef    string `json:"branch_ref"`
	BaseRef      string `json:"base_ref"`
	IsolationRef string `json:"isolation_ref"`
	WorktreePath string `json:"worktree_path,omitempty"`
}

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

type StatusEntry struct {
	RelativePath   string `json:"relative_path"`
	Status         string `json:"status"`
	StagedStatus   string `json:"staged_status,omitempty"`
	WorktreeStatus string `json:"worktree_status,omitempty"`
	RenamedFrom    string `json:"renamed_from,omitempty"`
}

type WorkspaceFile struct {
	FileID        string    `json:"file_id,omitempty"`
	ProjectID     string    `json:"project_id"`
	RelativePath  string    `json:"relative_path"`
	Extension     string    `json:"extension,omitempty"`
	SizeBytes     int64     `json:"size_bytes"`
	ModifiedAt    time.Time `json:"modified_at"`
	Text          string    `json:"text"`
	TextTruncated bool      `json:"text_truncated"`
	LineCount     int       `json:"line_count"`
	EditToken     string    `json:"edit_token,omitempty"`
}