apcore-js 0.19.0 → 0.20.0

package/dist/sys-modules/control.js

@@ -1,8 +1,12 @@
 /**
  * System control modules -- runtime config update and hot-reload.
  */
-import { ConfigError, InvalidInputError, ModuleNotFoundError, ReloadFailedError } from '../errors.js';
+import * as fs from 'node:fs';
+import * as yaml from 'js-yaml';
+import { ConfigError, InvalidInputError, ModuleNotFoundError, ReloadFailedError, ModuleReloadConflictError } from '../errors.js';
 import { createEvent } from '../events/emitter.js';
+import { buildAuditEntry, extractAuditIdentity } from './audit.js';
+import { matchPattern } from '../utils/pattern.js';
 const RESTRICTED_KEYS = new Set(['sys_modules.enabled']);
 const SENSITIVE_SEGMENTS = ['token', 'secret', 'key', 'password', 'auth', 'credential'];
 /** Match exact segments or underscore-compound segments (api_key, auth_token). */
@@ -33,12 +37,19 @@ export class UpdateConfigModule {
     };
     _config;
     _emitter;
-    constructor(config, eventEmitter) {
+    _auditStore;
+    _overridesPath;
+    _overridesStore;
+    constructor(config, eventEmitter, options) {
         this._config = config;
         this._emitter = eventEmitter;
+        this._auditStore = options?.auditStore ?? null;
+        this._overridesPath = options?.overridesPath ?? null;
+        this._overridesStore = options?.overridesStore ?? null;
     }
-    execute(inputs, _context) {
+    execute(inputs, context) {
         const { key, value, reason } = this._validateInputs(inputs);
+        const ctx = context;
         if (RESTRICTED_KEYS.has(key)) {
             throw new ConfigError(`Configuration key '${key}' cannot be changed at runtime`);
         }
@@ -47,12 +58,84 @@ export class UpdateConfigModule {
         const isSensitive = isSensitiveKey(key);
         const safeOld = isSensitive ? '***' : oldValue;
         const safeNew = isSensitive ? '***' : value;
-        this._emitter.emit(createEvent('apcore.config.updated', 'system.control.update_config', 'info', {
-            key, old_value: safeOld, new_value: safeNew,
-        }));
+        if (this._overridesPath !== null) {
+            this._persistOverride(key, value);
+        }
+        if (this._overridesStore !== null) {
+            this._persistOverrideToStore(key, value);
+        }
+        const entry = buildAuditEntry('update_config', 'system.control.update_config', ctx, { before: safeOld, after: safeNew });
+        if (this._auditStore !== null) {
+            this._auditStore.append(entry);
+        }
+        else {
+            console.warn(`[apcore:audit] update_config key=${key} actor=${entry.actorId} reason=${reason}`);
+        }
+        // Issue #45.2: Audit events carry requester identity so subscribers can
+        // attribute the change. caller_id defaults to "@external" when absent.
+        // When identity is null the field is OMITTED from the payload (not
+        // emitted as null).
+        const { caller_id, identity } = extractAuditIdentity(ctx);
+        const updatedPayload = {
+            key, old_value: safeOld, new_value: safeNew, caller_id,
+        };
+        if (identity !== null)
+            updatedPayload['identity'] = identity;
+        this._emitter.emit(createEvent('apcore.config.updated', 'system.control.update_config', 'info', updatedPayload));
         console.warn(`[apcore:control] Config updated: key=${key} old_value=${safeOld} new_value=${safeNew} reason=${reason}`);
         return { success: true, key, old_value: safeOld, new_value: safeNew };
     }
+    _persistOverrideToStore(key, value) {
+        try {
+            const store = this._overridesStore;
+            const loaded = store.load();
+            if (loaded !== null && typeof loaded.then === 'function') {
+                // Async store — fire-and-forget the read-modify-write so execute() stays sync.
+                loaded
+                    .then((existing) => {
+                    existing[key] = value;
+                    return store.save(existing);
+                })
+                    .catch((err) => {
+                    console.warn(`[apcore:control] Failed to persist override for key '${key}' via OverridesStore:`, err);
+                });
+                return;
+            }
+            const existing = loaded;
+            existing[key] = value;
+            const saveResult = store.save(existing);
+            if (saveResult !== undefined && typeof saveResult.then === 'function') {
+                saveResult.catch((err) => {
+                    console.warn(`[apcore:control] Failed to persist override for key '${key}' via OverridesStore:`, err);
+                });
+            }
+        }
+        catch (err) {
+            console.warn(`[apcore:control] Failed to persist override for key '${key}' via OverridesStore:`, err);
+        }
+    }
+    _persistOverride(key, value) {
+        let overrides = {};
+        if (fs.existsSync(this._overridesPath)) {
+            try {
+                const content = fs.readFileSync(this._overridesPath, 'utf-8');
+                const parsed = yaml.load(content);
+                if (typeof parsed === 'object' && parsed !== null) {
+                    overrides = parsed;
+                }
+            }
+            catch {
+                // Start fresh if parse fails
+            }
+        }
+        overrides[key] = value;
+        try {
+            fs.writeFileSync(this._overridesPath, yaml.dump(overrides), 'utf-8');
+        }
+        catch (err) {
+            console.warn(`[apcore:control] Failed to persist override for key '${key}':`, err);
+        }
+    }
     _validateInputs(inputs) {
         const key = inputs['key'];
         if (typeof key !== 'string' || !key) {
@@ -73,37 +156,48 @@ export class ReloadModule {
     inputSchema = {
         type: 'object',
         properties: {
-            module_id: { type: 'string', description: 'ID of the module to reload' },
+            module_id: { type: 'string', description: 'ID of the module to reload (mutually exclusive with path_filter)' },
+            path_filter: { type: 'string', description: 'Glob pattern to bulk-reload matching modules (mutually exclusive with module_id)' },
+            reload_dependents: { type: 'boolean', description: 'When true, also reload modules that depend on matched modules' },
             reason: { type: 'string', description: 'Audit reason for the reload' },
         },
-        required: ['module_id', 'reason'],
+        required: ['reason'],
     };
     outputSchema = {
         type: 'object',
         properties: {
             success: { type: 'boolean', description: 'Whether the reload succeeded' },
-            module_id: { type: 'string', description: 'ID of the reloaded module' },
+            module_id: { type: 'string', description: 'ID of the reloaded module (single-module mode)' },
+            reloaded_modules: { type: 'array', description: 'IDs of reloaded modules (path_filter mode)' },
             previous_version: { type: 'string', description: 'Version before reload' },
             new_version: { type: 'string', description: 'Version after reload' },
             reload_duration_ms: { type: 'number', description: 'Reload duration in milliseconds' },
         },
-        required: ['success', 'module_id', 'previous_version', 'new_version', 'reload_duration_ms'],
+        required: ['success'],
     };
     _registry;
     _emitter;
-    constructor(registry, eventEmitter) {
+    _auditStore;
+    constructor(registry, eventEmitter, auditStore) {
         this._registry = registry;
         this._emitter = eventEmitter;
+        this._auditStore = auditStore ?? null;
     }
-    async execute(inputs, _context) {
-        const { moduleId, reason } = this._validateInputs(inputs);
+    async execute(inputs, context) {
+        const { moduleId, pathFilter, reason } = this._validateInputs(inputs);
+        const ctx = context;
+        if (pathFilter !== undefined) {
+            return this._reloadWithPathFilter(pathFilter, reason, ctx);
+        }
+        return this._reloadSingleModule(moduleId, reason, ctx);
+    }
+    async _reloadSingleModule(moduleId, reason, ctx) {
         const existing = this._registry.get(moduleId);
         if (existing === null) {
             throw new ModuleNotFoundError(moduleId);
         }
         const existingObj = existing;
         const previousVersion = String(existingObj['version'] ?? '1.0.0');
-        // Capture suspend state from old module (if onSuspend is defined)
         let suspendedState = null;
         if (typeof existingObj['onSuspend'] === 'function') {
             try {
@@ -114,25 +208,19 @@ export class ReloadModule {
             }
         }
         const start = performance.now();
-        // Use safeUnregister so in-flight executions finish (or time out) before
-        // the module disappears. Bare unregister() lets a caller land between
-        // unregister and re-discovery and see ModuleNotFoundError.
         await this._registry.safeUnregister(moduleId);
         try {
             await this._registry.discover();
         }
         catch (err) {
-            // Restore original module on discover failure
             this._registry.registerInternal(moduleId, existing);
             throw new ReloadFailedError(moduleId, String(err));
         }
         const reloaded = this._registry.get(moduleId);
         if (reloaded === null) {
-            // Restore original module if not found after re-discovery
             this._registry.registerInternal(moduleId, existing);
             throw new ReloadFailedError(moduleId, `Module '${moduleId}' was not found after re-discovery`);
         }
-        // Resume state on new module (if state was captured and onResume is defined)
         const reloadedObj = reloaded;
         if (suspendedState !== null && typeof reloadedObj['onResume'] === 'function') {
             try {
@@ -144,10 +232,24 @@ export class ReloadModule {
         }
         const elapsedMs = performance.now() - start;
         const newVersion = String(reloadedObj['version'] ?? '1.0.0');
-        this._emitter.emit(createEvent('apcore.module.reloaded', moduleId, 'info', {
+        const entry = buildAuditEntry('reload_module', moduleId, ctx, { before: previousVersion, after: newVersion });
+        if (this._auditStore !== null) {
+            this._auditStore.append(entry);
+        }
+        else {
+            console.warn(`[apcore:audit] reload_module ${moduleId} actor=${entry.actorId} reason=${reason}`);
+        }
+        // Issue #45.2: include requester identity in reload audit event payload.
+        const { caller_id, identity } = extractAuditIdentity(ctx);
+        const reloadedPayload = {
+            module_id: moduleId,
             previous_version: previousVersion,
             new_version: newVersion,
-        }));
+            caller_id,
+        };
+        if (identity !== null)
+            reloadedPayload['identity'] = identity;
+        this._emitter.emit(createEvent('apcore.module.reloaded', moduleId, 'info', reloadedPayload));
         console.warn(`[apcore:control] Module reloaded: module_id=${moduleId} previous_version=${previousVersion} new_version=${newVersion} reason=${reason}`);
         return {
             success: true,
@@ -157,16 +259,85 @@ export class ReloadModule {
             reload_duration_ms: elapsedMs,
         };
     }
+    async _reloadWithPathFilter(pathFilter, reason, ctx) {
+        const allIds = this._registry.list();
+        const matchingIds = allIds.filter((id) => matchPattern(pathFilter, id)).sort();
+        // Capture existing modules and versions before unregistering
+        const existingModules = new Map();
+        const previousVersions = new Map();
+        for (const id of matchingIds) {
+            const mod = this._registry.get(id);
+            if (mod !== null) {
+                existingModules.set(id, mod);
+                previousVersions.set(id, String(mod['version'] ?? '1.0.0'));
+            }
+        }
+        // Unregister all matching modules
+        for (const id of matchingIds) {
+            await this._registry.safeUnregister(id);
+        }
+        // Re-discover
+        try {
+            await this._registry.discover();
+        }
+        catch (err) {
+            for (const [id, mod] of existingModules) {
+                this._registry.registerInternal(id, mod);
+            }
+            throw new ReloadFailedError(pathFilter, String(err));
+        }
+        // Collect successfully reloaded modules
+        const reloadedModules = [];
+        for (const id of matchingIds) {
+            const reloaded = this._registry.get(id);
+            if (reloaded === null) {
+                const orig = existingModules.get(id);
+                if (orig !== undefined) {
+                    this._registry.registerInternal(id, orig);
+                }
+            }
+            else {
+                reloadedModules.push(id);
+                const entry = buildAuditEntry('reload_module', id, ctx, {
+                    before: previousVersions.get(id) ?? '1.0.0',
+                    after: String(reloaded['version'] ?? '1.0.0'),
+                });
+                if (this._auditStore !== null) {
+                    this._auditStore.append(entry);
+                }
+            }
+        }
+        console.warn(`[apcore:control] Bulk reload: path_filter=${pathFilter} reloaded=${reloadedModules.length} reason=${reason}`);
+        return { success: true, reloaded_modules: reloadedModules };
+    }
     _validateInputs(inputs) {
         const moduleId = inputs['module_id'];
-        if (typeof moduleId !== 'string' || !moduleId) {
-            throw new InvalidInputError("'module_id' is required and must be a non-empty string");
+        const pathFilter = inputs['path_filter'];
+        if (moduleId !== undefined && pathFilter !== undefined) {
+            throw new ModuleReloadConflictError();
+        }
+        if (moduleId === undefined && pathFilter === undefined) {
+            throw new InvalidInputError("either 'module_id' or 'path_filter' is required");
+        }
+        if (moduleId !== undefined) {
+            if (typeof moduleId !== 'string' || !moduleId) {
+                throw new InvalidInputError("'module_id' is required and must be a non-empty string");
+            }
+        }
+        if (pathFilter !== undefined) {
+            if (typeof pathFilter !== 'string' || !pathFilter) {
+                throw new InvalidInputError("'path_filter' must be a non-empty string");
+            }
         }
         const reason = inputs['reason'];
         if (typeof reason !== 'string' || !reason) {
             throw new InvalidInputError("'reason' is required and must be a non-empty string");
         }
-        return { moduleId, reason };
+        return {
+            moduleId: moduleId,
+            pathFilter: pathFilter,
+            reason,
+        };
     }
 }
 //# sourceMappingURL=control.js.map

package/dist/sys-modules/control.js.map

@@ -1 +1 @@
-{"version":3,"file":"control.js","sourceRoot":"","sources":["../../src/sys-modules/control.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"control.js","sourceRoot":"","sources":["../../src/sys-modules/control.ts"],"names":[],"mappings":"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"}

package/dist/sys-modules/index.d.ts

@@ -2,7 +2,12 @@ export { ToggleState, ToggleFeatureModule, DEFAULT_TOGGLE_STATE, isModuleDisable
 export { HealthSummaryModule, HealthModule, classifyHealthStatus } from './health.js';
 export { ManifestModule, ManifestFullModule } from './manifest.js';
 export { UpdateConfigModule, ReloadModule } from './control.js';
+export type { UpdateConfigOptions } from './control.js';
 export { UsageSummaryModule, UsageModule } from './usage.js';
-export { registerSysModules, registerSubscriberType, unregisterSubscriberType, resetSubscriberRegistry } from './registration.js';
-export type { SysModulesContext } from './registration.js';
+export { registerSysModules, registerSubscriberType, unregisterSubscriberType, resetSubscriberRegistry, createSubscriberFromConfig } from './registration.js';
+export type { SysModulesContext, RegisterSysModulesOptions } from './registration.js';
+export { InMemoryAuditStore, buildAuditEntry, extractAuditIdentity } from './audit.js';
+export type { AuditEntry, AuditStore, AuditFilter, AuditAction } from './audit.js';
+export { FileOverridesStore, InMemoryOverridesStore } from './overrides.js';
+export type { OverridesStore } from './overrides.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/sys-modules/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sys-modules/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC5H,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAClI,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sys-modules/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC5H,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAChE,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAC9J,YAAY,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AACtF,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvF,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/sys-modules/index.js

@@ -3,5 +3,7 @@ export { HealthSummaryModule, HealthModule, classifyHealthStatus } from './healt
 export { ManifestModule, ManifestFullModule } from './manifest.js';
 export { UpdateConfigModule, ReloadModule } from './control.js';
 export { UsageSummaryModule, UsageModule } from './usage.js';
-export { registerSysModules, registerSubscriberType, unregisterSubscriberType, resetSubscriberRegistry } from './registration.js';
+export { registerSysModules, registerSubscriberType, unregisterSubscriberType, resetSubscriberRegistry, createSubscriberFromConfig } from './registration.js';
+export { InMemoryAuditStore, buildAuditEntry, extractAuditIdentity } from './audit.js';
+export { FileOverridesStore, InMemoryOverridesStore } from './overrides.js';
 //# sourceMappingURL=index.js.map

package/dist/sys-modules/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sys-modules/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC5H,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sys-modules/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC5H,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEhE,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAE9J,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvF,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/sys-modules/overrides.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Persistent runtime override store (Issue #45.1).
+ *
+ * Mirrors the Python `_load_overrides` / `_write_overrides` flow and the
+ * Rust `load_overrides` / `write_override` helpers, but exposed as a
+ * pluggable interface so embeddings (tests, multi-tenant deployments,
+ * remote config services) can swap the storage layer without forking
+ * `registerSysModules` or `UpdateConfigModule`.
+ *
+ * Each override is a flat `key → value` mapping where `key` is the
+ * dot-path config key (e.g. `"app.timeout"` or `"toggle.module.id"`).
+ */
+/**
+ * Pluggable persistence for runtime config & toggle overrides.
+ *
+ * Implementations must be safe to call from multiple call sites in sequence;
+ * the `FileOverridesStore` reference implementation uses an atomic
+ * tempfile + rename to prevent partial-write corruption.
+ */
+export interface OverridesStore {
+    /**
+     * Load all overrides from the backing store. Returns `{}` if empty/missing.
+     *
+     * Implementations may return synchronously or asynchronously — async stores
+     * (e.g. remote config services) cannot be applied at startup by the
+     * synchronous `registerSysModules`, so prefer sync stores there or
+     * pre-load and pass results into `Config` directly.
+     */
+    load(): Promise<Record<string, unknown>> | Record<string, unknown>;
+    /** Replace the entire override set with the given mapping. */
+    save(overrides: Record<string, unknown>): Promise<void> | void;
+}
+/**
+ * In-memory store, intended primarily for tests and embeddings that do not
+ * require disk persistence.
+ */
+export declare class InMemoryOverridesStore implements OverridesStore {
+    private _data;
+    constructor(initial?: Record<string, unknown>);
+    load(): Record<string, unknown>;
+    save(overrides: Record<string, unknown>): void;
+}
+/**
+ * YAML-file-backed override store with atomic write semantics.
+ *
+ * Each `save()` writes to a sibling tempfile and `fs.renameSync`-es it into
+ * place so an interrupted process cannot leave a half-written overrides file
+ * behind (matches Python's `os.replace` and Rust's `std::fs::rename` flow).
+ */
+export declare class FileOverridesStore implements OverridesStore {
+    private readonly _path;
+    constructor(filePath: string);
+    /** Path of the underlying YAML file. */
+    get path(): string;
+    load(): Record<string, unknown>;
+    save(overrides: Record<string, unknown>): void;
+}
+//# sourceMappingURL=overrides.d.ts.map

package/dist/sys-modules/overrides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overrides.d.ts","sourceRoot":"","sources":["../../src/sys-modules/overrides.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;;OAOG;IACH,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnE,8DAA8D;IAC9D,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAChE;AAED;;;GAGG;AACH,qBAAa,sBAAuB,YAAW,cAAc;IAC3D,OAAO,CAAC,KAAK,CAA0B;gBAE3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI7C,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI/B,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAG/C;AAED;;;;;;GAMG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IACvD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,QAAQ,EAAE,MAAM;IAI5B,wCAAwC;IACxC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAuB/B,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CA8B/C"}

package/dist/sys-modules/overrides.js

@@ -0,0 +1,106 @@
+/**
+ * Persistent runtime override store (Issue #45.1).
+ *
+ * Mirrors the Python `_load_overrides` / `_write_overrides` flow and the
+ * Rust `load_overrides` / `write_override` helpers, but exposed as a
+ * pluggable interface so embeddings (tests, multi-tenant deployments,
+ * remote config services) can swap the storage layer without forking
+ * `registerSysModules` or `UpdateConfigModule`.
+ *
+ * Each override is a flat `key → value` mapping where `key` is the
+ * dot-path config key (e.g. `"app.timeout"` or `"toggle.module.id"`).
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as yaml from 'js-yaml';
+/**
+ * In-memory store, intended primarily for tests and embeddings that do not
+ * require disk persistence.
+ */
+export class InMemoryOverridesStore {
+    _data;
+    constructor(initial) {
+        this._data = initial !== undefined ? { ...initial } : {};
+    }
+    load() {
+        return { ...this._data };
+    }
+    save(overrides) {
+        this._data = { ...overrides };
+    }
+}
+/**
+ * YAML-file-backed override store with atomic write semantics.
+ *
+ * Each `save()` writes to a sibling tempfile and `fs.renameSync`-es it into
+ * place so an interrupted process cannot leave a half-written overrides file
+ * behind (matches Python's `os.replace` and Rust's `std::fs::rename` flow).
+ */
+export class FileOverridesStore {
+    _path;
+    constructor(filePath) {
+        this._path = filePath;
+    }
+    /** Path of the underlying YAML file. */
+    get path() {
+        return this._path;
+    }
+    load() {
+        if (!fs.existsSync(this._path))
+            return {};
+        let raw;
+        try {
+            raw = fs.readFileSync(this._path, 'utf-8');
+        }
+        catch (err) {
+            console.warn(`[apcore:overrides] Failed to read overrides file '${this._path}':`, err);
+            return {};
+        }
+        if (raw.length === 0)
+            return {};
+        try {
+            const parsed = yaml.load(raw);
+            if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)) {
+                return { ...parsed };
+            }
+            console.warn(`[apcore:overrides] Overrides file '${this._path}' root is not a mapping; skipping`);
+            return {};
+        }
+        catch (err) {
+            console.warn(`[apcore:overrides] Overrides file '${this._path}' is not valid YAML; skipping`, err);
+            return {};
+        }
+    }
+    save(overrides) {
+        const dir = path.dirname(this._path) || '.';
+        try {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        catch (err) {
+            console.error(`[apcore:overrides] Failed to create parent directory '${dir}':`, err);
+            return;
+        }
+        // Sort keys for stable on-disk layout.
+        const ordered = {};
+        for (const key of Object.keys(overrides).sort()) {
+            ordered[key] = overrides[key];
+        }
+        const yamlText = yaml.dump(ordered, { sortKeys: true });
+        const base = path.basename(this._path);
+        const tmp = path.join(dir, `.${base}.${process.pid}.${Date.now()}.tmp`);
+        try {
+            fs.writeFileSync(tmp, yamlText, 'utf-8');
+            fs.renameSync(tmp, this._path);
+        }
+        catch (err) {
+            console.error(`[apcore:overrides] Failed to write overrides file '${this._path}':`, err);
+            try {
+                fs.unlinkSync(tmp);
+            }
+            catch {
+                /* ignore */
+            }
+        }
+    }
+}
+//# sourceMappingURL=overrides.js.map

package/dist/sys-modules/overrides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overrides.js","sourceRoot":"","sources":["../../src/sys-modules/overrides.ts"],"names":[],"mappings":"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"}

package/dist/sys-modules/registration.d.ts

@@ -5,6 +5,8 @@ import type { Registry } from '../registry/registry.js';
 import type { Executor } from '../executor.js';
 import type { Config } from '../config.js';
 import type { MetricsCollector } from '../observability/metrics.js';
+import type { AuditStore } from './audit.js';
+import type { OverridesStore } from './overrides.js';
 import { ErrorHistory } from '../observability/error-history.js';
 import { ErrorHistoryMiddleware } from '../middleware/error-history.js';
 import { UsageCollector, UsageMiddleware } from '../observability/usage.js';
@@ -12,21 +14,17 @@ import type { EventSubscriber } from '../events/emitter.js';
 import { EventEmitter } from '../events/emitter.js';
 import { PlatformNotifyMiddleware } from '../middleware/platform-notify.js';
 type SubscriberFactory = (config: Record<string, unknown>) => EventSubscriber;
-/**
- * @deprecated Internal use only. This function is not part of the public API
- * and will be removed in a future release. Use the built-in webhook and a2a
- * subscriber types, or contact the maintainers to add a new built-in type.
- */
+/** Register a custom subscriber type for config-driven instantiation. */
 export declare function registerSubscriberType(typeName: string, factory: SubscriberFactory): void;
-/**
- * @deprecated Internal use only. See {@link registerSubscriberType}.
- */
+/** Remove a previously registered subscriber type. */
 export declare function unregisterSubscriberType(typeName: string): void;
+/** Reset the registry to built-in types only. Intended for test teardown. */
+export declare function resetSubscriberRegistry(): void;
 /**
- * @deprecated Internal use only. Intended for test teardown only.
- * See {@link registerSubscriberType}.
+ * Instantiate a single subscriber from a config object.
+ * The `type` field selects the factory; all other fields are passed as config.
  */
-export declare function resetSubscriberRegistry(): void;
+export declare function createSubscriberFromConfig(config: Record<string, unknown>): EventSubscriber;
 /**
  * Instantiate subscribers from config and subscribe them to the emitter.
  */
@@ -39,9 +37,16 @@ export interface SysModulesContext {
     eventEmitter?: EventEmitter;
     platformNotifyMiddleware?: PlatformNotifyMiddleware;
 }
+export interface RegisterSysModulesOptions {
+    failOnError?: boolean;
+    overridesPath?: string;
+    /** Pluggable persistent override store (Issue #45.1). */
+    overridesStore?: OverridesStore;
+    auditStore?: AuditStore;
+}
 /**
  * Auto-register all sys.* modules and middleware based on config.
  */
-export declare function registerSysModules(registry: Registry, executor: Executor, config: Config, metricsCollector?: MetricsCollector | null): SysModulesContext;
+export declare function registerSysModules(registry: Registry, executor: Executor, config: Config, metricsCollector?: MetricsCollector | null, options?: RegisterSysModulesOptions): SysModulesContext;
 export {};
 //# sourceMappingURL=registration.d.ts.map