@mcpmake/core 0.2.0

package/dist/rescan/diff-engine.js

@@ -0,0 +1,313 @@
+/**
+ * Compare two SiteDescriptors and produce a structured diff of changes.
+ */
+export function diffSiteDescriptors(oldSite, newSite) {
+    const changes = [];
+    const brokenSelectors = [];
+    const now = new Date().toISOString();
+    const oldPagesByUrl = new Map(oldSite.pages.map((p) => [p.url, p]));
+    const newPagesByUrl = new Map(newSite.pages.map((p) => [p.url, p]));
+    // Detect added pages
+    for (const [url, page] of newPagesByUrl) {
+        if (!oldPagesByUrl.has(url)) {
+            changes.push({
+                changeType: 'added',
+                elementType: 'page',
+                elementId: page.pageId,
+                pageId: page.pageId,
+                description: `Page added: ${url}`,
+                timestamp: now,
+                newValue: url,
+            });
+        }
+    }
+    // Detect removed pages
+    for (const [url, page] of oldPagesByUrl) {
+        if (!newPagesByUrl.has(url)) {
+            changes.push({
+                changeType: 'removed',
+                elementType: 'page',
+                elementId: page.pageId,
+                pageId: page.pageId,
+                description: `Page removed: ${url}`,
+                timestamp: now,
+                oldValue: url,
+            });
+        }
+    }
+    // Compare matching pages
+    for (const [url, oldPage] of oldPagesByUrl) {
+        const newPage = newPagesByUrl.get(url);
+        if (!newPage)
+            continue;
+        diffForms(oldPage, newPage, changes, brokenSelectors, now);
+        diffButtons(oldPage, newPage, changes, brokenSelectors, now);
+        diffLinks(oldPage, newPage, changes, brokenSelectors, now);
+    }
+    const newVersion = oldSite.version + 1;
+    const updatedSite = {
+        ...newSite,
+        version: newVersion,
+    };
+    return {
+        previousVersion: oldSite.version,
+        newVersion,
+        changes,
+        brokenSelectors,
+        newSiteDescriptor: updatedSite,
+        timestamp: now,
+    };
+}
+function diffForms(oldPage, newPage, changes, brokenSelectors, timestamp) {
+    const oldFormsById = new Map(oldPage.forms.map((f) => [f.formId, f]));
+    const newFormsById = new Map(newPage.forms.map((f) => [f.formId, f]));
+    for (const [id, form] of newFormsById) {
+        if (!oldFormsById.has(id)) {
+            changes.push({
+                changeType: 'added',
+                elementType: 'form',
+                elementId: id,
+                pageId: newPage.pageId,
+                description: `Form added: ${form.semanticName ?? id}`,
+                timestamp,
+                newValue: form.semanticName,
+            });
+        }
+    }
+    for (const [id, form] of oldFormsById) {
+        if (!newFormsById.has(id)) {
+            changes.push({
+                changeType: 'removed',
+                elementType: 'form',
+                elementId: id,
+                pageId: oldPage.pageId,
+                description: `Form removed: ${form.semanticName ?? id}`,
+                timestamp,
+                oldValue: form.semanticName,
+            });
+        }
+    }
+    for (const [id, oldForm] of oldFormsById) {
+        const newForm = newFormsById.get(id);
+        if (!newForm)
+            continue;
+        // Check for field changes
+        diffFormFields(oldForm, newForm, oldPage.pageId, changes, timestamp);
+        // Check for broken selectors
+        if (oldForm.selector.primary !== newForm.selector.primary) {
+            if (newForm.selector.confidence < 0.5) {
+                brokenSelectors.push({
+                    toolName: newForm.semanticName ?? id,
+                    selector: oldForm.selector,
+                });
+                changes.push({
+                    changeType: 'selector-broken',
+                    elementType: 'form',
+                    elementId: id,
+                    pageId: oldPage.pageId,
+                    description: `Form selector changed with low confidence: ${oldForm.selector.primary}`,
+                    timestamp,
+                    oldValue: oldForm.selector.primary,
+                    newValue: newForm.selector.primary,
+                });
+            }
+            else {
+                changes.push({
+                    changeType: 'modified',
+                    elementType: 'form',
+                    elementId: id,
+                    pageId: oldPage.pageId,
+                    description: `Form selector updated: ${oldForm.selector.primary} → ${newForm.selector.primary}`,
+                    timestamp,
+                    oldValue: oldForm.selector.primary,
+                    newValue: newForm.selector.primary,
+                });
+            }
+        }
+    }
+}
+function diffFormFields(oldForm, newForm, pageId, changes, timestamp) {
+    const oldFieldsByName = new Map(oldForm.fields.map((f) => [f.name, f]));
+    const newFieldsByName = new Map(newForm.fields.map((f) => [f.name, f]));
+    for (const [name] of newFieldsByName) {
+        if (!oldFieldsByName.has(name)) {
+            changes.push({
+                changeType: 'added',
+                elementType: 'field',
+                elementId: `${oldForm.formId}:${name}`,
+                pageId,
+                description: `Field added to form ${oldForm.semanticName ?? oldForm.formId}: ${name}`,
+                timestamp,
+                newValue: name,
+            });
+        }
+    }
+    for (const [name] of oldFieldsByName) {
+        if (!newFieldsByName.has(name)) {
+            changes.push({
+                changeType: 'removed',
+                elementType: 'field',
+                elementId: `${oldForm.formId}:${name}`,
+                pageId,
+                description: `Field removed from form ${oldForm.semanticName ?? oldForm.formId}: ${name}`,
+                timestamp,
+                oldValue: name,
+            });
+        }
+    }
+    for (const [name, oldField] of oldFieldsByName) {
+        const newField = newFieldsByName.get(name);
+        if (!newField)
+            continue;
+        if (oldField.fieldType !== newField.fieldType) {
+            changes.push({
+                changeType: 'modified',
+                elementType: 'field',
+                elementId: `${oldForm.formId}:${name}`,
+                pageId,
+                description: `Field type changed in ${oldForm.semanticName ?? oldForm.formId}: ${oldField.fieldType} → ${newField.fieldType}`,
+                timestamp,
+                oldValue: oldField.fieldType,
+                newValue: newField.fieldType,
+            });
+        }
+        if (oldField.required !== newField.required) {
+            changes.push({
+                changeType: 'modified',
+                elementType: 'field',
+                elementId: `${oldForm.formId}:${name}`,
+                pageId,
+                description: `Field required changed in ${oldForm.semanticName ?? oldForm.formId}: ${oldField.required} → ${newField.required}`,
+                timestamp,
+                oldValue: oldField.required,
+                newValue: newField.required,
+            });
+        }
+    }
+}
+function diffButtons(oldPage, newPage, changes, brokenSelectors, timestamp) {
+    const oldById = new Map(oldPage.buttons.map((b) => [b.buttonId, b]));
+    const newById = new Map(newPage.buttons.map((b) => [b.buttonId, b]));
+    for (const [id, btn] of newById) {
+        if (!oldById.has(id)) {
+            changes.push({
+                changeType: 'added',
+                elementType: 'button',
+                elementId: id,
+                pageId: newPage.pageId,
+                description: `Button added: ${btn.text ?? btn.semanticAction ?? id}`,
+                timestamp,
+                newValue: btn.text,
+            });
+        }
+    }
+    for (const [id, btn] of oldById) {
+        if (!newById.has(id)) {
+            changes.push({
+                changeType: 'removed',
+                elementType: 'button',
+                elementId: id,
+                pageId: oldPage.pageId,
+                description: `Button removed: ${btn.text ?? btn.semanticAction ?? id}`,
+                timestamp,
+                oldValue: btn.text,
+            });
+        }
+    }
+    for (const [id, oldBtn] of oldById) {
+        const newBtn = newById.get(id);
+        if (!newBtn)
+            continue;
+        if (oldBtn.text !== newBtn.text) {
+            changes.push({
+                changeType: 'modified',
+                elementType: 'button',
+                elementId: id,
+                pageId: oldPage.pageId,
+                description: `Button text changed: "${oldBtn.text}" → "${newBtn.text}"`,
+                timestamp,
+                oldValue: oldBtn.text,
+                newValue: newBtn.text,
+            });
+        }
+        checkBrokenSelector(oldBtn.selector, newBtn.selector, oldBtn.semanticAction ?? id, id, 'button', oldPage.pageId, changes, brokenSelectors, timestamp);
+    }
+}
+function diffLinks(oldPage, newPage, changes, brokenSelectors, timestamp) {
+    const oldById = new Map(oldPage.links.map((l) => [l.linkId, l]));
+    const newById = new Map(newPage.links.map((l) => [l.linkId, l]));
+    for (const [id, link] of newById) {
+        if (!oldById.has(id)) {
+            changes.push({
+                changeType: 'added',
+                elementType: 'link',
+                elementId: id,
+                pageId: newPage.pageId,
+                description: `Link added: ${link.text ?? link.href}`,
+                timestamp,
+                newValue: link.href,
+            });
+        }
+    }
+    for (const [id, link] of oldById) {
+        if (!newById.has(id)) {
+            changes.push({
+                changeType: 'removed',
+                elementType: 'link',
+                elementId: id,
+                pageId: oldPage.pageId,
+                description: `Link removed: ${link.text ?? link.href}`,
+                timestamp,
+                oldValue: link.href,
+            });
+        }
+    }
+    for (const [id, oldLink] of oldById) {
+        const newLink = newById.get(id);
+        if (!newLink)
+            continue;
+        if (oldLink.href !== newLink.href) {
+            changes.push({
+                changeType: 'modified',
+                elementType: 'link',
+                elementId: id,
+                pageId: oldPage.pageId,
+                description: `Link href changed: "${oldLink.href}" → "${newLink.href}"`,
+                timestamp,
+                oldValue: oldLink.href,
+                newValue: newLink.href,
+            });
+        }
+        checkBrokenSelector(oldLink.selector, newLink.selector, oldLink.semanticAction ?? id, id, 'link', oldPage.pageId, changes, brokenSelectors, timestamp);
+    }
+}
+function checkBrokenSelector(oldSelector, newSelector, toolName, elementId, elementType, pageId, changes, brokenSelectors, timestamp) {
+    if (oldSelector.primary !== newSelector.primary) {
+        if (newSelector.confidence < 0.5) {
+            brokenSelectors.push({ toolName, selector: oldSelector });
+            changes.push({
+                changeType: 'selector-broken',
+                elementType,
+                elementId,
+                pageId,
+                description: `${elementType} selector changed with low confidence: ${oldSelector.primary}`,
+                timestamp,
+                oldValue: oldSelector.primary,
+                newValue: newSelector.primary,
+            });
+        }
+        else {
+            changes.push({
+                changeType: 'modified',
+                elementType,
+                elementId,
+                pageId,
+                description: `${elementType} selector updated: ${oldSelector.primary} → ${newSelector.primary}`,
+                timestamp,
+                oldValue: oldSelector.primary,
+                newValue: newSelector.primary,
+            });
+        }
+    }
+}
+//# sourceMappingURL=diff-engine.js.map

package/dist/rescan/diff-engine.js.map

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

package/dist/rescan/index.d.ts

@@ -0,0 +1,4 @@
+export { diffSiteDescriptors } from './diff-engine.js';
+export { RescanScheduler, computeNextRun } from './rescan-scheduler.js';
+export type { ScheduleEntry, RescanCallback } from './rescan-scheduler.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/rescan/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rescan/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACxE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/rescan/index.js

@@ -0,0 +1,3 @@
+export { diffSiteDescriptors } from './diff-engine.js';
+export { RescanScheduler, computeNextRun } from './rescan-scheduler.js';
+//# sourceMappingURL=index.js.map

package/dist/rescan/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rescan/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/rescan/rescan-runner.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Pure helpers for the `mcpmake rescan` command: collecting fragile selectors
+ * to heal and summarizing a diff. Kept free of Playwright/LLM/IO so they can be
+ * unit-tested directly; the browser + LLM orchestration lives in the command.
+ */
+import type { SiteDescriptor, SelectorSet, RescanResult } from '../types/site.js';
+/** A low-confidence selector flagged for healing, with a live object reference. */
+export interface LowConfidenceSelector {
+    /** URL of the page this selector lives on (for navigation during healing). */
+    pageUrl: string;
+    /** Human-readable description used in the heal prompt. */
+    description: string;
+    /**
+     * The actual SelectorSet object inside the descriptor. Mutating this (via
+     * Object.assign) updates the descriptor in place so regeneration picks up
+     * the healed selector.
+     */
+    selector: SelectorSet;
+}
+/**
+ * Walk a SiteDescriptor and collect every selector whose confidence is below
+ * `threshold` (default 0.5 — i.e. the brittle css-path / xpath fallbacks).
+ */
+export declare function collectLowConfidenceSelectors(site: SiteDescriptor, threshold?: number): LowConfidenceSelector[];
+export interface ChangeCounts {
+    page: number;
+    form: number;
+    field: number;
+    button: number;
+    link: number;
+}
+export interface RescanSummary {
+    previousVersion: number;
+    newVersion: number;
+    added: ChangeCounts;
+    removed: ChangeCounts;
+    modified: ChangeCounts;
+    brokenSelectors: number;
+    totalChanges: number;
+}
+/** Summarize a RescanResult into per-kind change counts for reporting. */
+export declare function summarizeRescan(result: RescanResult): RescanSummary;
+//# sourceMappingURL=rescan-runner.d.ts.map

package/dist/rescan/rescan-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rescan-runner.d.ts","sourceRoot":"","sources":["../../src/rescan/rescan-runner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAe,MAAM,kBAAkB,CAAC;AAE/F,mFAAmF;AACnF,MAAM,WAAW,qBAAqB;IACpC,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,QAAQ,EAAE,WAAW,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,cAAc,EACpB,SAAS,SAAM,GACd,qBAAqB,EAAE,CAmCzB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,EAAE,YAAY,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;CACtB;AAMD,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa,CAiCnE"}

package/dist/rescan/rescan-runner.js

@@ -0,0 +1,70 @@
+/**
+ * Pure helpers for the `mcpmake rescan` command: collecting fragile selectors
+ * to heal and summarizing a diff. Kept free of Playwright/LLM/IO so they can be
+ * unit-tested directly; the browser + LLM orchestration lives in the command.
+ */
+/**
+ * Walk a SiteDescriptor and collect every selector whose confidence is below
+ * `threshold` (default 0.5 — i.e. the brittle css-path / xpath fallbacks).
+ */
+export function collectLowConfidenceSelectors(site, threshold = 0.5) {
+    const out = [];
+    const consider = (selector, pageUrl, description) => {
+        if (selector && selector.confidence < threshold) {
+            out.push({ pageUrl, description, selector });
+        }
+    };
+    for (const page of site.pages) {
+        for (const form of page.forms) {
+            const formName = form.semanticName ?? form.formId;
+            consider(form.selector, page.url, `form "${formName}"`);
+            consider(form.submitButton, page.url, `submit button of form "${formName}"`);
+            for (const field of form.fields) {
+                consider(field.selector, page.url, `field "${field.name}" (${field.label ?? field.fieldType}) in form "${formName}"`);
+            }
+        }
+        for (const button of page.buttons) {
+            consider(button.selector, page.url, `button "${button.text ?? button.semanticAction ?? button.buttonId}"`);
+        }
+        for (const link of page.links) {
+            consider(link.selector, page.url, `link "${link.text ?? link.href}"`);
+        }
+    }
+    return out;
+}
+function emptyCounts() {
+    return { page: 0, form: 0, field: 0, button: 0, link: 0 };
+}
+/** Summarize a RescanResult into per-kind change counts for reporting. */
+export function summarizeRescan(result) {
+    const added = emptyCounts();
+    const removed = emptyCounts();
+    const modified = emptyCounts();
+    const bump = (counts, elementType) => {
+        counts[elementType] += 1;
+    };
+    for (const change of result.changes) {
+        switch (change.changeType) {
+            case 'added':
+                bump(added, change.elementType);
+                break;
+            case 'removed':
+                bump(removed, change.elementType);
+                break;
+            case 'modified':
+                bump(modified, change.elementType);
+                break;
+            // 'selector-broken' is reported separately via brokenSelectors.
+        }
+    }
+    return {
+        previousVersion: result.previousVersion,
+        newVersion: result.newVersion,
+        added,
+        removed,
+        modified,
+        brokenSelectors: result.brokenSelectors.length,
+        totalChanges: result.changes.length,
+    };
+}
+//# sourceMappingURL=rescan-runner.js.map

package/dist/rescan/rescan-runner.js.map

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

package/dist/rescan/rescan-scheduler.d.ts

@@ -0,0 +1,42 @@
+export interface ScheduleEntry {
+    slug: string;
+    cronExpr: string;
+    partial: boolean;
+    nextRunAt: Date;
+    createdAt: Date;
+}
+export type RescanCallback = (slug: string, partial: boolean) => void | Promise<void>;
+/**
+ * In-memory scheduler for periodic site rescans.
+ * Checks every 60 seconds for due rescans and invokes the callback.
+ */
+export declare class RescanScheduler {
+    private schedules;
+    private timer;
+    private callback;
+    private running;
+    constructor(callback: RescanCallback);
+    /** Register or update a rescan schedule for a site slug. */
+    scheduleRescan(slug: string, cronExpr: string, partial?: boolean): void;
+    /** Cancel a pending rescan schedule. */
+    cancelRescan(slug: string): boolean;
+    /** Start the periodic checker (every 60s). */
+    start(): void;
+    /** Stop the periodic checker. */
+    stop(): void;
+    /** Visible for testing: run a single check cycle. */
+    tick(): Promise<void>;
+    /** Get all registered schedules (for introspection / testing). */
+    getSchedules(): ReadonlyMap<string, ScheduleEntry>;
+}
+/**
+ * Parse a simplified cron expression and compute the next run time after `after`.
+ *
+ * Supported format: "minute hour dayOfMonth month dayOfWeek"
+ *   - Each field can be a number or '*'
+ *   - Ranges (1-5), lists (1,3,5), and step values (*\/10) are supported for minute/hour
+ *
+ * Returns null if the expression is invalid.
+ */
+export declare function computeNextRun(cronExpr: string, after: Date): Date | null;
+//# sourceMappingURL=rescan-scheduler.d.ts.map

package/dist/rescan/rescan-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rescan-scheduler.d.ts","sourceRoot":"","sources":["../../src/rescan/rescan-scheduler.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEtF;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,OAAO,CAAS;gBAEZ,QAAQ,EAAE,cAAc;IAIpC,4DAA4D;IAC5D,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,UAAQ,GAAG,IAAI;IAgBrE,wCAAwC;IACxC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQnC,8CAA8C;IAC9C,KAAK,IAAI,IAAI;IASb,iCAAiC;IACjC,IAAI,IAAI,IAAI;IAUZ,qDAAqD;IAC/C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB3B,kEAAkE;IAClE,YAAY,IAAI,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC;CAGnD;AAID;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CA8CzE"}