@bpinhosilva/agent-orchestrator 1.1.2 → 1.2.0

package/CHANGELOG.md

@@ -1,3 +1,24 @@
+# [1.2.0](https://github.com/bpinhosilva/agent-orchestrator/compare/v1.1.3...v1.2.0) (2026-05-17)
+
+
+### Bug Fixes
+
+* **tests:** move startServer tests to isolated spec using jest.mock ([8ede64a](https://github.com/bpinhosilva/agent-orchestrator/commit/8ede64a8e68175bbbe6ed3c076b682cd8412c25e))
+* **ui:** add missing test peers ([8c3d1a8](https://github.com/bpinhosilva/agent-orchestrator/commit/8c3d1a8b6941d5eb6e0ca38e7645c7b6b56b314a))
+
+
+### Features
+
+* **cli:** add runtime log rotation ([7ccd9f2](https://github.com/bpinhosilva/agent-orchestrator/commit/7ccd9f23a19ee8de0d5c000b178f2b4d9e990f08))
+
+## [1.1.3](https://github.com/bpinhosilva/agent-orchestrator/compare/v1.1.2...v1.1.3) (2026-05-02)
+
+
+### Bug Fixes
+
+* add UUID support and Postman collection generation ([a4bfd77](https://github.com/bpinhosilva/agent-orchestrator/commit/a4bfd7733d7a28ba3bc06748a6dce1ca27c5c466))
+* update cron job handling to replace inactive jobs for active tasks ([3d01155](https://github.com/bpinhosilva/agent-orchestrator/commit/3d01155f3f8f5be127e2bace79ede889502e4ec8))
+
 ## [1.1.2](https://github.com/bpinhosilva/agent-orchestrator/compare/v1.1.1...v1.1.2) (2026-04-21)
 
 

package/README.md

@@ -132,6 +132,9 @@ DB_LOGGING=false
 SERVE_STATIC_UI=true
 CHECK_PENDING_MIGRATIONS_ON_STARTUP=false
 LOG_LEVEL=error
+# Optional packaged-runtime / Docker file-rotation settings
+# LOG_ROTATION_MAX_SIZE_MB=10
+# LOG_ROTATION_MAX_FILES=4
 ```
 
 ## Database setup
@@ -215,6 +218,8 @@ agent-orchestrator rotate-secrets
 
 When running the packaged app or a production build with static UI enabled, the dashboard is served from `http://localhost:15789` by default.
 
+By default, the packaged CLI/runtime keeps writing to `${AGENT_ORCHESTRATOR_HOME}/server.log`, rotating the active file at **10 MB** and retaining **4** timestamped archives. You can persist different defaults with `agent-orchestrator setup --log-max-size-mb <mb> --log-max-files <count>` and override them for a single launch with `agent-orchestrator run --log-max-size-mb <mb> --log-max-files <count>`.
+
 ## Docker
 
 > For the full Docker guide, see [docs/DOCKER.md](docs/DOCKER.md).
@@ -227,6 +232,8 @@ The repository ships three Compose entrypoints:
 | `docker-compose.dev.yml` | Development stack with API hot reload and Vite UI dev server |
 | `docker-compose.test.yml` | Integration stack for migration, CLI/runtime, API, and UI checks |
 
+Docker keeps stdout/stderr as the primary log stream, so `docker compose logs` continues to work as before. If you also want rotated in-container log files, set `LOG_ROTATION_MAX_SIZE_MB` and `LOG_ROTATION_MAX_FILES`; the API container writes to the system temp directory by default (typically `/tmp/server.log`), or `${AGENT_ORCHESTRATOR_HOME}/server.log` if you set a writable runtime home.
+
 ### Production-style stack
 
 **Step 1: Create `.env`** — copy the example in the repo root and fill in your values:

package/dist/cli/commands/run.command.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerRunCommand = registerRunCommand;
 const utils_1 = require("../utils");
+const validators_1 = require("../setup/validators");
 const process_manager_1 = require("../process-manager");
 const migration_state_1 = require("../../database/migration-state");
 const constants_1 = require("../constants");
@@ -18,6 +19,8 @@ function registerRunCommand(program) {
         .command('run')
         .description('Start the orchestrator server in detached mode')
         .option('--log-level <level>', 'Set the log level (fatal, error, warn, log, debug, verbose)')
+        .option('--log-max-size-mb <mb>', 'One-off override: max log file size in MB before rotation', (v) => (0, validators_1.parsePositiveInt)(v) ?? Number.NaN)
+        .option('--log-max-files <count>', 'One-off override: max number of rotated log files to keep', (v) => (0, validators_1.parsePositiveInt)(v) ?? Number.NaN)
         .action(async (...args) => {
         try {
             const options = (0, utils_1.resolveActionOptions)(args);
@@ -26,6 +29,18 @@ function registerRunCommand(program) {
                     throw new Error(`Invalid log level "${options.logLevel}". Valid values: ${VALID_LOG_LEVELS.join(', ')}`);
                 }
             }
+            if (options.logMaxSizeMb !== undefined) {
+                if (!Number.isInteger(options.logMaxSizeMb) ||
+                    options.logMaxSizeMb <= 0) {
+                    throw new Error(`Invalid --log-max-size-mb "${options.logMaxSizeMb}". Must be a positive integer.`);
+                }
+            }
+            if (options.logMaxFiles !== undefined) {
+                if (!Number.isInteger(options.logMaxFiles) ||
+                    options.logMaxFiles <= 0) {
+                    throw new Error(`Invalid --log-max-files "${options.logMaxFiles}". Must be a positive integer.`);
+                }
+            }
             // Check for pending migrations before starting
             const { hasPending } = await (0, migration_state_1.checkPendingMigrations)({
                 assumePendingOnError: true,
@@ -44,7 +59,11 @@ function registerRunCommand(program) {
                 return;
             }
             console.log('Starting Agent Orchestrator in background...');
-            const { pid, host, port } = (0, process_manager_1.startServer)({ logLevel: options.logLevel });
+            const { pid, host, port } = (0, process_manager_1.startServer)({
+                logLevel: options.logLevel,
+                logMaxSizeMb: options.logMaxSizeMb,
+                logMaxFiles: options.logMaxFiles,
+            });
             const survived = await (0, utils_1.verifyServerStartup)(pid);
             if (!survived) {
                 process.exit(1);

package/dist/cli/commands/setup.command.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerSetupCommand = registerSetupCommand;
 const utils_1 = require("../utils");
 const index_1 = require("../setup/index");
+const validators_1 = require("../setup/validators");
 const migration_state_1 = require("../../database/migration-state");
 function registerSetupCommand(program) {
     program
@@ -27,10 +28,22 @@ function registerSetupCommand(program) {
         .option('--admin-email <email>', 'Admin user email for non-interactive setup')
         .option('--admin-password <password>', 'Admin user password for non-interactive setup')
         .option('--regenerate-jwt-secret', 'Generate a new JWT secret instead of preserving the existing one')
+        .option('--log-max-size-mb <mb>', 'Max log file size in MB before rotation (default: 10)', (v) => (0, validators_1.parsePositiveInt)(v) ?? Number.NaN)
+        .option('--log-max-files <count>', 'Max number of rotated log files to keep (default: 4)', (v) => (0, validators_1.parsePositiveInt)(v) ?? Number.NaN)
         .action(async (...args) => {
         const opts = (0, utils_1.resolveActionOptions)(args);
         console.log('Starting setup...');
         try {
+            if (opts.logMaxSizeMb !== undefined) {
+                if (!Number.isInteger(opts.logMaxSizeMb) || opts.logMaxSizeMb <= 0) {
+                    throw new Error(`Invalid --log-max-size-mb "${opts.logMaxSizeMb}". Must be a positive integer.`);
+                }
+            }
+            if (opts.logMaxFiles !== undefined) {
+                if (!Number.isInteger(opts.logMaxFiles) || opts.logMaxFiles <= 0) {
+                    throw new Error(`Invalid --log-max-files "${opts.logMaxFiles}". Must be a positive integer.`);
+                }
+            }
             await (0, index_1.handleSetup)(opts);
             if (opts.yes) {
                 const { hasPending, isEmpty } = await (0, migration_state_1.checkPendingMigrations)({

package/dist/cli/constants.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PROCESS_FILE = exports.ENV_PATH = exports.LOG_FILE = exports.PID_FILE = exports.PID_DIR = exports.UI_INDEX_FILE = exports.MAIN_FILE = exports.PACKAGE_JSON_PATH = exports.PACKAGE_ROOT = exports.SUPPORTED_PROVIDERS = void 0;
+exports.PROCESS_FILE = exports.ENV_PATH = exports.LOG_FILE = exports.PID_FILE = exports.PID_DIR = exports.PRELOAD_FILE = exports.UI_INDEX_FILE = exports.MAIN_FILE = exports.PACKAGE_JSON_PATH = exports.PACKAGE_ROOT = exports.SUPPORTED_PROVIDERS = void 0;
 const os = __importStar(require("os"));
 const path = __importStar(require("path"));
 var types_1 = require("./types");
@@ -42,6 +42,7 @@ exports.PACKAGE_ROOT = path.resolve(__dirname, '..', '..');
 exports.PACKAGE_JSON_PATH = path.join(exports.PACKAGE_ROOT, 'package.json');
 exports.MAIN_FILE = path.join(exports.PACKAGE_ROOT, 'dist/main.js');
 exports.UI_INDEX_FILE = path.join(exports.PACKAGE_ROOT, 'dist/ui/index.html');
+exports.PRELOAD_FILE = path.join(exports.PACKAGE_ROOT, 'dist/cli/preload.js');
 // These are set at process start before any imports, so the env var is always present
 exports.PID_DIR = process.env.AGENT_ORCHESTRATOR_HOME ??
     path.join(os.homedir(), '.agent-orchestrator');

package/dist/cli/env.js

@@ -139,6 +139,8 @@ function buildEnvContent(currentEnv, basicConfig, databaseUrl, geminiKey, anthro
         'ANTHROPIC_API_KEY',
         'OLLAMA_HOST',
         'OLLAMA_API_KEY',
+        'LOG_ROTATION_MAX_SIZE_MB',
+        'LOG_ROTATION_MAX_FILES',
         'JWT_SECRET',
         'JWT_REFRESH_SECRET',
     ];

package/dist/cli/preload.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const runtime_paths_1 = require("../config/runtime-paths");
+const runtime_logger_1 = require("../config/runtime-logger");
+(0, runtime_paths_1.loadRuntimeEnv)();
+try {
+    (0, runtime_logger_1.initRuntimeLogger)();
+}
+catch (err) {
+    (0, runtime_logger_1.persistRuntimeLoggerInitFailure)(String(err));
+    process.exit(1);
+}

package/dist/cli/process-manager.js

@@ -231,13 +231,16 @@ function getChildEnvironment(pidDir = constants_1.PID_DIR) {
     }
     return childEnv;
 }
-function assertBuildExists(mainFile = constants_1.MAIN_FILE, uiIndexFile = constants_1.UI_INDEX_FILE, fsDep = realFs) {
+function assertBuildExists(mainFile = constants_1.MAIN_FILE, uiIndexFile = constants_1.UI_INDEX_FILE, preloadFile = constants_1.PRELOAD_FILE, fsDep = realFs) {
     if (!fsDep.existsSync(mainFile)) {
         throw new Error(`Missing backend build at ${mainFile}. Run "npm run build:all" before using the CLI runtime.`);
     }
     if (!fsDep.existsSync(uiIndexFile)) {
         throw new Error(`Missing UI build at ${uiIndexFile}. Run "npm run build:all" so the packaged CLI starts the full application.`);
     }
+    if (!fsDep.existsSync(preloadFile)) {
+        throw new Error(`Missing CLI preload build at ${preloadFile}. Run "npm run build:all" before using the CLI runtime.`);
+    }
 }
 function isManagedProcess(pid, expected, fsDep = realFs) {
     if (os.platform() === 'win32') {
@@ -359,7 +362,8 @@ async function stopManagedProcessById(pid, cwd, mainPath, fsDep = realFs) {
  * that no instance is already running before calling this.
  */
 function startServer(options = {}, mainFile = constants_1.MAIN_FILE, packageRoot = constants_1.PACKAGE_ROOT, logFile = constants_1.LOG_FILE, pidDir = constants_1.PID_DIR, envPath = constants_1.ENV_PATH) {
-    assertBuildExists(mainFile, constants_1.UI_INDEX_FILE);
+    const preloadFile = path.join(packageRoot, 'dist/cli/preload.js');
+    assertBuildExists(mainFile, constants_1.UI_INDEX_FILE, preloadFile);
     if (!fs.existsSync(pidDir)) {
         fs.mkdirSync(pidDir, { recursive: true, mode: 0o700 });
     }
@@ -367,32 +371,32 @@ function startServer(options = {}, mainFile = constants_1.MAIN_FILE, packageRoot
     if (options.logLevel) {
         env.LOG_LEVEL = options.logLevel;
     }
-    const logFd = fs.openSync(logFile, 'a');
-    try {
-        const child = (0, child_process_1.spawn)('node', [mainFile], {
-            detached: true,
-            stdio: ['ignore', logFd, logFd],
-            cwd: packageRoot,
-            env,
-        });
-        const pid = child.pid;
-        if (!pid)
-            throw new Error('Failed to determine spawned process PID.');
-        const port = getConfiguredPort(envPath);
-        const host = getConfiguredHost(envPath);
-        persistProcessMetadata({
-            pid,
-            cwd: packageRoot,
-            mainPath: mainFile,
-            host,
-            port,
-            logFile,
-            startedAt: new Date().toISOString(),
-        });
-        child.unref();
-        return { pid, host, port };
-    }
-    finally {
-        fs.closeSync(logFd);
+    if (options.logMaxSizeMb !== undefined) {
+        env.LOG_ROTATION_MAX_SIZE_MB = String(options.logMaxSizeMb);
+    }
+    if (options.logMaxFiles !== undefined) {
+        env.LOG_ROTATION_MAX_FILES = String(options.logMaxFiles);
     }
+    const child = (0, child_process_1.spawn)('node', ['--require', preloadFile, mainFile], {
+        detached: true,
+        stdio: ['ignore', 'ignore', 'ignore'],
+        cwd: packageRoot,
+        env,
+    });
+    const pid = child.pid;
+    if (!pid)
+        throw new Error('Failed to determine spawned process PID.');
+    const port = getConfiguredPort(envPath);
+    const host = getConfiguredHost(envPath);
+    persistProcessMetadata({
+        pid,
+        cwd: packageRoot,
+        mainPath: mainFile,
+        host,
+        port,
+        logFile,
+        startedAt: new Date().toISOString(),
+    });
+    child.unref();
+    return { pid, host, port };
 }

package/dist/cli/setup/index.js

@@ -40,6 +40,8 @@ const env_1 = require("../env");
 const host_defaults_1 = require("../../config/host.defaults");
 const admin_1 = require("./admin");
 const prompts_1 = require("./prompts");
+const validators_1 = require("./validators");
+const LOG_ROTATION_DEFAULTS = { maxSizeMb: 10, maxFiles: 4 };
 const SENSITIVE_FLAG_ENV_VARS = [
     ['geminiKey', 'GEMINI_API_KEY', '--gemini-key'],
     ['anthropicKey', 'ANTHROPIC_API_KEY', '--anthropic-key'],
@@ -56,8 +58,28 @@ async function handleSetup(opts, fsDep, prompter, dsFactory) {
         }
     }
     const existingEnv = (0, env_1.readEnvFile)(constants_1.ENV_PATH, fsDep);
+    if (opts.logMaxSizeMb !== undefined &&
+        (!Number.isInteger(opts.logMaxSizeMb) || opts.logMaxSizeMb <= 0)) {
+        throw new Error('Invalid logMaxSizeMb. Expected a positive integer.');
+    }
+    if (opts.logMaxFiles !== undefined &&
+        (!Number.isInteger(opts.logMaxFiles) || opts.logMaxFiles <= 0)) {
+        throw new Error('Invalid logMaxFiles. Expected a positive integer.');
+    }
     // Resolve a sensitive value: CLI flag > process env var > existing .env value
     const resolveSecret = (flagValue, envVar, existingKey) => flagValue ?? process.env[envVar] ?? existingEnv[existingKey] ?? '';
+    // Resolve a positive-integer config value: flag > existing env > default
+    const resolvePositiveInt = (flagValue, existingKey, defaultValue) => {
+        if (flagValue !== undefined &&
+            Number.isInteger(flagValue) &&
+            flagValue > 0) {
+            return flagValue;
+        }
+        const fromEnv = (0, validators_1.parsePositiveInt)(existingEnv[existingKey]);
+        return fromEnv ?? defaultValue;
+    };
+    const logMaxSizeMb = resolvePositiveInt(opts.logMaxSizeMb, 'LOG_ROTATION_MAX_SIZE_MB', LOG_ROTATION_DEFAULTS.maxSizeMb);
+    const logMaxFiles = resolvePositiveInt(opts.logMaxFiles, 'LOG_ROTATION_MAX_FILES', LOG_ROTATION_DEFAULTS.maxFiles);
     let answers;
     if (opts.yes) {
         const jwtSecret = opts.regenerateJwtSecret || !existingEnv.JWT_SECRET
@@ -87,6 +109,8 @@ async function handleSetup(opts, fsDep, prompter, dsFactory) {
     const envContent = (0, env_1.buildEnvContent)({
         ...existingEnv,
         SCHEDULER_ENABLED: answers.schedulerEnabled ? 'true' : 'false',
+        LOG_ROTATION_MAX_SIZE_MB: String(logMaxSizeMb),
+        LOG_ROTATION_MAX_FILES: String(logMaxFiles),
     }, {
         host: answers.host,
         port: answers.port,

package/dist/cli/setup/validators.js

@@ -4,6 +4,7 @@ exports.validatePort = validatePort;
 exports.isValidPostgresConnectionString = isValidPostgresConnectionString;
 exports.collectProviders = collectProviders;
 exports.normalizeProviders = normalizeProviders;
+exports.parsePositiveInt = parsePositiveInt;
 const types_1 = require("../types");
 function validatePort(port) {
     const parsedPort = Number(port);
@@ -48,3 +49,16 @@ function normalizeProviders(values = []) {
         throw new Error(errors.join('\n'));
     return result;
 }
+/**
+ * Parses a string as a positive integer.
+ * Returns the integer when the value is a strict positive integer string,
+ * or `undefined` when the input is `undefined`, a decimal, or non-numeric.
+ */
+function parsePositiveInt(value) {
+    if (value === undefined)
+        return undefined;
+    if (!/^[1-9]\d*$/.test(value)) {
+        return undefined;
+    }
+    return Number(value);
+}

package/dist/common/postman/postman-conversion.js

@@ -0,0 +1,57 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertOpenApiToPostman = convertOpenApiToPostman;
+exports.writePostmanCollection = writePostmanCollection;
+const fs = __importStar(require("fs"));
+function convertOpenApiToPostman(openApiJson, convert) {
+    return new Promise((resolve, reject) => {
+        convert({ type: 'string', data: openApiJson }, { schemaFaker: true }, (error, result) => {
+            if (error) {
+                reject(error instanceof Error ? error : new Error('Converter failed'));
+                return;
+            }
+            if (!result?.result) {
+                reject(new Error(result?.reason ??
+                    'Could not convert OpenAPI document to Postman collection'));
+                return;
+            }
+            resolve(result.output?.[0]?.data ?? {});
+        });
+    });
+}
+function writePostmanCollection(outputPath, collection) {
+    fs.writeFileSync(outputPath, JSON.stringify(collection, null, 2));
+}

package/dist/config/env.validation.js

@@ -53,4 +53,10 @@ exports.envValidationSchema = Joi.object({
         .default('development'),
     ALLOWED_ORIGINS: Joi.string().optional(),
     SCHEDULER_ENABLED: Joi.boolean().default(true),
+    LOG_ROTATION_MAX_SIZE_MB: Joi.string()
+        .pattern(/^[1-9]\d*$/)
+        .optional(),
+    LOG_ROTATION_MAX_FILES: Joi.string()
+        .pattern(/^[1-9]\d*$/)
+        .optional(),
 });

package/dist/config/runtime-logger.js

@@ -0,0 +1,214 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RotatingFileLogger = exports.DEFAULT_MAX_FILES = exports.DEFAULT_MAX_SIZE_MB = exports.LOG_FILENAME = void 0;
+exports.shouldEnableFileLogging = shouldEnableFileLogging;
+exports.getLogRotationOptions = getLogRotationOptions;
+exports.persistRuntimeLoggerInitFailure = persistRuntimeLoggerInitFailure;
+exports.initRuntimeLogger = initRuntimeLogger;
+exports.teardownRuntimeLogger = teardownRuntimeLogger;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+exports.LOG_FILENAME = 'server.log';
+exports.DEFAULT_MAX_SIZE_MB = 10;
+exports.DEFAULT_MAX_FILES = 4;
+const ARCHIVE_PREFIX = 'server-';
+function parseStrictPositiveInt(value, envName) {
+    if (!/^[1-9]\d*$/.test(value)) {
+        throw new Error(`Invalid ${envName}: "${value}". Must be a plain positive integer (e.g. 10).`);
+    }
+    const n = Number(value);
+    if (!Number.isInteger(n) || n < 1) {
+        throw new Error(`Invalid ${envName}: "${value}". Must be a positive integer >= 1.`);
+    }
+    return n;
+}
+function shouldEnableFileLogging() {
+    if (process.env.AGENT_ORCHESTRATOR_HOME)
+        return true;
+    if (process.env.LOG_ROTATION_MAX_SIZE_MB !== undefined ||
+        process.env.LOG_ROTATION_MAX_FILES !== undefined)
+        return true;
+    return false;
+}
+function getLogRotationOptions() {
+    if (!shouldEnableFileLogging())
+        return null;
+    const logDir = process.env.AGENT_ORCHESTRATOR_HOME || os.tmpdir();
+    const maxSizeMb = process.env.LOG_ROTATION_MAX_SIZE_MB !== undefined
+        ? parseStrictPositiveInt(process.env.LOG_ROTATION_MAX_SIZE_MB, 'LOG_ROTATION_MAX_SIZE_MB')
+        : exports.DEFAULT_MAX_SIZE_MB;
+    const maxFiles = process.env.LOG_ROTATION_MAX_FILES !== undefined
+        ? parseStrictPositiveInt(process.env.LOG_ROTATION_MAX_FILES, 'LOG_ROTATION_MAX_FILES')
+        : exports.DEFAULT_MAX_FILES;
+    return { logDir, maxSizeMb, maxFiles };
+}
+function persistRuntimeLoggerInitFailure(message, fsDep = fs) {
+    if (!shouldEnableFileLogging()) {
+        return null;
+    }
+    const logDir = process.env.AGENT_ORCHESTRATOR_HOME || os.tmpdir();
+    fsDep.mkdirSync(logDir, { recursive: true, mode: 0o700 });
+    const logFilePath = path.join(logDir, exports.LOG_FILENAME);
+    fsDep.appendFileSync(logFilePath, `[preload] Runtime logger initialization failed: ${message}\n`);
+    return logFilePath;
+}
+class RotatingFileLogger {
+    logFile;
+    maxSizeBytes;
+    maxFiles;
+    fsDep;
+    getNow;
+    originalStdoutWrite = null;
+    originalStderrWrite = null;
+    active = false;
+    constructor(options) {
+        this.logFile = path.join(options.logDir, exports.LOG_FILENAME);
+        this.maxSizeBytes = options.maxSizeMb * 1024 * 1024;
+        this.maxFiles = options.maxFiles;
+        this.fsDep = options.fsDep ?? fs;
+        this.getNow = options.getNow ?? (() => new Date());
+    }
+    get logFilePath() {
+        return this.logFile;
+    }
+    init() {
+        if (this.active)
+            return;
+        const dir = path.dirname(this.logFile);
+        if (!this.fsDep.existsSync(dir)) {
+            this.fsDep.mkdirSync(dir, { recursive: true, mode: 0o700 });
+        }
+        this.originalStdoutWrite = process.stdout.write;
+        this.originalStderrWrite = process.stderr.write;
+        process.stdout.write = makeTeePatch(this.originalStdoutWrite, (chunk) => this.writeToFile(chunk));
+        process.stderr.write = makeTeePatch(this.originalStderrWrite, (chunk) => this.writeToFile(chunk));
+        this.active = true;
+    }
+    writeToFile(chunk) {
+        try {
+            const incomingBytes = typeof chunk === 'string' ? Buffer.byteLength(chunk) : chunk.byteLength;
+            this.rotateIfNeeded(incomingBytes);
+            this.fsDep.appendFileSync(this.logFile, chunk);
+        }
+        catch {
+        }
+    }
+    rotateIfNeeded(incomingBytes = 0) {
+        try {
+            if (!this.fsDep.existsSync(this.logFile))
+                return;
+            const stat = this.fsDep.statSync(this.logFile);
+            if (stat.size + incomingBytes < this.maxSizeBytes)
+                return;
+        }
+        catch {
+            return;
+        }
+        const ts = this.getNow().toISOString().replace(/[:.]/g, '-');
+        const dir = path.dirname(this.logFile);
+        const rotated = path.join(dir, `${ARCHIVE_PREFIX}${ts}.log`);
+        try {
+            this.fsDep.renameSync(this.logFile, rotated);
+        }
+        catch {
+            return;
+        }
+        this.pruneOldArchives();
+    }
+    pruneOldArchives() {
+        const dir = path.dirname(this.logFile);
+        let archives;
+        try {
+            archives = this.fsDep
+                .readdirSync(dir)
+                .filter((f) => f.startsWith(ARCHIVE_PREFIX) &&
+                f.endsWith('.log') &&
+                f !== exports.LOG_FILENAME)
+                .sort();
+        }
+        catch {
+            return;
+        }
+        while (archives.length > this.maxFiles) {
+            const oldest = archives.shift();
+            try {
+                this.fsDep.unlinkSync(path.join(dir, oldest));
+            }
+            catch {
+            }
+        }
+    }
+    teardown() {
+        if (!this.active)
+            return;
+        if (this.originalStdoutWrite) {
+            process.stdout.write = this.originalStdoutWrite;
+        }
+        if (this.originalStderrWrite) {
+            process.stderr.write = this.originalStderrWrite;
+        }
+        this.active = false;
+    }
+}
+exports.RotatingFileLogger = RotatingFileLogger;
+function makeTeePatch(original, writeToFile) {
+    const orig = original;
+    return function (chunk, encodingOrCb, cb) {
+        writeToFile(chunk);
+        if (typeof encodingOrCb === 'function') {
+            return orig.call(this, chunk, encodingOrCb);
+        }
+        return orig.call(this, chunk, encodingOrCb, cb);
+    };
+}
+let activeLogger = null;
+function initRuntimeLogger() {
+    if (activeLogger)
+        return activeLogger;
+    const opts = getLogRotationOptions();
+    if (!opts)
+        return null;
+    activeLogger = new RotatingFileLogger(opts);
+    activeLogger.init();
+    return activeLogger;
+}
+function teardownRuntimeLogger() {
+    if (activeLogger) {
+        activeLogger.teardown();
+        activeLogger = null;
+    }
+}

package/dist/main.js

@@ -15,6 +15,7 @@ const migration_state_1 = require("./database/migration-state");
 const port_defaults_1 = require("./config/port.defaults");
 const host_defaults_1 = require("./config/host.defaults");
 const runtime_paths_1 = require("./config/runtime-paths");
+const runtime_logger_1 = require("./config/runtime-logger");
 const logger = new common_1.Logger('Bootstrap');
 (0, runtime_paths_1.loadRuntimeEnv)();
 async function ensureDatabaseIsReadyForStartup() {
@@ -38,6 +39,13 @@ async function ensureDatabaseIsReadyForStartup() {
     ].join(' '));
 }
 async function bootstrap() {
+    try {
+        (0, runtime_logger_1.initRuntimeLogger)();
+    }
+    catch (err) {
+        (0, runtime_logger_1.persistRuntimeLoggerInitFailure)(String(err));
+        throw err;
+    }
     await ensureDatabaseIsReadyForStartup();
     const nodeEnv = process.env.NODE_ENV || 'development';
     const defaultLevels = nodeEnv === 'production'

package/dist/tasks/recurrent-task-scheduler.service.js

@@ -103,11 +103,10 @@ let RecurrentTaskSchedulerService = RecurrentTaskSchedulerService_1 = class Recu
             if (name.startsWith('recurrent-task-')) {
                 const taskId = name.replace('recurrent-task-', '');
                 const task = activeTasks.find((t) => t.id === taskId);
-                const jobWithCron = job;
+                const jobIsInactive = !job.isActive;
                 if (!activeTaskIds.has(taskId) ||
-                    (task &&
-                        jobWithCron.cronTime &&
-                        jobWithCron.cronTime.source !== task.cronExpression)) {
+                    jobIsInactive ||
+                    (task && job.cronTime && job.cronTime.source !== task.cronExpression)) {
                     void job.stop();
                     this.schedulerRegistry.deleteCronJob(name);
                 }