@yusufffararatt/dombridge-mcp 2.7.5

package/src/utils/workflow-state.js

@@ -0,0 +1,177 @@
+/**
+ * Workflow State
+ * Tracks per-tab history and per-domain profile usage.
+ */
+
+import { loadProfile, getProfileFieldTimestamp } from '../profiles/profile-manager.js';
+
+/**
+ * @typedef {object} TabState
+ * @property {string} url
+ * @property {string} domain
+ * @property {number|null} lastQuickScanAt
+ * @property {number|null} lastAnalyzeAt
+ * @property {number|null} lastDiscoverApisAt
+ * @property {number|null} lastProfileLoadAt
+ * @property {number|null} lastProfileCheckAt
+ * @property {number|null} lastSelectedElementAt
+ * @property {number|null} lastNavigationAt
+ */
+
+/**
+ * @typedef {object} ProfileState
+ * @property {boolean} exists
+ * @property {number|null} lastLoadedAt
+ * @property {number|null} lastSavedAt
+ * @property {number|null} lastCheckedAt
+ * @property {number|null} freshUntil
+ * @property {Record<string, string|number>} fieldFreshness
+ */
+
+const PROFILE_FRESHNESS_MS = 15 * 60 * 1000;
+
+const STALENESS_THRESHOLDS = {
+    framework: 7 * 24 * 60 * 60 * 1000,
+    apiEndpoints: 24 * 60 * 60 * 1000,
+    dataSchema: 3 * 24 * 60 * 60 * 1000,
+    authInfo: 7 * 24 * 60 * 60 * 1000,
+    pageCharacteristics: 3 * 24 * 60 * 60 * 1000,
+    knownPaths: 3 * 24 * 60 * 60 * 1000,
+    default: 24 * 60 * 60 * 1000
+};
+
+const workflowState = {
+    tabs: {},
+    profiles: {}
+};
+
+function extractDomain(url) {
+    if (!url) return '';
+    try {
+        return new URL(url).hostname;
+    } catch {
+        return '';
+    }
+}
+
+function createEmptyTabState(url) {
+    return {
+        url,
+        domain: extractDomain(url),
+        lastQuickScanAt: null,
+        lastAnalyzeAt: null,
+        lastDiscoverApisAt: null,
+        lastProfileLoadAt: null,
+        lastProfileCheckAt: null,
+        lastSelectedElementAt: null,
+        lastNavigationAt: null
+    };
+}
+
+function getTabState(tabId, url) {
+    if (!workflowState.tabs[tabId]) {
+        workflowState.tabs[tabId] = createEmptyTabState(url || '');
+    }
+    return workflowState.tabs[tabId];
+}
+
+function invalidateTabState(tabId, newUrl) {
+    workflowState.tabs[tabId] = createEmptyTabState(newUrl);
+    workflowState.tabs[tabId].lastNavigationAt = Date.now();
+}
+
+function touchTabField(tabId, field, url) {
+    const state = getTabState(tabId, url);
+
+    if (url && url !== state.url) {
+        invalidateTabState(tabId, url);
+        workflowState.tabs[tabId][field] = Date.now();
+        return;
+    }
+
+    state[field] = Date.now();
+}
+
+function removeTabState(tabId) {
+    delete workflowState.tabs[tabId];
+}
+
+function createEmptyProfileState() {
+    return {
+        exists: false,
+        lastLoadedAt: null,
+        lastSavedAt: null,
+        lastCheckedAt: null,
+        freshUntil: null,
+        fieldFreshness: {}
+    };
+}
+
+function getProfileState(domain) {
+    if (!workflowState.profiles[domain]) {
+        workflowState.profiles[domain] = createEmptyProfileState();
+    }
+    return workflowState.profiles[domain];
+}
+
+function markProfileLoaded(domain, freshnessMs = PROFILE_FRESHNESS_MS) {
+    const state = getProfileState(domain);
+    const now = Date.now();
+    state.exists = true;
+    state.lastLoadedAt = now;
+    state.freshUntil = now + freshnessMs;
+}
+
+function markProfileSaved(domain) {
+    const state = getProfileState(domain);
+    state.exists = true;
+    state.lastSavedAt = Date.now();
+}
+
+function markProfileChecked(domain) {
+    const state = getProfileState(domain);
+    state.lastCheckedAt = Date.now();
+}
+
+function isProfileFresh(domain) {
+    const state = workflowState.profiles[domain];
+    if (!state?.freshUntil) return false;
+    return Date.now() < state.freshUntil;
+}
+
+function markFieldFresh(domain, field, timestamp = Date.now()) {
+    const state = getProfileState(domain);
+    state.fieldFreshness[field] = timestamp;
+}
+
+function isFieldFresh(domain, field, maxAgeMs) {
+    const threshold = maxAgeMs ?? STALENESS_THRESHOLDS[field] ?? STALENESS_THRESHOLDS.default;
+    const runtimeTimestamp = workflowState.profiles[domain]?.fieldFreshness?.[field] || null;
+    const persistedTimestamp = getProfileFieldTimestamp(loadProfile(domain), field);
+    const timestamp = runtimeTimestamp || persistedTimestamp;
+    if (!timestamp) return false;
+    return Date.now() - new Date(timestamp).getTime() < threshold;
+}
+
+function snapshot() {
+    return JSON.parse(JSON.stringify(workflowState));
+}
+
+export {
+    workflowState,
+    getTabState,
+    touchTabField,
+    invalidateTabState,
+    removeTabState,
+    getProfileState,
+    markProfileLoaded,
+    markProfileSaved,
+    markProfileChecked,
+    isProfileFresh,
+    markFieldFresh,
+    isFieldFresh,
+    extractDomain,
+    snapshot,
+    PROFILE_FRESHNESS_MS,
+    STALENESS_THRESHOLDS
+};