@evalops/maestro 0.10.50 → 0.10.51

package/dist/customer-value/ambient-learning.js

@@ -0,0 +1,472 @@
+/**
+ * Ambient learner subsystem for the customer-value report.
+ *
+ * Owns everything that reads/classifies the ambient learner outcome file:
+ * daemon flush, JSON parsing, pattern derivation, transient-failure
+ * classification, and the ambient customer-value/opportunity builders that
+ * turn learner evidence into report sections.
+ *
+ * Extracted from report.ts to isolate the highest-churn surface (transient
+ * classification + flush freshness evolve frequently) behind a stable module
+ * boundary. Runtime dependencies are one-directional: this module imports
+ * shared leaf helpers from ./internal-helpers.js and types from ./report.js
+ * (type-only). report.ts imports the summary/build entry points back here.
+ */
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { sanitizeWithStaticMask } from "../utils/secret-redactor.js";
+import { isTimestampInRangeOrUnbounded, numberOrZero, parseTimestampMs, redactLine, sanitizeA2ALabel, slugify, sum, } from "./internal-helpers.js";
+function shellQuote(value) {
+    return `'${value.replaceAll("'", "'\\''")}'`;
+}
+export function ambientLearnerPresenceCommand(learnerPath) {
+    return `test -s ${shellQuote(learnerPath)}`;
+}
+export async function flushAmbientLearnerForReport(env, _learnerPath, flush) {
+    return flush(env);
+}
+export async function flushAmbientLearnerBeforeRead(env) {
+    return new Promise((resolve) => {
+        const child = spawn("ambient", ["flush"], {
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let stdout = "";
+        let stderr = "";
+        let settled = false;
+        const finish = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timeout);
+            resolve(result);
+        };
+        const timeout = setTimeout(() => {
+            child.kill();
+            finish({
+                flushed: false,
+                collectionGap: "Ambient learner flush timed out before report generation.",
+            });
+        }, 40000);
+        child.stdout?.setEncoding("utf8");
+        child.stdout?.on("data", (chunk) => {
+            stdout += chunk;
+        });
+        child.stderr?.setEncoding("utf8");
+        child.stderr?.on("data", (chunk) => {
+            stderr += chunk;
+        });
+        child.on("error", (error) => {
+            if (error.code === "ENOENT" &&
+                !existsSync(env.ambientSocketFile)) {
+                finish({ flushed: false });
+                return;
+            }
+            finish({
+                flushed: false,
+                collectionGap: `Ambient learner flush could not start: ${sanitizeWithStaticMask(error.message)}.`,
+            });
+        });
+        child.on("close", (code) => {
+            if (code === 0) {
+                finish({
+                    flushed: true,
+                    learnerPath: parseAmbientFlushLearnerPath(stdout, env.ambientLearnerDefaultFile),
+                });
+                return;
+            }
+            const failureMessage = stderr.trim() || stdout.trim() || `exit ${code ?? "unknown"}`;
+            if (isAmbientDaemonNotRunningFlushFailure(failureMessage, env)) {
+                finish({ flushed: false });
+                return;
+            }
+            finish({
+                flushed: false,
+                collectionGap: `Ambient learner flush failed before report generation: ${sanitizeWithStaticMask(failureMessage)}.`,
+            });
+        });
+    });
+}
+function isAmbientDaemonNotRunningFlushFailure(failureMessage, env) {
+    const normalized = failureMessage.toLowerCase();
+    return (normalized.includes("daemon is not running") ||
+        normalized.includes("daemon not running") ||
+        (normalized.includes("socket not found") &&
+            !existsSync(env.ambientSocketFile)));
+}
+function parseAmbientFlushLearnerPath(stdout, fallbackPath) {
+    const prefix = "Learner state flushed:";
+    const lines = stdout
+        .split(/\r?\n/u)
+        .map((line) => line.trim())
+        .filter(Boolean)
+        .reverse();
+    for (const line of lines) {
+        if (!line.startsWith(prefix))
+            continue;
+        const learnerPath = line.slice(prefix.length).trim();
+        if (learnerPath)
+            return learnerPath;
+    }
+    return fallbackPath;
+}
+export async function summarizeAmbientLearning(learnerPath, range, flushResult, requestedLearnerPath = learnerPath) {
+    const summary = {
+        learnerPath,
+        outcomes: [],
+        patterns: [],
+        collectionGaps: [],
+    };
+    if (flushResult?.collectionGap) {
+        summary.collectionGaps.push(flushResult.collectionGap);
+    }
+    if (flushResult?.learnerPath &&
+        requestedLearnerPath !== flushResult.learnerPath) {
+        summary.collectionGaps.push(`Ambient learner override at ${requestedLearnerPath} did not match the running daemon; report used flushed learner state from ${flushResult.learnerPath}.`);
+    }
+    if (!existsSync(learnerPath)) {
+        summary.collectionGaps.push(`Ambient learner file not found at ${learnerPath}. Run ambient work before claiming learned automation patterns.`);
+        return summary;
+    }
+    let raw = "";
+    try {
+        raw = await readFile(learnerPath, "utf8");
+    }
+    catch (error) {
+        summary.collectionGaps.push(`Ambient learner file could not be read: ${sanitizeWithStaticMask(error instanceof Error ? error.message : String(error))}.`);
+        return summary;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        summary.collectionGaps.push(`Ambient learner file at ${learnerPath} is not valid JSON.`);
+        return summary;
+    }
+    if (!parsed || typeof parsed !== "object") {
+        summary.collectionGaps.push(`Ambient learner file at ${learnerPath} did not contain an object.`);
+        return summary;
+    }
+    const record = parsed;
+    const outcomes = Array.isArray(record.outcomes) ? record.outcomes : [];
+    summary.outcomes = outcomes
+        .map(parseAmbientLearnerOutcome)
+        .filter((outcome) => Boolean(outcome))
+        .filter((outcome) => isTimestampInRangeOrUnbounded(outcome.timestamp, range));
+    summary.patterns = deriveAmbientLearnerPatterns(summary.outcomes);
+    if (summary.outcomes.length === 0) {
+        summary.collectionGaps.push(range.since === undefined && range.until === undefined
+            ? `Ambient learner file at ${learnerPath} has no outcome evidence.`
+            : `Ambient learner file at ${learnerPath} has no outcome evidence for the selected range.`);
+    }
+    return summary;
+}
+function parseAmbientLearnerOutcome(value) {
+    if (!value || typeof value !== "object")
+        return undefined;
+    const record = value;
+    const success = record.success;
+    if (typeof success !== "boolean")
+        return undefined;
+    const labels = Array.isArray(record.labels)
+        ? record.labels
+            .filter((label) => typeof label === "string")
+            .map((label) => sanitizeA2ALabel(label, 80))
+        : [];
+    return {
+        success,
+        ...(typeof record.failure_reason === "string" &&
+            record.failure_reason.trim()
+            ? { failureReason: redactLine(record.failure_reason) }
+            : {}),
+        labels,
+        ...(typeof record.repo === "string"
+            ? { repo: sanitizeA2ALabel(record.repo, 120) }
+            : {}),
+        ...(typeof record.task_type === "string"
+            ? { taskType: sanitizeA2ALabel(record.task_type, 80) }
+            : {}),
+        ...(typeof record.event_type === "string"
+            ? { eventType: sanitizeA2ALabel(record.event_type, 80) }
+            : {}),
+        costUsd: numberOrZero(record.cost_usd),
+        ...(parseTimestampMs(record.timestamp) !== undefined
+            ? { timestamp: parseTimestampMs(record.timestamp) }
+            : {}),
+    };
+}
+function deriveAmbientLearnerPatterns(outcomes) {
+    const groups = new Map();
+    const add = (patternType, key, outcome) => {
+        if (!key)
+            return;
+        const groupKey = `${patternType}\u0000${key}`;
+        const group = groups.get(groupKey) ?? {
+            patternType,
+            key,
+            successCount: 0,
+            sampleCount: 0,
+            transientFailureCount: 0,
+            nonTransientFailureCount: 0,
+        };
+        group.sampleCount += 1;
+        if (outcome.success) {
+            group.successCount += 1;
+        }
+        else if (isTransientAmbientFailureOutcome(outcome)) {
+            group.transientFailureCount += 1;
+        }
+        else {
+            group.nonTransientFailureCount += 1;
+        }
+        groups.set(groupKey, group);
+    };
+    for (const outcome of outcomes) {
+        for (const label of outcome.labels)
+            add("Label", label, outcome);
+        add("Repo", outcome.repo, outcome);
+        add("TaskType", outcome.taskType, outcome);
+        add("EventType", outcome.eventType, outcome);
+    }
+    return [...groups.values()]
+        .map((group) => ({
+        patternType: group.patternType,
+        key: group.key,
+        successRate: group.successCount / group.sampleCount,
+        sampleCount: group.sampleCount,
+        successCount: group.successCount,
+        transientFailureCount: group.transientFailureCount,
+        nonTransientFailureCount: group.nonTransientFailureCount,
+        nonTransientSampleCount: group.successCount + group.nonTransientFailureCount,
+        nonTransientSuccessRate: group.successCount + group.nonTransientFailureCount > 0
+            ? group.successCount /
+                (group.successCount + group.nonTransientFailureCount)
+            : null,
+    }))
+        .sort((left, right) => right.sampleCount - left.sampleCount ||
+        right.successRate - left.successRate ||
+        left.patternType.localeCompare(right.patternType) ||
+        left.key.localeCompare(right.key));
+}
+export function buildAmbientCustomerValue(input) {
+    const successCount = input.learning.outcomes.filter((outcome) => outcome.success).length;
+    const failureCount = input.learning.outcomes.length - successCount;
+    const protectedTransientFailureCount = input.learning.outcomes.filter(isTransientAmbientFailureOutcome).length;
+    const actionablePatternCount = input.learning.patterns.filter((pattern) => pattern.nonTransientSampleCount >= 3).length;
+    const base = {
+        learnerPath: input.learning.learnerPath,
+        outcomeCount: input.learning.outcomes.length,
+        successCount,
+        failureCount,
+        successRate: input.learning.outcomes.length > 0
+            ? successCount / input.learning.outcomes.length
+            : null,
+        totalCostUsd: sum(input.learning.outcomes, (outcome) => outcome.costUsd),
+        patternCount: input.learning.patterns.length,
+        actionablePatternCount,
+        protectedTransientFailureCount,
+        collectionGaps: input.learning.collectionGaps,
+    };
+    const automationOpportunities = buildAmbientAutomationOpportunities({
+        ambient: base,
+        multiAgent: input.multiAgent,
+        trustCards: input.trustCards,
+        handoffs: input.handoffs,
+    });
+    const playbookLearningOpportunities = buildPlaybookLearningOpportunities({
+        ambient: base,
+        learning: input.learning,
+        multiAgent: input.multiAgent,
+        trustCards: input.trustCards,
+        handoffs: input.handoffs,
+    });
+    return {
+        ...base,
+        automationOpportunities,
+        playbookLearningOpportunities,
+    };
+}
+function buildAmbientAutomationOpportunities(input) {
+    const opportunities = [];
+    if (input.multiAgent.delegatedPendingTaskCount > 0 ||
+        input.multiAgent.nextActions.length > 0) {
+        opportunities.push({
+            id: "a2a-followup-watchdog",
+            customerOutcome: "Wake operators only when delegated work needs a reply, wait, refresh, or evidence check.",
+            triggerEvidence: `${input.multiAgent.delegatedPendingTaskCount} pending delegated task(s) and ${input.multiAgent.nextActions.length} cockpit next action(s).`,
+            recommendedCadence: "hourly",
+            scriptGate: "maestro a2a cockpit --json | jq -e '.nextActions | length > 0'",
+            delivery: "Slack or CLI notification with the first cockpit next action and value-report link.",
+        });
+    }
+    const failedToolResults = sum(input.trustCards, (card) => card.failedToolResultCount);
+    if (failedToolResults > 0 || input.handoffs.blockedCount > 0) {
+        opportunities.push({
+            id: "failed-tool-digest",
+            customerOutcome: "Convert failed tool evidence into a daily repair queue instead of losing it in chat history.",
+            triggerEvidence: `${failedToolResults} failed tool result(s) and ${input.handoffs.blockedCount} blocked handoff(s).`,
+            recommendedCadence: "daily",
+            scriptGate: "maestro value yesterday --format json | jq -e '.handoffs.blockedCount > 0 or .summary.failedToolResultCount > 0'",
+            delivery: "Daily digest with blocked handoffs, failed tool counts, and replayable session paths.",
+        });
+    }
+    const memoryGapCount = input.trustCards.filter((card) => !card.evidence.hasMemoryProvenance).length;
+    if (memoryGapCount > 0) {
+        opportunities.push({
+            id: "memory-gap-digest",
+            customerOutcome: "Turn valuable one-off sessions into reusable customer context before the lessons go stale.",
+            triggerEvidence: `${memoryGapCount} trust card(s) lack durable memory provenance.`,
+            recommendedCadence: "weekly",
+            scriptGate: "maestro value week --format json | jq -e 'any(.trustCards[]?; .evidence.hasMemoryProvenance | not)'",
+            delivery: "Weekly report of sessions that need memory or playbook capture.",
+        });
+    }
+    if (input.ambient.outcomeCount > 0) {
+        opportunities.push({
+            id: "ambient-learner-review",
+            customerOutcome: "Review ambient outcomes on a schedule and promote only durable patterns into team playbooks.",
+            triggerEvidence: `${input.ambient.outcomeCount} learner outcome(s), ${input.ambient.actionablePatternCount} actionable pattern(s), ${input.ambient.protectedTransientFailureCount} protected transient failure(s).`,
+            recommendedCadence: "weekly",
+            scriptGate: ambientLearnerPresenceCommand(input.ambient.learnerPath),
+            delivery: "Weekly playbook review with successes, low-success patterns, and quarantined transient failures.",
+        });
+    }
+    return opportunities.slice(0, 5);
+}
+function buildPlaybookLearningOpportunities(input) {
+    const opportunities = [];
+    if (input.ambient.protectedTransientFailureCount > 0) {
+        opportunities.push({
+            id: "protect-transient-failures",
+            customerOutcome: "Prevent temporary setup failures from becoming permanent agent refusals or bad playbooks.",
+            evidenceSignal: `${input.ambient.protectedTransientFailureCount} learner failure(s) matched transient setup or environment patterns.`,
+            guardrail: "Capture the recovery command or setup prerequisite, not a durable claim that the tool is broken.",
+            recommendedArtifact: ".maestro/playbooks/ambient-transient-failure-guardrail.md",
+        });
+    }
+    const topSuccess = input.learning.patterns
+        .filter((pattern) => pattern.nonTransientSampleCount >= 3 &&
+        pattern.nonTransientSuccessRate !== null &&
+        pattern.nonTransientSuccessRate >= 0.75)
+        .sort((left, right) => (right.nonTransientSuccessRate ?? 0) -
+        (left.nonTransientSuccessRate ?? 0))[0];
+    if (topSuccess) {
+        opportunities.push({
+            id: "capture-successful-pattern",
+            customerOutcome: "Turn repeated ambient success into a reusable team playbook for similar work.",
+            evidenceSignal: `${topSuccess.patternType}=${topSuccess.key} succeeded ${((topSuccess.nonTransientSuccessRate ?? 0) * 100).toFixed(1)}% across ${topSuccess.nonTransientSampleCount} non-transient sample(s).`,
+            guardrail: "Promote the durable task shape, required evidence, and verification steps; do not copy one-off task details.",
+            recommendedArtifact: `.maestro/playbooks/ambient-${slugify(topSuccess.patternType)}-${slugify(topSuccess.key)}.md`,
+        });
+    }
+    const lowSuccess = input.learning.patterns
+        .filter((pattern) => pattern.nonTransientSampleCount >= 3 &&
+        pattern.nonTransientSuccessRate !== null &&
+        pattern.nonTransientSuccessRate < 0.45 &&
+        pattern.nonTransientFailureCount > 0)
+        .sort((left, right) => (left.nonTransientSuccessRate ?? 1) -
+        (right.nonTransientSuccessRate ?? 1))[0];
+    if (lowSuccess) {
+        opportunities.push({
+            id: "repair-low-success-pattern",
+            customerOutcome: "Reduce repeated ambient failures by tightening routing, approval, or verification for a known weak pattern.",
+            evidenceSignal: `${lowSuccess.patternType}=${lowSuccess.key} succeeded only ${((lowSuccess.nonTransientSuccessRate ?? 0) * 100).toFixed(1)}% across ${lowSuccess.nonTransientSampleCount} non-transient sample(s).`,
+            guardrail: "Prefer threshold/routing changes or added checks over broad bans on the task class.",
+            recommendedArtifact: `.maestro/playbooks/ambient-${slugify(lowSuccess.patternType)}-${slugify(lowSuccess.key)}-repair.md`,
+        });
+    }
+    if (input.multiAgent.delegatedEvidenceGapCount > 0 ||
+        input.multiAgent.nextActions.length > 0) {
+        opportunities.push({
+            id: "multi-agent-verification-playbook",
+            customerOutcome: "Make subagent work customer-trustworthy by requiring parent-side verification before value is claimed.",
+            evidenceSignal: `${input.multiAgent.delegatedEvidenceGapCount} delegated evidence gap(s) and ${input.multiAgent.nextActions.length} A2A next action(s).`,
+            guardrail: "Treat subagent summaries as self-reports until a URL, file path, task id, work graph, transcript, or test result is read back.",
+            recommendedArtifact: ".maestro/playbooks/multi-agent-verification.md",
+        });
+    }
+    if (input.handoffs.followupCount > 0 ||
+        input.handoffs.openWorkCount > 0 ||
+        input.trustCards.some((card) => card.riskSignals.length > 0)) {
+        opportunities.push({
+            id: "handoff-memory-playbook",
+            customerOutcome: "Convert unfinished work, blockers, and user corrections into durable next-session behavior.",
+            evidenceSignal: `${input.handoffs.followupCount} follow-up handoff(s), ${input.handoffs.openWorkCount} open work item(s).`,
+            guardrail: "Store user/workflow preferences as playbook steps, while keeping secrets and transient errors out of durable memory.",
+            recommendedArtifact: ".maestro/playbooks/customer-handoff-learning.md",
+        });
+    }
+    return opportunities.slice(0, 6);
+}
+function isTransientAmbientFailureOutcome(outcome) {
+    if (outcome.success || !outcome.failureReason)
+        return false;
+    return isTransientFailureText(outcome.failureReason);
+}
+function isTransientFailureText(text) {
+    const normalized = text.toLowerCase();
+    return ([
+        "command not found",
+        "no such file or directory",
+        "missing binary",
+        "missing credential",
+        "unconfigured",
+        "not configured",
+        "authentication required",
+        "connection refused",
+        "temporary failure in name resolution",
+    ].some((needle) => normalized.includes(needle)) ||
+        isTransientRateLimitFailureText(normalized) ||
+        isTransientTransportFailureText(normalized));
+}
+function isTransientRateLimitFailureText(normalized) {
+    return (["429 too many requests", "http 429", "status 429"].some((needle) => normalized.includes(needle)) ||
+        (normalized.includes("rate limit") &&
+            hasTransientEnvironmentContext(normalized)));
+}
+function isTransientTransportFailureText(normalized) {
+    return ([
+        "etimedout",
+        "econnreset",
+        "enotfound",
+        "eai_again",
+        "connection timed out",
+        "socket timed out",
+        "network unreachable",
+        "network unavailable",
+        "network reset",
+        "temporary network",
+    ].some((needle) => normalized.includes(needle)) ||
+        ([
+            "request timed out",
+            "connect timed out",
+            "fetch timed out",
+            "timed out",
+            "network error",
+            "network failure",
+            "dns lookup",
+            "name resolution",
+        ].some((needle) => normalized.includes(needle)) &&
+            hasTransientEnvironmentContext(normalized)));
+}
+function hasTransientEnvironmentContext(normalized) {
+    return [
+        "while bootstrapping",
+        "while fetching",
+        "while downloading",
+        "while installing",
+        "while authenticating",
+        "while connecting",
+        "while calling",
+        "fetching dependencies",
+        "downloading dependencies",
+        "installing dependencies",
+        "dependency install",
+        "fresh runner",
+        "github api",
+        "npm registry",
+        "package registry",
+    ].some((needle) => normalized.includes(needle));
+}
+//# sourceMappingURL=ambient-learning.js.map

package/dist/customer-value/ambient-learning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ambient-learning.js","sourceRoot":"","sources":["../../src/customer-value/ambient-learning.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Ambient learner subsystem for the customer-value report.\n *\n * Owns everything that reads/classifies the ambient learner outcome file:\n * daemon flush, JSON parsing, pattern derivation, transient-failure\n * classification, and the ambient customer-value/opportunity builders that\n * turn learner evidence into report sections.\n *\n * Extracted from report.ts to isolate the highest-churn surface (transient\n * classification + flush freshness evolve frequently) behind a stable module\n * boundary. Runtime dependencies are one-directional: this module imports\n * shared leaf helpers from ./internal-helpers.js and types from ./report.js\n * (type-only). report.ts imports the summary/build entry points back here.\n */\nimport { spawn } from \"node:child_process\";\nimport { existsSync } from \"node:fs\";\nimport { readFile } from \"node:fs/promises\";\nimport type { RuntimeEnv } from \"../runtime/env.js\";\nimport { sanitizeWithStaticMask } from \"../utils/secret-redactor.js\";\nimport {\n\tisTimestampInRangeOrUnbounded,\n\tnumberOrZero,\n\tparseTimestampMs,\n\tredactLine,\n\tsanitizeA2ALabel,\n\tslugify,\n\tsum,\n} from \"./internal-helpers.js\";\nimport type {\n\tCustomerValueRange,\n\tCustomerValueReport,\n\tMultiAgentValue,\n\tTrustCard,\n} from \"./report.js\";\n\nfunction shellQuote(value: string): string {\n\treturn `'${value.replaceAll(\"'\", \"'\\\\''\")}'`;\n}\n\nexport function ambientLearnerPresenceCommand(learnerPath: string): string {\n\treturn `test -s ${shellQuote(learnerPath)}`;\n}\n\nexport interface AmbientLearnerFlushResult {\n\tflushed: boolean;\n\tlearnerPath?: string;\n\tcollectionGap?: string;\n}\n\nexport interface AmbientAutomationOpportunity {\n\tid:\n\t\t| \"a2a-followup-watchdog\"\n\t\t| \"failed-tool-digest\"\n\t\t| \"memory-gap-digest\"\n\t\t| \"ambient-learner-review\";\n\tcustomerOutcome: string;\n\ttriggerEvidence: string;\n\trecommendedCadence: \"hourly\" | \"daily\" | \"weekly\";\n\tscriptGate: string;\n\tdelivery: string;\n}\n\nexport interface PlaybookLearningOpportunity {\n\tid:\n\t\t| \"protect-transient-failures\"\n\t\t| \"capture-successful-pattern\"\n\t\t| \"repair-low-success-pattern\"\n\t\t| \"multi-agent-verification-playbook\"\n\t\t| \"handoff-memory-playbook\";\n\tcustomerOutcome: string;\n\tevidenceSignal: string;\n\tguardrail: string;\n\trecommendedArtifact: string;\n}\n\nexport interface AmbientCustomerValue {\n\tlearnerPath: string;\n\toutcomeCount: number;\n\tsuccessCount: number;\n\tfailureCount: number;\n\tsuccessRate: number | null;\n\ttotalCostUsd: number;\n\tpatternCount: number;\n\tactionablePatternCount: number;\n\tprotectedTransientFailureCount: number;\n\tautomationOpportunities: AmbientAutomationOpportunity[];\n\tplaybookLearningOpportunities: PlaybookLearningOpportunity[];\n\tcollectionGaps: string[];\n}\n\ninterface AmbientLearningSummary {\n\tlearnerPath: string;\n\toutcomes: AmbientLearnerOutcome[];\n\tpatterns: AmbientLearnerPattern[];\n\tcollectionGaps: string[];\n}\n\ninterface AmbientLearnerOutcome {\n\tsuccess: boolean;\n\tfailureReason?: string;\n\tlabels: string[];\n\trepo?: string;\n\ttaskType?: string;\n\teventType?: string;\n\tcostUsd: number;\n\ttimestamp?: number;\n}\n\ninterface AmbientLearnerPattern {\n\tpatternType: string;\n\tkey: string;\n\tsuccessRate: number;\n\tsampleCount: number;\n\tsuccessCount: number;\n\ttransientFailureCount: number;\n\tnonTransientFailureCount: number;\n\tnonTransientSampleCount: number;\n\tnonTransientSuccessRate: number | null;\n}\n\nexport async function flushAmbientLearnerForReport(\n\tenv: RuntimeEnv,\n\t_learnerPath: string,\n\tflush: (env: RuntimeEnv) => Promise<AmbientLearnerFlushResult>,\n): Promise<AmbientLearnerFlushResult> {\n\treturn flush(env);\n}\n\nexport async function flushAmbientLearnerBeforeRead(\n\tenv: RuntimeEnv,\n): Promise<AmbientLearnerFlushResult> {\n\treturn new Promise((resolve) => {\n\t\tconst child = spawn(\"ambient\", [\"flush\"], {\n\t\t\tstdio: [\"ignore\", \"pipe\", \"pipe\"],\n\t\t});\n\t\tlet stdout = \"\";\n\t\tlet stderr = \"\";\n\t\tlet settled = false;\n\t\tconst finish = (result: AmbientLearnerFlushResult) => {\n\t\t\tif (settled) return;\n\t\t\tsettled = true;\n\t\t\tclearTimeout(timeout);\n\t\t\tresolve(result);\n\t\t};\n\t\tconst timeout = setTimeout(() => {\n\t\t\tchild.kill();\n\t\t\tfinish({\n\t\t\t\tflushed: false,\n\t\t\t\tcollectionGap:\n\t\t\t\t\t\"Ambient learner flush timed out before report generation.\",\n\t\t\t});\n\t\t}, 40000);\n\t\tchild.stdout?.setEncoding(\"utf8\");\n\t\tchild.stdout?.on(\"data\", (chunk: string) => {\n\t\t\tstdout += chunk;\n\t\t});\n\t\tchild.stderr?.setEncoding(\"utf8\");\n\t\tchild.stderr?.on(\"data\", (chunk: string) => {\n\t\t\tstderr += chunk;\n\t\t});\n\t\tchild.on(\"error\", (error) => {\n\t\t\tif (\n\t\t\t\t(error as NodeJS.ErrnoException).code === \"ENOENT\" &&\n\t\t\t\t!existsSync(env.ambientSocketFile)\n\t\t\t) {\n\t\t\t\tfinish({ flushed: false });\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tfinish({\n\t\t\t\tflushed: false,\n\t\t\t\tcollectionGap: `Ambient learner flush could not start: ${sanitizeWithStaticMask(error.message)}.`,\n\t\t\t});\n\t\t});\n\t\tchild.on(\"close\", (code) => {\n\t\t\tif (code === 0) {\n\t\t\t\tfinish({\n\t\t\t\t\tflushed: true,\n\t\t\t\t\tlearnerPath: parseAmbientFlushLearnerPath(\n\t\t\t\t\t\tstdout,\n\t\t\t\t\t\tenv.ambientLearnerDefaultFile,\n\t\t\t\t\t),\n\t\t\t\t});\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst failureMessage =\n\t\t\t\tstderr.trim() || stdout.trim() || `exit ${code ?? \"unknown\"}`;\n\t\t\tif (isAmbientDaemonNotRunningFlushFailure(failureMessage, env)) {\n\t\t\t\tfinish({ flushed: false });\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tfinish({\n\t\t\t\tflushed: false,\n\t\t\t\tcollectionGap: `Ambient learner flush failed before report generation: ${sanitizeWithStaticMask(failureMessage)}.`,\n\t\t\t});\n\t\t});\n\t});\n}\n\nfunction isAmbientDaemonNotRunningFlushFailure(\n\tfailureMessage: string,\n\tenv: RuntimeEnv,\n): boolean {\n\tconst normalized = failureMessage.toLowerCase();\n\treturn (\n\t\tnormalized.includes(\"daemon is not running\") ||\n\t\tnormalized.includes(\"daemon not running\") ||\n\t\t(normalized.includes(\"socket not found\") &&\n\t\t\t!existsSync(env.ambientSocketFile))\n\t);\n}\n\nfunction parseAmbientFlushLearnerPath(\n\tstdout: string,\n\tfallbackPath: string,\n): string {\n\tconst prefix = \"Learner state flushed:\";\n\tconst lines = stdout\n\t\t.split(/\\r?\\n/u)\n\t\t.map((line) => line.trim())\n\t\t.filter(Boolean)\n\t\t.reverse();\n\tfor (const line of lines) {\n\t\tif (!line.startsWith(prefix)) continue;\n\t\tconst learnerPath = line.slice(prefix.length).trim();\n\t\tif (learnerPath) return learnerPath;\n\t}\n\treturn fallbackPath;\n}\n\nexport async function summarizeAmbientLearning(\n\tlearnerPath: string,\n\trange: CustomerValueRange,\n\tflushResult?: AmbientLearnerFlushResult,\n\trequestedLearnerPath = learnerPath,\n): Promise<AmbientLearningSummary> {\n\tconst summary: AmbientLearningSummary = {\n\t\tlearnerPath,\n\t\toutcomes: [],\n\t\tpatterns: [],\n\t\tcollectionGaps: [],\n\t};\n\tif (flushResult?.collectionGap) {\n\t\tsummary.collectionGaps.push(flushResult.collectionGap);\n\t}\n\tif (\n\t\tflushResult?.learnerPath &&\n\t\trequestedLearnerPath !== flushResult.learnerPath\n\t) {\n\t\tsummary.collectionGaps.push(\n\t\t\t`Ambient learner override at ${requestedLearnerPath} did not match the running daemon; report used flushed learner state from ${flushResult.learnerPath}.`,\n\t\t);\n\t}\n\tif (!existsSync(learnerPath)) {\n\t\tsummary.collectionGaps.push(\n\t\t\t`Ambient learner file not found at ${learnerPath}. Run ambient work before claiming learned automation patterns.`,\n\t\t);\n\t\treturn summary;\n\t}\n\tlet raw = \"\";\n\ttry {\n\t\traw = await readFile(learnerPath, \"utf8\");\n\t} catch (error) {\n\t\tsummary.collectionGaps.push(\n\t\t\t`Ambient learner file could not be read: ${sanitizeWithStaticMask(error instanceof Error ? error.message : String(error))}.`,\n\t\t);\n\t\treturn summary;\n\t}\n\tlet parsed: unknown;\n\ttry {\n\t\tparsed = JSON.parse(raw);\n\t} catch {\n\t\tsummary.collectionGaps.push(\n\t\t\t`Ambient learner file at ${learnerPath} is not valid JSON.`,\n\t\t);\n\t\treturn summary;\n\t}\n\tif (!parsed || typeof parsed !== \"object\") {\n\t\tsummary.collectionGaps.push(\n\t\t\t`Ambient learner file at ${learnerPath} did not contain an object.`,\n\t\t);\n\t\treturn summary;\n\t}\n\tconst record = parsed as Record<string, unknown>;\n\tconst outcomes = Array.isArray(record.outcomes) ? record.outcomes : [];\n\tsummary.outcomes = outcomes\n\t\t.map(parseAmbientLearnerOutcome)\n\t\t.filter((outcome): outcome is AmbientLearnerOutcome => Boolean(outcome))\n\t\t.filter((outcome) =>\n\t\t\tisTimestampInRangeOrUnbounded(outcome.timestamp, range),\n\t\t);\n\tsummary.patterns = deriveAmbientLearnerPatterns(summary.outcomes);\n\tif (summary.outcomes.length === 0) {\n\t\tsummary.collectionGaps.push(\n\t\t\trange.since === undefined && range.until === undefined\n\t\t\t\t? `Ambient learner file at ${learnerPath} has no outcome evidence.`\n\t\t\t\t: `Ambient learner file at ${learnerPath} has no outcome evidence for the selected range.`,\n\t\t);\n\t}\n\treturn summary;\n}\n\nfunction parseAmbientLearnerOutcome(\n\tvalue: unknown,\n): AmbientLearnerOutcome | undefined {\n\tif (!value || typeof value !== \"object\") return undefined;\n\tconst record = value as Record<string, unknown>;\n\tconst success = record.success;\n\tif (typeof success !== \"boolean\") return undefined;\n\tconst labels = Array.isArray(record.labels)\n\t\t? record.labels\n\t\t\t\t.filter((label): label is string => typeof label === \"string\")\n\t\t\t\t.map((label) => sanitizeA2ALabel(label, 80))\n\t\t: [];\n\treturn {\n\t\tsuccess,\n\t\t...(typeof record.failure_reason === \"string\" &&\n\t\trecord.failure_reason.trim()\n\t\t\t? { failureReason: redactLine(record.failure_reason) }\n\t\t\t: {}),\n\t\tlabels,\n\t\t...(typeof record.repo === \"string\"\n\t\t\t? { repo: sanitizeA2ALabel(record.repo, 120) }\n\t\t\t: {}),\n\t\t...(typeof record.task_type === \"string\"\n\t\t\t? { taskType: sanitizeA2ALabel(record.task_type, 80) }\n\t\t\t: {}),\n\t\t...(typeof record.event_type === \"string\"\n\t\t\t? { eventType: sanitizeA2ALabel(record.event_type, 80) }\n\t\t\t: {}),\n\t\tcostUsd: numberOrZero(record.cost_usd),\n\t\t...(parseTimestampMs(record.timestamp) !== undefined\n\t\t\t? { timestamp: parseTimestampMs(record.timestamp)! }\n\t\t\t: {}),\n\t};\n}\n\nfunction deriveAmbientLearnerPatterns(\n\toutcomes: AmbientLearnerOutcome[],\n): AmbientLearnerPattern[] {\n\tconst groups = new Map<\n\t\tstring,\n\t\t{\n\t\t\tpatternType: string;\n\t\t\tkey: string;\n\t\t\tsuccessCount: number;\n\t\t\tsampleCount: number;\n\t\t\ttransientFailureCount: number;\n\t\t\tnonTransientFailureCount: number;\n\t\t}\n\t>();\n\tconst add = (\n\t\tpatternType: string,\n\t\tkey: string | undefined,\n\t\toutcome: AmbientLearnerOutcome,\n\t) => {\n\t\tif (!key) return;\n\t\tconst groupKey = `${patternType}\\u0000${key}`;\n\t\tconst group = groups.get(groupKey) ?? {\n\t\t\tpatternType,\n\t\t\tkey,\n\t\t\tsuccessCount: 0,\n\t\t\tsampleCount: 0,\n\t\t\ttransientFailureCount: 0,\n\t\t\tnonTransientFailureCount: 0,\n\t\t};\n\t\tgroup.sampleCount += 1;\n\t\tif (outcome.success) {\n\t\t\tgroup.successCount += 1;\n\t\t} else if (isTransientAmbientFailureOutcome(outcome)) {\n\t\t\tgroup.transientFailureCount += 1;\n\t\t} else {\n\t\t\tgroup.nonTransientFailureCount += 1;\n\t\t}\n\t\tgroups.set(groupKey, group);\n\t};\n\tfor (const outcome of outcomes) {\n\t\tfor (const label of outcome.labels) add(\"Label\", label, outcome);\n\t\tadd(\"Repo\", outcome.repo, outcome);\n\t\tadd(\"TaskType\", outcome.taskType, outcome);\n\t\tadd(\"EventType\", outcome.eventType, outcome);\n\t}\n\treturn [...groups.values()]\n\t\t.map((group) => ({\n\t\t\tpatternType: group.patternType,\n\t\t\tkey: group.key,\n\t\t\tsuccessRate: group.successCount / group.sampleCount,\n\t\t\tsampleCount: group.sampleCount,\n\t\t\tsuccessCount: group.successCount,\n\t\t\ttransientFailureCount: group.transientFailureCount,\n\t\t\tnonTransientFailureCount: group.nonTransientFailureCount,\n\t\t\tnonTransientSampleCount:\n\t\t\t\tgroup.successCount + group.nonTransientFailureCount,\n\t\t\tnonTransientSuccessRate:\n\t\t\t\tgroup.successCount + group.nonTransientFailureCount > 0\n\t\t\t\t\t? group.successCount /\n\t\t\t\t\t\t(group.successCount + group.nonTransientFailureCount)\n\t\t\t\t\t: null,\n\t\t}))\n\t\t.sort(\n\t\t\t(left, right) =>\n\t\t\t\tright.sampleCount - left.sampleCount ||\n\t\t\t\tright.successRate - left.successRate ||\n\t\t\t\tleft.patternType.localeCompare(right.patternType) ||\n\t\t\t\tleft.key.localeCompare(right.key),\n\t\t);\n}\n\nexport function buildAmbientCustomerValue(input: {\n\tlearning: AmbientLearningSummary;\n\tmultiAgent: MultiAgentValue;\n\ttrustCards: TrustCard[];\n\thandoffs: CustomerValueReport[\"handoffs\"];\n}): AmbientCustomerValue {\n\tconst successCount = input.learning.outcomes.filter(\n\t\t(outcome) => outcome.success,\n\t).length;\n\tconst failureCount = input.learning.outcomes.length - successCount;\n\tconst protectedTransientFailureCount = input.learning.outcomes.filter(\n\t\tisTransientAmbientFailureOutcome,\n\t).length;\n\tconst actionablePatternCount = input.learning.patterns.filter(\n\t\t(pattern) => pattern.nonTransientSampleCount >= 3,\n\t).length;\n\tconst base: Omit<\n\t\tAmbientCustomerValue,\n\t\t\"automationOpportunities\" | \"playbookLearningOpportunities\"\n\t> = {\n\t\tlearnerPath: input.learning.learnerPath,\n\t\toutcomeCount: input.learning.outcomes.length,\n\t\tsuccessCount,\n\t\tfailureCount,\n\t\tsuccessRate:\n\t\t\tinput.learning.outcomes.length > 0\n\t\t\t\t? successCount / input.learning.outcomes.length\n\t\t\t\t: null,\n\t\ttotalCostUsd: sum(input.learning.outcomes, (outcome) => outcome.costUsd),\n\t\tpatternCount: input.learning.patterns.length,\n\t\tactionablePatternCount,\n\t\tprotectedTransientFailureCount,\n\t\tcollectionGaps: input.learning.collectionGaps,\n\t};\n\tconst automationOpportunities = buildAmbientAutomationOpportunities({\n\t\tambient: base,\n\t\tmultiAgent: input.multiAgent,\n\t\ttrustCards: input.trustCards,\n\t\thandoffs: input.handoffs,\n\t});\n\tconst playbookLearningOpportunities = buildPlaybookLearningOpportunities({\n\t\tambient: base,\n\t\tlearning: input.learning,\n\t\tmultiAgent: input.multiAgent,\n\t\ttrustCards: input.trustCards,\n\t\thandoffs: input.handoffs,\n\t});\n\treturn {\n\t\t...base,\n\t\tautomationOpportunities,\n\t\tplaybookLearningOpportunities,\n\t};\n}\n\nfunction buildAmbientAutomationOpportunities(input: {\n\tambient: Omit<\n\t\tAmbientCustomerValue,\n\t\t\"automationOpportunities\" | \"playbookLearningOpportunities\"\n\t>;\n\tmultiAgent: MultiAgentValue;\n\ttrustCards: TrustCard[];\n\thandoffs: CustomerValueReport[\"handoffs\"];\n}): AmbientAutomationOpportunity[] {\n\tconst opportunities: AmbientAutomationOpportunity[] = [];\n\tif (\n\t\tinput.multiAgent.delegatedPendingTaskCount > 0 ||\n\t\tinput.multiAgent.nextActions.length > 0\n\t) {\n\t\topportunities.push({\n\t\t\tid: \"a2a-followup-watchdog\",\n\t\t\tcustomerOutcome:\n\t\t\t\t\"Wake operators only when delegated work needs a reply, wait, refresh, or evidence check.\",\n\t\t\ttriggerEvidence: `${input.multiAgent.delegatedPendingTaskCount} pending delegated task(s) and ${input.multiAgent.nextActions.length} cockpit next action(s).`,\n\t\t\trecommendedCadence: \"hourly\",\n\t\t\tscriptGate:\n\t\t\t\t\"maestro a2a cockpit --json | jq -e '.nextActions | length > 0'\",\n\t\t\tdelivery:\n\t\t\t\t\"Slack or CLI notification with the first cockpit next action and value-report link.\",\n\t\t});\n\t}\n\tconst failedToolResults = sum(\n\t\tinput.trustCards,\n\t\t(card) => card.failedToolResultCount,\n\t);\n\tif (failedToolResults > 0 || input.handoffs.blockedCount > 0) {\n\t\topportunities.push({\n\t\t\tid: \"failed-tool-digest\",\n\t\t\tcustomerOutcome:\n\t\t\t\t\"Convert failed tool evidence into a daily repair queue instead of losing it in chat history.\",\n\t\t\ttriggerEvidence: `${failedToolResults} failed tool result(s) and ${input.handoffs.blockedCount} blocked handoff(s).`,\n\t\t\trecommendedCadence: \"daily\",\n\t\t\tscriptGate:\n\t\t\t\t\"maestro value yesterday --format json | jq -e '.handoffs.blockedCount > 0 or .summary.failedToolResultCount > 0'\",\n\t\t\tdelivery:\n\t\t\t\t\"Daily digest with blocked handoffs, failed tool counts, and replayable session paths.\",\n\t\t});\n\t}\n\tconst memoryGapCount = input.trustCards.filter(\n\t\t(card) => !card.evidence.hasMemoryProvenance,\n\t).length;\n\tif (memoryGapCount > 0) {\n\t\topportunities.push({\n\t\t\tid: \"memory-gap-digest\",\n\t\t\tcustomerOutcome:\n\t\t\t\t\"Turn valuable one-off sessions into reusable customer context before the lessons go stale.\",\n\t\t\ttriggerEvidence: `${memoryGapCount} trust card(s) lack durable memory provenance.`,\n\t\t\trecommendedCadence: \"weekly\",\n\t\t\tscriptGate:\n\t\t\t\t\"maestro value week --format json | jq -e 'any(.trustCards[]?; .evidence.hasMemoryProvenance | not)'\",\n\t\t\tdelivery:\n\t\t\t\t\"Weekly report of sessions that need memory or playbook capture.\",\n\t\t});\n\t}\n\tif (input.ambient.outcomeCount > 0) {\n\t\topportunities.push({\n\t\t\tid: \"ambient-learner-review\",\n\t\t\tcustomerOutcome:\n\t\t\t\t\"Review ambient outcomes on a schedule and promote only durable patterns into team playbooks.\",\n\t\t\ttriggerEvidence: `${input.ambient.outcomeCount} learner outcome(s), ${input.ambient.actionablePatternCount} actionable pattern(s), ${input.ambient.protectedTransientFailureCount} protected transient failure(s).`,\n\t\t\trecommendedCadence: \"weekly\",\n\t\t\tscriptGate: ambientLearnerPresenceCommand(input.ambient.learnerPath),\n\t\t\tdelivery:\n\t\t\t\t\"Weekly playbook review with successes, low-success patterns, and quarantined transient failures.\",\n\t\t});\n\t}\n\treturn opportunities.slice(0, 5);\n}\n\nfunction buildPlaybookLearningOpportunities(input: {\n\tambient: Omit<\n\t\tAmbientCustomerValue,\n\t\t\"automationOpportunities\" | \"playbookLearningOpportunities\"\n\t>;\n\tlearning: AmbientLearningSummary;\n\tmultiAgent: MultiAgentValue;\n\ttrustCards: TrustCard[];\n\thandoffs: CustomerValueReport[\"handoffs\"];\n}): PlaybookLearningOpportunity[] {\n\tconst opportunities: PlaybookLearningOpportunity[] = [];\n\tif (input.ambient.protectedTransientFailureCount > 0) {\n\t\topportunities.push({\n\t\t\tid: \"protect-transient-failures\",\n\t\t\tcustomerOutcome:\n\t\t\t\t\"Prevent temporary setup failures from becoming permanent agent refusals or bad playbooks.\",\n\t\t\tevidenceSignal: `${input.ambient.protectedTransientFailureCount} learner failure(s) matched transient setup or environment patterns.`,\n\t\t\tguardrail:\n\t\t\t\t\"Capture the recovery command or setup prerequisite, not a durable claim that the tool is broken.\",\n\t\t\trecommendedArtifact:\n\t\t\t\t\".maestro/playbooks/ambient-transient-failure-guardrail.md\",\n\t\t});\n\t}\n\tconst topSuccess = input.learning.patterns\n\t\t.filter(\n\t\t\t(pattern) =>\n\t\t\t\tpattern.nonTransientSampleCount >= 3 &&\n\t\t\t\tpattern.nonTransientSuccessRate !== null &&\n\t\t\t\tpattern.nonTransientSuccessRate >= 0.75,\n\t\t)\n\t\t.sort(\n\t\t\t(left, right) =>\n\t\t\t\t(right.nonTransientSuccessRate ?? 0) -\n\t\t\t\t(left.nonTransientSuccessRate ?? 0),\n\t\t)[0];\n\tif (topSuccess) {\n\t\topportunities.push({\n\t\t\tid: \"capture-successful-pattern\",\n\t\t\tcustomerOutcome:\n\t\t\t\t\"Turn repeated ambient success into a reusable team playbook for similar work.\",\n\t\t\tevidenceSignal: `${topSuccess.patternType}=${topSuccess.key} succeeded ${((topSuccess.nonTransientSuccessRate ?? 0) * 100).toFixed(1)}% across ${topSuccess.nonTransientSampleCount} non-transient sample(s).`,\n\t\t\tguardrail:\n\t\t\t\t\"Promote the durable task shape, required evidence, and verification steps; do not copy one-off task details.\",\n\t\t\trecommendedArtifact: `.maestro/playbooks/ambient-${slugify(topSuccess.patternType)}-${slugify(topSuccess.key)}.md`,\n\t\t});\n\t}\n\tconst lowSuccess = input.learning.patterns\n\t\t.filter(\n\t\t\t(pattern) =>\n\t\t\t\tpattern.nonTransientSampleCount >= 3 &&\n\t\t\t\tpattern.nonTransientSuccessRate !== null &&\n\t\t\t\tpattern.nonTransientSuccessRate < 0.45 &&\n\t\t\t\tpattern.nonTransientFailureCount > 0,\n\t\t)\n\t\t.sort(\n\t\t\t(left, right) =>\n\t\t\t\t(left.nonTransientSuccessRate ?? 1) -\n\t\t\t\t(right.nonTransientSuccessRate ?? 1),\n\t\t)[0];\n\tif (lowSuccess) {\n\t\topportunities.push({\n\t\t\tid: \"repair-low-success-pattern\",\n\t\t\tcustomerOutcome:\n\t\t\t\t\"Reduce repeated ambient failures by tightening routing, approval, or verification for a known weak pattern.\",\n\t\t\tevidenceSignal: `${lowSuccess.patternType}=${lowSuccess.key} succeeded only ${((lowSuccess.nonTransientSuccessRate ?? 0) * 100).toFixed(1)}% across ${lowSuccess.nonTransientSampleCount} non-transient sample(s).`,\n\t\t\tguardrail:\n\t\t\t\t\"Prefer threshold/routing changes or added checks over broad bans on the task class.\",\n\t\t\trecommendedArtifact: `.maestro/playbooks/ambient-${slugify(lowSuccess.patternType)}-${slugify(lowSuccess.key)}-repair.md`,\n\t\t});\n\t}\n\tif (\n\t\tinput.multiAgent.delegatedEvidenceGapCount > 0 ||\n\t\tinput.multiAgent.nextActions.length > 0\n\t) {\n\t\topportunities.push({\n\t\t\tid: \"multi-agent-verification-playbook\",\n\t\t\tcustomerOutcome:\n\t\t\t\t\"Make subagent work customer-trustworthy by requiring parent-side verification before value is claimed.\",\n\t\t\tevidenceSignal: `${input.multiAgent.delegatedEvidenceGapCount} delegated evidence gap(s) and ${input.multiAgent.nextActions.length} A2A next action(s).`,\n\t\t\tguardrail:\n\t\t\t\t\"Treat subagent summaries as self-reports until a URL, file path, task id, work graph, transcript, or test result is read back.\",\n\t\t\trecommendedArtifact: \".maestro/playbooks/multi-agent-verification.md\",\n\t\t});\n\t}\n\tif (\n\t\tinput.handoffs.followupCount > 0 ||\n\t\tinput.handoffs.openWorkCount > 0 ||\n\t\tinput.trustCards.some((card) => card.riskSignals.length > 0)\n\t) {\n\t\topportunities.push({\n\t\t\tid: \"handoff-memory-playbook\",\n\t\t\tcustomerOutcome:\n\t\t\t\t\"Convert unfinished work, blockers, and user corrections into durable next-session behavior.\",\n\t\t\tevidenceSignal: `${input.handoffs.followupCount} follow-up handoff(s), ${input.handoffs.openWorkCount} open work item(s).`,\n\t\t\tguardrail:\n\t\t\t\t\"Store user/workflow preferences as playbook steps, while keeping secrets and transient errors out of durable memory.\",\n\t\t\trecommendedArtifact: \".maestro/playbooks/customer-handoff-learning.md\",\n\t\t});\n\t}\n\treturn opportunities.slice(0, 6);\n}\n\nfunction isTransientAmbientFailureOutcome(\n\toutcome: AmbientLearnerOutcome,\n): boolean {\n\tif (outcome.success || !outcome.failureReason) return false;\n\treturn isTransientFailureText(outcome.failureReason);\n}\n\nfunction isTransientFailureText(text: string): boolean {\n\tconst normalized = text.toLowerCase();\n\treturn (\n\t\t[\n\t\t\t\"command not found\",\n\t\t\t\"no such file or directory\",\n\t\t\t\"missing binary\",\n\t\t\t\"missing credential\",\n\t\t\t\"unconfigured\",\n\t\t\t\"not configured\",\n\t\t\t\"authentication required\",\n\t\t\t\"connection refused\",\n\t\t\t\"temporary failure in name resolution\",\n\t\t].some((needle) => normalized.includes(needle)) ||\n\t\tisTransientRateLimitFailureText(normalized) ||\n\t\tisTransientTransportFailureText(normalized)\n\t);\n}\n\nfunction isTransientRateLimitFailureText(normalized: string): boolean {\n\treturn (\n\t\t[\"429 too many requests\", \"http 429\", \"status 429\"].some((needle) =>\n\t\t\tnormalized.includes(needle),\n\t\t) ||\n\t\t(normalized.includes(\"rate limit\") &&\n\t\t\thasTransientEnvironmentContext(normalized))\n\t);\n}\n\nfunction isTransientTransportFailureText(normalized: string): boolean {\n\treturn (\n\t\t[\n\t\t\t\"etimedout\",\n\t\t\t\"econnreset\",\n\t\t\t\"enotfound\",\n\t\t\t\"eai_again\",\n\t\t\t\"connection timed out\",\n\t\t\t\"socket timed out\",\n\t\t\t\"network unreachable\",\n\t\t\t\"network unavailable\",\n\t\t\t\"network reset\",\n\t\t\t\"temporary network\",\n\t\t].some((needle) => normalized.includes(needle)) ||\n\t\t([\n\t\t\t\"request timed out\",\n\t\t\t\"connect timed out\",\n\t\t\t\"fetch timed out\",\n\t\t\t\"timed out\",\n\t\t\t\"network error\",\n\t\t\t\"network failure\",\n\t\t\t\"dns lookup\",\n\t\t\t\"name resolution\",\n\t\t].some((needle) => normalized.includes(needle)) &&\n\t\t\thasTransientEnvironmentContext(normalized))\n\t);\n}\n\nfunction hasTransientEnvironmentContext(normalized: string): boolean {\n\treturn [\n\t\t\"while bootstrapping\",\n\t\t\"while fetching\",\n\t\t\"while downloading\",\n\t\t\"while installing\",\n\t\t\"while authenticating\",\n\t\t\"while connecting\",\n\t\t\"while calling\",\n\t\t\"fetching dependencies\",\n\t\t\"downloading dependencies\",\n\t\t\"installing dependencies\",\n\t\t\"dependency install\",\n\t\t\"fresh runner\",\n\t\t\"github api\",\n\t\t\"npm registry\",\n\t\t\"package registry\",\n\t].some((needle) => normalized.includes(needle));\n}\n"]}

package/dist/customer-value/internal-helpers.d.ts

@@ -0,0 +1,13 @@
+import type { CustomerValueRange } from "./report.js";
+export declare function sum<T>(values: T[], read: (value: T) => number): number;
+export declare function parseTimestampMs(timestamp: unknown): number | undefined;
+export declare function isTimestampInRange(timestamp: unknown, range: CustomerValueRange): boolean;
+export declare function isTimestampInRangeOrUnbounded(timestamp: number | undefined, range: CustomerValueRange): boolean;
+export declare function numberField(value: unknown): number | undefined;
+export declare function numberOrZero(value: unknown): number;
+export declare function slugify(text: string): string;
+export declare function truncate(text: string, maxLength: number): string;
+export declare function normalizeLine(text: string): string;
+export declare function redactLine(text: string): string;
+export declare function sanitizeA2ALabel(text: string, maxLength: number): string;
+//# sourceMappingURL=internal-helpers.d.ts.map

package/dist/customer-value/internal-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-helpers.d.ts","sourceRoot":"","sources":["../../src/customer-value/internal-helpers.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CASvE;AAED,wBAAgB,kBAAkB,CACjC,SAAS,EAAE,OAAO,EAClB,KAAK,EAAE,kBAAkB,GACvB,OAAO,CAMT;AAED,wBAAgB,6BAA6B,CAC5C,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,KAAK,EAAE,kBAAkB,GACvB,OAAO,CAIT;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAI9D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM5C;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGhE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAExE"}

package/dist/customer-value/internal-helpers.js

@@ -0,0 +1,70 @@
+/**
+ * Shared leaf helpers extracted from report.ts so that the ambient-learning
+ * subsystem and the report builder can both depend on them without creating a
+ * runtime cycle between report.ts and ambient-learning.ts.
+ *
+ * Dependency direction (runtime): report.ts -> internal-helpers.ts,
+ * ambient-learning.ts -> internal-helpers.ts. No runtime imports point back at
+ * report.ts; the CustomerValueRange reference below is type-only (erased).
+ */
+import { sanitizeWithStaticMask } from "../utils/secret-redactor.js";
+export function sum(values, read) {
+    return values.reduce((total, value) => total + read(value), 0);
+}
+export function parseTimestampMs(timestamp) {
+    if (typeof timestamp === "number" && Number.isFinite(timestamp)) {
+        return timestamp;
+    }
+    if (typeof timestamp !== "string" || timestamp.trim() === "") {
+        return undefined;
+    }
+    const parsed = Date.parse(timestamp);
+    return Number.isNaN(parsed) ? undefined : parsed;
+}
+export function isTimestampInRange(timestamp, range) {
+    const timestampMs = parseTimestampMs(timestamp);
+    if (timestampMs === undefined)
+        return false;
+    if (range.since !== undefined && timestampMs < range.since)
+        return false;
+    if (range.until !== undefined && timestampMs >= range.until)
+        return false;
+    return true;
+}
+export function isTimestampInRangeOrUnbounded(timestamp, range) {
+    if (range.since === undefined && range.until === undefined)
+        return true;
+    if (timestamp === undefined)
+        return false;
+    return isTimestampInRange(timestamp, range);
+}
+export function numberField(value) {
+    return typeof value === "number" && Number.isFinite(value)
+        ? value
+        : undefined;
+}
+export function numberOrZero(value) {
+    return numberField(value) ?? 0;
+}
+export function slugify(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-|-$/g, "")
+        .slice(0, 64);
+}
+export function truncate(text, maxLength) {
+    if (text.length <= maxLength)
+        return text;
+    return `${text.slice(0, maxLength - 3)}...`;
+}
+export function normalizeLine(text) {
+    return text.replace(/\s+/g, " ").trim();
+}
+export function redactLine(text) {
+    return sanitizeWithStaticMask(normalizeLine(text));
+}
+export function sanitizeA2ALabel(text, maxLength) {
+    return truncate(redactLine(text), maxLength);
+}
+//# sourceMappingURL=internal-helpers.js.map