@serve.zone/gitops 2.13.1

package/dist_ts/classes/jobmanager.js

@@ -0,0 +1,301 @@
+import * as plugins from '../plugins.js';
+import { logger } from '../logging.js';
+import { intervalMinutesToMs, unrefTimer, validateIntervalMinutes } from '../timers.js';
+import { getRunner } from './jobrunners/index.js';
+const JOBS_PREFIX = '/jobs/';
+const KEYCHAIN_PREFIX = 'keychain:';
+const KEYCHAIN_JOB_PREFIX = 'gitops-job-';
+/**
+ * Manages job configurations: CRUD, scheduling, and execution dispatch.
+ * Job-type-specific logic is delegated to registered runners.
+ */
+export class JobManager {
+    storageManager;
+    connectionManager;
+    actionLog;
+    smartSecret;
+    jobs = [];
+    timers = new Map();
+    runningJobs = new Set();
+    activeJobExecutions = new Set();
+    stopping = false;
+    constructor(storageManager, connectionManager, actionLog, smartSecret) {
+        this.storageManager = storageManager;
+        this.connectionManager = connectionManager;
+        this.actionLog = actionLog;
+        this.smartSecret = smartSecret;
+    }
+    async init() {
+        this.stopping = false;
+        await this.loadJobs();
+        for (const job of this.jobs) {
+            if (job.status === 'active') {
+                this.startTimer(job);
+            }
+        }
+        if (this.jobs.length > 0) {
+            logger.info(`JobManager loaded ${this.jobs.length} job(s)`);
+        }
+    }
+    async stop() {
+        this.stopping = true;
+        for (const [_id, timer] of this.timers) {
+            clearInterval(timer);
+        }
+        this.timers.clear();
+        if (this.activeJobExecutions.size > 0) {
+            logger.info(`Waiting for ${this.activeJobExecutions.size} active job execution(s) to finish...`);
+            await Promise.allSettled([...this.activeJobExecutions]);
+        }
+    }
+    // ============================================================================
+    // CRUD
+    // ============================================================================
+    getJobs() {
+        return this.jobs.map((j) => this.maskSecrets(j));
+    }
+    getJob(id) {
+        const job = this.jobs.find((j) => j.id === id);
+        return job ? this.maskSecrets(job) : undefined;
+    }
+    async createJob(data) {
+        // Validate that a runner exists for this job type
+        getRunner(data.jobType);
+        const now = Date.now();
+        const intervalMinutes = validateIntervalMinutes(data.intervalMinutes, 'job intervalMinutes');
+        const job = {
+            id: crypto.randomUUID(),
+            name: data.name,
+            jobType: data.jobType,
+            status: 'paused',
+            intervalMinutes,
+            lastRunAt: 0,
+            createdAt: now,
+            updatedAt: now,
+            autoBookstackDocsConfig: data.autoBookstackDocsConfig,
+        };
+        // Store BookStack token in keychain
+        if (job.autoBookstackDocsConfig) {
+            await this.storeBookstackToken(job.id, job.autoBookstackDocsConfig.bookstackTarget.tokenSecret);
+            job.autoBookstackDocsConfig.bookstackTarget.tokenSecret = `${KEYCHAIN_PREFIX}${KEYCHAIN_JOB_PREFIX}${job.id}`;
+        }
+        this.jobs.push(job);
+        await this.persistJob(job);
+        logger.success(`Job created: ${job.name} (${job.jobType})`);
+        return this.maskSecrets(job);
+    }
+    async updateJob(id, updates) {
+        const job = this.jobs.find((j) => j.id === id);
+        if (!job)
+            throw new Error(`Job not found: ${id}`);
+        if (updates.name !== undefined)
+            job.name = updates.name;
+        if (updates.intervalMinutes !== undefined) {
+            job.intervalMinutes = validateIntervalMinutes(updates.intervalMinutes, 'job intervalMinutes');
+        }
+        if (updates.autoBookstackDocsConfig !== undefined) {
+            const newToken = updates.autoBookstackDocsConfig.bookstackTarget.tokenSecret;
+            if (newToken && newToken !== '***' && !newToken.startsWith(KEYCHAIN_PREFIX)) {
+                // New real token provided — store in keychain
+                await this.storeBookstackToken(job.id, newToken);
+                updates.autoBookstackDocsConfig.bookstackTarget.tokenSecret = `${KEYCHAIN_PREFIX}${KEYCHAIN_JOB_PREFIX}${job.id}`;
+            }
+            else {
+                // Empty, masked, or sentinel — preserve existing token reference
+                const existingToken = job.autoBookstackDocsConfig?.bookstackTarget?.tokenSecret;
+                if (existingToken) {
+                    updates.autoBookstackDocsConfig.bookstackTarget.tokenSecret = existingToken;
+                }
+            }
+            job.autoBookstackDocsConfig = updates.autoBookstackDocsConfig;
+        }
+        job.updatedAt = Date.now();
+        await this.persistJob(job);
+        // Restart timer if active
+        if (job.status === 'active') {
+            this.stopTimer(job.id);
+            this.startTimer(job);
+        }
+        return this.maskSecrets(job);
+    }
+    async deleteJob(id) {
+        const idx = this.jobs.findIndex((j) => j.id === id);
+        if (idx === -1)
+            throw new Error(`Job not found: ${id}`);
+        this.stopTimer(id);
+        this.jobs.splice(idx, 1);
+        await this.storageManager.delete(`${JOBS_PREFIX}${id}.json`);
+        await this.smartSecret.deleteSecret(`${KEYCHAIN_JOB_PREFIX}${id}`);
+        logger.info(`Job deleted: ${id}`);
+    }
+    async pauseJob(id, paused) {
+        const job = this.jobs.find((j) => j.id === id);
+        if (!job)
+            throw new Error(`Job not found: ${id}`);
+        job.status = paused ? 'paused' : 'active';
+        job.updatedAt = Date.now();
+        if (paused) {
+            this.stopTimer(id);
+        }
+        else {
+            this.startTimer(job);
+        }
+        await this.persistJob(job);
+        logger.info(`Job ${paused ? 'paused' : 'resumed'}: ${job.name}`);
+        return this.maskSecrets(job);
+    }
+    // ============================================================================
+    // Execution
+    // ============================================================================
+    async executeJob(jobId, force = false) {
+        if (this.stopping) {
+            logger.warn(`JobManager is stopping, skipping job ${jobId}`);
+            return;
+        }
+        const executionPromise = this.executeJobInternal(jobId, force);
+        this.activeJobExecutions.add(executionPromise);
+        try {
+            await executionPromise;
+        }
+        finally {
+            this.activeJobExecutions.delete(executionPromise);
+        }
+    }
+    async executeJobInternal(jobId, force = false) {
+        const job = this.jobs.find((j) => j.id === jobId);
+        if (!job)
+            throw new Error(`Job not found: ${jobId}`);
+        if (this.runningJobs.has(jobId)) {
+            logger.warn(`Job "${job.name}" is already running, skipping`);
+            return;
+        }
+        if (!force && job.status !== 'active') {
+            logger.warn(`Job "${job.name}" is not active, skipping`);
+            return;
+        }
+        this.runningJobs.add(jobId);
+        const startTime = Date.now();
+        try {
+            const runner = getRunner(job.jobType);
+            const context = {
+                jobConfig: job,
+                connectionManager: this.connectionManager,
+                storageManager: this.storageManager,
+                smartSecret: this.smartSecret,
+            };
+            logger.jobLog('info', `Executing job: ${job.name}`, 'job');
+            await runner.execute(context);
+            const durationSec = ((Date.now() - startTime) / 1000).toFixed(1);
+            job.lastRunAt = startTime;
+            job.lastRunDurationMs = Date.now() - startTime;
+            job.lastRunError = undefined;
+            if (job.status === 'error')
+                job.status = 'active';
+            logger.jobLog('success', `Job "${job.name}" completed in ${durationSec}s`, 'job');
+        }
+        catch (err) {
+            job.lastRunAt = startTime;
+            job.lastRunDurationMs = Date.now() - startTime;
+            job.lastRunError = String(err);
+            job.status = 'error';
+            logger.jobLog('error', `Job "${job.name}" failed: ${err}`, 'job');
+        }
+        finally {
+            job.updatedAt = Date.now();
+            this.runningJobs.delete(jobId);
+            await this.persistJob(job);
+        }
+    }
+    isJobRunning(jobId) {
+        return this.runningJobs.has(jobId);
+    }
+    // ============================================================================
+    // Storage
+    // ============================================================================
+    async loadJobs() {
+        const keys = await this.storageManager.list(JOBS_PREFIX);
+        this.jobs = [];
+        for (const key of keys) {
+            const job = await this.storageManager.getJSON(key);
+            if (job) {
+                try {
+                    job.intervalMinutes = validateIntervalMinutes(job.intervalMinutes, `job "${job.name}" intervalMinutes`);
+                }
+                catch (err) {
+                    job.status = 'error';
+                    job.lastRunError = err instanceof Error ? err.message : String(err);
+                    job.updatedAt = Date.now();
+                    await this.persistJob(job);
+                }
+                // Resolve keychain sentinels for BookStack tokens
+                if (job.autoBookstackDocsConfig) {
+                    const token = job.autoBookstackDocsConfig.bookstackTarget.tokenSecret;
+                    if (token.startsWith(KEYCHAIN_PREFIX)) {
+                        const keychainId = token.slice(KEYCHAIN_PREFIX.length);
+                        const realToken = await this.smartSecret.getSecret(keychainId);
+                        if (realToken) {
+                            job.autoBookstackDocsConfig.bookstackTarget.tokenSecret = realToken;
+                        }
+                        else {
+                            logger.warn(`Could not retrieve BookStack token for job ${job.id} from keychain`);
+                        }
+                    }
+                }
+                this.jobs.push(job);
+            }
+        }
+    }
+    async persistJob(job) {
+        // Create a copy with token replaced by sentinel for storage
+        const stored = structuredClone(job);
+        if (stored.autoBookstackDocsConfig) {
+            const token = stored.autoBookstackDocsConfig.bookstackTarget.tokenSecret;
+            if (token && !token.startsWith(KEYCHAIN_PREFIX)) {
+                await this.storeBookstackToken(job.id, token);
+                stored.autoBookstackDocsConfig.bookstackTarget.tokenSecret = `${KEYCHAIN_PREFIX}${KEYCHAIN_JOB_PREFIX}${job.id}`;
+            }
+        }
+        await this.storageManager.setJSON(`${JOBS_PREFIX}${job.id}.json`, stored);
+    }
+    async storeBookstackToken(jobId, tokenSecret) {
+        await this.smartSecret.setSecret(`${KEYCHAIN_JOB_PREFIX}${jobId}`, tokenSecret);
+    }
+    maskSecrets(job) {
+        const masked = structuredClone(job);
+        if (masked.autoBookstackDocsConfig) {
+            masked.autoBookstackDocsConfig.bookstackTarget.tokenSecret = '***';
+        }
+        return masked;
+    }
+    // ============================================================================
+    // Timers
+    // ============================================================================
+    startTimer(job) {
+        if (this.timers.has(job.id))
+            return;
+        let intervalMs;
+        try {
+            intervalMs = intervalMinutesToMs(job.intervalMinutes, `job "${job.name}" intervalMinutes`);
+        }
+        catch (err) {
+            logger.error(`Timer not started for job "${job.name}": ${err}`);
+            return;
+        }
+        const timer = setInterval(() => {
+            this.executeJob(job.id).catch((err) => {
+                logger.error(`Timer-triggered job execution failed for "${job.name}": ${err}`);
+            });
+        }, intervalMs);
+        unrefTimer(timer);
+        this.timers.set(job.id, timer);
+        logger.info(`Timer started for job "${job.name}" (every ${job.intervalMinutes}min)`);
+    }
+    stopTimer(jobId) {
+        const timer = this.timers.get(jobId);
+        if (timer !== undefined) {
+            clearInterval(timer);
+            this.timers.delete(jobId);
+        }
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiam9ibWFuYWdlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3RzL2NsYXNzZXMvam9ibWFuYWdlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGVBQWUsQ0FBQztBQUN6QyxPQUFPLEVBQUUsTUFBTSxFQUFFLE1BQU0sZUFBZSxDQUFDO0FBQ3ZDLE9BQU8sRUFBRSxtQkFBbUIsRUFBRSxVQUFVLEVBQUUsdUJBQXVCLEVBQUUsTUFBTSxjQUFjLENBQUM7QUFLeEYsT0FBTyxFQUFFLFNBQVMsRUFBdUIsTUFBTSx1QkFBdUIsQ0FBQztBQUV2RSxNQUFNLFdBQVcsR0FBRyxRQUFRLENBQUM7QUFDN0IsTUFBTSxlQUFlLEdBQUcsV0FBVyxDQUFDO0FBQ3BDLE1BQU0sbUJBQW1CLEdBQUcsYUFBYSxDQUFDO0FBRTFDOzs7R0FHRztBQUNILE1BQU0sT0FBTyxVQUFVO0lBUVg7SUFDQTtJQUNBO0lBQ0E7SUFWRixJQUFJLEdBQWlDLEVBQUUsQ0FBQztJQUN4QyxNQUFNLEdBQWdELElBQUksR0FBRyxFQUFFLENBQUM7SUFDaEUsV0FBVyxHQUFnQixJQUFJLEdBQUcsRUFBRSxDQUFDO0lBQ3JDLG1CQUFtQixHQUFHLElBQUksR0FBRyxFQUFpQixDQUFDO0lBQy9DLFFBQVEsR0FBRyxLQUFLLENBQUM7SUFFekIsWUFDVSxjQUE4QixFQUM5QixpQkFBb0MsRUFDcEMsU0FBb0IsRUFDcEIsV0FBNEM7UUFINUMsbUJBQWMsR0FBZCxjQUFjLENBQWdCO1FBQzlCLHNCQUFpQixHQUFqQixpQkFBaUIsQ0FBbUI7UUFDcEMsY0FBUyxHQUFULFNBQVMsQ0FBVztRQUNwQixnQkFBVyxHQUFYLFdBQVcsQ0FBaUM7SUFDbkQsQ0FBQztJQUVKLEtBQUssQ0FBQyxJQUFJO1FBQ1IsSUFBSSxDQUFDLFFBQVEsR0FBRyxLQUFLLENBQUM7UUFDdEIsTUFBTSxJQUFJLENBQUMsUUFBUSxFQUFFLENBQUM7UUFDdEIsS0FBSyxNQUFNLEdBQUcsSUFBSSxJQUFJLENBQUMsSUFBSSxFQUFFLENBQUM7WUFDNUIsSUFBSSxHQUFHLENBQUMsTUFBTSxLQUFLLFFBQVEsRUFBRSxDQUFDO2dCQUM1QixJQUFJLENBQUMsVUFBVSxDQUFDLEdBQUcsQ0FBQyxDQUFDO1lBQ3ZCLENBQUM7UUFDSCxDQUFDO1FBQ0QsSUFBSSxJQUFJLENBQUMsSUFBSSxDQUFDLE1BQU0sR0FBRyxDQUFDLEVBQUUsQ0FBQztZQUN6QixNQUFNLENBQUMsSUFBSSxDQUFDLHFCQUFxQixJQUFJLENBQUMsSUFBSSxDQUFDLE1BQU0sU0FBUyxDQUFDLENBQUM7UUFDOUQsQ0FBQztJQUNILENBQUM7SUFFRCxLQUFLLENBQUMsSUFBSTtRQUNSLElBQUksQ0FBQyxRQUFRLEdBQUcsSUFBSSxDQUFDO1FBQ3JCLEtBQUssTUFBTSxDQUFDLEdBQUcsRUFBRSxLQUFLLENBQUMsSUFBSSxJQUFJLENBQUMsTUFBTSxFQUFFLENBQUM7WUFDdkMsYUFBYSxDQUFDLEtBQUssQ0FBQyxDQUFDO1FBQ3ZCLENBQUM7UUFDRCxJQUFJLENBQUMsTUFBTSxDQUFDLEtBQUssRUFBRSxDQUFDO1FBRXBCLElBQUksSUFBSSxDQUFDLG1CQUFtQixDQUFDLElBQUksR0FBRyxDQUFDLEVBQUUsQ0FBQztZQUN0QyxNQUFNLENBQUMsSUFBSSxDQUFDLGVBQWUsSUFBSSxDQUFDLG1CQUFtQixDQUFDLElBQUksdUNBQXVDLENBQUMsQ0FBQztZQUNqRyxNQUFNLE9BQU8sQ0FBQyxVQUFVLENBQUMsQ0FBQyxHQUFHLElBQUksQ0FBQyxtQkFBbUIsQ0FBQyxDQUFDLENBQUM7UUFDMUQsQ0FBQztJQUNILENBQUM7SUFFRCwrRUFBK0U7SUFDL0UsT0FBTztJQUNQLCtFQUErRTtJQUUvRSxPQUFPO1FBQ0wsT0FBTyxJQUFJLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsRUFBRSxFQUFFLENBQUMsSUFBSSxDQUFDLFdBQVcsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDO0lBQ25ELENBQUM7SUFFRCxNQUFNLENBQUMsRUFBVTtRQUNmLE1BQU0sR0FBRyxHQUFHLElBQUksQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLENBQUMsQ0FBQyxFQUFFLEVBQUUsQ0FBQyxDQUFDLENBQUMsRUFBRSxLQUFLLEVBQUUsQ0FBQyxDQUFDO1FBQy9DLE9BQU8sR0FBRyxDQUFDLENBQUMsQ0FBQyxJQUFJLENBQUMsV0FBVyxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsQ0FBQyxTQUFTLENBQUM7SUFDakQsQ0FBQztJQUVELEtBQUssQ0FBQyxTQUFTLENBQUMsSUFLZjtRQUNDLGtEQUFrRDtRQUNsRCxTQUFTLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxDQUFDO1FBRXhCLE1BQU0sR0FBRyxHQUFHLElBQUksQ0FBQyxHQUFHLEVBQUUsQ0FBQztRQUN2QixNQUFNLGVBQWUsR0FBRyx1QkFBdUIsQ0FBQyxJQUFJLENBQUMsZUFBZSxFQUFFLHFCQUFxQixDQUFDLENBQUM7UUFDN0YsTUFBTSxHQUFHLEdBQStCO1lBQ3RDLEVBQUUsRUFBRSxNQUFNLENBQUMsVUFBVSxFQUFFO1lBQ3ZCLElBQUksRUFBRSxJQUFJLENBQUMsSUFBSTtZQUNmLE9BQU8sRUFBRSxJQUFJLENBQUMsT0FBTztZQUNyQixNQUFNLEVBQUUsUUFBUTtZQUNoQixlQUFlO1lBQ2YsU0FBUyxFQUFFLENBQUM7WUFDWixTQUFTLEVBQUUsR0FBRztZQUNkLFNBQVMsRUFBRSxHQUFHO1lBQ2QsdUJBQXVCLEVBQUUsSUFBSSxDQUFDLHVCQUF1QjtTQUN0RCxDQUFDO1FBRUYsb0NBQW9DO1FBQ3BDLElBQUksR0FBRyxDQUFDLHVCQUF1QixFQUFFLENBQUM7WUFDaEMsTUFBTSxJQUFJLENBQUMsbUJBQW1CLENBQUMsR0FBRyxDQUFDLEVBQUUsRUFBRSxHQUFHLENBQUMsdUJBQXVCLENBQUMsZUFBZSxDQUFDLFdBQVcsQ0FBQyxDQUFDO1lBQ2hHLEdBQUcsQ0FBQyx1QkFBdUIsQ0FBQyxlQUFlLENBQUMsV0FBVyxHQUFHLEdBQUcsZUFBZSxHQUFHLG1CQUFtQixHQUFHLEdBQUcsQ0FBQyxFQUFFLEVBQUUsQ0FBQztRQUNoSCxDQUFDO1FBRUQsSUFBSSxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUFDLENBQUM7UUFDcEIsTUFBTSxJQUFJLENBQUMsVUFBVSxDQUFDLEdBQUcsQ0FBQyxDQUFDO1FBQzNCLE1BQU0sQ0FBQyxPQUFPLENBQUMsZ0JBQWdCLEdBQUcsQ0FBQyxJQUFJLEtBQUssR0FBRyxDQUFDLE9BQU8sR0FBRyxDQUFDLENBQUM7UUFDNUQsT0FBTyxJQUFJLENBQUMsV0FBVyxDQUFDLEdBQUcsQ0FBQyxDQUFDO0lBQy9CLENBQUM7SUFFRCxLQUFLLENBQUMsU0FBUyxDQUNiLEVBQVUsRUFDVixPQUlDO1FBRUQsTUFBTSxHQUFHLEdBQUcsSUFBSSxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLEVBQUUsRUFBRSxDQUFDLENBQUMsQ0FBQyxFQUFFLEtBQUssRUFBRSxDQUFDLENBQUM7UUFDL0MsSUFBSSxDQUFDLEdBQUc7WUFBRSxNQUFNLElBQUksS0FBSyxDQUFDLGtCQUFrQixFQUFFLEVBQUUsQ0FBQyxDQUFDO1FBRWxELElBQUksT0FBTyxDQUFDLElBQUksS0FBSyxTQUFTO1lBQUUsR0FBRyxDQUFDLElBQUksR0FBRyxPQUFPLENBQUMsSUFBSSxDQUFDO1FBQ3hELElBQUksT0FBTyxDQUFDLGVBQWUsS0FBSyxTQUFTLEVBQUUsQ0FBQztZQUMxQyxHQUFHLENBQUMsZUFBZSxHQUFHLHVCQUF1QixDQUFDLE9BQU8sQ0FBQyxlQUFlLEVBQUUscUJBQXFCLENBQUMsQ0FBQztRQUNoRyxDQUFDO1FBQ0QsSUFBSSxPQUFPLENBQUMsdUJBQXVCLEtBQUssU0FBUyxFQUFFLENBQUM7WUFDbEQsTUFBTSxRQUFRLEdBQUcsT0FBTyxDQUFDLHVCQUF1QixDQUFDLGVBQWUsQ0FBQyxXQUFXLENBQUM7WUFDN0UsSUFBSSxRQUFRLElBQUksUUFBUSxLQUFLLEtBQUssSUFBSSxDQUFDLFFBQVEsQ0FBQyxVQUFVLENBQUMsZUFBZSxDQUFDLEVBQUUsQ0FBQztnQkFDNUUsOENBQThDO2dCQUM5QyxNQUFNLElBQUksQ0FBQyxtQkFBbUIsQ0FBQyxHQUFHLENBQUMsRUFBRSxFQUFFLFFBQVEsQ0FBQyxDQUFDO2dCQUNqRCxPQUFPLENBQUMsdUJBQXVCLENBQUMsZUFBZSxDQUFDLFdBQVcsR0FBRyxHQUFHLGVBQWUsR0FBRyxtQkFBbUIsR0FBRyxHQUFHLENBQUMsRUFBRSxFQUFFLENBQUM7WUFDcEgsQ0FBQztpQkFBTSxDQUFDO2dCQUNOLGlFQUFpRTtnQkFDakUsTUFBTSxhQUFhLEdBQUcsR0FBRyxDQUFDLHVCQUF1QixFQUFFLGVBQWUsRUFBRSxXQUFXLENBQUM7Z0JBQ2hGLElBQUksYUFBYSxFQUFFLENBQUM7b0JBQ2xCLE9BQU8sQ0FBQyx1QkFBdUIsQ0FBQyxlQUFlLENBQUMsV0FBVyxHQUFHLGFBQWEsQ0FBQztnQkFDOUUsQ0FBQztZQUNILENBQUM7WUFDRCxHQUFHLENBQUMsdUJBQXVCLEdBQUcsT0FBTyxDQUFDLHVCQUF1QixDQUFDO1FBQ2hFLENBQUM7UUFDRCxHQUFHLENBQUMsU0FBUyxHQUFHLElBQUksQ0FBQyxHQUFHLEVBQUUsQ0FBQztRQUUzQixNQUFNLElBQUksQ0FBQyxVQUFVLENBQUMsR0FBRyxDQUFDLENBQUM7UUFFM0IsMEJBQTBCO1FBQzFCLElBQUksR0FBRyxDQUFDLE1BQU0sS0FBSyxRQUFRLEVBQUUsQ0FBQztZQUM1QixJQUFJLENBQUMsU0FBUyxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUMsQ0FBQztZQUN2QixJQUFJLENBQUMsVUFBVSxDQUFDLEdBQUcsQ0FBQyxDQUFDO1FBQ3ZCLENBQUM7UUFFRCxPQUFPLElBQUksQ0FBQyxXQUFXLENBQUMsR0FBRyxDQUFDLENBQUM7SUFDL0IsQ0FBQztJQUVELEtBQUssQ0FBQyxTQUFTLENBQUMsRUFBVTtRQUN4QixNQUFNLEdBQUcsR0FBRyxJQUFJLENBQUMsSUFBSSxDQUFDLFNBQVMsQ0FBQyxDQUFDLENBQUMsRUFBRSxFQUFFLENBQUMsQ0FBQyxDQUFDLEVBQUUsS0FBSyxFQUFFLENBQUMsQ0FBQztRQUNwRCxJQUFJLEdBQUcsS0FBSyxDQUFDLENBQUM7WUFBRSxNQUFNLElBQUksS0FBSyxDQUFDLGtCQUFrQixFQUFFLEVBQUUsQ0FBQyxDQUFDO1FBQ3hELElBQUksQ0FBQyxTQUFTLENBQUMsRUFBRSxDQUFDLENBQUM7UUFDbkIsSUFBSSxDQUFDLElBQUksQ0FBQyxNQUFNLENBQUMsR0FBRyxFQUFFLENBQUMsQ0FBQyxDQUFDO1FBQ3pCLE1BQU0sSUFBSSxDQUFDLGNBQWMsQ0FBQyxNQUFNLENBQUMsR0FBRyxXQUFXLEdBQUcsRUFBRSxPQUFPLENBQUMsQ0FBQztRQUM3RCxNQUFNLElBQUksQ0FBQyxXQUFXLENBQUMsWUFBWSxDQUFDLEdBQUcsbUJBQW1CLEdBQUcsRUFBRSxFQUFFLENBQUMsQ0FBQztRQUNuRSxNQUFNLENBQUMsSUFBSSxDQUFDLGdCQUFnQixFQUFFLEVBQUUsQ0FBQyxDQUFDO0lBQ3BDLENBQUM7SUFFRCxLQUFLLENBQUMsUUFBUSxDQUFDLEVBQVUsRUFBRSxNQUFlO1FBQ3hDLE1BQU0sR0FBRyxHQUFHLElBQUksQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLENBQUMsQ0FBQyxFQUFFLEVBQUUsQ0FBQyxDQUFDLENBQUMsRUFBRSxLQUFLLEVBQUUsQ0FBQyxDQUFDO1FBQy9DLElBQUksQ0FBQyxHQUFHO1lBQUUsTUFBTSxJQUFJLEtBQUssQ0FBQyxrQkFBa0IsRUFBRSxFQUFFLENBQUMsQ0FBQztRQUNsRCxHQUFHLENBQUMsTUFBTSxHQUFHLE1BQU0sQ0FBQyxDQUFDLENBQUMsUUFBUSxDQUFDLENBQUMsQ0FBQyxRQUFRLENBQUM7UUFDMUMsR0FBRyxDQUFDLFNBQVMsR0FBRyxJQUFJLENBQUMsR0FBRyxFQUFFLENBQUM7UUFDM0IsSUFBSSxNQUFNLEVBQUUsQ0FBQztZQUNYLElBQUksQ0FBQyxTQUFTLENBQUMsRUFBRSxDQUFDLENBQUM7UUFDckIsQ0FBQzthQUFNLENBQUM7WUFDTixJQUFJLENBQUMsVUFBVSxDQUFDLEdBQUcsQ0FBQyxDQUFDO1FBQ3ZCLENBQUM7UUFDRCxNQUFNLElBQUksQ0FBQyxVQUFVLENBQUMsR0FBRyxDQUFDLENBQUM7UUFDM0IsTUFBTSxDQUFDLElBQUksQ0FBQyxPQUFPLE1BQU0sQ0FBQyxDQUFDLENBQUMsUUFBUSxDQUFDLENBQUMsQ0FBQyxTQUFTLEtBQUssR0FBRyxDQUFDLElBQUksRUFBRSxDQUFDLENBQUM7UUFDakUsT0FBTyxJQUFJLENBQUMsV0FBVyxDQUFDLEdBQUcsQ0FBQyxDQUFDO0lBQy9CLENBQUM7SUFFRCwrRUFBK0U7SUFDL0UsWUFBWTtJQUNaLCtFQUErRTtJQUUvRSxLQUFLLENBQUMsVUFBVSxDQUFDLEtBQWEsRUFBRSxLQUFLLEdBQUcsS0FBSztRQUMzQyxJQUFJLElBQUksQ0FBQyxRQUFRLEVBQUUsQ0FBQztZQUNsQixNQUFNLENBQUMsSUFBSSxDQUFDLHdDQUF3QyxLQUFLLEVBQUUsQ0FBQyxDQUFDO1lBQzdELE9BQU87UUFDVCxDQUFDO1FBRUQsTUFBTSxnQkFBZ0IsR0FBRyxJQUFJLENBQUMsa0JBQWtCLENBQUMsS0FBSyxFQUFFLEtBQUssQ0FBQyxDQUFDO1FBQy9ELElBQUksQ0FBQyxtQkFBbUIsQ0FBQyxHQUFHLENBQUMsZ0JBQWdCLENBQUMsQ0FBQztRQUMvQyxJQUFJLENBQUM7WUFDSCxNQUFNLGdCQUFnQixDQUFDO1FBQ3pCLENBQUM7Z0JBQVMsQ0FBQztZQUNULElBQUksQ0FBQyxtQkFBbUIsQ0FBQyxNQUFNLENBQUMsZ0JBQWdCLENBQUMsQ0FBQztRQUNwRCxDQUFDO0lBQ0gsQ0FBQztJQUVPLEtBQUssQ0FBQyxrQkFBa0IsQ0FBQyxLQUFhLEVBQUUsS0FBSyxHQUFHLEtBQUs7UUFDM0QsTUFBTSxHQUFHLEdBQUcsSUFBSSxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLEVBQUUsRUFBRSxDQUFDLENBQUMsQ0FBQyxFQUFFLEtBQUssS0FBSyxDQUFDLENBQUM7UUFDbEQsSUFBSSxDQUFDLEdBQUc7WUFBRSxNQUFNLElBQUksS0FBSyxDQUFDLGtCQUFrQixLQUFLLEVBQUUsQ0FBQyxDQUFDO1FBRXJELElBQUksSUFBSSxDQUFDLFdBQVcsQ0FBQyxHQUFHLENBQUMsS0FBSyxDQUFDLEVBQUUsQ0FBQztZQUNoQyxNQUFNLENBQUMsSUFBSSxDQUFDLFFBQVEsR0FBRyxDQUFDLElBQUksZ0NBQWdDLENBQUMsQ0FBQztZQUM5RCxPQUFPO1FBQ1QsQ0FBQztRQUVELElBQUksQ0FBQyxLQUFLLElBQUksR0FBRyxDQUFDLE1BQU0sS0FBSyxRQUFRLEVBQUUsQ0FBQztZQUN0QyxNQUFNLENBQUMsSUFBSSxDQUFDLFFBQVEsR0FBRyxDQUFDLElBQUksMkJBQTJCLENBQUMsQ0FBQztZQUN6RCxPQUFPO1FBQ1QsQ0FBQztRQUVELElBQUksQ0FBQyxXQUFXLENBQUMsR0FBRyxDQUFDLEtBQUssQ0FBQyxDQUFDO1FBQzVCLE1BQU0sU0FBUyxHQUFHLElBQUksQ0FBQyxHQUFHLEVBQUUsQ0FBQztRQUU3QixJQUFJLENBQUM7WUFDSCxNQUFNLE1BQU0sR0FBRyxTQUFTLENBQUMsR0FBRyxDQUFDLE9BQU8sQ0FBQyxDQUFDO1lBQ3RDLE1BQU0sT0FBTyxHQUFtQjtnQkFDOUIsU0FBUyxFQUFFLEdBQUc7Z0JBQ2QsaUJBQWlCLEVBQUUsSUFBSSxDQUFDLGlCQUFpQjtnQkFDekMsY0FBYyxFQUFFLElBQUksQ0FBQyxjQUFjO2dCQUNuQyxXQUFXLEVBQUUsSUFBSSxDQUFDLFdBQVc7YUFDOUIsQ0FBQztZQUVGLE1BQU0sQ0FBQyxNQUFNLENBQUMsTUFBTSxFQUFFLGtCQUFrQixHQUFHLENBQUMsSUFBSSxFQUFFLEVBQUUsS0FBSyxDQUFDLENBQUM7WUFDM0QsTUFBTSxNQUFNLENBQUMsT0FBTyxDQUFDLE9BQU8sQ0FBQyxDQUFDO1lBRTlCLE1BQU0sV0FBVyxHQUFHLENBQUMsQ0FBQyxJQUFJLENBQUMsR0FBRyxFQUFFLEdBQUcsU0FBUyxDQUFDLEdBQUcsSUFBSSxDQUFDLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQyxDQUFDO1lBQ2pFLEdBQUcsQ0FBQyxTQUFTLEdBQUcsU0FBUyxDQUFDO1lBQzFCLEdBQUcsQ0FBQyxpQkFBaUIsR0FBRyxJQUFJLENBQUMsR0FBRyxFQUFFLEdBQUcsU0FBUyxDQUFDO1lBQy9DLEdBQUcsQ0FBQyxZQUFZLEdBQUcsU0FBUyxDQUFDO1lBQzdCLElBQUksR0FBRyxDQUFDLE1BQU0sS0FBSyxPQUFPO2dCQUFFLEdBQUcsQ0FBQyxNQUFNLEdBQUcsUUFBUSxDQUFDO1lBQ2xELE1BQU0sQ0FBQyxNQUFNLENBQUMsU0FBUyxFQUFFLFFBQVEsR0FBRyxDQUFDLElBQUksa0JBQWtCLFdBQVcsR0FBRyxFQUFFLEtBQUssQ0FBQyxDQUFDO1FBQ3BGLENBQUM7UUFBQyxPQUFPLEdBQUcsRUFBRSxDQUFDO1lBQ2IsR0FBRyxDQUFDLFNBQVMsR0FBRyxTQUFTLENBQUM7WUFDMUIsR0FBRyxDQUFDLGlCQUFpQixHQUFHLElBQUksQ0FBQyxHQUFHLEVBQUUsR0FBRyxTQUFTLENBQUM7WUFDL0MsR0FBRyxDQUFDLFlBQVksR0FBRyxNQUFNLENBQUMsR0FBRyxDQUFDLENBQUM7WUFDL0IsR0FBRyxDQUFDLE1BQU0sR0FBRyxPQUFPLENBQUM7WUFDckIsTUFBTSxDQUFDLE1BQU0sQ0FBQyxPQUFPLEVBQUUsUUFBUSxHQUFHLENBQUMsSUFBSSxhQUFhLEdBQUcsRUFBRSxFQUFFLEtBQUssQ0FBQyxDQUFDO1FBQ3BFLENBQUM7Z0JBQVMsQ0FBQztZQUNULEdBQUcsQ0FBQyxTQUFTLEdBQUcsSUFBSSxDQUFDLEdBQUcsRUFBRSxDQUFDO1lBQzNCLElBQUksQ0FBQyxXQUFXLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FBQyxDQUFDO1lBQy9CLE1BQU0sSUFBSSxDQUFDLFVBQVUsQ0FBQyxHQUFHLENBQUMsQ0FBQztRQUM3QixDQUFDO0lBQ0gsQ0FBQztJQUVELFlBQVksQ0FBQyxLQUFhO1FBQ3hCLE9BQU8sSUFBSSxDQUFDLFdBQVcsQ0FBQyxHQUFHLENBQUMsS0FBSyxDQUFDLENBQUM7SUFDckMsQ0FBQztJQUVELCtFQUErRTtJQUMvRSxVQUFVO0lBQ1YsK0VBQStFO0lBRXZFLEtBQUssQ0FBQyxRQUFRO1FBQ3BCLE1BQU0sSUFBSSxHQUFHLE1BQU0sSUFBSSxDQUFDLGNBQWMsQ0FBQyxJQUFJLENBQUMsV0FBVyxDQUFDLENBQUM7UUFDekQsSUFBSSxDQUFDLElBQUksR0FBRyxFQUFFLENBQUM7UUFDZixLQUFLLE1BQU0sR0FBRyxJQUFJLElBQUksRUFBRSxDQUFDO1lBQ3ZCLE1BQU0sR0FBRyxHQUFHLE1BQU0sSUFBSSxDQUFDLGNBQWMsQ0FBQyxPQUFPLENBQTZCLEdBQUcsQ0FBQyxDQUFDO1lBQy9FLElBQUksR0FBRyxFQUFFLENBQUM7Z0JBQ1IsSUFBSSxDQUFDO29CQUNILEdBQUcsQ0FBQyxlQUFlLEdBQUcsdUJBQXVCLENBQUMsR0FBRyxDQUFDLGVBQWUsRUFBRSxRQUFRLEdBQUcsQ0FBQyxJQUFJLG1CQUFtQixDQUFDLENBQUM7Z0JBQzFHLENBQUM7Z0JBQUMsT0FBTyxHQUFHLEVBQUUsQ0FBQztvQkFDYixHQUFHLENBQUMsTUFBTSxHQUFHLE9BQU8sQ0FBQztvQkFDckIsR0FBRyxDQUFDLFlBQVksR0FBRyxHQUFHLFlBQVksS0FBSyxDQUFDLENBQUMsQ0FBQyxHQUFHLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQyxNQUFNLENBQUMsR0FBRyxDQUFDLENBQUM7b0JBQ3BFLEdBQUcsQ0FBQyxTQUFTLEdBQUcsSUFBSSxDQUFDLEdBQUcsRUFBRSxDQUFDO29CQUMzQixNQUFNLElBQUksQ0FBQyxVQUFVLENBQUMsR0FBRyxDQUFDLENBQUM7Z0JBQzdCLENBQUM7Z0JBRUQsa0RBQWtEO2dCQUNsRCxJQUFJLEdBQUcsQ0FBQyx1QkFBdUIsRUFBRSxDQUFDO29CQUNoQyxNQUFNLEtBQUssR0FBRyxHQUFHLENBQUMsdUJBQXVCLENBQUMsZUFBZSxDQUFDLFdBQVcsQ0FBQztvQkFDdEUsSUFBSSxLQUFLLENBQUMsVUFBVSxDQUFDLGVBQWUsQ0FBQyxFQUFFLENBQUM7d0JBQ3RDLE1BQU0sVUFBVSxHQUFHLEtBQUssQ0FBQyxLQUFLLENBQUMsZUFBZSxDQUFDLE1BQU0sQ0FBQyxDQUFDO3dCQUN2RCxNQUFNLFNBQVMsR0FBRyxNQUFNLElBQUksQ0FBQyxXQUFXLENBQUMsU0FBUyxDQUFDLFVBQVUsQ0FBQyxDQUFDO3dCQUMvRCxJQUFJLFNBQVMsRUFBRSxDQUFDOzRCQUNkLEdBQUcsQ0FBQyx1QkFBdUIsQ0FBQyxlQUFlLENBQUMsV0FBVyxHQUFHLFNBQVMsQ0FBQzt3QkFDdEUsQ0FBQzs2QkFBTSxDQUFDOzRCQUNOLE1BQU0sQ0FBQyxJQUFJLENBQUMsOENBQThDLEdBQUcsQ0FBQyxFQUFFLGdCQUFnQixDQUFDLENBQUM7d0JBQ3BGLENBQUM7b0JBQ0gsQ0FBQztnQkFDSCxDQUFDO2dCQUNELElBQUksQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxDQUFDO1lBQ3RCLENBQUM7UUFDSCxDQUFDO0lBQ0gsQ0FBQztJQUVPLEtBQUssQ0FBQyxVQUFVLENBQUMsR0FBK0I7UUFDdEQsNERBQTREO1FBQzVELE1BQU0sTUFBTSxHQUFHLGVBQWUsQ0FBQyxHQUFHLENBQUMsQ0FBQztRQUNwQyxJQUFJLE1BQU0sQ0FBQyx1QkFBdUIsRUFBRSxDQUFDO1lBQ25DLE1BQU0sS0FBSyxHQUFHLE1BQU0sQ0FBQyx1QkFBdUIsQ0FBQyxlQUFlLENBQUMsV0FBVyxDQUFDO1lBQ3pFLElBQUksS0FBSyxJQUFJLENBQUMsS0FBSyxDQUFDLFVBQVUsQ0FBQyxlQUFlLENBQUMsRUFBRSxDQUFDO2dCQUNoRCxNQUFNLElBQUksQ0FBQyxtQkFBbUIsQ0FBQyxHQUFHLENBQUMsRUFBRSxFQUFFLEtBQUssQ0FBQyxDQUFDO2dCQUM5QyxNQUFNLENBQUMsdUJBQXVCLENBQUMsZUFBZSxDQUFDLFdBQVcsR0FBRyxHQUFHLGVBQWUsR0FBRyxtQkFBbUIsR0FBRyxHQUFHLENBQUMsRUFBRSxFQUFFLENBQUM7WUFDbkgsQ0FBQztRQUNILENBQUM7UUFDRCxNQUFNLElBQUksQ0FBQyxjQUFjLENBQUMsT0FBTyxDQUFDLEdBQUcsV0FBVyxHQUFHLEdBQUcsQ0FBQyxFQUFFLE9BQU8sRUFBRSxNQUFNLENBQUMsQ0FBQztJQUM1RSxDQUFDO0lBRU8sS0FBSyxDQUFDLG1CQUFtQixDQUFDLEtBQWEsRUFBRSxXQUFtQjtRQUNsRSxNQUFNLElBQUksQ0FBQyxXQUFXLENBQUMsU0FBUyxDQUFDLEdBQUcsbUJBQW1CLEdBQUcsS0FBSyxFQUFFLEVBQUUsV0FBVyxDQUFDLENBQUM7SUFDbEYsQ0FBQztJQUVPLFdBQVcsQ0FBQyxHQUErQjtRQUNqRCxNQUFNLE1BQU0sR0FBRyxlQUFlLENBQUMsR0FBRyxDQUFDLENBQUM7UUFDcEMsSUFBSSxNQUFNLENBQUMsdUJBQXVCLEVBQUUsQ0FBQztZQUNuQyxNQUFNLENBQUMsdUJBQXVCLENBQUMsZUFBZSxDQUFDLFdBQVcsR0FBRyxLQUFLLENBQUM7UUFDckUsQ0FBQztRQUNELE9BQU8sTUFBTSxDQUFDO0lBQ2hCLENBQUM7SUFFRCwrRUFBK0U7SUFDL0UsU0FBUztJQUNULCtFQUErRTtJQUV2RSxVQUFVLENBQUMsR0FBK0I7UUFDaEQsSUFBSSxJQUFJLENBQUMsTUFBTSxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsRUFBRSxDQUFDO1lBQUUsT0FBTztRQUNwQyxJQUFJLFVBQWtCLENBQUM7UUFDdkIsSUFBSSxDQUFDO1lBQ0gsVUFBVSxHQUFHLG1CQUFtQixDQUFDLEdBQUcsQ0FBQyxlQUFlLEVBQUUsUUFBUSxHQUFHLENBQUMsSUFBSSxtQkFBbUIsQ0FBQyxDQUFDO1FBQzdGLENBQUM7UUFBQyxPQUFPLEdBQUcsRUFBRSxDQUFDO1lBQ2IsTUFBTSxDQUFDLEtBQUssQ0FBQyw4QkFBOEIsR0FBRyxDQUFDLElBQUksTUFBTSxHQUFHLEVBQUUsQ0FBQyxDQUFDO1lBQ2hFLE9BQU87UUFDVCxDQUFDO1FBQ0QsTUFBTSxLQUFLLEdBQUcsV0FBVyxDQUFDLEdBQUcsRUFBRTtZQUM3QixJQUFJLENBQUMsVUFBVSxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUMsQ0FBQyxLQUFLLENBQUMsQ0FBQyxHQUFHLEVBQUUsRUFBRTtnQkFDcEMsTUFBTSxDQUFDLEtBQUssQ0FBQyw2Q0FBNkMsR0FBRyxDQUFDLElBQUksTUFBTSxHQUFHLEVBQUUsQ0FBQyxDQUFDO1lBQ2pGLENBQUMsQ0FBQyxDQUFDO1FBQ0wsQ0FBQyxFQUFFLFVBQVUsQ0FBQyxDQUFDO1FBQ2YsVUFBVSxDQUFDLEtBQUssQ0FBQyxDQUFDO1FBQ2xCLElBQUksQ0FBQyxNQUFNLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxFQUFFLEVBQUUsS0FBSyxDQUFDLENBQUM7UUFDL0IsTUFBTSxDQUFDLElBQUksQ0FBQywwQkFBMEIsR0FBRyxDQUFDLElBQUksWUFBWSxHQUFHLENBQUMsZUFBZSxNQUFNLENBQUMsQ0FBQztJQUN2RixDQUFDO0lBRU8sU0FBUyxDQUFDLEtBQWE7UUFDN0IsTUFBTSxLQUFLLEdBQUcsSUFBSSxDQUFDLE1BQU0sQ0FBQyxHQUFHLENBQUMsS0FBSyxDQUFDLENBQUM7UUFDckMsSUFBSSxLQUFLLEtBQUssU0FBUyxFQUFFLENBQUM7WUFDeEIsYUFBYSxDQUFDLEtBQUssQ0FBQyxDQUFDO1lBQ3JCLElBQUksQ0FBQyxNQUFNLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FBQyxDQUFDO1FBQzVCLENBQUM7SUFDSCxDQUFDO0NBQ0YifQ==

package/dist_ts/classes/jobrunners/autobookstackdocs.runner.d.ts

@@ -0,0 +1,29 @@
+import type * as interfaces from '../../../dist_ts_interfaces/index.js';
+import { BaseJobRunner, type IJobRunContext } from './base.jobrunner.js';
+/**
+ * Mapping:
+ *   Git org/group  →  BookStack Shelf
+ *   Git repository →  BookStack Book (named @group/repo, assigned to shelf)
+ *   readme.md      →  BookStack Page (named "readme.md for @group/repo")
+ *   docs/*.md      →  BookStack Pages (named "docs/file.md for @group/repo")
+ *
+ * Content hashes are persisted in storage to skip updates when content hasn't changed.
+ */
+export declare class AutoBookstackDocsRunner extends BaseJobRunner {
+    readonly jobType: interfaces.data.TJobType;
+    execute(context: IJobRunContext): Promise<void>;
+    /**
+     * Syncs a single git repository as a BookStack Book.
+     * Returns book ID + page stats, or null if skipped (no docs).
+     */
+    private syncRepoAsBook;
+    /**
+     * Removes stale BookStack shelves and orphaned books.
+     */
+    private reconcileDeletes;
+    /**
+     * Collects tags from package.json keywords + git repo topics, deduplicated.
+     */
+    private collectTags;
+    private findOrCreateBook;
+}