@a5c-ai/genty-platform 5.1.1-staging.00ceebd28cf2

package/dist/plugins/validation.js

@@ -0,0 +1,117 @@
+"use strict";
+/**
+ * Plugin validation — structural checks for manifests and installed plugin
+ * directories.
+ *
+ * `validatePlugin` performs in-memory manifest validation.
+ * `diagnosePlugin` inspects the file-system layout of a plugin directory.
+ * `formatDiagnostics` renders issues into a human-readable report.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validatePlugin = validatePlugin;
+exports.diagnosePlugin = diagnosePlugin;
+exports.formatDiagnostics = formatDiagnostics;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+// ---------------------------------------------------------------------------
+// Manifest validation
+// ---------------------------------------------------------------------------
+const KNOWN_PERMISSIONS = new Set([
+    'fs:read',
+    'fs:write',
+    'net:outbound',
+    'process:spawn',
+    'env:read',
+    'mcp:connect',
+    'shell:execute',
+]);
+/**
+ * Validate a plugin manifest in memory.
+ * Returns errors (fatal) and warnings (non-fatal observations).
+ */
+function validatePlugin(manifest) {
+    const errors = [];
+    const warnings = [];
+    // Required string fields
+    if (!manifest.id || typeof manifest.id !== 'string') {
+        errors.push('Missing or invalid "id" field');
+    }
+    if (!manifest.name || typeof manifest.name !== 'string') {
+        errors.push('Missing or invalid "name" field');
+    }
+    if (!manifest.version || typeof manifest.version !== 'string') {
+        errors.push('Missing or invalid "version" field');
+    }
+    if (!manifest.entrypoint || typeof manifest.entrypoint !== 'string') {
+        errors.push('Missing or invalid "entrypoint" field');
+    }
+    // Permissions array
+    if (!Array.isArray(manifest.permissions)) {
+        errors.push('"permissions" must be an array');
+    }
+    else {
+        for (const perm of manifest.permissions) {
+            if (!KNOWN_PERMISSIONS.has(perm)) {
+                warnings.push(`Unknown permission "${perm}"`);
+            }
+        }
+    }
+    // Version format (basic check)
+    if (manifest.version) {
+        const parts = manifest.version.replace(/^v/, '').split('.');
+        if (parts.length < 3) {
+            warnings.push(`Version "${manifest.version}" is not standard semver`);
+        }
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+// ---------------------------------------------------------------------------
+// Directory diagnosis
+// ---------------------------------------------------------------------------
+/**
+ * Inspect a plugin directory on disk and return diagnostic entries.
+ */
+function diagnosePlugin(pluginDir) {
+    const entries = [];
+    if (!(0, node_fs_1.existsSync)(pluginDir)) {
+        entries.push({ level: 'error', message: `Plugin directory does not exist: ${pluginDir}` });
+        return entries;
+    }
+    // Check for manifest file
+    const manifestPath = (0, node_path_1.join)(pluginDir, 'plugin.json');
+    if (!(0, node_fs_1.existsSync)(manifestPath)) {
+        entries.push({ level: 'error', message: 'Missing plugin.json manifest' });
+    }
+    else {
+        entries.push({ level: 'info', message: 'plugin.json found' });
+    }
+    // Check for entrypoint (common patterns)
+    const commonEntrypoints = ['index.js', 'index.ts', 'dist/index.js'];
+    const hasEntry = commonEntrypoints.some((e) => (0, node_fs_1.existsSync)((0, node_path_1.join)(pluginDir, e)));
+    if (!hasEntry) {
+        entries.push({ level: 'warning', message: 'No common entrypoint found (index.js, index.ts, dist/index.js)' });
+    }
+    // Check for README
+    if (!(0, node_fs_1.existsSync)((0, node_path_1.join)(pluginDir, 'README.md'))) {
+        entries.push({ level: 'warning', message: 'No README.md found' });
+    }
+    return entries;
+}
+// ---------------------------------------------------------------------------
+// Formatting
+// ---------------------------------------------------------------------------
+const LEVEL_PREFIX = {
+    error: 'ERROR',
+    warning: 'WARN ',
+    info: 'INFO ',
+};
+/**
+ * Render diagnostic entries into a human-readable multi-line string.
+ */
+function formatDiagnostics(entries) {
+    if (entries.length === 0)
+        return 'No diagnostics.';
+    return entries
+        .map((e) => `[${LEVEL_PREFIX[e.level]}] ${e.message}`)
+        .join('\n');
+}

package/dist/plugins/version-check.d.ts

@@ -0,0 +1,23 @@
+/**
+ * PluginVersionChecker — simple semver compatibility checks for plugins.
+ *
+ * Compares a plugin manifest's `minPlatformVersion` against the current
+ * platform version to determine whether the plugin is compatible.
+ */
+import type { PluginManifest } from './types';
+export interface VersionCheckResult {
+    compatible: boolean;
+    issues: string[];
+}
+export declare class PluginVersionChecker {
+    /**
+     * Check whether a plugin manifest is compatible with the given platform
+     * version.
+     *
+     * When `minPlatformVersion` is not specified in the manifest the plugin
+     * is assumed compatible. Invalid version strings produce an issue but
+     * are treated as incompatible.
+     */
+    checkCompatibility(manifest: PluginManifest, platformVersion: string): VersionCheckResult;
+}
+//# sourceMappingURL=version-check.d.ts.map

package/dist/plugins/version-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-check.d.ts","sourceRoot":"","sources":["../../src/plugins/version-check.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAmCD,qBAAa,oBAAoB;IAC/B;;;;;;;OAOG;IACH,kBAAkB,CAChB,QAAQ,EAAE,cAAc,EACxB,eAAe,EAAE,MAAM,GACtB,kBAAkB;CAkCtB"}

package/dist/plugins/version-check.js

@@ -0,0 +1,70 @@
+"use strict";
+/**
+ * PluginVersionChecker — simple semver compatibility checks for plugins.
+ *
+ * Compares a plugin manifest's `minPlatformVersion` against the current
+ * platform version to determine whether the plugin is compatible.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PluginVersionChecker = void 0;
+/**
+ * Parse a version string in `major.minor.patch` format.
+ * Returns `undefined` if the string is not a valid semver triple.
+ */
+function parseSemVer(version) {
+    const cleaned = version.replace(/^v/, '');
+    const parts = cleaned.split('.');
+    if (parts.length < 3)
+        return undefined;
+    const major = parseInt(parts[0], 10);
+    const minor = parseInt(parts[1], 10);
+    // Strip pre-release / build metadata for comparison
+    const patch = parseInt(parts[2].split('-')[0], 10);
+    if (isNaN(major) || isNaN(minor) || isNaN(patch))
+        return undefined;
+    return { major, minor, patch };
+}
+/**
+ * Return `true` if `actual >= required` using standard semver ordering.
+ */
+function semverGte(actual, required) {
+    if (actual.major !== required.major)
+        return actual.major > required.major;
+    if (actual.minor !== required.minor)
+        return actual.minor > required.minor;
+    return actual.patch >= required.patch;
+}
+class PluginVersionChecker {
+    /**
+     * Check whether a plugin manifest is compatible with the given platform
+     * version.
+     *
+     * When `minPlatformVersion` is not specified in the manifest the plugin
+     * is assumed compatible. Invalid version strings produce an issue but
+     * are treated as incompatible.
+     */
+    checkCompatibility(manifest, platformVersion) {
+        const issues = [];
+        // If the manifest does not specify a minimum, it is compatible with any version
+        if (!manifest.minPlatformVersion) {
+            return { compatible: true, issues };
+        }
+        const required = parseSemVer(manifest.minPlatformVersion);
+        if (!required) {
+            issues.push(`Invalid minPlatformVersion "${manifest.minPlatformVersion}" in manifest for plugin "${manifest.id}"`);
+            return { compatible: false, issues };
+        }
+        const actual = parseSemVer(platformVersion);
+        if (!actual) {
+            issues.push(`Invalid platform version "${platformVersion}" — cannot verify compatibility`);
+            return { compatible: false, issues };
+        }
+        if (!semverGte(actual, required)) {
+            issues.push(`Plugin "${manifest.id}" requires platform >= ${manifest.minPlatformVersion}, ` +
+                `but current platform is ${platformVersion}`);
+            return { compatible: false, issues };
+        }
+        return { compatible: true, issues };
+    }
+}
+exports.PluginVersionChecker = PluginVersionChecker;

package/dist/plugins/versioning.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Plugin versioning — semver-aware update policy for installed plugins.
+ *
+ * Determines whether a plugin update should be applied automatically (patch),
+ * require user confirmation (minor), or be blocked until explicitly approved
+ * (major).
+ */
+export interface PluginVersion {
+    major: number;
+    minor: number;
+    patch: number;
+    preRelease?: string;
+}
+export type UpdateAction = 'auto' | 'prompt' | 'block';
+export interface UpdateCheckResult {
+    available: boolean;
+    currentVersion: string;
+    latestVersion: string;
+    action: UpdateAction;
+    reason: string;
+}
+/**
+ * Parse a semver string into a PluginVersion.
+ * Returns `undefined` for malformed strings.
+ */
+export declare function parseVersion(version: string): PluginVersion | undefined;
+/**
+ * Check whether an update is available and what action policy applies.
+ */
+export declare function checkForUpdate(currentVersionStr: string, latestVersionStr: string): UpdateCheckResult;
+/**
+ * Determine the update action for a version transition.
+ *
+ * Policy:
+ *  - patch change → auto
+ *  - minor change (same major) → prompt
+ *  - major change → block
+ */
+export declare function shouldAutoUpdate(current: PluginVersion, latest: PluginVersion): UpdateAction;
+//# sourceMappingURL=versioning.d.ts.map

package/dist/plugins/versioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioning.d.ts","sourceRoot":"","sources":["../../src/plugins/versioning.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEvD,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAYvE;AAmBD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,iBAAiB,EAAE,MAAM,EACzB,gBAAgB,EAAE,MAAM,GACvB,iBAAiB,CAsCnB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,aAAa,GACpB,YAAY,CAId"}

package/dist/plugins/versioning.js

@@ -0,0 +1,101 @@
+"use strict";
+/**
+ * Plugin versioning — semver-aware update policy for installed plugins.
+ *
+ * Determines whether a plugin update should be applied automatically (patch),
+ * require user confirmation (minor), or be blocked until explicitly approved
+ * (major).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseVersion = parseVersion;
+exports.checkForUpdate = checkForUpdate;
+exports.shouldAutoUpdate = shouldAutoUpdate;
+// ---------------------------------------------------------------------------
+// Parsing
+// ---------------------------------------------------------------------------
+/**
+ * Parse a semver string into a PluginVersion.
+ * Returns `undefined` for malformed strings.
+ */
+function parseVersion(version) {
+    const cleaned = version.replace(/^v/, '');
+    const [core, preRelease] = cleaned.split('-', 2);
+    const parts = core.split('.');
+    if (parts.length < 3)
+        return undefined;
+    const major = parseInt(parts[0], 10);
+    const minor = parseInt(parts[1], 10);
+    const patch = parseInt(parts[2], 10);
+    if (isNaN(major) || isNaN(minor) || isNaN(patch))
+        return undefined;
+    return { major, minor, patch, preRelease };
+}
+// ---------------------------------------------------------------------------
+// Comparison helpers
+// ---------------------------------------------------------------------------
+/**
+ * Return true if `a` is strictly less than `b` in semver ordering.
+ */
+function isOlderThan(a, b) {
+    if (a.major !== b.major)
+        return a.major < b.major;
+    if (a.minor !== b.minor)
+        return a.minor < b.minor;
+    return a.patch < b.patch;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Check whether an update is available and what action policy applies.
+ */
+function checkForUpdate(currentVersionStr, latestVersionStr) {
+    const current = parseVersion(currentVersionStr);
+    const latest = parseVersion(latestVersionStr);
+    if (!current || !latest) {
+        return {
+            available: false,
+            currentVersion: currentVersionStr,
+            latestVersion: latestVersionStr,
+            action: 'block',
+            reason: 'Unable to parse version string',
+        };
+    }
+    if (!isOlderThan(current, latest)) {
+        return {
+            available: false,
+            currentVersion: currentVersionStr,
+            latestVersion: latestVersionStr,
+            action: 'auto',
+            reason: 'Already up to date',
+        };
+    }
+    const action = shouldAutoUpdate(current, latest);
+    const reason = action === 'auto'
+        ? 'Patch update — applied automatically'
+        : action === 'prompt'
+            ? 'Minor update — user confirmation required'
+            : 'Major update — blocked until explicitly approved';
+    return {
+        available: true,
+        currentVersion: currentVersionStr,
+        latestVersion: latestVersionStr,
+        action,
+        reason,
+    };
+}
+/**
+ * Determine the update action for a version transition.
+ *
+ * Policy:
+ *  - patch change → auto
+ *  - minor change (same major) → prompt
+ *  - major change → block
+ */
+function shouldAutoUpdate(current, latest) {
+    if (latest.major > current.major)
+        return 'block';
+    if (latest.minor > current.minor)
+        return 'prompt';
+    return 'auto';
+}

package/dist/processes/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Process recommender module for L6 Agent-Platform.
+ *
+ * Provides process registration, criteria-based scoring, and
+ * recommendation of the most relevant processes for a given task.
+ */
+export type { ProcessDescriptor, RecommendationCriteria, ProcessRecommendation, } from './types';
+export { ProcessScorer } from './scorer';
+export type { ScoringResult } from './scorer';
+export { ProcessRecommender } from './recommender';
+export type { ProcessFilter } from './recommender';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/processes/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/processes/index.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * Process recommender module for L6 Agent-Platform.
+ *
+ * Provides process registration, criteria-based scoring, and
+ * recommendation of the most relevant processes for a given task.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProcessRecommender = exports.ProcessScorer = void 0;
+// Scorer
+var scorer_1 = require("./scorer");
+Object.defineProperty(exports, "ProcessScorer", { enumerable: true, get: function () { return scorer_1.ProcessScorer; } });
+// Recommender
+var recommender_1 = require("./recommender");
+Object.defineProperty(exports, "ProcessRecommender", { enumerable: true, get: function () { return recommender_1.ProcessRecommender; } });

package/dist/processes/recommender.d.ts

@@ -0,0 +1,36 @@
+/**
+ * ProcessRecommender — registers process descriptors and recommends
+ * the most relevant ones for a given set of criteria.
+ *
+ * Delegates scoring to {@link ProcessScorer} and exposes a simple
+ * registry + query API analogous to the sibling SkillRouter.
+ */
+import type { ProcessDescriptor, ProcessRecommendation, RecommendationCriteria } from './types';
+export interface ProcessFilter {
+    category?: string;
+    domain?: string;
+}
+export declare class ProcessRecommender {
+    private readonly registry;
+    private readonly scorer;
+    /** Register a single process descriptor. Replaces any existing entry with the same id. */
+    register(descriptor: ProcessDescriptor): void;
+    /** Register multiple descriptors at once. */
+    registerBatch(descriptors: ProcessDescriptor[]): void;
+    /**
+     * Score all registered processes against the given criteria and return
+     * the top results sorted by descending score. Processes that score 0
+     * are excluded.
+     */
+    recommend(criteria: RecommendationCriteria): ProcessRecommendation[];
+    /** Look up a process descriptor by its id. */
+    getById(id: string): ProcessDescriptor | undefined;
+    /**
+     * List all registered descriptors, optionally filtered by category
+     * and/or domain.
+     */
+    list(filter?: ProcessFilter): ProcessDescriptor[];
+    /** Return the number of registered process descriptors. */
+    get size(): number;
+}
+//# sourceMappingURL=recommender.d.ts.map

package/dist/processes/recommender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommender.d.ts","sourceRoot":"","sources":["../../src/processes/recommender.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,SAAS,CAAC;AAKjB,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwC;IACjE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAI9C,0FAA0F;IAC1F,QAAQ,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI;IAI7C,6CAA6C;IAC7C,aAAa,CAAC,WAAW,EAAE,iBAAiB,EAAE,GAAG,IAAI;IAQrD;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,sBAAsB,GAAG,qBAAqB,EAAE;IAepE,8CAA8C;IAC9C,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIlD;;;OAGG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,iBAAiB,EAAE;IAgBjD,2DAA2D;IAC3D,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/processes/recommender.js

@@ -0,0 +1,73 @@
+"use strict";
+/**
+ * ProcessRecommender — registers process descriptors and recommends
+ * the most relevant ones for a given set of criteria.
+ *
+ * Delegates scoring to {@link ProcessScorer} and exposes a simple
+ * registry + query API analogous to the sibling SkillRouter.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProcessRecommender = void 0;
+const scorer_1 = require("./scorer");
+const DEFAULT_MAX_RESULTS = 5;
+class ProcessRecommender {
+    registry = new Map();
+    scorer = new scorer_1.ProcessScorer();
+    // ── registration ─────────────────────────────────────────────────────────
+    /** Register a single process descriptor. Replaces any existing entry with the same id. */
+    register(descriptor) {
+        this.registry.set(descriptor.id, descriptor);
+    }
+    /** Register multiple descriptors at once. */
+    registerBatch(descriptors) {
+        for (const descriptor of descriptors) {
+            this.register(descriptor);
+        }
+    }
+    // ── queries ──────────────────────────────────────────────────────────────
+    /**
+     * Score all registered processes against the given criteria and return
+     * the top results sorted by descending score. Processes that score 0
+     * are excluded.
+     */
+    recommend(criteria) {
+        const maxResults = criteria.maxResults ?? DEFAULT_MAX_RESULTS;
+        const results = [];
+        for (const process of this.registry.values()) {
+            const { score, reasons } = this.scorer.score(process, criteria);
+            if (score > 0) {
+                results.push({ process, score, reasons });
+            }
+        }
+        results.sort((a, b) => b.score - a.score);
+        return results.slice(0, maxResults);
+    }
+    /** Look up a process descriptor by its id. */
+    getById(id) {
+        return this.registry.get(id);
+    }
+    /**
+     * List all registered descriptors, optionally filtered by category
+     * and/or domain.
+     */
+    list(filter) {
+        const all = Array.from(this.registry.values());
+        if (!filter) {
+            return all;
+        }
+        return all.filter((process) => {
+            if (filter.category && process.category !== filter.category) {
+                return false;
+            }
+            if (filter.domain && process.domain !== filter.domain) {
+                return false;
+            }
+            return true;
+        });
+    }
+    /** Return the number of registered process descriptors. */
+    get size() {
+        return this.registry.size;
+    }
+}
+exports.ProcessRecommender = ProcessRecommender;

package/dist/processes/scorer.d.ts

@@ -0,0 +1,26 @@
+/**
+ * ProcessScorer — computes a relevance score for a ProcessDescriptor
+ * against a set of RecommendationCriteria.
+ *
+ * Scoring factors:
+ *   1. Keyword overlap between criteria text and the process description,
+ *      task ids, inputs, and outputs.
+ *   2. Category bonus when the process category appears in the criteria text.
+ *   3. Domain bonus when criteria.domain matches process.domain.
+ *   4. Quality score multiplier (boosts/dampens the raw score).
+ */
+import type { ProcessDescriptor, RecommendationCriteria } from './types';
+export interface ScoringResult {
+    score: number;
+    reasons: string[];
+}
+export declare class ProcessScorer {
+    /**
+     * Score a single process against the given criteria.
+     *
+     * Returns a composite score >= 0 and an array of human-readable
+     * reason strings explaining what contributed to the score.
+     */
+    score(process: ProcessDescriptor, criteria: RecommendationCriteria): ScoringResult;
+}
+//# sourceMappingURL=scorer.d.ts.map

package/dist/processes/scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scorer.d.ts","sourceRoot":"","sources":["../../src/processes/scorer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAoCzE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,qBAAa,aAAa;IACxB;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,sBAAsB,GAAG,aAAa;CA6DnF"}

package/dist/processes/scorer.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * ProcessScorer — computes a relevance score for a ProcessDescriptor
+ * against a set of RecommendationCriteria.
+ *
+ * Scoring factors:
+ *   1. Keyword overlap between criteria text and the process description,
+ *      task ids, inputs, and outputs.
+ *   2. Category bonus when the process category appears in the criteria text.
+ *   3. Domain bonus when criteria.domain matches process.domain.
+ *   4. Quality score multiplier (boosts/dampens the raw score).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProcessScorer = void 0;
+// ── helpers ──────────────────────────────────────────────────────────────────
+/** Normalize text to a set of lowercase tokens for overlap scoring. */
+function tokenize(text) {
+    return new Set(text
+        .toLowerCase()
+        .split(/[\s,.\-_/|:;]+/)
+        .filter((token) => token.length > 1));
+}
+/** Count how many tokens from `query` appear in `corpus`. */
+function tokenOverlap(query, corpus) {
+    let count = 0;
+    for (const token of query) {
+        if (corpus.has(token)) {
+            count += 1;
+        }
+    }
+    return count;
+}
+// ── constants ────────────────────────────────────────────────────────────────
+const CATEGORY_BONUS = 10;
+const DOMAIN_BONUS = 15;
+/** Range for the quality multiplier: [MIN, MAX]. */
+const QUALITY_MULTIPLIER_MIN = 0.5;
+const QUALITY_MULTIPLIER_MAX = 1.5;
+class ProcessScorer {
+    /**
+     * Score a single process against the given criteria.
+     *
+     * Returns a composite score >= 0 and an array of human-readable
+     * reason strings explaining what contributed to the score.
+     */
+    score(process, criteria) {
+        let rawScore = 0;
+        const reasons = [];
+        // ── 1. Build query tokens from criteria ────────────────────────────
+        const queryParts = [criteria.taskDescription];
+        if (criteria.repoContext)
+            queryParts.push(criteria.repoContext);
+        if (criteria.capabilities)
+            queryParts.push(...criteria.capabilities);
+        const queryTokens = tokenize(queryParts.join(' '));
+        // ── 2. Build corpus tokens from process ────────────────────────────
+        const corpusParts = [process.name, process.description];
+        if (process.category)
+            corpusParts.push(process.category);
+        if (process.tasks)
+            corpusParts.push(...process.tasks);
+        if (process.inputs)
+            corpusParts.push(...process.inputs);
+        if (process.outputs)
+            corpusParts.push(...process.outputs);
+        const corpusTokens = tokenize(corpusParts.join(' '));
+        // ── 3. Keyword overlap ─────────────────────────────────────────────
+        if (queryTokens.size > 0 && corpusTokens.size > 0) {
+            const overlap = tokenOverlap(queryTokens, corpusTokens);
+            if (overlap > 0) {
+                const ratio = overlap / queryTokens.size;
+                const keywordScore = ratio * 100;
+                rawScore += keywordScore;
+                reasons.push(`keyword overlap ${overlap}/${queryTokens.size} (${Math.round(ratio * 100)}%)`);
+            }
+        }
+        // ── 4. Category bonus ──────────────────────────────────────────────
+        if (process.category) {
+            const categoryLower = process.category.toLowerCase();
+            const rawQuery = queryParts.join(' ').toLowerCase();
+            if (rawQuery.includes(categoryLower)) {
+                rawScore += CATEGORY_BONUS;
+                reasons.push(`category match "${process.category}"`);
+            }
+        }
+        // ── 5. Domain bonus ────────────────────────────────────────────────
+        if (criteria.domain &&
+            process.domain &&
+            criteria.domain.toLowerCase() === process.domain.toLowerCase()) {
+            rawScore += DOMAIN_BONUS;
+            reasons.push('domain match');
+        }
+        // ── 6. Quality multiplier ──────────────────────────────────────────
+        if (typeof process.qualityScore === 'number' && rawScore > 0) {
+            const clamped = Math.max(0, Math.min(1, process.qualityScore));
+            const multiplier = QUALITY_MULTIPLIER_MIN +
+                clamped * (QUALITY_MULTIPLIER_MAX - QUALITY_MULTIPLIER_MIN);
+            rawScore *= multiplier;
+            reasons.push(`quality multiplier x${multiplier.toFixed(2)}`);
+        }
+        return { score: Math.round(rawScore * 100) / 100, reasons };
+    }
+}
+exports.ProcessScorer = ProcessScorer;