@resolveio/server-lib 22.3.17 → 22.3.19

package/types/error-report.d.ts

@@ -1,25 +0,0 @@
-export interface ErrorReportAttachment {
-    name?: string;
-    url?: string;
-    contentType?: string;
-    size?: number;
-}
-export interface ErrorReportPayload {
-    clientId?: string;
-    clientName?: string;
-    clientRepo?: string;
-    clientEmail?: string;
-    clientSlug?: string;
-    sourceApp: string;
-    environment?: string;
-    severity?: string;
-    message: string;
-    stack?: string;
-    context?: Record<string, any>;
-    metadata?: Record<string, any>;
-    attachments?: ErrorReportAttachment[];
-    fingerprint?: string;
-    idempotencyKey?: string;
-    reportedBy?: string;
-    reportedAt?: Date;
-}

package/types/error-report.js

@@ -1,4 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-
-//# sourceMappingURL=error-report.js.map

package/types/error-report.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/types/error-report.ts"],"names":[],"mappings":"","file":"error-report.js","sourcesContent":["export interface ErrorReportAttachment {\n\tname?: string;\n\turl?: string;\n\tcontentType?: string;\n\tsize?: number;\n}\n\nexport interface ErrorReportPayload {\n\tclientId?: string;\n\tclientName?: string;\n\tclientRepo?: string;\n\tclientEmail?: string;\n\tclientSlug?: string;\n\tsourceApp: string;\n\tenvironment?: string;\n\tseverity?: string;\n\tmessage: string;\n\tstack?: string;\n\tcontext?: Record<string, any>;\n\tmetadata?: Record<string, any>;\n\tattachments?: ErrorReportAttachment[];\n\tfingerprint?: string;\n\tidempotencyKey?: string;\n\treportedBy?: string;\n\treportedAt?: Date;\n}\n"]}

package/types/slow-query-report.d.ts

@@ -1,27 +0,0 @@
-export type SlowQueryLogStatus = 'new' | 'investigating' | 'queued' | 'optimized' | 'ignored';
-export declare const slowQueryLogStatuses: SlowQueryLogStatus[];
-export interface SlowQueryReportPayload {
-    queryHash: string;
-    collection: string;
-    filter?: Record<string, any>;
-    options?: Record<string, any>;
-    durationMs: number;
-    maxDurationMs?: number;
-    thresholdMs?: number;
-    explainPlan?: Record<string, any>;
-    explainExecutionStats?: Record<string, any>;
-    explainGeneratedAt?: Date | string;
-    clientSlug?: string;
-    clientName?: string;
-    environment?: string;
-    sourceApp?: string;
-    nodeHostname?: string;
-    status?: SlowQueryLogStatus;
-    ignored?: boolean;
-    notes?: string;
-    pipeline?: Record<string, any>[];
-    server_url?: string;
-    publication?: string;
-    subscription_data?: any[];
-    userId?: string;
-}

package/types/slow-query-report.js

@@ -1,6 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.slowQueryLogStatuses = void 0;
-exports.slowQueryLogStatuses = ['new', 'investigating', 'queued', 'optimized', 'ignored'];
-
-//# sourceMappingURL=slow-query-report.js.map

package/types/slow-query-report.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/types/slow-query-report.ts"],"names":[],"mappings":";;;AACa,QAAA,oBAAoB,GAAyB,CAAC,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC","file":"slow-query-report.js","sourcesContent":["export type SlowQueryLogStatus = 'new' | 'investigating' | 'queued' | 'optimized' | 'ignored';\nexport const slowQueryLogStatuses: SlowQueryLogStatus[] = ['new', 'investigating', 'queued', 'optimized', 'ignored'];\n\nexport interface SlowQueryReportPayload {\n\tqueryHash: string;\n\tcollection: string;\n\tfilter?: Record<string, any>;\n\toptions?: Record<string, any>;\n\tdurationMs: number;\n\tmaxDurationMs?: number;\n\tthresholdMs?: number;\n\texplainPlan?: Record<string, any>;\n\texplainExecutionStats?: Record<string, any>;\n\texplainGeneratedAt?: Date | string;\n\tclientSlug?: string;\n\tclientName?: string;\n\tenvironment?: string;\n\tsourceApp?: string;\n\tnodeHostname?: string;\n\tstatus?: SlowQueryLogStatus;\n\tignored?: boolean;\n\tnotes?: string;\n\tpipeline?: Record<string, any>[];\n\tserver_url?: string;\n\tpublication?: string;\n\tsubscription_data?: any[];\n\tuserId?: string;\n}\n"]}

package/util/ai-qa-policy.d.ts

@@ -1,66 +0,0 @@
-export type ResolveIOQaPolicyContext = 'support_ticket' | 'aicoder_dashboard' | 'ai_terminal' | 'general';
-export interface ResolveIOQaPolicyOptions {
-    context?: ResolveIOQaPolicyContext;
-    includeDevServerRules?: boolean;
-    qaRepairEnabled?: boolean;
-    qaEvidenceRequired?: boolean;
-    qaDistinctScreenshotRequired?: boolean;
-    qaFailFastCompile?: boolean;
-    qaLiveDataRequired?: boolean;
-    qaSelfRepairMaxWaves?: number;
-    currentRoute?: string;
-    currentContextMode?: string;
-    customInstructions?: string[];
-}
-export interface ResolveIORunnerBasicsOptions extends ResolveIOQaPolicyOptions {
-    includeQaPolicy?: boolean;
-    includeTokenDiscipline?: boolean;
-    includeDependencyBootstrap?: boolean;
-    includeRepairLoop?: boolean;
-    includeEvidenceContract?: boolean;
-    maxContextBullets?: number;
-    maxRepairWaves?: number;
-}
-export interface ResolveIORunnerPromptInput extends ResolveIORunnerBasicsOptions {
-    objective?: string;
-    blockers?: string[];
-    relevantFiles?: string[];
-    evidence?: string[];
-    priorSummary?: string;
-    latestFailure?: string;
-    maxBlockers?: number;
-    maxFiles?: number;
-    maxEvidence?: number;
-    maxTextChars?: number;
-}
-export interface ResolveIORunnerContract {
-    context: ResolveIOQaPolicyContext;
-    sections: {
-        runnerBasics: string[];
-        tokenDiscipline: string[];
-        dependencyBootstrap: string[];
-        repairLoop: string[];
-        qaPolicy: string[];
-        evidenceContract: string[];
-        finalNotes: string[];
-    };
-    rules: string[];
-    promptLines: string[];
-}
-export interface ResolveIORunnerPromptBundle extends ResolveIORunnerContract {
-    objective: string;
-    contextLines: string[];
-    repairLines: string[];
-    fullPromptLines: string[];
-}
-export declare function normalizeResolveIOQaPolicyOptions(options?: ResolveIOQaPolicyOptions): Required<Omit<ResolveIOQaPolicyOptions, 'currentRoute' | 'currentContextMode' | 'customInstructions'>> & {
-    currentRoute: string;
-    currentContextMode: string;
-    customInstructions: string[];
-};
-export declare function buildResolveIOQaPolicyRules(options?: ResolveIOQaPolicyOptions): string[];
-export declare function buildResolveIORunnerBasicsRules(options?: ResolveIORunnerBasicsOptions): string[];
-export declare function buildResolveIORunnerContract(options?: ResolveIORunnerBasicsOptions): ResolveIORunnerContract;
-export declare function buildResolveIORunnerPromptLines(options?: ResolveIORunnerBasicsOptions): string[];
-export declare function buildResolveIORunnerPromptBundle(input?: ResolveIORunnerPromptInput): ResolveIORunnerPromptBundle;
-export declare function buildResolveIORunnerRepairPromptLines(input?: ResolveIORunnerPromptInput): string[];

package/util/ai-qa-policy.js

@@ -1,250 +0,0 @@
-"use strict";
-var __assign = (this && this.__assign) || function () {
-    __assign = Object.assign || function(t) {
-        for (var s, i = 1, n = arguments.length; i < n; i++) {
-            s = arguments[i];
-            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
-                t[p] = s[p];
-        }
-        return t;
-    };
-    return __assign.apply(this, arguments);
-};
-var __values = (this && this.__values) || function(o) {
-    var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
-    if (m) return m.call(o);
-    if (o && typeof o.length === "number") return {
-        next: function () {
-            if (o && i >= o.length) o = void 0;
-            return { value: o && o[i++], done: !o };
-        }
-    };
-    throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
-};
-var __read = (this && this.__read) || function (o, n) {
-    var m = typeof Symbol === "function" && o[Symbol.iterator];
-    if (!m) return o;
-    var i = m.call(o), r, ar = [], e;
-    try {
-        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
-    }
-    catch (error) { e = { error: error }; }
-    finally {
-        try {
-            if (r && !r.done && (m = i["return"])) m.call(i);
-        }
-        finally { if (e) throw e.error; }
-    }
-    return ar;
-};
-var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
-    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
-        if (ar || !(i in from)) {
-            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
-            ar[i] = from[i];
-        }
-    }
-    return to.concat(ar || Array.prototype.slice.call(from));
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.normalizeResolveIOQaPolicyOptions = normalizeResolveIOQaPolicyOptions;
-exports.buildResolveIOQaPolicyRules = buildResolveIOQaPolicyRules;
-exports.buildResolveIORunnerBasicsRules = buildResolveIORunnerBasicsRules;
-exports.buildResolveIORunnerContract = buildResolveIORunnerContract;
-exports.buildResolveIORunnerPromptLines = buildResolveIORunnerPromptLines;
-exports.buildResolveIORunnerPromptBundle = buildResolveIORunnerPromptBundle;
-exports.buildResolveIORunnerRepairPromptLines = buildResolveIORunnerRepairPromptLines;
-function normalizeOptionalString(value) {
-    return String(value || '').replace(/\s+/g, ' ').trim();
-}
-function normalizePositiveInteger(value, fallback, min, max) {
-    var numeric = Number(value);
-    if (!Number.isFinite(numeric)) {
-        return fallback;
-    }
-    var rounded = Number(numeric.toFixed(0));
-    return Math.max(min, Math.min(max, rounded));
-}
-function normalizeTextLine(value, maxChars) {
-    return normalizeOptionalString(value).slice(0, maxChars).trim();
-}
-function normalizeTextList(values, limit, maxChars) {
-    var e_1, _a;
-    if (!Array.isArray(values)) {
-        return [];
-    }
-    var result = [];
-    try {
-        for (var values_1 = __values(values), values_1_1 = values_1.next(); !values_1_1.done; values_1_1 = values_1.next()) {
-            var value = values_1_1.value;
-            var normalized = normalizeTextLine(value, maxChars);
-            if (normalized && !result.includes(normalized)) {
-                result.push(normalized);
-            }
-            if (result.length >= limit) {
-                break;
-            }
-        }
-    }
-    catch (e_1_1) { e_1 = { error: e_1_1 }; }
-    finally {
-        try {
-            if (values_1_1 && !values_1_1.done && (_a = values_1.return)) _a.call(values_1);
-        }
-        finally { if (e_1) throw e_1.error; }
-    }
-    return result;
-}
-function normalizeResolveIOQaPolicyOptions(options) {
-    if (options === void 0) { options = {}; }
-    return {
-        context: options.context || 'general',
-        includeDevServerRules: options.includeDevServerRules === true,
-        qaRepairEnabled: options.qaRepairEnabled !== false,
-        qaEvidenceRequired: options.qaEvidenceRequired !== false,
-        qaDistinctScreenshotRequired: options.qaDistinctScreenshotRequired !== false,
-        qaFailFastCompile: options.qaFailFastCompile !== false,
-        qaLiveDataRequired: options.qaLiveDataRequired !== false,
-        qaSelfRepairMaxWaves: normalizePositiveInteger(options.qaSelfRepairMaxWaves, 3, 1, 6),
-        currentRoute: normalizeOptionalString(options.currentRoute),
-        currentContextMode: normalizeOptionalString(options.currentContextMode),
-        customInstructions: Array.isArray(options.customInstructions)
-            ? options.customInstructions.map(normalizeOptionalString).filter(Boolean).slice(0, 12)
-            : []
-    };
-}
-function buildResolveIOQaPolicyRules(options) {
-    if (options === void 0) { options = {}; }
-    var policy = normalizeResolveIOQaPolicyOptions(options);
-    var rules = [];
-    if (policy.includeDevServerRules) {
-        rules.push('When browser/localhost QA needs long-running commands like `npm run server`, `npm run client`, `npm run dev`, `ng serve`, `vite`, or `nodemon`, start them as managed background processes with log files and PIDs; do not leave foreground dev-server commands as the active shell tool.', 'Before localhost/browser QA, source `.resolveio-support-tools/env.sh` when present. It supplies shared EC2 browser cache settings, `PUPPETEER_EXECUTABLE_PATH`/`CHROME_BIN`, Mongo wrappers, and `RESOLVEIO_SUPPORT_QA_CLIENT_PORT`/`RESOLVEIO_SUPPORT_QA_CLIENT_URL` for non-conflicting client ports.', 'When launching Puppeteer or Playwright on workers, pass `executablePath: process.env.PUPPETEER_EXECUTABLE_PATH || process.env.CHROME_BIN` if either env var is set. Do not download a fresh browser before checking these env vars and `PUPPETEER_CACHE_DIR`.', 'Use the managed-server pattern for localhost QA: `command > .build-output/<name>.log 2>&1 & PID=$!; trap "kill $PID 2>/dev/null || true" EXIT; wait for the port with curl; run browser checks; then kill/wait the PID`. Prefer `npm run client` or `./start_client.sh`; those scripts honor `RESOLVEIO_SUPPORT_QA_CLIENT_PORT` and `PORT`. Never run `ng serve ... | tee ...` or another dev server as a foreground command.');
-    }
-    if (policy.qaFailFastCompile) {
-        rules.push('Before browser QA, run the fastest compile/type/startup checks that can prove the app can load. Fix compile/startup failures before launching browser QA.');
-    }
-    if (policy.qaRepairEnabled) {
-        rules.push("If compile, startup, browser, or live-data QA fails, run a targeted repair wave for the exact failing route/action/data state, then rerun that same failed step before continuing. Limit self-repair to ".concat(policy.qaSelfRepairMaxWaves, " focused waves before returning the precise blocker."));
-    }
-    if (policy.qaLiveDataRequired) {
-        rules.push('For bug fixes and data/publication changes, test against available live app data or a faithful seeded record; do not rely only on static inspection when the user reported a runtime workflow problem.');
-    }
-    if (policy.qaDistinctScreenshotRequired) {
-        rules.push('Capture one screenshot or trace for each distinct changed customer-facing feature, screen, workflow state, or data result. Do not repeat equivalent screenshots for multiple records unless record-specific behavior changed.');
-    }
-    if (policy.qaEvidenceRequired) {
-        rules.push('Final notes must list the exact QA command, route, account/data used, screenshot/trace/log paths, and result for each changed behavior; if browser QA is not applicable, say why and provide the compile/data proof used instead.');
-    }
-    if (policy.currentRoute) {
-        rules.push("Current app context route from the AI terminal is ".concat(policy.currentRoute).concat(policy.currentContextMode ? " (".concat(policy.currentContextMode, ")") : '', "; start QA there when the request refers to this page or current screen."));
-    }
-    rules.push.apply(rules, __spreadArray([], __read(policy.customInstructions), false));
-    return rules;
-}
-function buildResolveIORunnerBasicsRules(options) {
-    if (options === void 0) { options = {}; }
-    return buildResolveIORunnerContract(options).rules;
-}
-function buildResolveIORunnerContract(options) {
-    var _a;
-    if (options === void 0) { options = {}; }
-    var maxContextBullets = normalizePositiveInteger(options.maxContextBullets, 8, 3, 20);
-    var maxRepairWaves = normalizePositiveInteger((_a = options.maxRepairWaves) !== null && _a !== void 0 ? _a : options.qaSelfRepairMaxWaves, 3, 1, 6);
-    var context = options.context || 'general';
-    var runnerBasics = [
-        'Use repo-local patterns first: read the closest existing implementation, matching tests, model/schema, method/publication, and UI route before editing.',
-        'Make the smallest complete change that satisfies the request; avoid broad refactors, config churn, dependency changes, and generated-file edits unless the workflow explicitly requires regeneration.',
-        'Before returning, state what changed, how it was verified, remaining blockers, and exact artifact paths in final notes.'
-    ];
-    var tokenDiscipline = options.includeTokenDiscipline !== false
-        ? [
-            "Keep context lean: summarize prior history into at most ".concat(maxContextBullets, " bullets, retrieve specific files on demand, and do not paste full logs, lockfiles, generated files, or stale ticket/email chains unless they are the current blocker evidence."),
-            'Prefer targeted search/read commands over loading broad directories. If a command returns noisy output, summarize the useful lines and continue with narrower reads.',
-            'On retries, carry only the active blocker contract, changed-file list, relevant diff/evidence summary, and latest failing command output. Do not restart with a clean-slate mega prompt.',
-            'Stop autonomous retries when the same normalized blocker repeats without meaningful diff or evidence improvement; park with a precise blocker instead of burning tokens.'
-        ]
-        : [];
-    var dependencyBootstrap = options.includeDependencyBootstrap !== false
-        ? [
-            'Reuse existing dependency caches and hydrated node_modules when available. Prefer npm install --force with the configured npm cache; do not use npm ci unless the workflow explicitly requires it.',
-            'Before reinstalling or downloading browsers, check the existing workspace cache, shared node_modules, PUPPETEER_EXECUTABLE_PATH, CHROME_BIN, PUPPETEER_CACHE_DIR, and project-provided bootstrap scripts.'
-        ]
-        : [];
-    var repairLoop = options.includeRepairLoop !== false
-        ? [
-            "Use targeted repair waves: compile/startup blocker, browser route/action blocker, data/publication blocker, and review blocker each get a focused repair, then rerun the exact failed step. Limit this to ".concat(maxRepairWaves, " focused waves before returning a precise blocker."),
-            'Repair all instances of a detected blocker class in the touched scope, not only the first occurrence.'
-        ]
-        : [];
-    var qaPolicy = options.includeQaPolicy !== false
-        ? buildResolveIOQaPolicyRules(__assign(__assign({}, options), { qaSelfRepairMaxWaves: maxRepairWaves }))
-        : [];
-    var evidenceContract = options.includeEvidenceContract !== false
-        ? [
-            'Evidence must be customer/workflow oriented: routes, buttons, pages, data states, screenshots/traces, command results, and assertions. Do not expose internal file names, backend paths, stack traces, or implementation chatter in customer-facing text.',
-            'For UI-facing changes, capture one screenshot or trace per distinct changed feature/workflow; for data-only changes, provide live-data or seeded-data assertion proof.'
-        ]
-        : [];
-    var finalNotes = [
-        'Final notes must include: changed behavior, touched functional areas, exact commands run, exact QA route/data state, screenshot/trace/log paths, and remaining blockers if any.',
-        'If work is parked, final notes must name the blocker class, last failing command/artifact, why another autonomous attempt would repeat, and the smallest manual action needed.'
-    ];
-    var sections = {
-        runnerBasics: runnerBasics,
-        tokenDiscipline: tokenDiscipline,
-        dependencyBootstrap: dependencyBootstrap,
-        repairLoop: repairLoop,
-        qaPolicy: qaPolicy,
-        evidenceContract: evidenceContract,
-        finalNotes: finalNotes
-    };
-    var rules = __spreadArray(__spreadArray(__spreadArray(__spreadArray(__spreadArray(__spreadArray(__spreadArray([], __read(runnerBasics), false), __read(tokenDiscipline), false), __read(dependencyBootstrap), false), __read(repairLoop), false), __read(qaPolicy), false), __read(evidenceContract), false), __read(finalNotes), false);
-    var promptLines = __spreadArray([
-        "ResolveIO shared runner contract (".concat(context, "):")
-    ], __read(rules.map(function (rule) { return "- ".concat(rule); })), false);
-    return {
-        context: context,
-        sections: sections,
-        rules: rules,
-        promptLines: promptLines
-    };
-}
-function buildResolveIORunnerPromptLines(options) {
-    if (options === void 0) { options = {}; }
-    return buildResolveIORunnerContract(options).promptLines;
-}
-function buildResolveIORunnerPromptBundle(input) {
-    if (input === void 0) { input = {}; }
-    var contract = buildResolveIORunnerContract(input);
-    var maxTextChars = normalizePositiveInteger(input.maxTextChars, 900, 160, 2400);
-    var objective = normalizeTextLine(input.objective, maxTextChars)
-        || 'Complete the requested ResolveIO runner task with minimal, verified changes.';
-    var priorSummary = normalizeTextLine(input.priorSummary, maxTextChars);
-    var latestFailure = normalizeTextLine(input.latestFailure, maxTextChars);
-    var blockers = normalizeTextList(input.blockers, normalizePositiveInteger(input.maxBlockers, 5, 1, 12), maxTextChars);
-    var relevantFiles = normalizeTextList(input.relevantFiles, normalizePositiveInteger(input.maxFiles, 12, 1, 30), 260);
-    var evidence = normalizeTextList(input.evidence, normalizePositiveInteger(input.maxEvidence, 8, 1, 20), maxTextChars);
-    var contextLines = __spreadArray(__spreadArray(__spreadArray(__spreadArray(__spreadArray([
-        "Objective: ".concat(objective)
-    ], __read((priorSummary ? ["Prior summary: ".concat(priorSummary)] : [])), false), __read((latestFailure ? ["Latest failure: ".concat(latestFailure)] : [])), false), __read((blockers.length ? __spreadArray(['Active blockers:'], __read(blockers.map(function (line) { return "- ".concat(line); })), false) : [])), false), __read((relevantFiles.length ? __spreadArray(['Relevant files:'], __read(relevantFiles.map(function (line) { return "- ".concat(line); })), false) : [])), false), __read((evidence.length ? __spreadArray(['Known evidence:'], __read(evidence.map(function (line) { return "- ".concat(line); })), false) : [])), false);
-    var repairLines = blockers.length
-        ? [
-            'Mandatory repair contract:',
-            '- Address each active blocker before unrelated work.',
-            '- For each blocker, mark resolved, proven false, or blocked.',
-            '- Attach code, data, command, browser, screenshot, or trace proof for each blocker.',
-            '- If a blocker repeats with no meaningful diff/evidence change, park instead of starting another broad attempt.'
-        ]
-        : [];
-    var fullPromptLines = __spreadArray(__spreadArray(__spreadArray(__spreadArray([], __read(contract.promptLines), false), [
-        '',
-        'Runner task context:'
-    ], false), __read(contextLines), false), __read((repairLines.length ? __spreadArray([''], __read(repairLines), false) : [])), false);
-    return __assign(__assign({}, contract), { objective: objective, contextLines: contextLines, repairLines: repairLines, fullPromptLines: fullPromptLines });
-}
-function buildResolveIORunnerRepairPromptLines(input) {
-    if (input === void 0) { input = {}; }
-    return buildResolveIORunnerPromptBundle(input).repairLines;
-}
-
-//# sourceMappingURL=ai-qa-policy.js.map

package/util/ai-qa-policy.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/util/ai-qa-policy.ts"],"names":[],"mappings":"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","file":"ai-qa-policy.js","sourcesContent":["export type ResolveIOQaPolicyContext =\n\t| 'support_ticket'\n\t| 'aicoder_dashboard'\n\t| 'ai_terminal'\n\t| 'general';\n\nexport interface ResolveIOQaPolicyOptions {\n\tcontext?: ResolveIOQaPolicyContext;\n\tincludeDevServerRules?: boolean;\n\tqaRepairEnabled?: boolean;\n\tqaEvidenceRequired?: boolean;\n\tqaDistinctScreenshotRequired?: boolean;\n\tqaFailFastCompile?: boolean;\n\tqaLiveDataRequired?: boolean;\n\tqaSelfRepairMaxWaves?: number;\n\tcurrentRoute?: string;\n\tcurrentContextMode?: string;\n\tcustomInstructions?: string[];\n}\n\nexport interface ResolveIORunnerBasicsOptions extends ResolveIOQaPolicyOptions {\n\tincludeQaPolicy?: boolean;\n\tincludeTokenDiscipline?: boolean;\n\tincludeDependencyBootstrap?: boolean;\n\tincludeRepairLoop?: boolean;\n\tincludeEvidenceContract?: boolean;\n\tmaxContextBullets?: number;\n\tmaxRepairWaves?: number;\n}\n\nexport interface ResolveIORunnerPromptInput extends ResolveIORunnerBasicsOptions {\n\tobjective?: string;\n\tblockers?: string[];\n\trelevantFiles?: string[];\n\tevidence?: string[];\n\tpriorSummary?: string;\n\tlatestFailure?: string;\n\tmaxBlockers?: number;\n\tmaxFiles?: number;\n\tmaxEvidence?: number;\n\tmaxTextChars?: number;\n}\n\nexport interface ResolveIORunnerContract {\n\tcontext: ResolveIOQaPolicyContext;\n\tsections: {\n\t\trunnerBasics: string[];\n\t\ttokenDiscipline: string[];\n\t\tdependencyBootstrap: string[];\n\t\trepairLoop: string[];\n\t\tqaPolicy: string[];\n\t\tevidenceContract: string[];\n\t\tfinalNotes: string[];\n\t};\n\trules: string[];\n\tpromptLines: string[];\n}\n\nexport interface ResolveIORunnerPromptBundle extends ResolveIORunnerContract {\n\tobjective: string;\n\tcontextLines: string[];\n\trepairLines: string[];\n\tfullPromptLines: string[];\n}\n\nfunction normalizeOptionalString(value: any): string {\n\treturn String(value || '').replace(/\\s+/g, ' ').trim();\n}\n\nfunction normalizePositiveInteger(value: any, fallback: number, min: number, max: number): number {\n\tconst numeric = Number(value);\n\tif (!Number.isFinite(numeric)) {\n\t\treturn fallback;\n\t}\n\tconst rounded = Number(numeric.toFixed(0));\n\treturn Math.max(min, Math.min(max, rounded));\n}\n\nfunction normalizeTextLine(value: any, maxChars: number): string {\n\treturn normalizeOptionalString(value).slice(0, maxChars).trim();\n}\n\nfunction normalizeTextList(values: any, limit: number, maxChars: number): string[] {\n\tif (!Array.isArray(values)) {\n\t\treturn [];\n\t}\n\tconst result: string[] = [];\n\tfor (const value of values) {\n\t\tconst normalized = normalizeTextLine(value, maxChars);\n\t\tif (normalized && !result.includes(normalized)) {\n\t\t\tresult.push(normalized);\n\t\t}\n\t\tif (result.length >= limit) {\n\t\t\tbreak;\n\t\t}\n\t}\n\treturn result;\n}\n\nexport function normalizeResolveIOQaPolicyOptions(options: ResolveIOQaPolicyOptions = {}): Required<Omit<ResolveIOQaPolicyOptions, 'currentRoute' | 'currentContextMode' | 'customInstructions'>> & {\n\tcurrentRoute: string;\n\tcurrentContextMode: string;\n\tcustomInstructions: string[];\n} {\n\treturn {\n\t\tcontext: options.context || 'general',\n\t\tincludeDevServerRules: options.includeDevServerRules === true,\n\t\tqaRepairEnabled: options.qaRepairEnabled !== false,\n\t\tqaEvidenceRequired: options.qaEvidenceRequired !== false,\n\t\tqaDistinctScreenshotRequired: options.qaDistinctScreenshotRequired !== false,\n\t\tqaFailFastCompile: options.qaFailFastCompile !== false,\n\t\tqaLiveDataRequired: options.qaLiveDataRequired !== false,\n\t\tqaSelfRepairMaxWaves: normalizePositiveInteger(options.qaSelfRepairMaxWaves, 3, 1, 6),\n\t\tcurrentRoute: normalizeOptionalString(options.currentRoute),\n\t\tcurrentContextMode: normalizeOptionalString(options.currentContextMode),\n\t\tcustomInstructions: Array.isArray(options.customInstructions)\n\t\t\t? options.customInstructions.map(normalizeOptionalString).filter(Boolean).slice(0, 12)\n\t\t\t: []\n\t};\n}\n\nexport function buildResolveIOQaPolicyRules(options: ResolveIOQaPolicyOptions = {}): string[] {\n\tconst policy = normalizeResolveIOQaPolicyOptions(options);\n\tconst rules: string[] = [];\n\tif (policy.includeDevServerRules) {\n\t\trules.push(\n\t\t\t'When browser/localhost QA needs long-running commands like `npm run server`, `npm run client`, `npm run dev`, `ng serve`, `vite`, or `nodemon`, start them as managed background processes with log files and PIDs; do not leave foreground dev-server commands as the active shell tool.',\n\t\t\t'Before localhost/browser QA, source `.resolveio-support-tools/env.sh` when present. It supplies shared EC2 browser cache settings, `PUPPETEER_EXECUTABLE_PATH`/`CHROME_BIN`, Mongo wrappers, and `RESOLVEIO_SUPPORT_QA_CLIENT_PORT`/`RESOLVEIO_SUPPORT_QA_CLIENT_URL` for non-conflicting client ports.',\n\t\t\t'When launching Puppeteer or Playwright on workers, pass `executablePath: process.env.PUPPETEER_EXECUTABLE_PATH || process.env.CHROME_BIN` if either env var is set. Do not download a fresh browser before checking these env vars and `PUPPETEER_CACHE_DIR`.',\n\t\t\t'Use the managed-server pattern for localhost QA: `command > .build-output/<name>.log 2>&1 & PID=$!; trap \"kill $PID 2>/dev/null || true\" EXIT; wait for the port with curl; run browser checks; then kill/wait the PID`. Prefer `npm run client` or `./start_client.sh`; those scripts honor `RESOLVEIO_SUPPORT_QA_CLIENT_PORT` and `PORT`. Never run `ng serve ... | tee ...` or another dev server as a foreground command.'\n\t\t);\n\t}\n\tif (policy.qaFailFastCompile) {\n\t\trules.push('Before browser QA, run the fastest compile/type/startup checks that can prove the app can load. Fix compile/startup failures before launching browser QA.');\n\t}\n\tif (policy.qaRepairEnabled) {\n\t\trules.push(`If compile, startup, browser, or live-data QA fails, run a targeted repair wave for the exact failing route/action/data state, then rerun that same failed step before continuing. Limit self-repair to ${policy.qaSelfRepairMaxWaves} focused waves before returning the precise blocker.`);\n\t}\n\tif (policy.qaLiveDataRequired) {\n\t\trules.push('For bug fixes and data/publication changes, test against available live app data or a faithful seeded record; do not rely only on static inspection when the user reported a runtime workflow problem.');\n\t}\n\tif (policy.qaDistinctScreenshotRequired) {\n\t\trules.push('Capture one screenshot or trace for each distinct changed customer-facing feature, screen, workflow state, or data result. Do not repeat equivalent screenshots for multiple records unless record-specific behavior changed.');\n\t}\n\tif (policy.qaEvidenceRequired) {\n\t\trules.push('Final notes must list the exact QA command, route, account/data used, screenshot/trace/log paths, and result for each changed behavior; if browser QA is not applicable, say why and provide the compile/data proof used instead.');\n\t}\n\tif (policy.currentRoute) {\n\t\trules.push(`Current app context route from the AI terminal is ${policy.currentRoute}${policy.currentContextMode ? ` (${policy.currentContextMode})` : ''}; start QA there when the request refers to this page or current screen.`);\n\t}\n\trules.push(...policy.customInstructions);\n\treturn rules;\n}\n\nexport function buildResolveIORunnerBasicsRules(options: ResolveIORunnerBasicsOptions = {}): string[] {\n\treturn buildResolveIORunnerContract(options).rules;\n}\n\nexport function buildResolveIORunnerContract(options: ResolveIORunnerBasicsOptions = {}): ResolveIORunnerContract {\n\tconst maxContextBullets = normalizePositiveInteger(options.maxContextBullets, 8, 3, 20);\n\tconst maxRepairWaves = normalizePositiveInteger(\n\t\toptions.maxRepairWaves ?? options.qaSelfRepairMaxWaves,\n\t\t3,\n\t\t1,\n\t\t6\n\t);\n\tconst context = options.context || 'general';\n\tconst runnerBasics = [\n\t\t'Use repo-local patterns first: read the closest existing implementation, matching tests, model/schema, method/publication, and UI route before editing.',\n\t\t'Make the smallest complete change that satisfies the request; avoid broad refactors, config churn, dependency changes, and generated-file edits unless the workflow explicitly requires regeneration.',\n\t\t'Before returning, state what changed, how it was verified, remaining blockers, and exact artifact paths in final notes.'\n\t];\n\tconst tokenDiscipline = options.includeTokenDiscipline !== false\n\t\t? [\n\t\t\t`Keep context lean: summarize prior history into at most ${maxContextBullets} bullets, retrieve specific files on demand, and do not paste full logs, lockfiles, generated files, or stale ticket/email chains unless they are the current blocker evidence.`,\n\t\t\t'Prefer targeted search/read commands over loading broad directories. If a command returns noisy output, summarize the useful lines and continue with narrower reads.',\n\t\t\t'On retries, carry only the active blocker contract, changed-file list, relevant diff/evidence summary, and latest failing command output. Do not restart with a clean-slate mega prompt.',\n\t\t\t'Stop autonomous retries when the same normalized blocker repeats without meaningful diff or evidence improvement; park with a precise blocker instead of burning tokens.'\n\t\t]\n\t\t: [];\n\tconst dependencyBootstrap = options.includeDependencyBootstrap !== false\n\t\t? [\n\t\t\t'Reuse existing dependency caches and hydrated node_modules when available. Prefer npm install --force with the configured npm cache; do not use npm ci unless the workflow explicitly requires it.',\n\t\t\t'Before reinstalling or downloading browsers, check the existing workspace cache, shared node_modules, PUPPETEER_EXECUTABLE_PATH, CHROME_BIN, PUPPETEER_CACHE_DIR, and project-provided bootstrap scripts.'\n\t\t]\n\t\t: [];\n\tconst repairLoop = options.includeRepairLoop !== false\n\t\t? [\n\t\t\t`Use targeted repair waves: compile/startup blocker, browser route/action blocker, data/publication blocker, and review blocker each get a focused repair, then rerun the exact failed step. Limit this to ${maxRepairWaves} focused waves before returning a precise blocker.`,\n\t\t\t'Repair all instances of a detected blocker class in the touched scope, not only the first occurrence.'\n\t\t]\n\t\t: [];\n\tconst qaPolicy = options.includeQaPolicy !== false\n\t\t? buildResolveIOQaPolicyRules({\n\t\t\t...options,\n\t\t\tqaSelfRepairMaxWaves: maxRepairWaves\n\t\t})\n\t\t: [];\n\tconst evidenceContract = options.includeEvidenceContract !== false\n\t\t? [\n\t\t\t'Evidence must be customer/workflow oriented: routes, buttons, pages, data states, screenshots/traces, command results, and assertions. Do not expose internal file names, backend paths, stack traces, or implementation chatter in customer-facing text.',\n\t\t\t'For UI-facing changes, capture one screenshot or trace per distinct changed feature/workflow; for data-only changes, provide live-data or seeded-data assertion proof.'\n\t\t]\n\t\t: [];\n\tconst finalNotes = [\n\t\t'Final notes must include: changed behavior, touched functional areas, exact commands run, exact QA route/data state, screenshot/trace/log paths, and remaining blockers if any.',\n\t\t'If work is parked, final notes must name the blocker class, last failing command/artifact, why another autonomous attempt would repeat, and the smallest manual action needed.'\n\t];\n\tconst sections = {\n\t\trunnerBasics,\n\t\ttokenDiscipline,\n\t\tdependencyBootstrap,\n\t\trepairLoop,\n\t\tqaPolicy,\n\t\tevidenceContract,\n\t\tfinalNotes\n\t};\n\tconst rules = [\n\t\t...runnerBasics,\n\t\t...tokenDiscipline,\n\t\t...dependencyBootstrap,\n\t\t...repairLoop,\n\t\t...qaPolicy,\n\t\t...evidenceContract,\n\t\t...finalNotes\n\t];\n\tconst promptLines = [\n\t\t`ResolveIO shared runner contract (${context}):`,\n\t\t...rules.map((rule) => `- ${rule}`)\n\t];\n\treturn {\n\t\tcontext,\n\t\tsections,\n\t\trules,\n\t\tpromptLines\n\t};\n}\n\nexport function buildResolveIORunnerPromptLines(options: ResolveIORunnerBasicsOptions = {}): string[] {\n\treturn buildResolveIORunnerContract(options).promptLines;\n}\n\nexport function buildResolveIORunnerPromptBundle(input: ResolveIORunnerPromptInput = {}): ResolveIORunnerPromptBundle {\n\tconst contract = buildResolveIORunnerContract(input);\n\tconst maxTextChars = normalizePositiveInteger(input.maxTextChars, 900, 160, 2400);\n\tconst objective = normalizeTextLine(input.objective, maxTextChars)\n\t\t|| 'Complete the requested ResolveIO runner task with minimal, verified changes.';\n\tconst priorSummary = normalizeTextLine(input.priorSummary, maxTextChars);\n\tconst latestFailure = normalizeTextLine(input.latestFailure, maxTextChars);\n\tconst blockers = normalizeTextList(input.blockers, normalizePositiveInteger(input.maxBlockers, 5, 1, 12), maxTextChars);\n\tconst relevantFiles = normalizeTextList(input.relevantFiles, normalizePositiveInteger(input.maxFiles, 12, 1, 30), 260);\n\tconst evidence = normalizeTextList(input.evidence, normalizePositiveInteger(input.maxEvidence, 8, 1, 20), maxTextChars);\n\tconst contextLines = [\n\t\t`Objective: ${objective}`,\n\t\t...(priorSummary ? [`Prior summary: ${priorSummary}`] : []),\n\t\t...(latestFailure ? [`Latest failure: ${latestFailure}`] : []),\n\t\t...(blockers.length ? ['Active blockers:', ...blockers.map((line) => `- ${line}`)] : []),\n\t\t...(relevantFiles.length ? ['Relevant files:', ...relevantFiles.map((line) => `- ${line}`)] : []),\n\t\t...(evidence.length ? ['Known evidence:', ...evidence.map((line) => `- ${line}`)] : [])\n\t];\n\tconst repairLines = blockers.length\n\t\t? [\n\t\t\t'Mandatory repair contract:',\n\t\t\t'- Address each active blocker before unrelated work.',\n\t\t\t'- For each blocker, mark resolved, proven false, or blocked.',\n\t\t\t'- Attach code, data, command, browser, screenshot, or trace proof for each blocker.',\n\t\t\t'- If a blocker repeats with no meaningful diff/evidence change, park instead of starting another broad attempt.'\n\t\t]\n\t\t: [];\n\tconst fullPromptLines = [\n\t\t...contract.promptLines,\n\t\t'',\n\t\t'Runner task context:',\n\t\t...contextLines,\n\t\t...(repairLines.length ? ['', ...repairLines] : [])\n\t];\n\treturn {\n\t\t...contract,\n\t\tobjective,\n\t\tcontextLines,\n\t\trepairLines,\n\t\tfullPromptLines\n\t};\n}\n\nexport function buildResolveIORunnerRepairPromptLines(input: ResolveIORunnerPromptInput = {}): string[] {\n\treturn buildResolveIORunnerPromptBundle(input).repairLines;\n}\n"]}

package/util/common.d.ts

@@ -1,31 +0,0 @@
-import { LookupTables } from '../models/report-builder.model';
-export declare function objectIdHexString(): string;
-export declare function buildRbSchema(rbSchema: any): any;
-export declare function buildRbLookups(rbLookups: LookupTables[], defaultSchema: object, default_checked_array?: string[]): object;
-export declare function throwErr(err: any, lkp: any, lookupNode: any, newPropertyName?: string): void;
-export declare function roundPrecision(value: number, precision?: number): number;
-export declare function round(value: any, precision?: number): number;
-export declare function floorPrecision(value: number, precision?: number): number;
-export declare function deepCopy(value: any): any;
-export declare function dateReviver(key: any, value: any): any;
-export declare function getAllowedOrigins(serverConfig: any): string[];
-export declare function isAllowedOrigin(origin: string, serverConfig: any): boolean;
-export declare function getMongoUpdates(currDoc: any, modifiedDoc: any, incVersion: any): any;
-export declare function getMongoMergeUpdatedDoc(f_doc: any, currentDoc: any, oldDoc: any): any;
-export declare function mergeUpdates(...updatesToMerge: any[]): {
-    $set: {};
-    $unset: {};
-    $inc: {};
-    $push: {};
-    $pull: {};
-};
-export declare function getDeepDiff(doc1: any, doc2: any): any;
-export declare function applyMongoUpdate(uDoc: any, delta: any): any;
-export declare function deepDiffDetails(object1: Object, object2: Object): string;
-export declare function getBinarySize(string: any): number;
-export declare function pad(num: any, size: any): string;
-export declare function randomString(length: any, chars: any): string;
-export declare function toTitleCase(str: any): any;
-export declare function isObject(item: any): boolean;
-export declare function mergeDeep(target: any, ...sources: any[]): any;
-export declare function generateSearchTokensFromFields(doc: any, fields: string[]): string[];