Skip to content

Modern Docker Management, Designed for Everyone

refactor: optimize struct field alignment

Kyle Mendelle668617119a7
diff --git a/.gitignore b/.gitignore
index e1cbbe73c..ded0acf28 100644
--- a/.gitignore
+++ b/.gitignore
@@ -21,6 +21,7 @@ CLAUDE.md
*.key
*.pem
*.crt
+.claude/**
# OS
.DS_Store
@@ -46,22 +47,11 @@ cli/test-results/
types/test-results/
backend/.bin
backend/build-errors.log
-frontend/bun.lock
-tests/bun.lock
-tests/package-lock.json
/.idea/**
.pnpm-store/**
.pnpm-store
-.claude/settings.local.json
-.claude/**
-.fast-check
*.out
-arcane-devcli
-
-
-# btca
-.btca
cli/arcane-cli
completions
-coverage.txt
+*.txt
diff --git a/backend/api/handlers/swarm.go b/backend/api/handlers/swarm.go
index 8a1d6e679..0bacf15b6 100644
--- a/backend/api/handlers/swarm.go
+++ b/backend/api/handlers/swarm.go
@@ -159,8 +159,8 @@ type GetSwarmNodeAgentDeploymentOutput struct {
}
type ReconcileSwarmNodeAgentsInput struct {
- EnvironmentID string `path:"id" doc:"Environment ID"`
Body swarmtypes.NodeAgentReconcileRequest
+ EnvironmentID string `path:"id" doc:"Environment ID"`
}
type ReconcileSwarmNodeAgentsOutput struct {
diff --git a/backend/api/ws/handler.go b/backend/api/ws/handler.go
index f270b085a..b90879483 100644
--- a/backend/api/ws/handler.go
+++ b/backend/api/ws/handler.go
@@ -253,11 +253,11 @@ func NewWebSocketHandler(
// logStreamParams holds the standard query parameters shared by every WS log endpoint.
type logStreamParams struct {
- follow bool
tail string
since string
- timestamps bool
format string
+ follow bool
+ timestamps bool
batched bool
}
diff --git a/backend/internal/configschema/schema.go b/backend/internal/configschema/schema.go
index 0f9179981..0e35c64bc 100644
--- a/backend/internal/configschema/schema.go
+++ b/backend/internal/configschema/schema.go
@@ -67,15 +67,15 @@ type SettingOverrideEntry struct {
Description string `json:"description,omitempty"`
DefaultValue string `json:"defaultValue,omitempty"`
Type string `json:"type"`
- Sensitive bool `json:"sensitive"`
- Deprecated bool `json:"deprecated"`
Category string `json:"category,omitempty"`
- Public bool `json:"public"`
Requires string `json:"requires,omitempty"`
Note string `json:"note,omitempty"`
Source string `json:"source"`
SourceFile string `json:"sourceFile"`
SourceSymbol string `json:"sourceSymbol"`
+ Sensitive bool `json:"sensitive"`
+ Deprecated bool `json:"deprecated"`
+ Public bool `json:"public"`
}
type envFieldOptions struct {
diff --git a/backend/internal/models/gitops_sync.go b/backend/internal/models/gitops_sync.go
index cb9dad3fa..3faf4cbbd 100644
--- a/backend/internal/models/gitops_sync.go
+++ b/backend/internal/models/gitops_sync.go
@@ -7,28 +7,15 @@ import (
type GitOpsSync struct {
BaseModel
- Name string `json:"name" sortable:"true" search:"sync,gitops,automation,deploy,deployment,continuous"`
- EnvironmentID string `json:"environmentId" sortable:"true"`
- Environment *Environment `json:"environment,omitempty" gorm:"foreignKey:EnvironmentID"`
- RepositoryID string `json:"repositoryId" sortable:"true"`
- Repository *GitRepository `json:"repository,omitempty" gorm:"foreignKey:RepositoryID"`
- Branch string `json:"branch" sortable:"true" search:"branch,main,master,develop,feature,release"`
- ComposePath string `json:"composePath" sortable:"true" search:"compose,docker-compose,path,file,yaml,yml"`
- TargetType string `json:"targetType" gorm:"column:target_type;default:'project'"` // "project" or "swarm_stack"
- ProjectName string `json:"projectName" sortable:"true" search:"project,name,stack,application,service"` // Name of project to create/update
- ProjectID *string `json:"projectId,omitempty" sortable:"true"` // Set after project is created
- Project *Project `json:"project,omitempty" gorm:"foreignKey:ProjectID"`
- AutoSync bool `json:"autoSync" sortable:"true" search:"auto,automatic,sync,continuous,scheduled"`
- SyncInterval int `json:"syncInterval" sortable:"true" search:"interval,frequency,schedule,cron,minutes"` // in minutes
- SyncDirectory bool `json:"syncDirectory" gorm:"column:sync_directory"` // Sync entire directory containing compose file
- SyncedFiles *string `json:"syncedFiles,omitempty" gorm:"column:synced_files"` // JSON array of synced file paths
- MaxSyncFiles int `json:"maxSyncFiles" gorm:"column:max_sync_files;default:500"` // 0 = unlimited; env var overrides take precedence
- MaxSyncTotalSize int64 `json:"maxSyncTotalSize" gorm:"column:max_sync_total_size;default:52428800"` // bytes; 0 = unlimited; env var overrides take precedence
- MaxSyncBinarySize int64 `json:"maxSyncBinarySize" gorm:"column:max_sync_binary_size;default:10485760"` // bytes; 0 = unlimited; env var overrides take precedence
- LastSyncAt *time.Time `json:"lastSyncAt,omitempty" sortable:"true"`
- LastSyncStatus *string `json:"lastSyncStatus,omitempty" search:"status,success,failed,pending,error"`
- LastSyncError *string `json:"lastSyncError,omitempty"`
- LastSyncCommit *string `json:"lastSyncCommit,omitempty" search:"commit,hash,sha,revision"`
+ Environment *Environment `json:"environment,omitempty" gorm:"foreignKey:EnvironmentID"`
+ Repository *GitRepository `json:"repository,omitempty" gorm:"foreignKey:RepositoryID"`
+ ProjectID *string `json:"projectId,omitempty" sortable:"true"` // Set after project is created
+ Project *Project `json:"project,omitempty" gorm:"foreignKey:ProjectID"`
+ SyncedFiles *string `json:"syncedFiles,omitempty" gorm:"column:synced_files"` // JSON array of synced file paths
+ LastSyncAt *time.Time `json:"lastSyncAt,omitempty" sortable:"true"`
+ LastSyncStatus *string `json:"lastSyncStatus,omitempty" search:"status,success,failed,pending,error"`
+ LastSyncError *string `json:"lastSyncError,omitempty"`
+ LastSyncCommit *string `json:"lastSyncCommit,omitempty" search:"commit,hash,sha,revision"`
// Pre-deploy lifecycle hook (configuration)
// When PreDeployScriptPath is set, the named script is executed in a
@@ -40,13 +27,26 @@ type GitOpsSync struct {
PreDeployRunnerImage *string `json:"preDeployRunnerImage,omitempty" gorm:"column:pre_deploy_runner_image"`
PreDeployEnv *string `json:"preDeployEnv,omitempty" gorm:"column:pre_deploy_env"` // KEY=VALUE lines, one per line; same format as .env files
PreDeployExtraMounts *string `json:"preDeployExtraMounts,omitempty" gorm:"column:pre_deploy_extra_mounts"` // docker -v style "src:tgt[:ro|:rw]" entries, one per line
- PreDeployTimeoutSec int `json:"preDeployTimeoutSec" gorm:"column:pre_deploy_timeout_sec;default:60"`
- PreDeployNetworkMode string `json:"preDeployNetworkMode" gorm:"column:pre_deploy_network_mode;default:'none'"` // Docker network mode passed to the runner container. Default "none" denies network access; set to "bridge", "host", or a named network when the script needs it.
// Pre-deploy lifecycle hook (last-run state)
PreDeployLastRunAt *time.Time `json:"preDeployLastRunAt,omitempty" gorm:"column:pre_deploy_last_run_at" sortable:"true"`
PreDeployLastRunStatus *string `json:"preDeployLastRunStatus,omitempty" gorm:"column:pre_deploy_last_run_status" sortable:"true"` // "success" | "failed" | "timeout"
PreDeployLastRunOutput *string `json:"preDeployLastRunOutput,omitempty" gorm:"column:pre_deploy_last_run_output"` // truncated stdout+stderr
+ Name string `json:"name" sortable:"true" search:"sync,gitops,automation,deploy,deployment,continuous"`
+ EnvironmentID string `json:"environmentId" sortable:"true"`
+ RepositoryID string `json:"repositoryId" sortable:"true"`
+ Branch string `json:"branch" sortable:"true" search:"branch,main,master,develop,feature,release"`
+ ComposePath string `json:"composePath" sortable:"true" search:"compose,docker-compose,path,file,yaml,yml"`
+ TargetType string `json:"targetType" gorm:"column:target_type;default:'project'"` // "project" or "swarm_stack"
+ ProjectName string `json:"projectName" sortable:"true" search:"project,name,stack,application,service"` // Name of project to create/update
+ PreDeployNetworkMode string `json:"preDeployNetworkMode" gorm:"column:pre_deploy_network_mode;default:'none'"` // Docker network mode passed to the runner container. Default "none" denies network access; set to "bridge", "host", or a named network when the script needs it.
+ SyncInterval int `json:"syncInterval" sortable:"true" search:"interval,frequency,schedule,cron,minutes"` // in minutes
+ MaxSyncFiles int `json:"maxSyncFiles" gorm:"column:max_sync_files;default:500"` // 0 = unlimited; env var overrides take precedence
+ MaxSyncTotalSize int64 `json:"maxSyncTotalSize" gorm:"column:max_sync_total_size;default:52428800"` // bytes; 0 = unlimited; env var overrides take precedence
+ MaxSyncBinarySize int64 `json:"maxSyncBinarySize" gorm:"column:max_sync_binary_size;default:10485760"` // bytes; 0 = unlimited; env var overrides take precedence
+ PreDeployTimeoutSec int `json:"preDeployTimeoutSec" gorm:"column:pre_deploy_timeout_sec;default:60"`
+ AutoSync bool `json:"autoSync" sortable:"true" search:"auto,automatic,sync,continuous,scheduled"`
+ SyncDirectory bool `json:"syncDirectory" gorm:"column:sync_directory"` // Sync entire directory containing compose file
}
func (GitOpsSync) TableName() string {
diff --git a/backend/internal/models/image_build.go b/backend/internal/models/image_build.go
index 3191c8e87..3998e2270 100644
--- a/backend/internal/models/image_build.go
+++ b/backend/internal/models/image_build.go
@@ -13,37 +13,37 @@ const (
type ImageBuild struct {
BaseModel
- EnvironmentID string `json:"environmentId" gorm:"column:environment_id;index"`
+ BuildArgs JSON `json:"buildArgs,omitempty" gorm:"column:build_args;type:text"`
+ Labels JSON `json:"labels,omitempty" gorm:"column:labels;type:text"`
+ Ulimits JSON `json:"ulimits,omitempty" gorm:"column:ulimits;type:text"`
UserID *string `json:"userId,omitempty" gorm:"column:user_id"`
Username *string `json:"username,omitempty" gorm:"column:username"`
+ Digest *string `json:"digest,omitempty" gorm:"column:digest"`
+ ErrorMessage *string `json:"errorMessage,omitempty" gorm:"column:error_message"`
+ Output *string `json:"output,omitempty" gorm:"column:output;type:text"`
+ CompletedAt *time.Time `json:"completedAt,omitempty" gorm:"column:completed_at" sortable:"true"`
+ DurationMs *int64 `json:"durationMs,omitempty" gorm:"column:duration_ms"`
+ EnvironmentID string `json:"environmentId" gorm:"column:environment_id;index"`
Status ImageBuildStatus `json:"status" gorm:"column:status;index" sortable:"true"`
Provider string `json:"provider,omitempty" gorm:"column:provider"`
ContextDir string `json:"contextDir" gorm:"column:context_dir"`
Dockerfile string `json:"dockerfile,omitempty" gorm:"column:dockerfile"`
Target string `json:"target,omitempty" gorm:"column:target"`
+ BuildNetwork string `json:"network,omitempty" gorm:"column:build_network"`
+ Isolation string `json:"isolation,omitempty" gorm:"column:isolation"`
Tags StringSlice `json:"tags,omitempty" gorm:"column:tags;type:text"`
Platforms StringSlice `json:"platforms,omitempty" gorm:"column:platforms;type:text"`
- BuildArgs JSON `json:"buildArgs,omitempty" gorm:"column:build_args;type:text"`
- Labels JSON `json:"labels,omitempty" gorm:"column:labels;type:text"`
CacheFrom StringSlice `json:"cacheFrom,omitempty" gorm:"column:cache_from;type:text"`
CacheTo StringSlice `json:"cacheTo,omitempty" gorm:"column:cache_to;type:text"`
+ Entitlements StringSlice `json:"entitlements,omitempty" gorm:"column:entitlements;type:text"`
+ ExtraHosts StringSlice `json:"extraHosts,omitempty" gorm:"column:extra_hosts;type:text"`
+ ShmSize int64 `json:"shmSize,omitempty" gorm:"column:shm_size"`
NoCache bool `json:"noCache" gorm:"column:no_cache;default:false"`
Pull bool `json:"pull" gorm:"column:pull;default:false"`
- BuildNetwork string `json:"network,omitempty" gorm:"column:build_network"`
- Isolation string `json:"isolation,omitempty" gorm:"column:isolation"`
- ShmSize int64 `json:"shmSize,omitempty" gorm:"column:shm_size"`
- Ulimits JSON `json:"ulimits,omitempty" gorm:"column:ulimits;type:text"`
- Entitlements StringSlice `json:"entitlements,omitempty" gorm:"column:entitlements;type:text"`
Privileged bool `json:"privileged" gorm:"column:privileged;default:false"`
- ExtraHosts StringSlice `json:"extraHosts,omitempty" gorm:"column:extra_hosts;type:text"`
Push bool `json:"push" gorm:"column:push"`
Load bool `json:"load" gorm:"column:load"`
- Digest *string `json:"digest,omitempty" gorm:"column:digest"`
- ErrorMessage *string `json:"errorMessage,omitempty" gorm:"column:error_message"`
- Output *string `json:"output,omitempty" gorm:"column:output;type:text"`
OutputTruncated bool `json:"outputTruncated" gorm:"column:output_truncated;default:false"`
- CompletedAt *time.Time `json:"completedAt,omitempty" gorm:"column:completed_at" sortable:"true"`
- DurationMs *int64 `json:"durationMs,omitempty" gorm:"column:duration_ms"`
}
func (ImageBuild) TableName() string {
diff --git a/backend/internal/models/image_update.go b/backend/internal/models/image_update.go
index 51841371b..81eda8210 100644
--- a/backend/internal/models/image_update.go
+++ b/backend/internal/models/image_update.go
@@ -7,25 +7,23 @@ import (
type ImageUpdateRecord struct {
BaseModel
- ID string `json:"id" gorm:"primaryKey;type:text"`
- Repository string `json:"repository"`
- Tag string `json:"tag"`
- HasUpdate bool `json:"hasUpdate" gorm:"column:has_update"`
- UpdateType string `json:"updateType" gorm:"column:update_type"`
- CurrentVersion string `json:"currentVersion" gorm:"column:current_version"`
- LatestVersion *string `json:"latestVersion,omitempty" gorm:"column:latest_version"`
- CurrentDigest *string `json:"currentDigest,omitempty" gorm:"column:current_digest"`
- LatestDigest *string `json:"latestDigest,omitempty" gorm:"column:latest_digest"`
- CheckTime time.Time `json:"checkTime" gorm:"column:check_time"`
- ResponseTimeMs int `json:"responseTimeMs" gorm:"column:response_time_ms"`
- LastError *string `json:"lastError,omitempty" gorm:"column:last_error"`
-
- AuthMethod *string `json:"authMethod,omitempty" gorm:"column:auth_method"`
- AuthUsername *string `json:"authUsername,omitempty" gorm:"column:auth_username"`
- AuthRegistry *string `json:"authRegistry,omitempty" gorm:"column:auth_registry"`
- UsedCredential bool `json:"usedCredential,omitempty" gorm:"column:used_credential"`
-
- NotificationSent bool `json:"notificationSent" gorm:"column:notification_sent;default:false"`
+ CheckTime time.Time `json:"checkTime" gorm:"column:check_time"`
+ LatestVersion *string `json:"latestVersion,omitempty" gorm:"column:latest_version"`
+ CurrentDigest *string `json:"currentDigest,omitempty" gorm:"column:current_digest"`
+ LatestDigest *string `json:"latestDigest,omitempty" gorm:"column:latest_digest"`
+ LastError *string `json:"lastError,omitempty" gorm:"column:last_error"`
+ AuthMethod *string `json:"authMethod,omitempty" gorm:"column:auth_method"`
+ AuthUsername *string `json:"authUsername,omitempty" gorm:"column:auth_username"`
+ AuthRegistry *string `json:"authRegistry,omitempty" gorm:"column:auth_registry"`
+ ID string `json:"id" gorm:"primaryKey;type:text"`
+ Repository string `json:"repository"`
+ Tag string `json:"tag"`
+ UpdateType string `json:"updateType" gorm:"column:update_type"`
+ CurrentVersion string `json:"currentVersion" gorm:"column:current_version"`
+ ResponseTimeMs int `json:"responseTimeMs" gorm:"column:response_time_ms"`
+ HasUpdate bool `json:"hasUpdate" gorm:"column:has_update"`
+ UsedCredential bool `json:"usedCredential,omitempty" gorm:"column:used_credential"`
+ NotificationSent bool `json:"notificationSent" gorm:"column:notification_sent;default:false"`
}
func (i *ImageUpdateRecord) TableName() string {
diff --git a/backend/pkg/libarcane/edge/client.go b/backend/pkg/libarcane/edge/client.go
index fa7b2d585..6f1e9e0bb 100644
--- a/backend/pkg/libarcane/edge/client.go
+++ b/backend/pkg/libarcane/edge/client.go
@@ -1080,17 +1080,17 @@ type responseRecorder struct {
}
type commandResponseRecorder struct {
- commandID string
- commandName string
conn TunnelConnection
headers http.Header
- statusCode int
+ commandID string
+ commandName string
buffer bytes.Buffer
+ statusCode int
+ sequence int64
+ mu sync.Mutex
wroteHeader bool
streaming bool
- sequence int64
closed bool
- mu sync.Mutex
}
func newCommandResponseRecorderInternal(commandID, commandName string, conn TunnelConnection) *commandResponseRecorder {
diff --git a/backend/pkg/libarcane/edge/tunnel.go b/backend/pkg/libarcane/edge/tunnel.go
index a2b4f322f..6d602f661 100644
--- a/backend/pkg/libarcane/edge/tunnel.go
+++ b/backend/pkg/libarcane/edge/tunnel.go
@@ -63,31 +63,31 @@ const (
// TunnelMessage represents a transport-agnostic edge tunnel message.
type TunnelMessage struct {
+ Headers map[string]string `json:"headers,omitempty"` // HTTP headers
+ Event *TunnelEvent `json:"event,omitempty"` // Agent event payload
+ Metadata map[string]string `json:"metadata,omitempty"` // Correlation and audit metadata
ID string `json:"id"` // Unique request/stream ID
Type TunnelMessageType `json:"type"` // Message type
Method string `json:"method,omitempty"` // HTTP method for requests
Path string `json:"path,omitempty"` // Request path
Query string `json:"query,omitempty"` // Query string
- Headers map[string]string `json:"headers,omitempty"` // HTTP headers
- Body []byte `json:"body,omitempty"` // Request/response body
- WSMessageType int `json:"ws_message_type,omitempty"` // WebSocket message type
- Status int `json:"status,omitempty"` // HTTP status for responses
- Accepted bool `json:"accepted,omitempty"` // Registration accepted
AgentToken string `json:"agent_token,omitempty"` // Register request token
EnvironmentID string `json:"environment_id,omitempty"` // Manager-resolved environment ID
Error string `json:"error,omitempty"` // Error field for register response
- Event *TunnelEvent `json:"event,omitempty"` // Agent event payload
Command string `json:"command,omitempty"` // Typed command name
SessionID string `json:"session_id,omitempty"` // Manager-issued session identifier
ResumeSession string `json:"resume_session,omitempty"` // Previous session being resumed
AgentInstance string `json:"agent_instance,omitempty"` // Stable agent runtime identity
- Capabilities []string `json:"capabilities,omitempty"` // Agent advertised capabilities
SecurityMode string `json:"security_mode,omitempty"` // token, mtls, etc.
- DrainPrevious bool `json:"drain_previous,omitempty"` // Replace previous session
+ Body []byte `json:"body,omitempty"` // Request/response body
+ Capabilities []string `json:"capabilities,omitempty"` // Agent advertised capabilities
+ WSMessageType int `json:"ws_message_type,omitempty"` // WebSocket message type
+ Status int `json:"status,omitempty"` // HTTP status for responses
TimeoutMillis int64 `json:"timeout_millis,omitempty"` // Command timeout
Sequence int64 `json:"sequence,omitempty"` // Chunk sequence number
+ Accepted bool `json:"accepted,omitempty"` // Registration accepted
+ DrainPrevious bool `json:"drain_previous,omitempty"` // Replace previous session
Streaming bool `json:"streaming,omitempty"` // Response used chunked output
- Metadata map[string]string `json:"metadata,omitempty"` // Correlation and audit metadata
EOF bool `json:"eof,omitempty"` // Final chunk indicator
}
diff --git a/backend/pkg/libarcane/swarm/stack_deploy_engine.go b/backend/pkg/libarcane/swarm/stack_deploy_engine.go
index fdf0cded6..0c4e8c554 100644
--- a/backend/pkg/libarcane/swarm/stack_deploy_engine.go
+++ b/backend/pkg/libarcane/swarm/stack_deploy_engine.go
@@ -45,16 +45,16 @@ const (
// StackDeployOptions controls how a swarm stack is deployed.
type StackDeployOptions struct {
+ RegistryAuthForImage func(context.Context, string) (string, error)
+ PathMapper *projects.PathMapper
Name string
ComposeContent string
OverrideContent string
EnvContent string
- WithRegistryAuth bool
- RegistryAuthForImage func(context.Context, string) (string, error)
- Prune bool
ResolveImage string
WorkingDir string
- PathMapper *projects.PathMapper
+ WithRegistryAuth bool
+ Prune bool
}
type StackRenderOptions struct {
diff --git a/backend/pkg/projects/env.go b/backend/pkg/projects/env.go
index b0e71d027..82998ec45 100644
--- a/backend/pkg/projects/env.go
+++ b/backend/pkg/projects/env.go
@@ -43,10 +43,10 @@ type ProjectEnvState struct {
EditableContent string
EffectiveContent string
DirectContent string
- HasEffective bool
GitContent string
- HasGitSource bool
OverrideContent string
+ HasEffective bool
+ HasGitSource bool
HasOverride bool
// The *Unreadable fields report a file that exists on disk but could not be
// read because of a permission error (e.g. a chmod 000 or foreign-owned
diff --git a/backend/pkg/utils/notifications/email_sender_test.go b/backend/pkg/utils/notifications/email_sender_test.go
index 0df7cf117..951c12679 100644
--- a/backend/pkg/utils/notifications/email_sender_test.go
+++ b/backend/pkg/utils/notifications/email_sender_test.go
@@ -26,19 +26,21 @@ import (
"github.com/stretchr/testify/require"
)
-const smtpTestHost = "localhost."
-const smtpTestConnTimeout = 2 * time.Second
+const (
+ smtpTestHost = "localhost."
+ smtpTestConnTimeout = 2 * time.Second
+)
type smtpTestServer struct {
listener net.Listener
tlsConfig *tls.Config
clientTLSConfig *tls.Config
- supportStartTLS bool
- authMechanisms []string
done chan error
- mu sync.Mutex
- commands []string
authMechanismUsed string
+ authMechanisms []string
+ commands []string
+ mu sync.Mutex
+ supportStartTLS bool
authBeforeTLS bool
authAfterTLS bool
startTLSNegotiated bool
diff --git a/types/auth/oidc.go b/types/auth/oidc.go
index fbd02538b..7a03b1a28 100644
--- a/types/auth/oidc.go
+++ b/types/auth/oidc.go
@@ -8,6 +8,12 @@ import (
// OidcUserInfo represents user information retrieved from an OIDC provider.
type OidcUserInfo struct {
+ // Extra contains additional claims from the userinfo endpoint that are not
+ // part of the standard OIDC claims. This field is not serialized to JSON.
+ //
+ // Required: false
+ Extra map[string]any `json:"-"`
+
// Subject is the unique identifier for the user at the OIDC provider.
//
// Required: true
@@ -23,11 +29,6 @@ type OidcUserInfo struct {
// Required: false
Email string `json:"email,omitempty"`
- // EmailVerified indicates if the user's email has been verified.
- //
- // Required: false
- EmailVerified bool `json:"email_verified,omitempty"`
-
// PreferredUsername is the user's preferred username.
//
// Required: false
@@ -43,11 +44,6 @@ type OidcUserInfo struct {
// Required: false
FamilyName string `json:"family_name,omitempty"`
- // Admin indicates if the user is an administrator.
- //
- // Required: false
- Admin bool `json:"admin,omitempty"`
-
// Roles is a list of roles assigned to the user.
//
// Required: false
@@ -58,11 +54,15 @@ type OidcUserInfo struct {
// Required: false
Groups []string `json:"groups,omitempty"`
- // Extra contains additional claims from the userinfo endpoint that are not
- // part of the standard OIDC claims. This field is not serialized to JSON.
+ // EmailVerified indicates if the user's email has been verified.
//
// Required: false
- Extra map[string]any `json:"-"`
+ EmailVerified bool `json:"email_verified,omitempty"`
+
+ // Admin indicates if the user is an administrator.
+ //
+ // Required: false
+ Admin bool `json:"admin,omitempty"`
}
// OidcTokenResponse represents the response from an OIDC token endpoint.
diff --git a/types/gitops/gitops.go b/types/gitops/gitops.go
index 64bcba9dc..e6e3558d3 100644
--- a/types/gitops/gitops.go
+++ b/types/gitops/gitops.go
@@ -57,72 +57,80 @@ type GitRepository struct {
// GitOpsSync represents a GitOps sync configuration.
type GitOpsSync struct {
- // ID of the gitops sync.
+
+ // CreatedAt is the date and time at which the sync was created.
//
// Required: true
- ID string `json:"id"`
+ CreatedAt time.Time `json:"createdAt"`
- // Name of the sync configuration.
+ // UpdatedAt is the date and time at which the sync was last updated.
//
// Required: true
- Name string `json:"name"`
+ UpdatedAt time.Time `json:"updatedAt"`
- // EnvironmentID is the ID of the environment this sync belongs to.
+ // PreDeployEnv is the KEY=VALUE env config exposed to the script, one
+ // entry per line; same format as a .env file.
//
- // Required: true
- EnvironmentID string `json:"environmentId"`
+ // Required: false
+ PreDeployEnv *string `json:"preDeployEnv,omitempty"`
- // RepositoryID is the ID of the git repository to sync from.
+ // PreDeployLastRunOutput is the truncated combined stdout+stderr from
+ // the most recent pre-deploy lifecycle hook run.
//
- // Required: true
- RepositoryID string `json:"repositoryId"`
+ // Required: false
+ PreDeployLastRunOutput *string `json:"preDeployLastRunOutput,omitempty"`
// Repository is the associated git repository.
//
// Required: false
Repository *GitRepository `json:"repository,omitempty"`
- // Branch to sync from.
+ // PreDeployLastRunStatus is the status of the most recent pre-deploy
+ // lifecycle hook run: "success", "failed", or "timeout".
//
- // Required: true
- Branch string `json:"branch"`
+ // Required: false
+ PreDeployLastRunStatus *string `json:"preDeployLastRunStatus,omitempty"`
- // ComposePath is the path to the docker-compose file in the repository.
+ // PreDeployLastRunAt is the timestamp of the most recent pre-deploy
+ // lifecycle hook run on this sync.
//
- // Required: true
- ComposePath string `json:"composePath"`
+ // Required: false
+ PreDeployLastRunAt *time.Time `json:"preDeployLastRunAt,omitempty"`
- // TargetType indicates what entity is being deployed (e.g. "project" or "swarm_stack").
+ // PreDeployExtraMounts is the bind-mount config added to the runner
+ // container, one entry per line in docker -v "src:tgt[:ro|:rw]" form.
//
- // Required: true
- TargetType string `json:"targetType"`
+ // Required: false
+ PreDeployExtraMounts *string `json:"preDeployExtraMounts,omitempty"`
- // ProjectName is the name used to create/identify the project or stack.
+ // LastSyncAt is the date and time of the last successful sync.
//
- // Required: true
- ProjectName string `json:"projectName"`
+ // Required: false
+ LastSyncAt *time.Time `json:"lastSyncAt,omitempty"`
// ProjectID is the ID of the linked project (set after first sync).
//
// Required: false
ProjectID *string `json:"projectId,omitempty"`
- // AutoSync indicates if the sync should run automatically.
+ // PreDeployRunnerImage is the image used to run the pre-deploy script.
+ // Required whenever PreDeployScriptPath is set.
//
- // Required: true
- AutoSync bool `json:"autoSync"`
+ // Required: false
+ PreDeployRunnerImage *string `json:"preDeployRunnerImage,omitempty"`
- // SyncInterval is the interval in minutes between automatic syncs.
+ // PreDeployScriptPath is the optional path inside the synced repo to a
+ // script executed in a throwaway container before each deploy. Scripts
+ // are repo-trusted code; the configured runner image, env, and mounts
+ // shape the runtime context (admin-managed, never from repo data).
//
- // Required: true
- SyncInterval int `json:"syncInterval"`
+ // Required: false
+ PreDeployScriptPath *string `json:"preDeployScriptPath,omitempty"`
- // SyncDirectory indicates if the entire directory containing the compose file should be synced.
- // When true, all files in the compose file's directory (and subdirectories) are synced.
- // When false, only the compose file itself is synced.
+ // LastSyncCommit is the commit hash from the last successful sync.
//
- // Required: true
- SyncDirectory bool `json:"syncDirectory"`
+ // Required: false
+ LastSyncCommit *string `json:"lastSyncCommit,omitempty"`
// SyncedFiles is a JSON-encoded list of file paths that were synced in the last successful sync.
// Only populated when SyncDirectory is true. Parse as JSON array of strings.
@@ -130,69 +138,62 @@ type GitOpsSync struct {
// Required: false
SyncedFiles *string `json:"syncedFiles,omitempty"`
- // MaxSyncFiles is the maximum number of files to sync.
- // 0 means unlimited; env var overrides take precedence.
+ // LastSyncError is the error message from the last sync attempt if it failed.
//
- // Required: true
- MaxSyncFiles int `json:"maxSyncFiles"`
+ // Required: false
+ LastSyncError *string `json:"lastSyncError,omitempty"`
- // MaxSyncTotalSize is the maximum total size in bytes for all synced files.
- // 0 means unlimited; env var overrides take precedence.
+ // LastSyncStatus is the status of the last sync attempt.
//
- // Required: true
- MaxSyncTotalSize int64 `json:"maxSyncTotalSize"`
+ // Required: false
+ LastSyncStatus *string `json:"lastSyncStatus,omitempty"`
- // MaxSyncBinarySize is the maximum size in bytes for individual binary files.
- // 0 means unlimited; env var overrides take precedence.
+ // ProjectName is the name used to create/identify the project or stack.
//
// Required: true
- MaxSyncBinarySize int64 `json:"maxSyncBinarySize"`
+ ProjectName string `json:"projectName"`
- // LastSyncAt is the date and time of the last successful sync.
+ // PreDeployNetworkMode is the Docker network mode passed to the runner
+ // container. Defaults to "none" so scripts run with no network access
+ // unless explicitly opted in. Set to "bridge", "host", or a named
+ // network when the script needs outbound or compose-network access.
//
- // Required: false
- LastSyncAt *time.Time `json:"lastSyncAt,omitempty"`
+ // Required: true
+ PreDeployNetworkMode string `json:"preDeployNetworkMode"`
- // LastSyncStatus is the status of the last sync attempt.
+ // Name of the sync configuration.
//
- // Required: false
- LastSyncStatus *string `json:"lastSyncStatus,omitempty"`
+ // Required: true
+ Name string `json:"name"`
- // LastSyncError is the error message from the last sync attempt if it failed.
+ // EnvironmentID is the ID of the environment this sync belongs to.
//
- // Required: false
- LastSyncError *string `json:"lastSyncError,omitempty"`
+ // Required: true
+ EnvironmentID string `json:"environmentId"`
- // LastSyncCommit is the commit hash from the last successful sync.
+ // RepositoryID is the ID of the git repository to sync from.
//
- // Required: false
- LastSyncCommit *string `json:"lastSyncCommit,omitempty"`
+ // Required: true
+ RepositoryID string `json:"repositoryId"`
- // PreDeployScriptPath is the optional path inside the synced repo to a
- // script executed in a throwaway container before each deploy. Scripts
- // are repo-trusted code; the configured runner image, env, and mounts
- // shape the runtime context (admin-managed, never from repo data).
+ // Branch to sync from.
//
- // Required: false
- PreDeployScriptPath *string `json:"preDeployScriptPath,omitempty"`
+ // Required: true
+ Branch string `json:"branch"`
- // PreDeployRunnerImage is the image used to run the pre-deploy script.
- // Required whenever PreDeployScriptPath is set.
+ // ComposePath is the path to the docker-compose file in the repository.
//
- // Required: false
- PreDeployRunnerImage *string `json:"preDeployRunnerImage,omitempty"`
-
- // PreDeployEnv is the KEY=VALUE env config exposed to the script, one
- // entry per line; same format as a .env file.
+ // Required: true
+ ComposePath string `json:"composePath"`
+ // ID of the gitops sync.
//
- // Required: false
- PreDeployEnv *string `json:"preDeployEnv,omitempty"`
+ // Required: true
+ ID string `json:"id"`
- // PreDeployExtraMounts is the bind-mount config added to the runner
- // container, one entry per line in docker -v "src:tgt[:ro|:rw]" form.
+ // TargetType indicates what entity is being deployed (e.g. "project" or "swarm_stack").
//
- // Required: false
- PreDeployExtraMounts *string `json:"preDeployExtraMounts,omitempty"`
+ // Required: true
+ TargetType string `json:"targetType"`
// PreDeployTimeoutSec bounds the script execution. Capped by the
// lifecycleMaxTimeoutSec global setting at run time.
@@ -200,41 +201,40 @@ type GitOpsSync struct {
// Required: true
PreDeployTimeoutSec int `json:"preDeployTimeoutSec"`
- // PreDeployNetworkMode is the Docker network mode passed to the runner
- // container. Defaults to "none" so scripts run with no network access
- // unless explicitly opted in. Set to "bridge", "host", or a named
- // network when the script needs outbound or compose-network access.
+ // MaxSyncBinarySize is the maximum size in bytes for individual binary files.
+ // 0 means unlimited; env var overrides take precedence.
//
// Required: true
- PreDeployNetworkMode string `json:"preDeployNetworkMode"`
+ MaxSyncBinarySize int64 `json:"maxSyncBinarySize"`
- // PreDeployLastRunAt is the timestamp of the most recent pre-deploy
- // lifecycle hook run on this sync.
+ // SyncInterval is the interval in minutes between automatic syncs.
//
- // Required: false
- PreDeployLastRunAt *time.Time `json:"preDeployLastRunAt,omitempty"`
+ // Required: true
+ SyncInterval int `json:"syncInterval"`
- // PreDeployLastRunStatus is the status of the most recent pre-deploy
- // lifecycle hook run: "success", "failed", or "timeout".
+ // MaxSyncFiles is the maximum number of files to sync.
+ // 0 means unlimited; env var overrides take precedence.
//
- // Required: false
- PreDeployLastRunStatus *string `json:"preDeployLastRunStatus,omitempty"`
+ // Required: true
+ MaxSyncFiles int `json:"maxSyncFiles"`
- // PreDeployLastRunOutput is the truncated combined stdout+stderr from
- // the most recent pre-deploy lifecycle hook run.
+ // MaxSyncTotalSize is the maximum total size in bytes for all synced files.
+ // 0 means unlimited; env var overrides take precedence.
//
- // Required: false
- PreDeployLastRunOutput *string `json:"preDeployLastRunOutput,omitempty"`
+ // Required: true
+ MaxSyncTotalSize int64 `json:"maxSyncTotalSize"`
- // CreatedAt is the date and time at which the sync was created.
+ // AutoSync indicates if the sync should run automatically.
//
// Required: true
- CreatedAt time.Time `json:"createdAt"`
+ AutoSync bool `json:"autoSync"`
- // UpdatedAt is the date and time at which the sync was last updated.
+ // SyncDirectory indicates if the entire directory containing the compose file should be synced.
+ // When true, all files in the compose file's directory (and subdirectories) are synced.
+ // When false, only the compose file itself is synced.
//
// Required: true
- UpdatedAt time.Time `json:"updatedAt"`
+ SyncDirectory bool `json:"syncDirectory"`
}
// SyncCounts contains counts of syncs by status within the current filtered set.
diff --git a/types/image/build_history.go b/types/image/build_history.go
index 69e3939df..f5e592bdf 100644
--- a/types/image/build_history.go
+++ b/types/image/build_history.go
@@ -4,37 +4,37 @@ import "time"
// BuildRecord represents a historical image build entry.
type BuildRecord struct {
- ID string `json:"id" sortable:"true"`
- EnvironmentID string `json:"environmentId"`
+ CreatedAt time.Time `json:"createdAt" sortable:"true"`
+ BuildArgs map[string]string `json:"buildArgs,omitempty"`
UserID *string `json:"userId,omitempty"`
Username *string `json:"username,omitempty"`
+ Digest *string `json:"digest,omitempty"`
+ ErrorMessage *string `json:"errorMessage,omitempty"`
+ Output *string `json:"output,omitempty"`
+ CompletedAt *time.Time `json:"completedAt,omitempty" sortable:"true"`
+ DurationMs *int64 `json:"durationMs,omitempty"`
+ Labels map[string]string `json:"labels,omitempty"`
+ Ulimits map[string]string `json:"ulimits,omitempty"`
+ ID string `json:"id" sortable:"true"`
+ EnvironmentID string `json:"environmentId"`
Status string `json:"status" sortable:"true"`
Provider string `json:"provider,omitempty"`
ContextDir string `json:"contextDir"`
Dockerfile string `json:"dockerfile,omitempty"`
Target string `json:"target,omitempty"`
+ Network string `json:"network,omitempty"`
+ Isolation string `json:"isolation,omitempty"`
Tags []string `json:"tags,omitempty"`
Platforms []string `json:"platforms,omitempty"`
- BuildArgs map[string]string `json:"buildArgs,omitempty"`
- Labels map[string]string `json:"labels,omitempty"`
CacheFrom []string `json:"cacheFrom,omitempty"`
CacheTo []string `json:"cacheTo,omitempty"`
+ Entitlements []string `json:"entitlements,omitempty"`
+ ExtraHosts []string `json:"extraHosts,omitempty"`
+ ShmSize int64 `json:"shmSize,omitempty"`
NoCache bool `json:"noCache"`
Pull bool `json:"pull"`
- Network string `json:"network,omitempty"`
- Isolation string `json:"isolation,omitempty"`
- ShmSize int64 `json:"shmSize,omitempty"`
- Ulimits map[string]string `json:"ulimits,omitempty"`
- Entitlements []string `json:"entitlements,omitempty"`
Privileged bool `json:"privileged"`
- ExtraHosts []string `json:"extraHosts,omitempty"`
Push bool `json:"push"`
Load bool `json:"load"`
- Digest *string `json:"digest,omitempty"`
- ErrorMessage *string `json:"errorMessage,omitempty"`
- Output *string `json:"output,omitempty"`
OutputTruncated bool `json:"outputTruncated"`
- CompletedAt *time.Time `json:"completedAt,omitempty" sortable:"true"`
- DurationMs *int64 `json:"durationMs,omitempty"`
- CreatedAt time.Time `json:"createdAt" sortable:"true"`
}
diff --git a/types/image/image.go b/types/image/image.go
index 2c75317e3..b32908895 100644
--- a/types/image/image.go
+++ b/types/image/image.go
@@ -12,10 +12,10 @@ import (
)
type UpdateInfo struct {
- // HasUpdate indicates if an update is available for the image.
+ // CheckTime is the time when the update check was performed.
//
// Required: true
- HasUpdate bool `json:"hasUpdate"`
+ CheckTime time.Time `json:"checkTime"`
// UpdateType describes the type of update (e.g., major, minor, patch).
//
@@ -42,16 +42,6 @@ type UpdateInfo struct {
// Required: true
LatestDigest string `json:"latestDigest"`
- // CheckTime is the time when the update check was performed.
- //
- // Required: true
- CheckTime time.Time `json:"checkTime"`
-
- // ResponseTimeMs is the response time in milliseconds.
- //
- // Required: true
- ResponseTimeMs int `json:"responseTimeMs"`
-
// Error contains any error message from the update check.
//
// Required: true
@@ -72,6 +62,16 @@ type UpdateInfo struct {
// Required: false
AuthRegistry string `json:"authRegistry,omitempty"`
+ // ResponseTimeMs is the response time in milliseconds.
+ //
+ // Required: true
+ ResponseTimeMs int `json:"responseTimeMs"`
+
+ // HasUpdate indicates if an update is available for the image.
+ //
+ // Required: true
+ HasUpdate bool `json:"hasUpdate"`
+
// UsedCredential indicates if credentials were used for the update check.
//
// Required: false
diff --git a/types/imageupdate/image_update.go b/types/imageupdate/image_update.go
index b15ee4ae3..0bbd51566 100644
--- a/types/imageupdate/image_update.go
+++ b/types/imageupdate/image_update.go
@@ -7,10 +7,15 @@ import (
)
type Response struct {
- // HasUpdate indicates if an update is available for the image.
+ // CheckTime is the time when the update check was performed.
//
// Required: true
- HasUpdate bool `json:"hasUpdate"`
+ CheckTime time.Time `json:"checkTime"`
+
+ // ActivityID is the background activity that tracked this check.
+ //
+ // Required: false
+ ActivityID *string `json:"activityId,omitempty"`
// UpdateType describes the type of update (e.g., major, minor, patch).
//
@@ -37,16 +42,6 @@ type Response struct {
// Required: false
LatestDigest string `json:"latestDigest,omitempty"`
- // CheckTime is the time when the update check was performed.
- //
- // Required: true
- CheckTime time.Time `json:"checkTime"`
-
- // ResponseTimeMs is the response time in milliseconds.
- //
- // Required: true
- ResponseTimeMs int `json:"responseTimeMs"`
-
// Error contains any error message from the update check.
//
// Required: false
@@ -67,15 +62,20 @@ type Response struct {
// Required: false
AuthRegistry string `json:"authRegistry,omitempty"`
- // UsedCredential indicates if credentials were used for the update check.
+ // ResponseTimeMs is the response time in milliseconds.
//
- // Required: false
- UsedCredential bool `json:"usedCredential,omitempty"`
+ // Required: true
+ ResponseTimeMs int `json:"responseTimeMs"`
- // ActivityID is the background activity that tracked this check.
+ // HasUpdate indicates if an update is available for the image.
+ //
+ // Required: true
+ HasUpdate bool `json:"hasUpdate"`
+
+ // UsedCredential indicates if credentials were used for the update check.
//
// Required: false
- ActivityID *string `json:"activityId,omitempty"`
+ UsedCredential bool `json:"usedCredential,omitempty"`
}
type Summary struct {
diff --git a/types/network/network.go b/types/network/network.go
index eb2c69f0b..56206317f 100644
--- a/types/network/network.go
+++ b/types/network/network.go
@@ -131,38 +131,14 @@ type Inspect struct {
// Required: true
Created time.Time `json:"created"`
- // EnableIPv4 represents whether IPv4 is enabled.
- EnableIPv4 bool `json:"enableIPv4"`
-
- // EnableIPv6 represents whether IPv6 is enabled.
- EnableIPv6 bool `json:"enableIPv6"`
-
// IPAM contains IP address management configuration.
//
// Required: true
IPAM IPAM `json:"ipam"`
- // Internal indicates if the network is internal.
- //
- // Required: true
- Internal bool `json:"internal"`
-
- // Attachable indicates if the network is attachable.
- //
- // Required: true
- Attachable bool `json:"attachable"`
-
- // Ingress indicates if the network is an ingress network.
- //
- // Required: true
- Ingress bool `json:"ingress"`
-
// ConfigFrom specifies the source which will provide the configuration for this network.
ConfigFrom network.ConfigReference `json:"configFrom"`
- // ConfigOnly networks are place-holder networks.
- ConfigOnly bool `json:"configOnly"`
-
// Containers is a map of containers connected to this network.
//
// Required: true
@@ -188,6 +164,30 @@ type Inspect struct {
//
// Required: true
ContainersList []ContainerEndpoint `json:"containersList"`
+
+ // EnableIPv4 represents whether IPv4 is enabled.
+ EnableIPv4 bool `json:"enableIPv4"`
+
+ // EnableIPv6 represents whether IPv6 is enabled.
+ EnableIPv6 bool `json:"enableIPv6"`
+
+ // Internal indicates if the network is internal.
+ //
+ // Required: true
+ Internal bool `json:"internal"`
+
+ // Attachable indicates if the network is attachable.
+ //
+ // Required: true
+ Attachable bool `json:"attachable"`
+
+ // Ingress indicates if the network is an ingress network.
+ //
+ // Required: true
+ Ingress bool `json:"ingress"`
+
+ // ConfigOnly networks are place-holder networks.
+ ConfigOnly bool `json:"configOnly"`
}
type CreateResponse struct {
@@ -237,6 +237,15 @@ type IPAM struct {
// CreateOptions contains options for creating a network.
type CreateOptions struct {
+ // IPAM configuration for the network.
+ IPAM *IPAM `json:"ipam,omitempty" doc:"IP Address Management configuration"`
+
+ // Options are driver-specific options.
+ Options map[string]string `json:"options,omitempty" doc:"Driver-specific options"`
+
+ // Labels are user-defined metadata.
+ Labels map[string]string `json:"labels,omitempty" doc:"User-defined labels"`
+
// Driver is the network driver to use (e.g., bridge, overlay).
Driver string `json:"driver,omitempty" doc:"Network driver (e.g., bridge, overlay)"`
@@ -252,17 +261,8 @@ type CreateOptions struct {
// Ingress enables routing-mesh for swarm cluster.
Ingress bool `json:"ingress,omitempty" doc:"Enable routing-mesh for swarm cluster"`
- // IPAM configuration for the network.
- IPAM *IPAM `json:"ipam,omitempty" doc:"IP Address Management configuration"`
-
// EnableIPv6 enables IPv6 networking.
EnableIPv6 bool `json:"enableIPv6,omitempty" doc:"Enable IPv6 networking"`
-
- // Options are driver-specific options.
- Options map[string]string `json:"options,omitempty" doc:"Driver-specific options"`
-
- // Labels are user-defined metadata.
- Labels map[string]string `json:"labels,omitempty" doc:"User-defined labels"`
}
// ToDockerCreateOptions converts to Docker SDK CreateOptions.
diff --git a/types/project/project.go b/types/project/project.go
index 5190bd25d..b15a45477 100644
--- a/types/project/project.go
+++ b/types/project/project.go
@@ -27,6 +27,11 @@ type IncludeFile struct {
// ProjectFile represents a file or folder within a project directory.
type ProjectFile struct {
+ // ModTime is the last modification time.
+ //
+ // Required: true
+ ModTime time.Time `json:"modTime"`
+
// Path is the absolute path to the file or folder.
//
// Required: true
@@ -42,31 +47,26 @@ type ProjectFile struct {
// Required: true
Name string `json:"name"`
- // IsDirectory indicates whether this entry is a folder.
+ // Content is the file content when explicitly requested.
//
- // Required: true
- IsDirectory bool `json:"isDirectory"`
+ // Required: false
+ Content string `json:"content,omitempty"`
// Size is the file size in bytes. Directories report zero.
//
// Required: true
Size int64 `json:"size"`
- // ModTime is the last modification time.
+ // IsDirectory indicates whether this entry is a folder.
//
// Required: true
- ModTime time.Time `json:"modTime"`
+ IsDirectory bool `json:"isDirectory"`
// Protected indicates that Arcane owns this path and it cannot be renamed,
// deleted, moved, or overwritten through project file management.
//
// Required: false
Protected bool `json:"protected,omitempty"`
-
- // Content is the file content when explicitly requested.
- //
- // Required: false
- Content string `json:"content,omitempty"`
}
// ProjectFileDraft is used when creating a project with staged files.
@@ -449,45 +449,46 @@ type CreateReponse struct {
// Details contains detailed information about a project.
type Details struct {
- // ID is the unique identifier of the project.
- //
- // Required: true
- ID string `json:"id"`
- // Name of the project.
+ // StatusReason provides additional information about the status.
//
- // Required: true
- Name string `json:"name"`
+ // Required: false
+ StatusReason *string `json:"statusReason,omitempty"`
- // DirName is the directory name where the project is stored.
+ // ActivityID is the activity created by the project action.
//
// Required: false
- DirName string `json:"dirName,omitempty"`
+ ActivityID *string `json:"activityId,omitempty"`
- // RelativePath is the path to the project directory relative to the configured projects root.
+ // LastSyncCommit is the last commit synced from Git (if GitOps managed).
//
// Required: false
- RelativePath string `json:"relativePath,omitempty"`
+ LastSyncCommit *string `json:"lastSyncCommit,omitempty"`
- // Path is the file path to the project.
+ // GitOpsManagedBy is the ID of the GitOps sync managing this project (if any).
//
- // Required: true
- Path string `json:"path"`
+ // Required: false
+ GitOpsManagedBy *string `json:"gitOpsManagedBy,omitempty"`
- // IconLightURL is the optional light stack icon URL for dark themes.
+ // UpdateInfo contains aggregated image update status for the project.
//
// Required: false
- IconLightURL string `json:"iconLightUrl,omitempty"`
+ UpdateInfo *UpdateInfo `json:"updateInfo,omitempty"`
- // IconDarkURL is the optional dark stack icon URL for light themes.
+ // ArchivedAt is the date and time when the project was archived.
//
// Required: false
- IconDarkURL string `json:"iconDarkUrl,omitempty"`
+ ArchivedAt *time.Time `json:"archivedAt,omitempty"`
- // URLs are optional custom stack URLs from compose metadata.
+ // Status is the current status of the project.
+ //
+ // Required: true
+ Status string `json:"status"`
+
+ // DirName is the directory name where the project is stored.
//
// Required: false
- URLs []string `json:"urls,omitempty"`
+ DirName string `json:"dirName,omitempty"`
// ComposeContent is the Docker Compose file content.
//
@@ -514,21 +515,20 @@ type Details struct {
// Required: false
OverrideFileName string `json:"overrideFileName,omitempty"`
- // IncludeFiles is a list of included files in the project.
+ // Name of the project.
//
- // Required: false
- IncludeFiles []IncludeFile `json:"includeFiles,omitempty"`
+ // Required: true
+ Name string `json:"name"`
- // DirectoryFiles contains all other files in the project directory
- // (excluding compose files, .env, and include files which are shown separately).
+ // GitRepositoryURL is the URL of the Git repository (if GitOps managed).
//
// Required: false
- DirectoryFiles []IncludeFile `json:"directoryFiles,omitempty"`
+ GitRepositoryURL string `json:"gitRepositoryURL,omitempty"`
- // ProjectFiles contains the editable file tree for project file management.
+ // IconLightURL is the optional light stack icon URL for dark themes.
//
// Required: false
- ProjectFiles []ProjectFile `json:"projectFiles,omitempty"`
+ IconLightURL string `json:"iconLightUrl,omitempty"`
// FileTreeRevision identifies the project file tree state returned to the client.
// Mutations using staged file changes must include this value.
@@ -536,101 +536,101 @@ type Details struct {
// Required: false
FileTreeRevision string `json:"fileTreeRevision,omitempty"`
- // FileTreeTruncated indicates the file tree walk hit the entry cap and
- // ProjectFiles is only a prefix of the full tree.
+ // RelativePath is the path to the project directory relative to the configured projects root.
//
// Required: false
- FileTreeTruncated bool `json:"fileTreeTruncated,omitempty"`
-
- // Status is the current status of the project.
+ RelativePath string `json:"relativePath,omitempty"`
+ // ID is the unique identifier of the project.
//
// Required: true
- Status string `json:"status"`
+ ID string `json:"id"`
- // StatusReason provides additional information about the status.
+ // IconDarkURL is the optional dark stack icon URL for light themes.
//
// Required: false
- StatusReason *string `json:"statusReason,omitempty"`
+ IconDarkURL string `json:"iconDarkUrl,omitempty"`
- // ServiceCount is the total number of services in the project.
+ // Path is the file path to the project.
//
// Required: true
- ServiceCount int `json:"serviceCount"`
+ Path string `json:"path"`
- // RunningCount is the number of running services in the project.
+ // UpdatedAt is the date and time when the project was last updated.
//
// Required: true
- RunningCount int `json:"runningCount"`
+ UpdatedAt string `json:"updatedAt"`
- // IsArchived indicates whether the project is hidden from the default project list.
+ // CreatedAt is the date and time when the project was created.
//
// Required: true
- IsArchived bool `json:"isArchived"`
+ CreatedAt string `json:"createdAt"`
- // IsDiscovered indicates whether this row was derived from runtime Compose labels instead of an Arcane project record.
+ // RuntimeServices contains live container status information for each service.
//
// Required: false
- IsDiscovered bool `json:"isDiscovered,omitempty"`
+ RuntimeServices []RuntimeService `json:"runtimeServices,omitempty"`
- // ArchivedAt is the date and time when the project was archived.
+ // Services is a list of services defined in the Docker Compose file.
//
// Required: false
- ArchivedAt *time.Time `json:"archivedAt,omitempty"`
+ Services []composetypes.ServiceConfig `json:"services,omitempty"`
- // CreatedAt is the date and time when the project was created.
+ // URLs are optional custom stack URLs from compose metadata.
//
- // Required: true
- CreatedAt string `json:"createdAt"`
+ // Required: false
+ URLs []string `json:"urls,omitempty"`
- // UpdatedAt is the date and time when the project was last updated.
+ // ProjectFiles contains the editable file tree for project file management.
//
- // Required: true
- UpdatedAt string `json:"updatedAt"`
+ // Required: false
+ ProjectFiles []ProjectFile `json:"projectFiles,omitempty"`
- // Services is a list of services defined in the Docker Compose file.
+ // DirectoryFiles contains all other files in the project directory
+ // (excluding compose files, .env, and include files which are shown separately).
//
// Required: false
- Services []composetypes.ServiceConfig `json:"services,omitempty"`
+ DirectoryFiles []IncludeFile `json:"directoryFiles,omitempty"`
- // RuntimeServices contains live container status information for each service.
+ // IncludeFiles is a list of included files in the project.
//
// Required: false
- RuntimeServices []RuntimeService `json:"runtimeServices,omitempty"`
+ IncludeFiles []IncludeFile `json:"includeFiles,omitempty"`
- // UpdateInfo contains aggregated image update status for the project.
+ // RunningCount is the number of running services in the project.
//
- // Required: false
- UpdateInfo *UpdateInfo `json:"updateInfo,omitempty"`
+ // Required: true
+ RunningCount int `json:"runningCount"`
- // HasBuildDirective indicates whether any Compose service defines a build directive.
+ // ServiceCount is the total number of services in the project.
//
- // Required: false
- HasBuildDirective bool `json:"hasBuildDirective,omitempty"`
+ // Required: true
+ ServiceCount int `json:"serviceCount"`
- // RedeployDisabled indicates whether redeploy actions are disabled for this project.
+ // IsDiscovered indicates whether this row was derived from runtime Compose labels instead of an Arcane project record.
//
// Required: false
- RedeployDisabled bool `json:"redeployDisabled,omitempty"`
+ IsDiscovered bool `json:"isDiscovered,omitempty"`
- // GitOpsManagedBy is the ID of the GitOps sync managing this project (if any).
+ // IsArchived indicates whether the project is hidden from the default project list.
//
- // Required: false
- GitOpsManagedBy *string `json:"gitOpsManagedBy,omitempty"`
+ // Required: true
+ IsArchived bool `json:"isArchived"`
- // LastSyncCommit is the last commit synced from Git (if GitOps managed).
+ // HasBuildDirective indicates whether any Compose service defines a build directive.
//
// Required: false
- LastSyncCommit *string `json:"lastSyncCommit,omitempty"`
+ HasBuildDirective bool `json:"hasBuildDirective,omitempty"`
- // GitRepositoryURL is the URL of the Git repository (if GitOps managed).
+ // RedeployDisabled indicates whether redeploy actions are disabled for this project.
//
// Required: false
- GitRepositoryURL string `json:"gitRepositoryURL,omitempty"`
+ RedeployDisabled bool `json:"redeployDisabled,omitempty"`
- // ActivityID is the activity created by the project action.
+ // FileTreeTruncated indicates the file tree walk hit the entry cap and
+ // ProjectFiles is only a prefix of the full tree.
//
// Required: false
- ActivityID *string `json:"activityId,omitempty"`
+ FileTreeTruncated bool `json:"fileTreeTruncated,omitempty"`
}
// Destroy is used to destroy a project.
diff --git a/types/swarm/lifecycle.go b/types/swarm/lifecycle.go
index efedd7a91..3b56fa012 100644
--- a/types/swarm/lifecycle.go
+++ b/types/swarm/lifecycle.go
@@ -10,13 +10,13 @@ type SwarmInitRequest struct {
ListenAddr string `json:"listenAddr,omitempty"`
AdvertiseAddr string `json:"advertiseAddr,omitempty"`
DataPathAddr string `json:"dataPathAddr,omitempty"`
- DataPathPort uint32 `json:"dataPathPort,omitempty"`
- ForceNewCluster bool `json:"forceNewCluster,omitempty"`
Spec json.RawMessage `json:"spec" doc:"Swarm specification"`
- AutoLockManagers bool `json:"autoLockManagers,omitempty"`
Availability swarm.NodeAvailability `json:"availability,omitempty"`
DefaultAddrPool []string `json:"defaultAddrPool,omitempty"`
+ DataPathPort uint32 `json:"dataPathPort,omitempty"`
SubnetSize uint32 `json:"subnetSize,omitempty"`
+ ForceNewCluster bool `json:"forceNewCluster,omitempty"`
+ AutoLockManagers bool `json:"autoLockManagers,omitempty"`
}
type SwarmInitResponse struct {
diff --git a/types/swarm/service.go b/types/swarm/service.go
index abe16c998..17120b63b 100644
--- a/types/swarm/service.go
+++ b/types/swarm/service.go
@@ -193,20 +193,20 @@ type ServiceNetworkConfigDetail struct {
// ServiceNetworkDetail holds enriched network information for a service's attached network.
type ServiceNetworkDetail struct {
+ Options map[string]string `json:"options,omitempty"`
+ ConfigNetwork *ServiceNetworkConfigDetail `json:"configNetwork,omitempty"`
ID string `json:"id"`
Name string `json:"name"`
Driver string `json:"driver"`
Scope string `json:"scope"`
+ ConfigFrom string `json:"configFrom,omitempty"`
+ IPAMConfigs []ServiceNetworkIPAMConfig `json:"ipamConfigs,omitempty"`
Internal bool `json:"internal"`
Attachable bool `json:"attachable"`
Ingress bool `json:"ingress"`
EnableIPv4 bool `json:"enableIPv4"`
EnableIPv6 bool `json:"enableIPv6"`
- ConfigFrom string `json:"configFrom,omitempty"`
ConfigOnly bool `json:"configOnly"`
- Options map[string]string `json:"options,omitempty"`
- IPAMConfigs []ServiceNetworkIPAMConfig `json:"ipamConfigs,omitempty"`
- ConfigNetwork *ServiceNetworkConfigDetail `json:"configNetwork,omitempty"`
}
type ServiceCreateRequest struct {
diff --git a/types/user/user.go b/types/user/user.go
index 83700da85..035d4d69e 100644
--- a/types/user/user.go
+++ b/types/user/user.go
@@ -42,20 +42,20 @@ type RoleAssignmentSummary struct {
// User represents a user in API responses.
type User struct {
- ID string `json:"id" doc:"Unique identifier of the user" example:"550e8400-e29b-41d4-a716-446655440000"`
- Username string `json:"username" doc:"Username of the user" example:"johndoe"`
+ FontSize *int `json:"fontSize,omitempty" minimum:"12" maximum:"20" doc:"Preferred root UI font size in px" example:"14"`
DisplayName *string `json:"displayName,omitempty" doc:"Display name of the user" example:"John Doe"`
Email *string `json:"email,omitempty" doc:"Email address of the user" example:"[email protected]"`
AvatarURL *string `json:"avatarUrl,omitempty" doc:"URL to the user's custom avatar image; omitted when using the default profile picture"`
- RoleAssignments []RoleAssignmentSummary `json:"roleAssignments" doc:"Role assignments held by the user"`
- PermissionsByEnv map[string][]string `json:"permissionsByEnv" doc:"Permissions the user effectively holds, keyed by environment ID. The 'global' key holds permissions that apply across every environment (and to org-level endpoints)."`
- IsGlobalAdmin bool `json:"isGlobalAdmin" doc:"Whether the user effectively holds global administrator access"`
- CanDelete bool `json:"canDelete" doc:"Whether the user can currently be deleted"`
OidcSubjectId *string `json:"oidcSubjectId,omitempty" doc:"OIDC subject identifier for SSO users"`
Locale *string `json:"locale,omitempty" doc:"Locale preference of the user" example:"en-US"`
+ PermissionsByEnv map[string][]string `json:"permissionsByEnv" doc:"Permissions the user effectively holds, keyed by environment ID. The 'global' key holds permissions that apply across every environment (and to org-level endpoints)."`
+ ID string `json:"id" doc:"Unique identifier of the user" example:"550e8400-e29b-41d4-a716-446655440000"`
+ Username string `json:"username" doc:"Username of the user" example:"johndoe"`
TimeFormat TimeFormat `json:"timeFormat" enum:"auto,12h,24h" doc:"Preferred time display format" example:"auto"`
- FontSize *int `json:"fontSize,omitempty" minimum:"12" maximum:"20" doc:"Preferred root UI font size in px" example:"14"`
CreatedAt string `json:"createdAt,omitempty" doc:"Date and time when the user was created"`
UpdatedAt string `json:"updatedAt,omitempty" doc:"Date and time when the user was last updated"`
+ RoleAssignments []RoleAssignmentSummary `json:"roleAssignments" doc:"Role assignments held by the user"`
+ IsGlobalAdmin bool `json:"isGlobalAdmin" doc:"Whether the user effectively holds global administrator access"`
+ CanDelete bool `json:"canDelete" doc:"Whether the user can currently be deleted"`
RequiresPasswordChange bool `json:"requiresPasswordChange" doc:"Whether the user must change their password"`
}
diff --git a/types/version/version.go b/types/version/version.go
index 588d548af..e169fa899 100644
--- a/types/version/version.go
+++ b/types/version/version.go
@@ -42,11 +42,6 @@ type Info struct {
// Required: true
SvelteKitVersion string `json:"svelteKitVersion"`
- // EnabledFeatures is the list of build-time feature flags compiled into the binary.
- //
- // Required: false
- EnabledFeatures []string `json:"enabledFeatures,omitempty"`
-
// BuildTime is the timestamp when the application was built.
//
// Required: false
@@ -57,11 +52,6 @@ type Info struct {
// Required: true
DisplayVersion string `json:"displayVersion"`
- // IsSemverVersion indicates if the current version follows semantic versioning.
- //
- // Required: true
- IsSemverVersion bool `json:"isSemverVersion"`
-
// NewestVersion is the newest available version string.
//
// Required: false
@@ -72,11 +62,6 @@ type Info struct {
// Required: false
NewestDigest string `json:"newestDigest,omitempty"`
- // UpdateAvailable indicates if an update is available.
- //
- // Required: true
- UpdateAvailable bool `json:"updateAvailable"`
-
// ReleaseURL is the URL to the release page.
//
// Required: false
@@ -91,6 +76,21 @@ type Info struct {
//
// Required: false
ReleasedAt string `json:"releasedAt,omitempty"`
+
+ // EnabledFeatures is the list of build-time feature flags compiled into the binary.
+ //
+ // Required: false
+ EnabledFeatures []string `json:"enabledFeatures,omitempty"`
+
+ // IsSemverVersion indicates if the current version follows semantic versioning.
+ //
+ // Required: true
+ IsSemverVersion bool `json:"isSemverVersion"`
+
+ // UpdateAvailable indicates if an update is available.
+ //
+ // Required: true
+ UpdateAvailable bool `json:"updateAvailable"`
}
// Check contains simplified version check information.
diff --git a/types/volume/browse.go b/types/volume/browse.go
index b6f2f470e..2e96a7b1b 100644
--- a/types/volume/browse.go
+++ b/types/volume/browse.go
@@ -3,14 +3,14 @@ package volume
import "time"
type FileEntry struct {
+ ModTime time.Time `json:"modTime" doc:"Last modification time"`
Name string `json:"name" doc:"Name of the file or directory"`
Path string `json:"path" doc:"Full path to the file"`
- IsDirectory bool `json:"isDirectory" doc:"Whether this entry is a directory"`
- Size int64 `json:"size" doc:"Size of the file in bytes"`
- ModTime time.Time `json:"modTime" doc:"Last modification time"`
Mode string `json:"mode" doc:"File mode/permissions"`
- IsSymlink bool `json:"isSymlink" doc:"Whether this entry is a symbolic link"`
LinkTarget string `json:"linkTarget,omitempty" doc:"Target of the symbolic link"`
+ Size int64 `json:"size" doc:"Size of the file in bytes"`
+ IsDirectory bool `json:"isDirectory" doc:"Whether this entry is a directory"`
+ IsSymlink bool `json:"isSymlink" doc:"Whether this entry is a symbolic link"`
}
type FileMetadata struct {