@promptbook/cli 0.113.0-1 → 0.113.0-10

package/apps/agents-server/src/app/admin/update/UpdateOverview.ts

@@ -0,0 +1,142 @@
+/**
+ * Browser-safe environment option returned by the update API.
+ *
+ * @private type of `<UpdateClient/>`
+ */
+export type UpdateEnvironmentOption = {
+    readonly id: string;
+    readonly branch: string;
+    readonly label: string;
+    readonly description: string;
+    readonly isCustom: boolean;
+};
+
+/**
+ * Browser-safe database migration status recorded during one self-update job.
+ *
+ * @private type of `<UpdateClient/>`
+ */
+export type UpdateDatabaseMigrationStatus =
+    | 'pending'
+    | 'running'
+    | 'succeeded'
+    | 'failed'
+    | 'skipped'
+    | 'unknown';
+
+/**
+ * Browser-safe database migration summary for one table prefix.
+ *
+ * @private type of `<UpdateClient/>`
+ */
+export type UpdateDatabaseMigrationPrefixSummary = {
+    readonly prefix: string;
+    readonly appliedCount: number;
+    readonly appliedMigrationFiles: ReadonlyArray<string>;
+};
+
+/**
+ * Browser-safe database migration snapshot recorded during one self-update job.
+ *
+ * @private type of `<UpdateClient/>`
+ */
+export type UpdateDatabaseMigrationSnapshot = {
+    readonly status: UpdateDatabaseMigrationStatus;
+    readonly processedPrefixes: ReadonlyArray<string>;
+    readonly totalMigrationFiles: number | null;
+    readonly perPrefix: ReadonlyArray<UpdateDatabaseMigrationPrefixSummary>;
+    readonly isSkippedDueToActiveMigrationLock: boolean | null;
+    readonly errorMessage: string | null;
+    readonly summaryFilePath: string | null;
+};
+
+/**
+ * Browser-safe latest update-job snapshot.
+ *
+ * @private type of `<UpdateClient/>`
+ */
+export type UpdateJobSnapshot = {
+    readonly jobId: string | null;
+    readonly status: 'idle' | 'running' | 'succeeded' | 'failed';
+    readonly trigger: 'manual' | 'automatic';
+    readonly pid: number | null;
+    readonly targetBranch: string | null;
+    readonly targetEnvironment: UpdateEnvironmentOption;
+    readonly currentStep: string | null;
+    readonly currentCommitSha: string | null;
+    readonly targetCommitSha: string | null;
+    readonly errorMessage: string | null;
+    readonly startedAt: string | null;
+    readonly finishedAt: string | null;
+    readonly isStale: boolean;
+    readonly logTail: string | null;
+    readonly logFilePath: string | null;
+    readonly databaseMigrations: UpdateDatabaseMigrationSnapshot;
+};
+
+/**
+ * Browser-safe automatic self-update configuration.
+ *
+ * @private type of `<UpdateClient/>`
+ */
+export type AutomaticUpdateConfiguration = {
+    readonly isEnabled: boolean;
+    readonly environment: UpdateEnvironmentOption;
+    readonly cronExpression: string;
+};
+
+/**
+ * Browser-safe summary of one installed Agents Server version.
+ *
+ * @private type of `<UpdateClient/>`
+ */
+export type UpdateInstalledVersion = {
+    readonly name: string;
+    readonly directoryPath: string;
+    readonly modifiedAt: string | null;
+    readonly isCurrent: boolean;
+};
+
+/**
+ * Browser-safe summary of one commit between the deployed checkout and the latest remote commit.
+ *
+ * @private type of `<UpdateClient/>`
+ */
+export type UpdatePendingCommit = {
+    readonly commitSha: string;
+    readonly shortCommitSha: string;
+    readonly subject: string;
+    readonly authoredAt: string | null;
+};
+
+/**
+ * Browser-safe self-update overview returned by the super-admin API.
+ *
+ * @private type of `<UpdateClient/>`
+ */
+export type UpdateOverview = {
+    readonly isAvailable: boolean;
+    readonly unavailableReason: string | null;
+    readonly environments: ReadonlyArray<UpdateEnvironmentOption>;
+    readonly currentEnvironment: UpdateEnvironmentOption;
+    readonly repositoryDirectory: string | null;
+    readonly currentCommitSha: string | null;
+    readonly currentCommitShortSha: string | null;
+    readonly currentCommitMessage: string | null;
+    readonly currentCommitDate: string | null;
+    readonly latestRemoteCommitSha: string | null;
+    readonly latestRemoteCommitShortSha: string | null;
+    readonly latestRemoteCommitDate: string | null;
+    readonly latestRemoteCommitMessage: string | null;
+    readonly commitsBehindCount: number | null;
+    readonly pendingCommits: ReadonlyArray<UpdatePendingCommit>;
+    readonly isUpdateAvailable: boolean;
+    readonly originRepositoryUrl: string;
+    readonly isOriginRepositoryDefault: boolean;
+    readonly defaultOriginRepositoryUrl: string;
+    readonly automaticConfiguration: AutomaticUpdateConfiguration;
+    readonly installedVersions: ReadonlyArray<UpdateInstalledVersion>;
+    readonly garbageCollectionKeepVersionsCount: number;
+    readonly job: UpdateJobSnapshot;
+    readonly error?: string;
+};

package/apps/agents-server/src/app/admin/update/buildDeploymentTimeBehindLabel.ts

@@ -0,0 +1,29 @@
+import type { ServerLanguageCode } from '../../../languages/ServerLanguageRegistry';
+import { createServerLanguageMoment } from '../../../utils/localization/createServerLanguageMoment';
+import type { UpdateOverview } from './UpdateOverview';
+
+/**
+ * Builds the localized time-behind portion of the deployment drift label (e.g. `3 days behind`).
+ *
+ * @param overview - Current overview snapshot.
+ * @param language - Active UI language for moment localization.
+ * @returns Time-behind label or empty string when either side of the comparison is missing.
+ *
+ * @private function of `<UpdateClient/>`
+ */
+export function buildDeploymentTimeBehindLabel(
+    overview: UpdateOverview | null,
+    language: ServerLanguageCode,
+): string {
+    if (!overview?.currentCommitDate || !overview.latestRemoteCommitDate) {
+        return '';
+    }
+
+    const currentMoment = createServerLanguageMoment(overview.currentCommitDate, language);
+    const latestMoment = createServerLanguageMoment(overview.latestRemoteCommitDate, language);
+    if (!currentMoment.isValid() || !latestMoment.isValid()) {
+        return '';
+    }
+
+    return `${currentMoment.from(latestMoment, true)} behind`;
+}

package/apps/agents-server/src/app/admin/update/formatHumanReadableTimestamp.ts

@@ -0,0 +1,18 @@
+import type { ServerLanguageCode } from '../../../languages/ServerLanguageRegistry';
+import { formatServerLanguageHumanReadableDate } from '../../../utils/localization/formatServerLanguageHumanReadableDate';
+
+/**
+ * Formats optional timestamps for the update status cards using `moment.js` with the active UI language.
+ *
+ * @param value - ISO timestamp or `null`.
+ * @param language - Active UI language code.
+ * @returns Localized human-friendly timestamp or fallback text.
+ *
+ * @private function of `<UpdateClient/>`
+ */
+export function formatHumanReadableTimestamp(value: string | null | undefined, language: ServerLanguageCode): string {
+    return formatServerLanguageHumanReadableDate(value, language, {
+        fallbackLabel: 'Not available',
+        isExactDateIncluded: true,
+    });
+}

package/apps/agents-server/src/app/admin/update/getUpdateJobFailureMessage.ts

@@ -0,0 +1,13 @@
+import type { UpdateJobSnapshot } from './UpdateOverview';
+
+/**
+ * Builds the failure message for a failed standalone VPS update.
+ *
+ * @param job - Failed update job snapshot.
+ * @returns Human-readable failure message.
+ *
+ * @private function of `<UpdateClient/>`
+ */
+export function getUpdateJobFailureMessage(job: UpdateJobSnapshot): string {
+    return job.errorMessage || 'The standalone VPS update failed. Review the installer log for details.';
+}

package/apps/agents-server/src/app/admin/update/getUpdateJobSuccessMessage.ts

@@ -0,0 +1,13 @@
+import type { UpdateJobSnapshot } from './UpdateOverview';
+
+/**
+ * Builds the success message for a finished standalone VPS update.
+ *
+ * @param job - Completed update job snapshot.
+ * @returns Human-readable success message.
+ *
+ * @private function of `<UpdateClient/>`
+ */
+export function getUpdateJobSuccessMessage(job: UpdateJobSnapshot): string {
+    return job.currentStep || 'Standalone VPS update finished successfully.';
+}

package/apps/agents-server/src/app/admin/update/updatePageCardClassName.ts

@@ -0,0 +1,6 @@
+/**
+ * Shared card styling for `/admin/update` cards that should size to their content inside stacked grids.
+ *
+ * @private constant of `/admin/update`
+ */
+export const UPDATE_PAGE_CARD_CLASS_NAME = '!h-auto min-w-0 hover:border-gray-200 hover:shadow-md';