backup

type EdgeRecord struct {
	ID            int64          `json:"id"`
	FromObsID     int64          `json:"from_obs_id"`
	ToObsID       int64          `json:"to_obs_id"`
	RelationType  string         `json:"relation_type"`
	Weight        float64        `json:"weight"`
	Confidence    float64        `json:"confidence"`
	Source        sql.NullString `json:"source,omitempty"`
	Reasoning     sql.NullString `json:"reasoning,omitempty"`
	ValidFrom     sql.NullString `json:"valid_from,omitempty"`
	InvalidAt     sql.NullString `json:"invalid_at,omitempty"`
	ValidUntil    sql.NullString `json:"valid_until,omitempty"`
	TenantID      sql.NullString `json:"tenant_id,omitempty"`
	WorkspaceID   sql.NullString `json:"workspace_id,omitempty"`
	EvolutionID   sql.NullInt64  `json:"evolution_id,omitempty"`
	EvolutionType string         `json:"evolution_type"`
	FactState     string         `json:"fact_state"`
	ChangeReason  sql.NullString `json:"change_reason,omitempty"`
	CreatedAt     sql.NullString `json:"created_at,omitempty"`
}

type EmbeddingState struct {
	Model      string `json:"model"`
	Dimensions int    `json:"dimensions"`
}

type ErrIncompatibleSchema struct {
	Backup  string
	Current string
}

type ErrSecretDetected struct{ Name string }

type ErrTampered struct{ Part string }

type ExportOptions struct {
	// Out is the destination file path (a tar.gz archive).
	Out string
	// Tenant optionally restricts the export to one tenant id.
	Tenant string
	// ToolVersion is recorded in the manifest (the CLI injects its version).
	ToolVersion string
	// Secrets are credential values that must never appear in the archive
	// (defense-in-depth; see package doc).
	Secrets []Secret
	// Now overrides the manifest timestamp (tests).
	Now func() time.Time
}

type ExportResult struct {
	Path         string
	SizeBytes    int64
	Observations int
	Edges        int
	Sessions     int
	SchemaVer    string
}

type Exporter struct {
	DB *sql.DB
}

type Manifest struct {
	Format        string            `json:"format"`
	FormatVersion int               `json:"format_version"`
	SchemaFamily  string            `json:"schema_family"`
	SchemaVersion string            `json:"schema_version"`
	ToolVersion   string            `json:"tool_version"`
	CreatedAt     string            `json:"created_at"`
	Source        Source            `json:"source"`
	Parts         map[string]Part   `json:"parts"`
	Notes         map[string]string `json:"notes,omitempty"`
}

type ObservationRecord struct {
	ID             int64           `json:"id"`
	SessionID      string          `json:"session_id"`
	Type           string          `json:"type"`
	Title          string          `json:"title"`
	Content        string          `json:"content"`
	ToolName       sql.NullString  `json:"tool_name,omitempty"`
	Project        sql.NullString  `json:"project,omitempty"`
	Scope          string          `json:"scope"`
	TopicKey       sql.NullString  `json:"topic_key,omitempty"`
	Confidence     float64         `json:"confidence"`
	Source         string          `json:"source"`
	Tags           sql.NullString  `json:"tags,omitempty"`
	TenantID       sql.NullString  `json:"tenant_id,omitempty"`
	WorkspaceID    sql.NullString  `json:"workspace_id,omitempty"`
	OwnerID        sql.NullString  `json:"owner_id,omitempty"`
	CreatedAt      string          `json:"created_at"`
	UpdatedAt      string          `json:"updated_at"`
	ValidUntil     sql.NullString  `json:"valid_until,omitempty"`
	EmbeddingState *EmbeddingState `json:"embedding_state,omitempty"`
}

type Part struct {
	Count  int    `json:"count"`
	SHA256 string `json:"sha256"`
}

type RestoreOptions struct {
	// From is the source archive path (tar.gz produced by Export).
	From string
	// Secrets are credential values that must never have been exported; if
	// any appears inside the archive the restore refuses (the archive was
	// produced by a non-Cortex tool or tampered with).
	Secrets []Secret
}

type RestoreResult struct {
	ObservationsRestored int
	ObservationsSkipped  int
	EdgesRestored        int
	EdgesSkipped         int
	SessionsRestored     int
	SessionsSkipped      int
	SchemaVer            string
}

type Restorer struct {
	DB *sql.DB
}

type Secret struct {
	Name  string
	Value string
}

type SessionRecord struct {
	ID          string         `json:"id"`
	Project     string         `json:"project"`
	Directory   string         `json:"directory"`
	StartedAt   string         `json:"started_at"`
	EndedAt     sql.NullString `json:"ended_at,omitempty"`
	Summary     sql.NullString `json:"summary,omitempty"`
	TenantID    sql.NullString `json:"tenant_id,omitempty"`
	WorkspaceID sql.NullString `json:"workspace_id,omitempty"`
}

type Source struct {
	Mode     string `json:"mode"` // "local-sqlite"
	TenantID string `json:"tenant_id,omitempty"`
}