@alan512/experienceengine 0.2.0 → 0.3.0

package/dist/maintenance/experience-hygiene.d.ts

@@ -0,0 +1,38 @@
+import type { AttributionRecord, ExperienceCandidate, ExperienceNode } from "../types/domain.js";
+export type HygieneFindingType = "stale_experience" | "duplicate_guidance" | "conflicting_guidance" | "over_generalized_guidance" | "evidence_drift";
+export type HygieneSeverity = "high" | "medium" | "low";
+export type HygieneReviewFilters = {
+    scopeId?: string;
+    type?: HygieneFindingType;
+    severity?: HygieneSeverity;
+    limit?: number;
+    now?: string;
+};
+export type HygieneFinding = {
+    type: HygieneFindingType;
+    severity: HygieneSeverity;
+    affectedNodeIds: string[];
+    affectedCandidateIds: string[];
+    evidenceSummary: string;
+    recommendation: string;
+    evidenceRefs: string[];
+    createdAt: string;
+};
+export type HygieneReviewReport = {
+    scopeId?: string;
+    generatedAt: string;
+    filters: Omit<HygieneReviewFilters, "now">;
+    summary: {
+        total: number;
+        byType: Record<HygieneFindingType, number>;
+        bySeverity: Record<HygieneSeverity, number>;
+    };
+    findings: HygieneFinding[];
+};
+export type BuildHygieneReviewInput = {
+    nodes: ExperienceNode[];
+    candidates: ExperienceCandidate[];
+    attributionRecords: AttributionRecord[];
+    filters?: HygieneReviewFilters;
+};
+export declare const buildHygieneReviewReport: (input: BuildHygieneReviewInput) => HygieneReviewReport;

package/dist/maintenance/experience-hygiene.js

@@ -0,0 +1,266 @@
+const FINDING_TYPES = [
+    "stale_experience",
+    "duplicate_guidance",
+    "conflicting_guidance",
+    "over_generalized_guidance",
+    "evidence_drift"
+];
+const SEVERITIES = ["high", "medium", "low"];
+const REVIEWABLE_NODE_STATES = ["candidate", "priority_candidate", "active", "cooling"];
+const REVIEWABLE_CANDIDATE_STATES = ["pending", "distilled", "failed"];
+const DEFAULT_LIMIT = 20;
+const STALE_DAYS = 90;
+const TOKEN_SIMILARITY_THRESHOLD = 0.72;
+const GENERIC_TERMS = new Set([
+    "always",
+    "before",
+    "careful",
+    "check",
+    "debug",
+    "ensure",
+    "every",
+    "first",
+    "fix",
+    "follow",
+    "issue",
+    "make",
+    "review",
+    "run",
+    "task",
+    "test",
+    "thing",
+    "use",
+    "verify",
+    "when"
+]);
+const emptyTypeCounts = () => Object.fromEntries(FINDING_TYPES.map((type) => [type, 0]));
+const emptySeverityCounts = () => Object.fromEntries(SEVERITIES.map((severity) => [severity, 0]));
+const toMillis = (value) => {
+    if (!value) {
+        return undefined;
+    }
+    const parsed = Date.parse(value);
+    return Number.isFinite(parsed) ? parsed : undefined;
+};
+const ageDays = (referenceIso, value) => {
+    const reference = toMillis(referenceIso);
+    const current = toMillis(value);
+    if (reference === undefined || current === undefined) {
+        return undefined;
+    }
+    return Math.max(0, Math.floor((reference - current) / 86_400_000));
+};
+const normalizeText = (value) => (value ?? "")
+    .toLowerCase()
+    .replace(/[^a-z0-9_/\-.]+/g, " ")
+    .split(/\s+/)
+    .filter((token) => token.length > 2);
+const guidanceTokens = (entry) => new Set([...normalizeText(entry.trigger_pattern), ...normalizeText(entry.compact_hint), ...normalizeText(entry.retrieval_text)]);
+const tokenSimilarity = (left, right) => {
+    if (!left.size || !right.size) {
+        return 0;
+    }
+    let overlap = 0;
+    for (const token of left) {
+        if (right.has(token)) {
+            overlap += 1;
+        }
+    }
+    return overlap / Math.max(left.size, right.size);
+};
+const hasGenericGuidance = (entry) => {
+    const tokens = normalizeText(`${entry.trigger_pattern} ${entry.compact_hint}`);
+    const hasSpecificSignal = tokens.some((token) => token.includes("/") || token.includes(".") || token.includes("_") || token.length >= 12);
+    if (tokens.length < 8) {
+        return !hasSpecificSignal;
+    }
+    const genericCount = tokens.filter((token) => GENERIC_TERMS.has(token)).length;
+    return genericCount / tokens.length >= 0.45;
+};
+const hasRecommendationConflict = (left, right) => {
+    const leftRecommended = new Set((left.recommended_steps ?? []).flatMap(normalizeText));
+    const leftAvoided = new Set((left.avoid_steps ?? []).flatMap(normalizeText));
+    const rightRecommended = new Set((right.recommended_steps ?? []).flatMap(normalizeText));
+    const rightAvoided = new Set((right.avoid_steps ?? []).flatMap(normalizeText));
+    const overlaps = (a, b) => {
+        for (const token of a) {
+            if (b.has(token) && !GENERIC_TERMS.has(token)) {
+                return true;
+            }
+        }
+        return false;
+    };
+    return overlaps(leftRecommended, rightAvoided) || overlaps(rightRecommended, leftAvoided);
+};
+const sortFindings = (findings) => {
+    const severityRank = { high: 0, medium: 1, low: 2 };
+    return findings.sort((left, right) => {
+        const severityDelta = severityRank[left.severity] - severityRank[right.severity];
+        if (severityDelta !== 0) {
+            return severityDelta;
+        }
+        const timeDelta = (toMillis(right.createdAt) ?? 0) - (toMillis(left.createdAt) ?? 0);
+        if (timeDelta !== 0) {
+            return timeDelta;
+        }
+        return left.type.localeCompare(right.type) || left.affectedNodeIds.join(",").localeCompare(right.affectedNodeIds.join(","));
+    });
+};
+export const buildHygieneReviewReport = (input) => {
+    const filters = input.filters ?? {};
+    const generatedAt = filters.now ?? new Date().toISOString();
+    const nodes = input.nodes.filter((node) => (!filters.scopeId || node.scope_id === filters.scopeId) && REVIEWABLE_NODE_STATES.includes(node.state));
+    const candidates = input.candidates.filter((candidate) => (!filters.scopeId || candidate.scope_id === filters.scopeId) && REVIEWABLE_CANDIDATE_STATES.includes(candidate.lifecycle_state));
+    const attributionByNode = new Map();
+    for (const record of input.attributionRecords) {
+        if (!filters.scopeId || nodes.some((node) => node.id === record.node_id)) {
+            const records = attributionByNode.get(record.node_id) ?? [];
+            records.push(record);
+            attributionByNode.set(record.node_id, records);
+        }
+    }
+    const findings = [];
+    for (const node of nodes.filter((candidate) => candidate.state === "active" || candidate.state === "cooling")) {
+        const lastPositive = node.last_helped_at;
+        const lastEvidenceAt = node.last_used_at ?? node.updated_at;
+        const staleAge = ageDays(generatedAt, lastEvidenceAt);
+        if ((staleAge ?? 0) >= STALE_DAYS && !lastPositive) {
+            findings.push({
+                type: "stale_experience",
+                severity: node.delivery_state === "eligible" ? "medium" : "low",
+                affectedNodeIds: [node.id],
+                affectedCandidateIds: [],
+                evidenceSummary: `Node has no recent helped attribution and has not been used for ${staleAge} day(s).`,
+                recommendation: "Inspect this node and review whether cooling or retirement should be handled through explicit lifecycle controls.",
+                evidenceRefs: node.origin_record_ids,
+                createdAt: node.last_used_at ?? node.updated_at
+            });
+        }
+    }
+    for (let i = 0; i < nodes.length; i += 1) {
+        for (let j = i + 1; j < nodes.length; j += 1) {
+            const left = nodes[i];
+            const right = nodes[j];
+            if (left.scope_id !== right.scope_id || left.task_type !== right.task_type) {
+                continue;
+            }
+            const similarity = tokenSimilarity(guidanceTokens(left), guidanceTokens(right));
+            if (similarity >= TOKEN_SIMILARITY_THRESHOLD) {
+                findings.push({
+                    type: "duplicate_guidance",
+                    severity: "medium",
+                    affectedNodeIds: [left.id, right.id],
+                    affectedCandidateIds: [],
+                    evidenceSummary: `Same-scope ${left.task_type} nodes have ${similarity.toFixed(2)} lexical guidance overlap.`,
+                    recommendation: "Review whether these nodes should stay separate or be merged through a separate explicit workflow.",
+                    evidenceRefs: [...left.origin_record_ids, ...right.origin_record_ids],
+                    createdAt: left.updated_at > right.updated_at ? left.updated_at : right.updated_at
+                });
+            }
+            if (hasRecommendationConflict(left, right)) {
+                findings.push({
+                    type: "conflicting_guidance",
+                    severity: "high",
+                    affectedNodeIds: [left.id, right.id],
+                    affectedCandidateIds: [],
+                    evidenceSummary: `Same-scope ${left.task_type} nodes contain overlapping recommended and avoided paths.`,
+                    recommendation: "Review the conflicting guidance before allowing either lesson to guide similar work.",
+                    evidenceRefs: [...left.origin_record_ids, ...right.origin_record_ids],
+                    createdAt: left.updated_at > right.updated_at ? left.updated_at : right.updated_at
+                });
+            }
+        }
+    }
+    for (const candidate of candidates) {
+        for (const node of nodes) {
+            if (candidate.scope_id !== node.scope_id || candidate.task_type !== node.task_type) {
+                continue;
+            }
+            const similarity = tokenSimilarity(guidanceTokens(candidate), guidanceTokens(node));
+            if (similarity >= TOKEN_SIMILARITY_THRESHOLD) {
+                findings.push({
+                    type: "duplicate_guidance",
+                    severity: "low",
+                    affectedNodeIds: [node.id],
+                    affectedCandidateIds: [candidate.id],
+                    evidenceSummary: `Raw candidate overlaps with existing node at ${similarity.toFixed(2)} lexical guidance similarity.`,
+                    recommendation: "Review the candidate before promotion; do not discard or merge it from the hygiene report.",
+                    evidenceRefs: [candidate.source_record_id, ...node.origin_record_ids],
+                    createdAt: candidate.updated_at > node.updated_at ? candidate.updated_at : node.updated_at
+                });
+            }
+        }
+    }
+    for (const node of nodes) {
+        const harmedRatio = node.harmed_count / Math.max(1, node.helped_count + node.harmed_count);
+        if (hasGenericGuidance(node) && (node.support_count <= 1 || harmedRatio >= 0.4)) {
+            findings.push({
+                type: "over_generalized_guidance",
+                severity: harmedRatio >= 0.5 ? "high" : "medium",
+                affectedNodeIds: [node.id],
+                affectedCandidateIds: [],
+                evidenceSummary: "Node wording is broad while support is weak or harm evidence is elevated.",
+                recommendation: "Review whether the lesson should be narrowed, cooled, or retired through explicit controls.",
+                evidenceRefs: [...node.origin_record_ids, ...node.harmed_record_ids],
+                createdAt: node.last_harmed_at ?? node.updated_at
+            });
+        }
+    }
+    for (const candidate of candidates) {
+        if (hasGenericGuidance(candidate) && candidate.lifecycle_state !== "discarded") {
+            findings.push({
+                type: "over_generalized_guidance",
+                severity: "low",
+                affectedNodeIds: [],
+                affectedCandidateIds: [candidate.id],
+                evidenceSummary: "Raw candidate wording is broad and should be checked before promotion.",
+                recommendation: "Review whether the candidate needs narrower trigger or hint wording before distillation.",
+                evidenceRefs: [candidate.source_record_id],
+                createdAt: candidate.updated_at
+            });
+        }
+    }
+    for (const node of nodes) {
+        if (node.delivery_state !== "eligible" && node.delivery_state !== "conservative_only") {
+            continue;
+        }
+        const recentHarm = (attributionByNode.get(node.id) ?? []).find((record) => record.attribution_verdict === "strong_harmed" || record.attribution_verdict === "weak_harmed");
+        if (recentHarm) {
+            findings.push({
+                type: "evidence_drift",
+                severity: recentHarm.attribution_verdict === "strong_harmed" ? "high" : "medium",
+                affectedNodeIds: [node.id],
+                affectedCandidateIds: [],
+                evidenceSummary: `Delivery-state ${node.delivery_state} node has recent ${recentHarm.attribution_verdict} attribution evidence.`,
+                recommendation: "Inspect the attribution evidence before relying on this node in similar live tasks.",
+                evidenceRefs: recentHarm.evidence_refs,
+                createdAt: recentHarm.created_at
+            });
+        }
+    }
+    const filtered = sortFindings(findings).filter((finding) => (!filters.type || finding.type === filters.type) && (!filters.severity || finding.severity === filters.severity));
+    const bounded = filtered.slice(0, filters.limit ?? DEFAULT_LIMIT);
+    const byType = emptyTypeCounts();
+    const bySeverity = emptySeverityCounts();
+    for (const finding of bounded) {
+        byType[finding.type] += 1;
+        bySeverity[finding.severity] += 1;
+    }
+    return {
+        scopeId: filters.scopeId,
+        generatedAt,
+        filters: {
+            scopeId: filters.scopeId,
+            type: filters.type,
+            severity: filters.severity,
+            limit: filters.limit ?? DEFAULT_LIMIT
+        },
+        summary: {
+            total: bounded.length,
+            byType,
+            bySeverity
+        },
+        findings: bounded
+    };
+};
+//# sourceMappingURL=experience-hygiene.js.map

package/dist/maintenance/experience-hygiene.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"experience-hygiene.js","sourceRoot":"","sources":["../../src/maintenance/experience-hygiene.ts"],"names":[],"mappings":"AAuDA,MAAM,aAAa,GAAyB;IAC1C,kBAAkB;IAClB,oBAAoB;IACpB,sBAAsB;IACtB,2BAA2B;IAC3B,gBAAgB;CACjB,CAAC;AACF,MAAM,UAAU,GAAsB,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;AAChE,MAAM,sBAAsB,GAAsB,CAAC,WAAW,EAAE,oBAAoB,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;AAC3G,MAAM,2BAA2B,GAA8B,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;AAClG,MAAM,aAAa,GAAG,EAAE,CAAC;AACzB,MAAM,UAAU,GAAG,EAAE,CAAC;AACtB,MAAM,0BAA0B,GAAG,IAAI,CAAC;AACxC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IAC5B,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,OAAO;IACP,OAAO;IACP,QAAQ;IACR,OAAO;IACP,OAAO;IACP,KAAK;IACL,QAAQ;IACR,OAAO;IACP,MAAM;IACN,QAAQ;IACR,KAAK;IACL,MAAM;IACN,MAAM;IACN,OAAO;IACP,KAAK;IACL,QAAQ;IACR,MAAM;CACP,CAAC,CAAC;AAEH,MAAM,eAAe,GAAG,GAAuC,EAAE,CAC/D,MAAM,CAAC,WAAW,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAuC,CAAC;AAEnG,MAAM,mBAAmB,GAAG,GAAoC,EAAE,CAChE,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAoC,CAAC;AAErG,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAsB,EAAE;IACtD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACjC,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACtD,CAAC,CAAC;AAEF,MAAM,OAAO,GAAG,CAAC,YAAoB,EAAE,KAAc,EAAsB,EAAE;IAC3E,MAAM,SAAS,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,SAAS,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QACrD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,OAAO,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;AACrE,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,KAAyB,EAAY,EAAE,CAC5D,CAAC,KAAK,IAAI,EAAE,CAAC;KACV,WAAW,EAAE;KACb,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC;KAChC,KAAK,CAAC,KAAK,CAAC;KACZ,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAEzC,MAAM,cAAc,GAAG,CAAC,KAAwG,EAAe,EAAE,CAC/I,IAAI,GAAG,CAAC,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,GAAG,aAAa,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,GAAG,aAAa,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;AAEnI,MAAM,eAAe,GAAG,CAAC,IAAiB,EAAE,KAAkB,EAAU,EAAE;IACxE,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC9B,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC;QACzB,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;AACnD,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,KAAqF,EAAW,EAAE;IAC5H,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,KAAK,CAAC,eAAe,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC;IAC/E,MAAM,iBAAiB,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IAC1I,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,iBAAiB,CAAC;IAC5B,CAAC;IACD,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IAC/E,OAAO,YAAY,GAAG,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC;AAC9C,CAAC,CAAC;AAEF,MAAM,yBAAyB,GAAG,CAChC,IAAqF,EACrF,KAAsF,EAC7E,EAAE;IACX,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;IACvF,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;IAC7E,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;IACzF,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC;IAC/E,MAAM,QAAQ,GAAG,CAAC,CAAc,EAAE,CAAc,EAAW,EAAE;QAC3D,KAAK,MAAM,KAAK,IAAI,CAAC,EAAE,CAAC;YACtB,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9C,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IACF,OAAO,QAAQ,CAAC,eAAe,EAAE,YAAY,CAAC,IAAI,QAAQ,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC;AAC5F,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,QAA0B,EAAoB,EAAE;IACpE,MAAM,YAAY,GAAoC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;IACrF,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACnC,MAAM,aAAa,GAAG,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACjF,IAAI,aAAa,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,aAAa,CAAC;QACvB,CAAC;QACD,MAAM,SAAS,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QACrF,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;YACpB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9H,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,KAA8B,EAAuB,EAAE;IAC9F,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;IACpC,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5D,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAC9B,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,KAAK,OAAO,CAAC,OAAO,CAAC,IAAI,sBAAsB,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CACjH,CAAC;IACF,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,MAAM,CACxC,CAAC,SAAS,EAAE,EAAE,CACZ,CAAC,CAAC,OAAO,CAAC,OAAO,IAAI,SAAS,CAAC,QAAQ,KAAK,OAAO,CAAC,OAAO,CAAC,IAAI,2BAA2B,CAAC,QAAQ,CAAC,SAAS,CAAC,eAAe,CAAC,CAClI,CAAC;IACF,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAA+B,CAAC;IACjE,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,kBAAkB,EAAE,CAAC;QAC9C,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YACzE,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAC5D,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrB,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAqB,EAAE,CAAC;IAEtC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,KAAK,QAAQ,IAAI,SAAS,CAAC,KAAK,KAAK,SAAS,CAAC,EAAE,CAAC;QAC9G,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC;QACzC,MAAM,cAAc,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,UAAU,CAAC;QAC5D,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;QACtD,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,UAAU,IAAI,CAAC,YAAY,EAAE,CAAC;YACnD,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,kBAAkB;gBACxB,QAAQ,EAAE,IAAI,CAAC,cAAc,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK;gBAC/D,eAAe,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1B,oBAAoB,EAAE,EAAE;gBACxB,eAAe,EAAE,mEAAmE,QAAQ,UAAU;gBACtG,cAAc,EAAE,mHAAmH;gBACnI,YAAY,EAAE,IAAI,CAAC,iBAAiB;gBACpC,SAAS,EAAE,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,UAAU;aAChD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACvB,IAAI,IAAI,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS,EAAE,CAAC;gBAC3E,SAAS;YACX,CAAC;YACD,MAAM,UAAU,GAAG,eAAe,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;YAChF,IAAI,UAAU,IAAI,0BAA0B,EAAE,CAAC;gBAC7C,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,oBAAoB;oBAC1B,QAAQ,EAAE,QAAQ;oBAClB,eAAe,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,CAAC;oBACpC,oBAAoB,EAAE,EAAE;oBACxB,eAAe,EAAE,cAAc,IAAI,CAAC,SAAS,eAAe,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,4BAA4B;oBAC7G,cAAc,EAAE,oGAAoG;oBACpH,YAAY,EAAE,CAAC,GAAG,IAAI,CAAC,iBAAiB,EAAE,GAAG,KAAK,CAAC,iBAAiB,CAAC;oBACrE,SAAS,EAAE,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU;iBACnF,CAAC,CAAC;YACL,CAAC;YAED,IAAI,yBAAyB,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;gBAC3C,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,sBAAsB;oBAC5B,QAAQ,EAAE,MAAM;oBAChB,eAAe,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,CAAC;oBACpC,oBAAoB,EAAE,EAAE;oBACxB,eAAe,EAAE,cAAc,IAAI,CAAC,SAAS,2DAA2D;oBACxG,cAAc,EAAE,sFAAsF;oBACtG,YAAY,EAAE,CAAC,GAAG,IAAI,CAAC,iBAAiB,EAAE,GAAG,KAAK,CAAC,iBAAiB,CAAC;oBACrE,SAAS,EAAE,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU;iBACnF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,SAAS,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,IAAI,SAAS,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;gBACnF,SAAS;YACX,CAAC;YACD,MAAM,UAAU,GAAG,eAAe,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;YACpF,IAAI,UAAU,IAAI,0BAA0B,EAAE,CAAC;gBAC7C,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,oBAAoB;oBAC1B,QAAQ,EAAE,KAAK;oBACf,eAAe,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC1B,oBAAoB,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC;oBACpC,eAAe,EAAE,gDAAgD,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,+BAA+B;oBACrH,cAAc,EAAE,4FAA4F;oBAC5G,YAAY,EAAE,CAAC,SAAS,CAAC,gBAAgB,EAAE,GAAG,IAAI,CAAC,iBAAiB,CAAC;oBACrE,SAAS,EAAE,SAAS,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU;iBAC3F,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC;QAC3F,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,IAAI,WAAW,IAAI,GAAG,CAAC,EAAE,CAAC;YAChF,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,2BAA2B;gBACjC,QAAQ,EAAE,WAAW,IAAI,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;gBAChD,eAAe,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1B,oBAAoB,EAAE,EAAE;gBACxB,eAAe,EAAE,2EAA2E;gBAC5F,cAAc,EAAE,6FAA6F;gBAC7G,YAAY,EAAE,CAAC,GAAG,IAAI,CAAC,iBAAiB,EAAE,GAAG,IAAI,CAAC,iBAAiB,CAAC;gBACpE,SAAS,EAAE,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,UAAU;aAClD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,kBAAkB,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,eAAe,KAAK,WAAW,EAAE,CAAC;YAC/E,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,2BAA2B;gBACjC,QAAQ,EAAE,KAAK;gBACf,eAAe,EAAE,EAAE;gBACnB,oBAAoB,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC;gBACpC,eAAe,EAAE,wEAAwE;gBACzF,cAAc,EAAE,0FAA0F;gBAC1G,YAAY,EAAE,CAAC,SAAS,CAAC,gBAAgB,CAAC;gBAC1C,SAAS,EAAE,SAAS,CAAC,UAAU;aAChC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,cAAc,KAAK,UAAU,IAAI,IAAI,CAAC,cAAc,KAAK,mBAAmB,EAAE,CAAC;YACtF,SAAS;QACX,CAAC;QACD,MAAM,UAAU,GAAG,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAC5D,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,mBAAmB,KAAK,eAAe,IAAI,MAAM,CAAC,mBAAmB,KAAK,aAAa,CAC3G,CAAC;QACF,IAAI,UAAU,EAAE,CAAC;YACf,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,gBAAgB;gBACtB,QAAQ,EAAE,UAAU,CAAC,mBAAmB,KAAK,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;gBAChF,eAAe,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1B,oBAAoB,EAAE,EAAE;gBACxB,eAAe,EAAE,kBAAkB,IAAI,CAAC,cAAc,oBAAoB,UAAU,CAAC,mBAAmB,wBAAwB;gBAChI,cAAc,EAAE,qFAAqF;gBACrG,YAAY,EAAE,UAAU,CAAC,aAAa;gBACtC,SAAS,EAAE,UAAU,CAAC,UAAU;aACjC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,MAAM,CAC5C,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,QAAQ,CAAC,CAC9H,CAAC;IACF,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,IAAI,aAAa,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IACjC,MAAM,UAAU,GAAG,mBAAmB,EAAE,CAAC;IACzC,KAAK,MAAM,OAAO,IAAI,OAAO,EAAE,CAAC;QAC9B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,WAAW;QACX,OAAO,EAAE;YACP,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,aAAa;SACtC;QACD,OAAO,EAAE;YACP,KAAK,EAAE,OAAO,CAAC,MAAM;YACrB,MAAM;YACN,UAAU;SACX;QACD,QAAQ,EAAE,OAAO;KAClB,CAAC;AACJ,CAAC,CAAC"}

package/dist/maintenance/operator-review-flow.d.ts

@@ -0,0 +1,81 @@
+import type { ExperienceRepoSummary } from "../interaction/repo-summary.js";
+import type { ExperienceExportDraftReport } from "./experience-export-drafts.js";
+import type { HygieneReviewReport } from "./experience-hygiene.js";
+export type OperatorReviewPriority = "high" | "medium" | "low";
+export type OperatorReviewSource = "repo_policy" | "hygiene" | "export_drafts";
+export type RepoPolicyReviewHealth = "clear" | "attention" | "tripped";
+export type OperatorReviewDrillDown = {
+    cli: string;
+    mcpResource?: string;
+    brokerAction?: string;
+};
+export type OperatorReviewItem = {
+    priority: OperatorReviewPriority;
+    source: OperatorReviewSource;
+    title: string;
+    summary: string;
+    drillDown: OperatorReviewDrillDown;
+};
+export type OperatorReviewNextAction = {
+    priority: OperatorReviewPriority;
+    summary: string;
+    drillDown?: OperatorReviewDrillDown;
+};
+export type OperatorReviewReport = {
+    scopeId: string;
+    generatedAt: string;
+    filters: {
+        scopeId?: string;
+        limit: number;
+    };
+    sections: {
+        repo_policy: {
+            health: RepoPolicyReviewHealth;
+            configuredMode?: string;
+            effectiveMode?: string;
+            circuitState?: string;
+            circuitReason?: string;
+            summary: string;
+            drillDown: OperatorReviewDrillDown;
+        };
+        hygiene: {
+            total: number;
+            high: number;
+            medium: number;
+            low: number;
+            surfacedFindings: Array<{
+                severity: "high" | "medium" | "low";
+                type: string;
+                summary: string;
+                affectedNodeIds: string[];
+                affectedCandidateIds: string[];
+            }>;
+            drillDown: OperatorReviewDrillDown;
+        };
+        export_drafts: {
+            total: number;
+            highRisk: number;
+            mediumRisk: number;
+            lowRisk: number;
+            surfacedDrafts: Array<{
+                draftId: string;
+                nodeIds: string[];
+                risk: "high" | "medium" | "low";
+                suggestedTargetType: string;
+                summary: string;
+            }>;
+            drillDown: OperatorReviewDrillDown;
+        };
+    };
+    reviewItems: OperatorReviewItem[];
+    recommendedReviewOrder: OperatorReviewSource[];
+    reviewOnlyNextActions: OperatorReviewNextAction[];
+};
+export type BuildOperatorReviewFlowInput = {
+    repo: ExperienceRepoSummary;
+    hygiene: HygieneReviewReport;
+    exportDrafts: ExperienceExportDraftReport;
+    limit?: number;
+    generatedAt?: string;
+};
+export declare const buildOperatorReviewFlow: (input: BuildOperatorReviewFlowInput) => OperatorReviewReport;

package/dist/maintenance/operator-review-flow.js

@@ -0,0 +1,172 @@
+const DEFAULT_LIMIT = 5;
+const PRIORITY_RANK = { high: 0, medium: 1, low: 2 };
+const SOURCE_RANK = { repo_policy: 0, hygiene: 1, export_drafts: 2 };
+const drillDowns = () => ({
+    repo_policy: {
+        cli: "ee inspect repo",
+        mcpResource: "experienceengine://repo-summary"
+    },
+    hygiene: {
+        cli: "ee inspect hygiene",
+        mcpResource: "experienceengine://hygiene",
+        brokerAction: "inspect_experience_hygiene"
+    },
+    export_drafts: {
+        cli: "ee inspect export-drafts",
+        mcpResource: "experienceengine://export-drafts",
+        brokerAction: "inspect_export_drafts"
+    }
+});
+const policyHealth = (repo) => {
+    if (repo.policy?.circuitState === "tripped") {
+        return "tripped";
+    }
+    if (repo.benchmark.verdict === "failing" || repo.policy?.effectiveMode === "strict") {
+        return "attention";
+    }
+    return "clear";
+};
+const policySummary = (repo, health) => {
+    if (health === "tripped") {
+        return repo.policy?.circuitReason ?? "Repo policy circuit is tripped.";
+    }
+    if (health === "attention") {
+        return `Repo review needs attention: benchmark=${repo.benchmark.verdict}, effectiveMode=${repo.policy?.effectiveMode ?? "unknown"}.`;
+    }
+    return "Repo policy is clear for normal review.";
+};
+const addReviewItem = (items, item) => {
+    items.push(item);
+};
+const sortedItems = (items) => [...items].sort((left, right) => {
+    const priorityDelta = PRIORITY_RANK[left.priority] - PRIORITY_RANK[right.priority];
+    if (priorityDelta !== 0) {
+        return priorityDelta;
+    }
+    return SOURCE_RANK[left.source] - SOURCE_RANK[right.source] || left.title.localeCompare(right.title);
+});
+const reviewOrder = (items) => {
+    const order = [];
+    for (const item of sortedItems(items)) {
+        if (!order.includes(item.source)) {
+            order.push(item.source);
+        }
+    }
+    for (const source of ["repo_policy", "hygiene", "export_drafts"]) {
+        if (!order.includes(source)) {
+            order.push(source);
+        }
+    }
+    return order;
+};
+export const buildOperatorReviewFlow = (input) => {
+    const limit = input.limit ?? DEFAULT_LIMIT;
+    const scopeId = input.repo.scope.scopeId;
+    const drillDown = drillDowns();
+    const health = policyHealth(input.repo);
+    const items = [];
+    if (health === "tripped") {
+        addReviewItem(items, {
+            priority: "high",
+            source: "repo_policy",
+            title: "Repo policy circuit is tripped",
+            summary: policySummary(input.repo, health),
+            drillDown: drillDown.repo_policy
+        });
+    }
+    else if (health === "attention") {
+        addReviewItem(items, {
+            priority: "medium",
+            source: "repo_policy",
+            title: "Repo policy needs attention",
+            summary: policySummary(input.repo, health),
+            drillDown: drillDown.repo_policy
+        });
+    }
+    for (const finding of input.hygiene.findings.slice(0, limit)) {
+        addReviewItem(items, {
+            priority: finding.severity,
+            source: "hygiene",
+            title: `${finding.type} hygiene finding`,
+            summary: finding.evidenceSummary,
+            drillDown: drillDown.hygiene
+        });
+    }
+    const riskyHygiene = input.hygiene.summary.bySeverity.high > 0;
+    for (const draft of input.exportDrafts.drafts.slice(0, limit)) {
+        const priority = draft.risk === "high" ? "high" : draft.risk === "medium" || riskyHygiene ? "medium" : "low";
+        addReviewItem(items, {
+            priority,
+            source: "export_drafts",
+            title: `Export draft ${draft.draftId}`,
+            summary: riskyHygiene
+                ? `Review hygiene risk before exporting ${draft.suggestedTargetType}.`
+                : `Review ${draft.suggestedTargetType} candidate for ${draft.taskFamily}.`,
+            drillDown: drillDown.export_drafts
+        });
+    }
+    const reviewItems = sortedItems(items);
+    const nextActions = reviewItems.length
+        ? reviewItems.slice(0, 3).map((item) => ({
+            priority: item.priority,
+            summary: `Review ${item.source}: ${item.summary}`,
+            drillDown: item.drillDown
+        }))
+        : [
+            {
+                priority: "low",
+                summary: "No immediate review items. Keep monitoring repo policy, hygiene, and export drafts."
+            }
+        ];
+    return {
+        scopeId,
+        generatedAt: input.generatedAt ?? new Date().toISOString(),
+        filters: {
+            scopeId,
+            limit
+        },
+        sections: {
+            repo_policy: {
+                health,
+                configuredMode: input.repo.policy?.configuredMode,
+                effectiveMode: input.repo.policy?.effectiveMode,
+                circuitState: input.repo.policy?.circuitState,
+                circuitReason: input.repo.policy?.circuitReason,
+                summary: policySummary(input.repo, health),
+                drillDown: drillDown.repo_policy
+            },
+            hygiene: {
+                total: input.hygiene.summary.total,
+                high: input.hygiene.summary.bySeverity.high,
+                medium: input.hygiene.summary.bySeverity.medium,
+                low: input.hygiene.summary.bySeverity.low,
+                surfacedFindings: input.hygiene.findings.slice(0, limit).map((finding) => ({
+                    severity: finding.severity,
+                    type: finding.type,
+                    summary: finding.evidenceSummary,
+                    affectedNodeIds: finding.affectedNodeIds,
+                    affectedCandidateIds: finding.affectedCandidateIds
+                })),
+                drillDown: drillDown.hygiene
+            },
+            export_drafts: {
+                total: input.exportDrafts.summary.total,
+                highRisk: input.exportDrafts.summary.byRisk.high,
+                mediumRisk: input.exportDrafts.summary.byRisk.medium,
+                lowRisk: input.exportDrafts.summary.byRisk.low,
+                surfacedDrafts: input.exportDrafts.drafts.slice(0, limit).map((draft) => ({
+                    draftId: draft.draftId,
+                    nodeIds: draft.nodeIds,
+                    risk: draft.risk,
+                    suggestedTargetType: draft.suggestedTargetType,
+                    summary: draft.evidenceSummary
+                })),
+                drillDown: drillDown.export_drafts
+            }
+        },
+        reviewItems,
+        recommendedReviewOrder: reviewOrder(reviewItems),
+        reviewOnlyNextActions: nextActions
+    };
+};
+//# sourceMappingURL=operator-review-flow.js.map

package/dist/maintenance/operator-review-flow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operator-review-flow.js","sourceRoot":"","sources":["../../src/maintenance/operator-review-flow.ts"],"names":[],"mappings":"AAuFA,MAAM,aAAa,GAAG,CAAC,CAAC;AACxB,MAAM,aAAa,GAA2C,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;AAC7F,MAAM,WAAW,GAAyC,EAAE,WAAW,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;AAE3G,MAAM,UAAU,GAAG,GAAG,EAAE,CAAC,CAAC;IACxB,WAAW,EAAE;QACX,GAAG,EAAE,iBAAiB;QACtB,WAAW,EAAE,iCAAiC;KAC/C;IACD,OAAO,EAAE;QACP,GAAG,EAAE,oBAAoB;QACzB,WAAW,EAAE,4BAA4B;QACzC,YAAY,EAAE,4BAA4B;KAC3C;IACD,aAAa,EAAE;QACb,GAAG,EAAE,0BAA0B;QAC/B,WAAW,EAAE,kCAAkC;QAC/C,YAAY,EAAE,uBAAuB;KACtC;CACF,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,CAAC,IAA2B,EAA0B,EAAE;IAC3E,IAAI,IAAI,CAAC,MAAM,EAAE,YAAY,KAAK,SAAS,EAAE,CAAC;QAC5C,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,EAAE,aAAa,KAAK,QAAQ,EAAE,CAAC;QACpF,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,IAA2B,EAAE,MAA8B,EAAU,EAAE;IAC5F,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,MAAM,EAAE,aAAa,IAAI,iCAAiC,CAAC;IACzE,CAAC;IACD,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;QAC3B,OAAO,0CAA0C,IAAI,CAAC,SAAS,CAAC,OAAO,mBAAmB,IAAI,CAAC,MAAM,EAAE,aAAa,IAAI,SAAS,GAAG,CAAC;IACvI,CAAC;IACD,OAAO,yCAAyC,CAAC;AACnD,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,KAA2B,EAAE,IAAwB,EAAQ,EAAE;IACpF,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,KAA2B,EAAwB,EAAE,CACxE,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;IAC9B,MAAM,aAAa,GAAG,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACnF,IAAI,aAAa,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,OAAO,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACvG,CAAC,CAAC,CAAC;AAEL,MAAM,WAAW,GAAG,CAAC,KAA2B,EAA0B,EAAE;IAC1E,MAAM,KAAK,GAA2B,EAAE,CAAC;IACzC,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;QACtC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,CAAC,aAAa,EAAE,SAAS,EAAE,eAAe,CAA2B,EAAE,CAAC;QAC3F,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,KAAmC,EAAwB,EAAE;IACnG,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,aAAa,CAAC;IAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;IACzC,MAAM,SAAS,GAAG,UAAU,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,KAAK,GAAyB,EAAE,CAAC;IAEvC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,aAAa,CAAC,KAAK,EAAE;YACnB,QAAQ,EAAE,MAAM;YAChB,MAAM,EAAE,aAAa;YACrB,KAAK,EAAE,gCAAgC;YACvC,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC;YAC1C,SAAS,EAAE,SAAS,CAAC,WAAW;SACjC,CAAC,CAAC;IACL,CAAC;SAAM,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,aAAa,CAAC,KAAK,EAAE;YACnB,QAAQ,EAAE,QAAQ;YAClB,MAAM,EAAE,aAAa;YACrB,KAAK,EAAE,6BAA6B;YACpC,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC;YAC1C,SAAS,EAAE,SAAS,CAAC,WAAW;SACjC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC;QAC7D,aAAa,CAAC,KAAK,EAAE;YACnB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE,GAAG,OAAO,CAAC,IAAI,kBAAkB;YACxC,OAAO,EAAE,OAAO,CAAC,eAAe;YAChC,SAAS,EAAE,SAAS,CAAC,OAAO;SAC7B,CAAC,CAAC;IACL,CAAC;IAED,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,CAAC;IAC/D,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC;QAC9D,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;QAC7G,aAAa,CAAC,KAAK,EAAE;YACnB,QAAQ;YACR,MAAM,EAAE,eAAe;YACvB,KAAK,EAAE,gBAAgB,KAAK,CAAC,OAAO,EAAE;YACtC,OAAO,EAAE,YAAY;gBACnB,CAAC,CAAC,wCAAwC,KAAK,CAAC,mBAAmB,GAAG;gBACtE,CAAC,CAAC,UAAU,KAAK,CAAC,mBAAmB,kBAAkB,KAAK,CAAC,UAAU,GAAG;YAC5E,SAAS,EAAE,SAAS,CAAC,aAAa;SACnC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,WAAW,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,WAAW,GAAG,WAAW,CAAC,MAAM;QACpC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACrC,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO,EAAE,UAAU,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,OAAO,EAAE;YACjD,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;QACL,CAAC,CAAC;YACE;gBACE,QAAQ,EAAE,KAAc;gBACxB,OAAO,EAAE,qFAAqF;aAC/F;SACF,CAAC;IAEN,OAAO;QACL,OAAO;QACP,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC1D,OAAO,EAAE;YACP,OAAO;YACP,KAAK;SACN;QACD,QAAQ,EAAE;YACR,WAAW,EAAE;gBACX,MAAM;gBACN,cAAc,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc;gBACjD,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa;gBAC/C,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY;gBAC7C,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa;gBAC/C,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC;gBAC1C,SAAS,EAAE,SAAS,CAAC,WAAW;aACjC;YACD,OAAO,EAAE;gBACP,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK;gBAClC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI;gBAC3C,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM;gBAC/C,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG;gBACzC,gBAAgB,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;oBACzE,QAAQ,EAAE,OAAO,CAAC,QAAQ;oBAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,OAAO,EAAE,OAAO,CAAC,eAAe;oBAChC,eAAe,EAAE,OAAO,CAAC,eAAe;oBACxC,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;iBACnD,CAAC,CAAC;gBACH,SAAS,EAAE,SAAS,CAAC,OAAO;aAC7B;YACD,aAAa,EAAE;gBACb,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK;gBACvC,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI;gBAChD,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM;gBACpD,OAAO,EAAE,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG;gBAC9C,cAAc,EAAE,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;oBACxE,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;oBAC9C,OAAO,EAAE,KAAK,CAAC,eAAe;iBAC/B,CAAC,CAAC;gBACH,SAAS,EAAE,SAAS,CAAC,aAAa;aACnC;SACF;QACD,WAAW;QACX,sBAAsB,EAAE,WAAW,CAAC,WAAW,CAAC;QAChD,qBAAqB,EAAE,WAAW;KACnC,CAAC;AACJ,CAAC,CAAC"}

package/dist/plugin/openclaw-plugin.d.ts

@@ -74,6 +74,11 @@ declare const plugin: {
                 readonly enum: readonly ["live", "shadow", "holdout"];
                 readonly description: "Controls whether ExperienceEngine delivers interventions live, suppresses them in shadow mode, or randomly withholds them for holdout evaluation.";
             };
+            readonly repoExperienceMode: {
+                readonly type: "string";
+                readonly enum: readonly ["safe", "fast_learning", "strict"];
+                readonly description: "Repo-level policy mode for diagnostic candidate aggressiveness. It does not override disabled scopes or delivery-state safety gates.";
+            };
             readonly holdoutRate: {
                 readonly type: "number";
                 readonly minimum: 0;