@resolveio/server-lib 22.3.14 → 22.3.16

package/types/error-report.d.ts

@@ -0,0 +1,25 @@
+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

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

package/types/error-report.js.map

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,27 @@
+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

@@ -0,0 +1,6 @@
+"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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,46 @@
+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 ResolveIORunnerContract {
+    context: ResolveIOQaPolicyContext;
+    sections: {
+        runnerBasics: string[];
+        tokenDiscipline: string[];
+        dependencyBootstrap: string[];
+        repairLoop: string[];
+        qaPolicy: string[];
+        evidenceContract: string[];
+        finalNotes: string[];
+    };
+    rules: string[];
+    promptLines: 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[];

package/util/ai-qa-policy.js

@@ -0,0 +1,174 @@
+"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 __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;
+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 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;
+}
+
+//# sourceMappingURL=ai-qa-policy.js.map

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

@@ -0,0 +1 @@
+{"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 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\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\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"]}

package/util/common.d.ts

@@ -0,0 +1,31 @@
+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[];