bundle

type Action string

type CWDInfo struct {
	// Path is the first-seen original spelling of the cwd (for display).
	Path string
	// Count is how many sessions recorded this cwd.
	Count int
	// ExistsLocal reports whether the directory exists on this machine. A
	// session whose cwd does not exist locally is hidden in Codex's project
	// sidebar until the folder is created or the cwd is remapped on import.
	ExistsLocal bool
}

type CWDMapping struct {
	Old string
	New string
}

type CWDSummary struct {
	// Dirs are the distinct non-empty recorded cwds, sorted by path.
	Dirs []CWDInfo
	// UnknownCWD counts sessions with no recorded cwd (e.g. compressed
	// sessions, whose cwd is unknown in v0.1).
	UnknownCWD int
	// MissingCount is how many entries in Dirs do not exist locally.
	MissingCount int
}

type Checksums map[string]string

type ExportOptions struct {
	// ProjectPath, when non-empty, restricts the export to sessions whose
	// SessionMeta cwd matches this (already absolute) path. Leave empty to
	// export every session regardless of cwd (the `--all` behavior).
	ProjectPath string
	// OutputPath is the .codexbundle file to write.
	OutputPath string
	// IncludeArchived also considers archived sessions.
	IncludeArchived bool
	// Since, when non-zero, restricts the export to sessions whose file
	// modification time is at or after this instant.
	Since time.Time
	// SessionID, when non-empty, exports exactly the single session whose
	// thread id equals (or uniquely begins with) this value, regardless of
	// cwd. It is mutually exclusive with project/all filtering.
	SessionID string
	// WithGit forces capture of the project's git metadata (remote, branch,
	// commit, dirty/unpushed) into the manifest even when ProjectPath is empty
	// (e.g. with --all or --session). When ProjectPath is set, git metadata is
	// always captured regardless of this flag.
	WithGit bool
}

type ExportResult struct {
	BundlePath        string
	Manifest          Manifest
	IncludedCount     int
	TotalScanned      int
	CompressedSkipped int // compressed sessions skipped by cwd filter (cwd unknown)
	Warnings          []string
}

type ImportItem struct {
	BundlePath  string
	DestPath    string
	Action      Action
	OriginalCWD string
	CWDMismatch bool
	// Mapped reports whether --map-cwd rewrote this session's cwd.
	Mapped bool
	// Copied reports whether this entry was imported as a brand-new session
	// (ActionImportCopy, --import-as-copy) with NewThreadID as its fresh id.
	Copied bool
	// NewThreadID is the freshly assigned session id when Copied is true.
	NewThreadID string
	// BackupPath, when non-empty, is where the pre-existing local file was
	// backed up before being replaced (ActionReplace, --replace-with-backup).
	BackupPath string
	// contains filtered or unexported fields
}

type ImportOptions struct {
	BundlePath string
	DryRun     bool
	// ProjectPath, when non-empty, enables per-session cwd-mismatch checks
	// against this (already absolute) path.
	ProjectPath string
	// MapCWD, when set, rewrites matching sessions' recorded cwd on import.
	// Only plain .jsonl files are rewritten; .jsonl.zst files that match a
	// mapping are copied byte-for-byte and reported as unmappable.
	MapCWD []CWDMapping
	// ReplaceWithBackup turns conflicts (a local file with different content
	// for the same session) into a replace: the local file is backed up next
	// to itself and then overwritten with the bundle's version. Without it,
	// conflicts are reported and skipped (the default, never-overwrite behavior).
	ReplaceWithBackup bool
	// SessionIDs, when non-empty, restricts the import to the bundle sessions
	// whose thread id equals (or uniquely begins with) one of these values; every
	// other session in the bundle is skipped (ActionSkipDeselected). An id that
	// matches no session in the bundle is an error (nothing is written).
	SessionIDs []string
	// ImportAsCopy turns conflicts into a brand-new session: the bundle's
	// version is assigned a fresh session id and written under a new rollout
	// filename, so it coexists with the diverged local session rather than being
	// skipped or replacing it. Only plain .jsonl files can be copied; a
	// compressed (.jsonl.zst) conflict, or one without a session_meta id, stays a
	// skipped conflict. Mutually exclusive with ReplaceWithBackup at the CLI.
	ImportAsCopy bool
}

type ImportResult struct {
	Manifest         Manifest
	Items            []ImportItem
	Imported         int
	SkippedIdentical int
	Conflicts        int
	SkippedOther     int
	// SkippedDeselected counts bundle sessions excluded by a --session filter.
	SkippedDeselected int
	CWDMismatchCount  int
	// Replaced counts conflicting sessions that were overwritten after the local
	// file was backed up (--replace-with-backup).
	Replaced int
	// ImportedCopies counts conflicting sessions imported as brand-new sessions
	// (--import-as-copy).
	ImportedCopies int
	// Mapped counts imported sessions whose cwd was rewritten by --map-cwd.
	Mapped int
	// MappedCompressedSkipped counts compressed sessions that matched a
	// mapping but could not be rewritten in v0.1 (copied byte-for-byte).
	MappedCompressedSkipped int
	ProjectProvided         bool
	DryRun                  bool
	Warnings                []string
}

type InspectResult struct {
	Manifest  Manifest
	Checksums Checksums
	Entries   []string
}

type Manifest struct {
	FormatVersion     string            `json:"format_version"`
	CreatedAt         string            `json:"created_at"`
	CreatedByDevice   string            `json:"created_by_device,omitempty"`
	SourceOS          string            `json:"source_os"`
	SourceCodexHome   string            `json:"source_codex_home"`
	SourceProjectPath string            `json:"source_project_path,omitempty"`
	Git               *git.Info         `json:"git,omitempty"`
	CodexVersion      string            `json:"codex_version,omitempty"`
	Sessions          []ManifestSession `json:"sessions"`
}

type ManifestSession struct {
	ThreadID         string `json:"thread_id,omitempty"`
	OriginalPath     string `json:"original_path"`
	BundlePath       string `json:"bundle_path"`
	OriginalCWD      string `json:"original_cwd,omitempty"`
	Preview          string `json:"preview,omitempty"`
	FirstUserMessage string `json:"first_user_message,omitempty"`
	CreatedAt        string `json:"created_at,omitempty"`
	UpdatedAt        string `json:"updated_at,omitempty"`
	Source           string `json:"source,omitempty"`
	ModelProvider    string `json:"model_provider,omitempty"`
	GitBranch        string `json:"git_branch,omitempty"`
	GitSHA           string `json:"git_sha,omitempty"`
	Archived         bool   `json:"archived"`
	Compressed       bool   `json:"compressed"`
	SizeBytes        int64  `json:"size_bytes"`
	SHA256           string `json:"sha256"`
}