@pellux/goodvibes-sdk 0.24.0 → 0.25.0

package/dist/_internal/platform/tools/shared/overflow.js

@@ -2,6 +2,7 @@ import { mkdirSync, writeFileSync, readFileSync, readdirSync, unlinkSync, statSy
 import { join } from 'node:path';
 import { logger } from '../../utils/logger.js';
 import { summarizeError } from '../../utils/error-display.js';
+import { isFeatureGateEnabled } from '../../runtime/feature-flags/index.js';
 // ─── Constants ─────────────────────────────────────────────────────────────
 export const DEFAULT_MAX_CHARS = 50_000;
 const OVERFLOW_DIR = '.goodvibes/.overflow';
@@ -277,10 +278,13 @@ export class OverflowHandler {
     backend;
     retention;
     constructor(config = {}) {
-        if (!config.backend && (config.spillBackend ?? 'file') === 'file' && !config.baseDir) {
+        const alternateBackendsEnabled = isFeatureGateEnabled(config.featureFlags, 'overflow-spill-backends');
+        const backend = alternateBackendsEnabled ? config.backend : undefined;
+        const spillBackend = alternateBackendsEnabled ? (config.spillBackend ?? 'file') : 'file';
+        if (!backend && spillBackend === 'file' && !config.baseDir) {
             throw new Error('OverflowHandler requires an explicit baseDir when using the file spill backend');
         }
-        this.backend = config.backend ?? createSpillBackend(config.spillBackend ?? 'file', config.baseDir);
+        this.backend = backend ?? createSpillBackend(spillBackend, config.baseDir);
         this.retention = { ...DEFAULT_RETENTION, ...config.retention };
     }
     sanitizeLabel(label) {

package/dist/_internal/platform/version.js

@@ -1,6 +1,6 @@
 import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
-let version = '0.24.0';
+let version = '0.25.0';
 try {
     const pkg = JSON.parse(readFileSync(join(import.meta.dir, '..', '..', 'package.json'), 'utf-8'));
     version = pkg.version ?? version;

package/dist/_internal/platform/watchers/registry.d.ts

@@ -2,6 +2,7 @@ import type { RuntimeStore } from '../runtime/store/index.js';
 import type { RuntimeEventBus } from '../runtime/events/index.js';
 import type { WatcherKind, WatcherRecord } from '../runtime/store/domains/watchers.js';
 import type { AutomationSourceRecord } from '../automation/sources.js';
+import type { FeatureFlagReader } from '../runtime/feature-flags/index.js';
 export interface RegisterWatcherInput {
     readonly id: string;
     readonly label: string;
@@ -20,6 +21,7 @@ export interface RegisterPollingWatcherInput {
 }
 export interface WatcherRegistryOptions {
     readonly storePath?: string;
+    readonly featureFlags?: FeatureFlagReader;
 }
 export declare class WatcherRegistry {
     private readonly watchers;
@@ -28,8 +30,12 @@ export declare class WatcherRegistry {
     private readonly storePath;
     private runtimeDispatch;
     private runtimeBus;
+    private readonly featureFlags;
     private loaded;
     constructor(options?: WatcherRegistryOptions);
+    private isEnabled;
+    private requireEnabled;
+    private clearTimers;
     attachRuntime(config: {
         readonly runtimeStore?: RuntimeStore | null;
         readonly runtimeBus?: RuntimeEventBus | null;

package/dist/_internal/platform/watchers/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/watchers/registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAuB,MAAM,sCAAsC,CAAC;AAC5G,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAgBvE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;IACxC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;CAC7D;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;CAC5D;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAwFD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwC;IACjE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqD;IAC5E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,UAAU,CAAgC;IAClD,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,GAAE,sBAA2B;IAIhD,aAAa,CAAC,MAAM,EAAE;QACpB,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;QAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;KAC9C,GAAG,IAAI;IAYR,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,aAAa;IAuC3D,sBAAsB,CAAC,KAAK,EAAE,2BAA2B,GAAG,aAAa;IAezE,IAAI,IAAI,aAAa,EAAE;IAkBvB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAa5C,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAuC9C,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,SAAY,GAAG,aAAa,GAAG,IAAI;IA8B3D,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAQ9D,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAoBlC,OAAO,CAAC,YAAY;IAkCpB,OAAO,CAAC,eAAe;YAYT,UAAU;IA4DxB,OAAO,CAAC,gBAAgB;IA+DxB,OAAO,CAAC,OAAO;CAShB"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/watchers/registry.ts"],"names":[],"mappings":"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"}

package/dist/_internal/platform/watchers/registry.js

@@ -4,6 +4,7 @@ import { summarizeError } from '../utils/error-display.js';
 import { emitWatcherFailed, emitWatcherHeartbeat, emitWatcherStarted, emitWatcherStopped, } from '../runtime/emitters/index.js';
 import { loadWatcherSnapshotFromPath, resolveWatcherStorePath, saveWatcherSnapshotToPath, } from './store.js';
 import { instrumentedFetch } from '../utils/fetch-with-timeout.js';
+import { isFeatureGateEnabled, requireFeatureGate } from '../runtime/feature-flags/index.js';
 function now() {
     return Date.now();
 }
@@ -83,9 +84,23 @@ export class WatcherRegistry {
     storePath;
     runtimeDispatch = null;
     runtimeBus = null;
+    featureFlags;
     loaded = false;
     constructor(options = {}) {
         this.storePath = resolveWatcherStorePath(options.storePath);
+        this.featureFlags = options.featureFlags ?? null;
+    }
+    isEnabled() {
+        return isFeatureGateEnabled(this.featureFlags, 'watcher-framework', ['managed-watcher-services']);
+    }
+    requireEnabled(operation) {
+        requireFeatureGate(this.featureFlags, 'watcher-framework', operation, ['managed-watcher-services']);
+    }
+    clearTimers() {
+        for (const timer of this.timers.values()) {
+            clearInterval(timer);
+        }
+        this.timers.clear();
     }
     attachRuntime(config) {
         if (config.runtimeStore) {
@@ -99,6 +114,7 @@ export class WatcherRegistry {
         }
     }
     registerWatcher(input) {
+        this.requireEnabled('register watcher');
         this.ensureLoaded();
         const existing = this.watchers.get(input.id)?.record;
         const wasRunning = existing?.state === 'running' || existing?.state === 'starting' || existing?.state === 'degraded';
@@ -151,6 +167,10 @@ export class WatcherRegistry {
         });
     }
     list() {
+        if (!this.isEnabled()) {
+            this.clearTimers();
+            return [];
+        }
         this.ensureLoaded();
         const refreshed = [];
         let changed = false;
@@ -168,6 +188,10 @@ export class WatcherRegistry {
         return sortWatchers(refreshed);
     }
     getWatcher(id) {
+        if (!this.isEnabled()) {
+            this.clearTimers();
+            return null;
+        }
         this.ensureLoaded();
         const watcher = this.watchers.get(id);
         if (!watcher)
@@ -181,6 +205,7 @@ export class WatcherRegistry {
         return normalized;
     }
     startWatcher(id) {
+        this.requireEnabled('start watcher');
         this.ensureLoaded();
         const watcher = this.watchers.get(id);
         if (!watcher)
@@ -219,6 +244,7 @@ export class WatcherRegistry {
         return started;
     }
     stopWatcher(id, reason = 'stopped') {
+        this.requireEnabled('stop watcher');
         this.ensureLoaded();
         const watcher = this.watchers.get(id);
         if (!watcher)
@@ -249,6 +275,7 @@ export class WatcherRegistry {
         return stopped;
     }
     async runWatcherNow(id) {
+        this.requireEnabled('run watcher');
         this.ensureLoaded();
         const watcher = this.watchers.get(id);
         if (!watcher)
@@ -257,6 +284,7 @@ export class WatcherRegistry {
         return this.getWatcher(id);
     }
     removeWatcher(id) {
+        this.requireEnabled('remove watcher');
         this.ensureLoaded();
         const watcher = this.watchers.get(id);
         if (!watcher)
@@ -277,6 +305,8 @@ export class WatcherRegistry {
         return removed;
     }
     ensureLoaded() {
+        if (!this.isEnabled())
+            return;
         if (this.loaded)
             return;
         const snapshot = loadWatcherSnapshotFromPath(this.storePath);
@@ -320,6 +350,8 @@ export class WatcherRegistry {
         };
     }
     async runWatcher(id) {
+        if (!this.isEnabled())
+            return;
         if (this.inFlight.has(id))
             return;
         const watcher = this.watchers.get(id);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pellux/goodvibes-sdk",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/mgd34msu/goodvibes-sdk.git"