includio-cms 0.14.1 → 0.14.3

package/CHANGELOG.md

@@ -3,6 +3,39 @@
 All notable changes to includio-cms are documented here.
 Generated from `src/lib/updates/` — do not edit manually.
 
+## 0.14.3 — 2026-03-27
+
+Background maintenance system — automatic style generation, poster regeneration, video transcoding, orphan cleanup on configurable schedule
+
+### Added
+- Background maintenance scheduler — runs style generation, poster regeneration, video transcoding, and orphan cleanup automatically
+- Maintenance status API endpoint (`/admin/api/maintenance-status`) — real-time status of background tasks
+- Configurable maintenance interval via `media.maintenance` config (`autoRun`, `intervalHours`)
+- Maintenance page UI redesign — auto-status banner, organized sections, compact progress indicators
+
+### Fixed
+- Maintenance page SSE handler deduplication — single reusable `handleSSE()` replaces 3 duplicated implementations
+
+## 0.14.2 — 2026-03-27
+
+Image styles: aspectRatio support, lazy generation, skip defaults when custom styles defined
+
+### Added
+- aspectRatio option for image styles — crop to ratio without fixed dimensions
+- Lazy generation of custom field styles on first read
+- Skip default styles when field defines custom styles (prevents <source> conflicts in <picture>)
+
+### Migration
+
+```sql
+ALTER TABLE image_styles ADD COLUMN IF NOT EXISTS aspect_ratio REAL;
+
+-- Drop old unique index and recreate with aspect_ratio
+DROP INDEX IF EXISTS image_styles_unique_key;
+CREATE UNIQUE INDEX image_styles_unique_key
+ON image_styles (media_file_id, name, COALESCE(width, 0), COALESCE(height, 0), COALESCE(quality, 0), COALESCE(aspect_ratio, 0));
+```
+
 ## 0.14.1 — 2026-03-27
 
 CMS context provider, Svelte 5 compat, docs overhaul

package/DOCS.md

@@ -1,4 +1,4 @@
-# Includio CMS Documentation (v0.14.1)
+# Includio CMS Documentation (v0.14.3)
 
 > This file is auto-generated from the docs site. For the latest version, update the package.
 
@@ -2472,6 +2472,17 @@ On the frontend, the `<Video>` component serves transcoded sources automatically
 
 See [Video Transcoding](/docs/video-transcoding) for full configuration and usage.
 
+## Background Maintenance
+
+Includio runs automatic background maintenance on a configurable schedule (default: every 6 hours). Tasks include:
+
+1. Generate missing image styles
+2. Regenerate missing video posters
+3. Transcode missing video variants (if ffmpeg available)
+4. Clean up orphaned disk files
+
+Configure via `media.maintenance` in your CMS config. See [Video Transcoding](/docs/video-transcoding#background-maintenance) for details.
+
 ## File Adapter
 
 The file adapter handles physical storage. See [Files Adapter](/docs/adapters/files) for the interface.
@@ -2557,10 +2568,32 @@ interface VideoStyle {
 }
 ```
 
+## Background Maintenance
+
+Since **v0.14.3**, Includio runs automatic background maintenance that includes video transcoding alongside other tasks (image styles, posters, orphan cleanup).
+
+Configure via `media.maintenance`:
+
+```typescript
+defineConfig({
+  media: {
+    maintenance: {
+      autoRun: true,       // default: true — start on CMS init
+      intervalHours: 6     // default: 6 — hours between runs
+    }
+  }
+});
+```
+
+The first run starts 30 seconds after CMS initialization, then repeats at the configured interval.
+
+Check status via `GET /admin/api/maintenance-status` — returns whether maintenance is running, last run time, next scheduled run, and result summary.
+
 ## Admin UI
 
 The admin maintenance page provides:
 
+- **Auto-maintenance status banner** — shows running state, last/next run, result summary
 - **Batch transcode** — transcode all videos that don't have styles yet (SSE progress)
 - **Purge video styles** — delete all transcoded variants from disk and database
 - **Retranscode** — purge + retranscode all videos

package/ROADMAP.md

@@ -263,6 +263,19 @@
 - [x] `[chore]` `[P1]` Documentation overhaul — new pages, README rewrite, DOCS.md compilation script <!-- files: scripts/compile-docs.ts, DOCS.md -->
 - [x] `[chore]` `[P2]` Remove obsolete docs/ Obsidian config & stale docs
 
+## 0.14.2 — Image styles: aspectRatio, skip defaults, lazy generation
+
+- [x] `[feature]` `[P1]` aspectRatio option for image styles — crop to ratio without fixed dimensions <!-- files: src/lib/types/fields.ts, src/lib/core/server/media/styles/sharp/generateImageStyle.ts, src/lib/db-postgres/schema/imageStyle.ts -->
+- [x] `[feature]` `[P1]` Skip default styles when field defines custom styles (prevents `<source>` conflicts in `<picture>`) <!-- files: src/lib/core/server/fields/utils/imageStyles.ts -->
+- [x] `[feature]` `[P2]` Lazy generation of custom field styles on first read <!-- files: src/lib/core/server/fields/utils/imageStyles.ts -->
+
+## 0.14.3 — Background maintenance
+
+- [x] `[feature]` `[P1]` Background maintenance scheduler — auto styles, posters, transcodes, orphan cleanup on configurable interval <!-- files: src/lib/core/server/media/operations/backgroundMaintenance.ts, src/lib/core/cms.ts -->
+- [x] `[feature]` `[P1]` Maintenance status API endpoint <!-- files: src/lib/admin/api/maintenance-status.ts, src/lib/admin/api/handler.ts -->
+- [x] `[feature]` `[P2]` Configurable maintenance interval via `media.maintenance` config <!-- files: src/lib/types/cms.ts -->
+- [x] `[feature]` `[P1]` Maintenance page UI redesign — status banner, sections, SSE handler dedup <!-- files: src/lib/admin/client/maintenance/maintenance-page.svelte -->
+
 ## 0.15.0 — SEO module
 
 - [ ] `[feature]` `[P1]` SERP preview + character limits for title/description <!-- files: src/lib/admin/components/fields/seo-field.svelte -->

package/dist/admin/api/handler.js

@@ -10,6 +10,7 @@ import * as regeneratePostersHandlers from './regenerate-posters.js';
 import * as transcodeVideosHandlers from './transcode-videos.js';
 import * as uploadLimitHandlers from './upload-limit.js';
 import * as systemInfoHandlers from './system-info.js';
+import * as maintenanceStatusHandlers from './maintenance-status.js';
 import { requireAuth } from '../remote/middleware/auth.js';
 import { getCMS } from '../../core/cms.js';
 import { lookup } from 'mrmime';
@@ -26,6 +27,7 @@ export function createAdminApiHandler(options) {
         'transcode-videos': transcodeVideosHandlers,
         'upload-limit': uploadLimitHandlers,
         'system-info': systemInfoHandlers,
+        'maintenance-status': maintenanceStatusHandlers,
         ...options?.extraRoutes
     };
     const privateMediaGet = async (event) => {

package/dist/admin/api/maintenance-status.d.ts

@@ -0,0 +1,2 @@
+import { type RequestHandler } from '@sveltejs/kit';
+export declare const GET: RequestHandler;

package/dist/admin/api/maintenance-status.js

@@ -0,0 +1,7 @@
+import { requireRole } from '../remote/middleware/auth.js';
+import { getMaintenanceStatus } from '../../core/server/media/operations/backgroundMaintenance.js';
+import { json } from '@sveltejs/kit';
+export const GET = async () => {
+    requireRole('admin');
+    return json(getMaintenanceStatus());
+};