@alan512/experienceengine 0.3.4 → 0.3.6

package/dist/maintenance/hygiene-governance-llm-planner.js

@@ -0,0 +1,169 @@
+import { resolveDistillerEndpoint } from "../distillation/host-llm.js";
+const SYSTEM_PROMPT = [
+    "You are the autonomous hygiene governance planner for ExperienceEngine.",
+    "Return strict JSON only with shape {\"source\":\"llm\",\"scopeId\":\"...\",\"findingHash\":\"...\",\"clusters\":[],\"actions\":[]}.",
+    "Use only ids present in the input. Do not invent node ids, candidate ids, evidence refs, action types, or scope ids.",
+    "Cluster semantic duplicates, overlapping applicability, and conflicting guidance.",
+    "For every high or medium severity conflict cluster, include at least one governance action.",
+    "When the safe mutation is uncertain, still propose a high-risk guarded action instead of leaving the cluster actionless.",
+    "Prefer safe, evidence-preserving actions: merge_exact_duplicate, merge_near_duplicate, retire_stale_shadow, downgrade_delivery, quarantine.",
+    "Mark uncertain semantic merges, conflicted helped/harmed merges, promotion, and soft deletion as high risk; ExperienceEngine will apply accepted high-risk experience-node actions conservatively with rollback snapshots.",
+    "Do not propose export writing, repo policy changes, restore, or broad rewrite unless the input includes an explicit replacement contract.",
+    "For merge actions choose a canonical node with stronger helped/support evidence or newer evidence.",
+    "Do not broaden applicability. Preserve narrower triggers, avoid steps, and evidence references in the rationale.",
+    "If no safe action is supported, return clusters explaining the conflict and no actions."
+].join(" ");
+const buildPrompt = (input) => JSON.stringify({
+    task: "Plan hygiene governance actions for this ExperienceEngine scope.",
+    outputContract: {
+        source: "llm",
+        scopeId: input.scope.scopeId,
+        findingHash: input.findingHash,
+        clusters: [
+            {
+                clusterId: "stable descriptive id",
+                type: "duplicate_guidance | conflicting_guidance | over_generalized_guidance | evidence_drift | stale_experience | stale_shadow",
+                nodeIds: ["existing node ids only"],
+                candidateIds: ["existing candidate ids only"],
+                rationale: "why these entries belong together"
+            }
+        ],
+        actions: [
+            {
+                actionId: "stable descriptive id",
+                actionType: "merge_exact_duplicate | merge_near_duplicate | retire_stale_shadow | downgrade_delivery | quarantine | promote_delivery | delete_record | export_guidance | change_repo_policy | restore_guidance | rewrite_guidance",
+                riskLevel: "low | medium | high",
+                approvalRequired: false,
+                affectedNodeIds: ["existing node ids only"],
+                affectedCandidateIds: ["existing candidate ids only"],
+                canonicalNodeId: "required for merge actions",
+                expectedEffect: "specific risk reduction",
+                rationale: "evidence-preserving reason"
+            }
+        ]
+    },
+    input
+}, null, 2);
+const buildRequestUrl = (endpoint) => {
+    if (endpoint.kind === "anthropic" || endpoint.kind === "gemini" || endpoint.kind === "bedrock") {
+        return endpoint.baseUrl;
+    }
+    if (/\/chat\/completions(?:\?.*)?$/.test(endpoint.baseUrl)) {
+        return endpoint.baseUrl;
+    }
+    if (/\/v1\/?$/.test(endpoint.baseUrl)) {
+        return `${endpoint.baseUrl.replace(/\/$/, "")}/chat/completions`;
+    }
+    return `${endpoint.baseUrl.replace(/\/$/, "")}/v1/chat/completions`;
+};
+const buildRequestBody = (endpoint, prompt) => {
+    if (endpoint.kind === "anthropic") {
+        return {
+            model: endpoint.model,
+            max_tokens: 4096,
+            system: SYSTEM_PROMPT,
+            messages: [{ role: "user", content: prompt }],
+            temperature: 0
+        };
+    }
+    if (endpoint.kind === "gemini") {
+        return {
+            system_instruction: { parts: [{ text: SYSTEM_PROMPT }] },
+            contents: [{ role: "user", parts: [{ text: prompt }] }],
+            generationConfig: {
+                temperature: 0,
+                responseMimeType: "application/json"
+            }
+        };
+    }
+    if (endpoint.kind === "bedrock") {
+        return {
+            system: [{ text: SYSTEM_PROMPT }],
+            messages: [{ role: "user", content: [{ text: prompt }] }],
+            inferenceConfig: {
+                maxTokens: 4096,
+                temperature: 0
+            }
+        };
+    }
+    return {
+        model: endpoint.model,
+        response_format: { type: "json_object" },
+        temperature: 0,
+        messages: [
+            { role: "system", content: SYSTEM_PROMPT },
+            { role: "user", content: prompt }
+        ]
+    };
+};
+const extractTextPayload = async (endpoint, response) => {
+    if (endpoint.kind === "anthropic") {
+        const payload = (await response.json());
+        return payload.content?.find((entry) => entry.type === "text" && typeof entry.text === "string")?.text ?? "";
+    }
+    if (endpoint.kind === "gemini") {
+        const payload = (await response.json());
+        return payload.candidates?.[0]?.content?.parts?.find((entry) => typeof entry.text === "string")?.text ?? "";
+    }
+    if (endpoint.kind === "bedrock") {
+        const payload = (await response.json());
+        return payload.output?.message?.content?.find((entry) => typeof entry.text === "string")?.text ?? "";
+    }
+    const payload = (await response.json());
+    return payload.choices?.[0]?.message?.content ?? "";
+};
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+const shouldRetry = (status) => status === 429 || status >= 500;
+export class LlmHygieneGovernancePlanner {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    hasEndpoint() {
+        return Boolean((this.options.resolveEndpoint ?? resolveDistillerEndpoint)({
+            env: this.options.env,
+            homeDir: this.options.homeDir,
+            configProvider: this.options.config.distillerProvider,
+            configAuthMode: this.options.config.distillationAuthMode,
+            configModel: this.options.config.distillerModel
+        }));
+    }
+    async plan(input) {
+        const endpoint = (this.options.resolveEndpoint ?? resolveDistillerEndpoint)({
+            env: this.options.env,
+            homeDir: this.options.homeDir,
+            configProvider: this.options.config.distillerProvider,
+            configAuthMode: this.options.config.distillationAuthMode,
+            configModel: this.options.config.distillerModel
+        });
+        if (!endpoint) {
+            throw new Error("No configured ExperienceEngine distiller endpoint is available for hygiene governance planning.");
+        }
+        const request = {
+            method: "POST",
+            headers: {
+                "content-type": "application/json",
+                ...endpoint.headers
+            },
+            body: JSON.stringify(buildRequestBody(endpoint, buildPrompt(input)))
+        };
+        const maxRetries = this.options.maxRetries ?? 2;
+        let response;
+        for (let attempt = 0; attempt <= maxRetries; attempt += 1) {
+            response = await (this.options.fetchImpl ?? fetch)(buildRequestUrl(endpoint), request);
+            if (response.ok || !shouldRetry(response.status) || attempt === maxRetries) {
+                break;
+            }
+            await sleep((this.options.retryDelayMs ?? 500) * (attempt + 1));
+        }
+        if (!response?.ok) {
+            throw new Error(`Hygiene governance LLM planner failed with HTTP ${response?.status ?? "unknown"}.`);
+        }
+        const text = await extractTextPayload(endpoint, response);
+        if (!text.trim()) {
+            throw new Error("Hygiene governance LLM planner returned an empty response.");
+        }
+        return text;
+    }
+}
+//# sourceMappingURL=hygiene-governance-llm-planner.js.map

package/dist/maintenance/hygiene-governance-llm-planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hygiene-governance-llm-planner.js","sourceRoot":"","sources":["../../src/maintenance/hygiene-governance-llm-planner.ts"],"names":[],"mappings":"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"}

package/dist/maintenance/hygiene-governance-planner.d.ts

@@ -0,0 +1,113 @@
+import type { AttributionRecord, ExperienceCandidate, ExperienceNode, Scope } from "../types/domain.js";
+import { type HygieneFinding, type HygieneReviewReport } from "./experience-hygiene.js";
+export type HygieneGovernanceScopeInput = {
+    scopeId: string;
+    scopeName?: string;
+    scopeType?: Scope["scope_type"];
+};
+export type HygieneGovernanceNodeSummary = {
+    id: string;
+    scopeId: string;
+    nodeType: ExperienceNode["node_type"];
+    taskType: ExperienceNode["task_type"];
+    state: ExperienceNode["state"];
+    deliveryState?: ExperienceNode["delivery_state"];
+    triggerPattern: string;
+    compactHint: string;
+    recommendedSteps: string[];
+    avoidSteps: string[];
+    originRecordIds: string[];
+    helpedRecordIds: string[];
+    harmedRecordIds: string[];
+    usageCount: number;
+    helpedCount: number;
+    harmedCount: number;
+    supportCount: number;
+    updatedAt: string;
+};
+export type HygieneGovernanceCandidateSummary = {
+    id: string;
+    sourceRecordId: string;
+    taskType: ExperienceCandidate["task_type"];
+    nodeType: ExperienceCandidate["node_type"];
+    lifecycleState: ExperienceCandidate["lifecycle_state"];
+    triggerPattern: string;
+    compactHint: string;
+    recommendedSteps: string[];
+    avoidSteps: string[];
+    retryCount: number;
+    updatedAt: string;
+};
+export type HygieneGovernanceAttributionSummary = {
+    id: string;
+    nodeId: string;
+    delivered: boolean;
+    outcome: AttributionRecord["outcome"];
+    verdict: AttributionRecord["attribution_verdict"];
+    confidence: AttributionRecord["confidence"];
+    evidenceRefs: string[];
+    createdAt: string;
+};
+export type HygieneGovernanceExportRiskNote = {
+    nodeId: string;
+    reason: string;
+    evidenceRefs: string[];
+};
+export type BuildHygieneGovernanceInput = HygieneGovernanceScopeInput & {
+    nodes: ExperienceNode[];
+    candidates: ExperienceCandidate[];
+    attributionRecords: AttributionRecord[];
+    now?: string;
+    maxFindings?: number;
+    maxNodes?: number;
+    maxCandidates?: number;
+    maxAttributions?: number;
+    exportRiskEnabled?: boolean;
+};
+export type HygieneGovernanceInput = {
+    scope: HygieneGovernanceScopeInput;
+    generatedAt: string;
+    findingHash: string;
+    review: HygieneReviewReport["summary"];
+    findings: HygieneFinding[];
+    nodes: HygieneGovernanceNodeSummary[];
+    candidates: HygieneGovernanceCandidateSummary[];
+    attributions: HygieneGovernanceAttributionSummary[];
+    exportRiskNotes: HygieneGovernanceExportRiskNote[];
+    evidenceRefs: string[];
+};
+export declare const HYGIENE_GOVERNANCE_ACTION_TYPES: readonly ["merge_exact_duplicate", "merge_near_duplicate", "retire_stale_shadow", "downgrade_delivery", "quarantine", "promote_delivery", "delete_record", "export_guidance", "change_repo_policy", "restore_guidance", "rewrite_guidance"];
+export type HygieneGovernanceActionType = (typeof HYGIENE_GOVERNANCE_ACTION_TYPES)[number];
+export type HygieneGovernanceRiskLevel = "low" | "medium" | "high";
+export type HygieneGovernancePlanAction = {
+    actionId: string;
+    actionType: HygieneGovernanceActionType;
+    riskLevel: HygieneGovernanceRiskLevel;
+    approvalRequired: boolean;
+    affectedNodeIds: string[];
+    affectedCandidateIds: string[];
+    canonicalNodeId?: string;
+    expectedEffect: string;
+    rationale?: string;
+};
+export type HygieneGovernancePlanCluster = {
+    clusterId: string;
+    type: HygieneFinding["type"] | "stale_shadow";
+    nodeIds: string[];
+    candidateIds: string[];
+    rationale: string;
+};
+export type HygieneGovernancePlan = {
+    source: "llm" | "deterministic_fallback";
+    scopeId: string;
+    findingHash: string;
+    clusters: HygieneGovernancePlanCluster[];
+    actions: HygieneGovernancePlanAction[];
+};
+export type HygieneGovernancePlannerProvider = {
+    plan(input: HygieneGovernanceInput): Promise<string>;
+};
+export declare const buildHygieneGovernanceInput: (input: BuildHygieneGovernanceInput) => HygieneGovernanceInput;
+export declare const planHygieneGovernance: (input: HygieneGovernanceInput, options?: {
+    planner?: HygieneGovernancePlannerProvider;
+}) => Promise<HygieneGovernancePlan>;

package/dist/maintenance/hygiene-governance-planner.js

@@ -0,0 +1,302 @@
+import { z } from "zod";
+import { stableId } from "../utils/ids.js";
+import { buildHygieneReviewReport } from "./experience-hygiene.js";
+export const HYGIENE_GOVERNANCE_ACTION_TYPES = [
+    "merge_exact_duplicate",
+    "merge_near_duplicate",
+    "retire_stale_shadow",
+    "downgrade_delivery",
+    "quarantine",
+    "promote_delivery",
+    "delete_record",
+    "export_guidance",
+    "change_repo_policy",
+    "restore_guidance",
+    "rewrite_guidance"
+];
+const DEFAULT_MAX_FINDINGS = 20;
+const DEFAULT_MAX_NODES = 30;
+const DEFAULT_MAX_CANDIDATES = 30;
+const DEFAULT_MAX_ATTRIBUTIONS = 50;
+const planSchema = z.object({
+    source: z.enum(["llm", "deterministic_fallback"]),
+    scopeId: z.string().min(1),
+    findingHash: z.string().min(1),
+    clusters: z.array(z.object({
+        clusterId: z.string().min(1),
+        type: z.union([
+            z.enum(["stale_shadow"]),
+            z.enum([
+                "stale_experience",
+                "duplicate_guidance",
+                "conflicting_guidance",
+                "over_generalized_guidance",
+                "evidence_drift"
+            ])
+        ]),
+        nodeIds: z.array(z.string()),
+        candidateIds: z.array(z.string()),
+        rationale: z.string().min(1)
+    })),
+    actions: z.array(z.object({
+        actionId: z.string().min(1),
+        actionType: z.enum(HYGIENE_GOVERNANCE_ACTION_TYPES),
+        riskLevel: z.enum(["low", "medium", "high"]),
+        approvalRequired: z.boolean(),
+        affectedNodeIds: z.array(z.string()),
+        affectedCandidateIds: z.array(z.string()),
+        canonicalNodeId: z.string().optional(),
+        expectedEffect: z.string().min(1),
+        rationale: z.string().optional()
+    }))
+});
+const uniqueSorted = (values) => [...new Set(values.filter((value) => Boolean(value)))].sort();
+const summarizeNode = (node) => ({
+    id: node.id,
+    scopeId: node.scope_id,
+    nodeType: node.node_type,
+    taskType: node.task_type,
+    state: node.state,
+    deliveryState: node.delivery_state,
+    triggerPattern: node.trigger_pattern,
+    compactHint: node.compact_hint,
+    recommendedSteps: node.recommended_steps ?? [],
+    avoidSteps: node.avoid_steps ?? [],
+    originRecordIds: node.origin_record_ids,
+    helpedRecordIds: node.helped_record_ids,
+    harmedRecordIds: node.harmed_record_ids,
+    usageCount: node.usage_count,
+    helpedCount: node.helped_count,
+    harmedCount: node.harmed_count,
+    supportCount: node.support_count,
+    updatedAt: node.updated_at
+});
+const summarizeCandidate = (candidate) => ({
+    id: candidate.id,
+    sourceRecordId: candidate.source_record_id,
+    taskType: candidate.task_type,
+    nodeType: candidate.node_type,
+    lifecycleState: candidate.lifecycle_state,
+    triggerPattern: candidate.trigger_pattern,
+    compactHint: candidate.compact_hint,
+    recommendedSteps: candidate.recommended_steps ?? [],
+    avoidSteps: candidate.avoid_steps ?? [],
+    retryCount: candidate.retry_count,
+    updatedAt: candidate.updated_at
+});
+const summarizeAttribution = (record) => ({
+    id: record.id,
+    nodeId: record.node_id,
+    delivered: record.delivered,
+    outcome: record.outcome,
+    verdict: record.attribution_verdict,
+    confidence: record.confidence,
+    evidenceRefs: record.evidence_refs,
+    createdAt: record.created_at
+});
+const normalizeFindingForHash = (finding) => ({
+    type: finding.type,
+    severity: finding.severity,
+    affectedNodeIds: uniqueSorted(finding.affectedNodeIds),
+    affectedCandidateIds: uniqueSorted(finding.affectedCandidateIds),
+    evidenceRefs: uniqueSorted(finding.evidenceRefs)
+});
+const buildFindingHash = (scopeId, findings) => stableId("hygiene_findings", JSON.stringify({
+    scopeId,
+    findings: findings
+        .map(normalizeFindingForHash)
+        .sort((left, right) => JSON.stringify(left).localeCompare(JSON.stringify(right)))
+}));
+const compareByRisk = (left, right) => (right.harmed_count - left.harmed_count)
+    || (right.helped_count - left.helped_count)
+    || right.updated_at.localeCompare(left.updated_at);
+const buildExportRiskNotes = (nodes, attributionRecords, enabled) => {
+    if (!enabled) {
+        return [];
+    }
+    const harmfulEvidenceByNode = new Map();
+    for (const record of attributionRecords) {
+        if (record.attribution_verdict !== "strong_harmed" && record.attribution_verdict !== "weak_harmed") {
+            continue;
+        }
+        harmfulEvidenceByNode.set(record.node_id, [
+            ...(harmfulEvidenceByNode.get(record.node_id) ?? []),
+            ...record.evidence_refs
+        ]);
+    }
+    return nodes
+        .filter((node) => node.delivery_state === "eligible" && harmfulEvidenceByNode.has(node.id))
+        .sort(compareByRisk)
+        .map((node) => ({
+        nodeId: node.id,
+        reason: "eligible guidance has recent harmed attribution",
+        evidenceRefs: uniqueSorted([...(harmfulEvidenceByNode.get(node.id) ?? []), ...node.harmed_record_ids])
+    }));
+};
+export const buildHygieneGovernanceInput = (input) => {
+    const maxFindings = input.maxFindings ?? DEFAULT_MAX_FINDINGS;
+    const report = buildHygieneReviewReport({
+        nodes: input.nodes,
+        candidates: input.candidates,
+        attributionRecords: input.attributionRecords,
+        filters: {
+            scopeId: input.scopeId,
+            now: input.now,
+            limit: maxFindings
+        }
+    });
+    const findings = report.findings.slice(0, maxFindings);
+    const findingNodeIds = new Set(findings.flatMap((finding) => finding.affectedNodeIds));
+    const findingCandidateIds = new Set(findings.flatMap((finding) => finding.affectedCandidateIds));
+    const nodes = input.nodes
+        .filter((node) => node.scope_id === input.scopeId && (findingNodeIds.size === 0 || findingNodeIds.has(node.id)))
+        .sort(compareByRisk)
+        .slice(0, input.maxNodes ?? DEFAULT_MAX_NODES)
+        .map(summarizeNode);
+    const candidates = input.candidates
+        .filter((candidate) => candidate.scope_id === input.scopeId && (findingCandidateIds.size === 0 || findingCandidateIds.has(candidate.id)))
+        .sort((left, right) => right.updated_at.localeCompare(left.updated_at))
+        .slice(0, input.maxCandidates ?? DEFAULT_MAX_CANDIDATES)
+        .map(summarizeCandidate);
+    const attributions = input.attributionRecords
+        .filter((record) => !findingNodeIds.size || findingNodeIds.has(record.node_id))
+        .sort((left, right) => right.created_at.localeCompare(left.created_at))
+        .slice(0, input.maxAttributions ?? DEFAULT_MAX_ATTRIBUTIONS)
+        .map(summarizeAttribution);
+    const exportRiskNotes = buildExportRiskNotes(input.nodes, input.attributionRecords, input.exportRiskEnabled ?? false);
+    const evidenceRefs = uniqueSorted([
+        ...findings.flatMap((finding) => finding.evidenceRefs),
+        ...nodes.flatMap((node) => [...node.originRecordIds, ...node.helpedRecordIds, ...node.harmedRecordIds]),
+        ...candidates.map((candidate) => candidate.sourceRecordId),
+        ...attributions.flatMap((record) => record.evidenceRefs),
+        ...exportRiskNotes.flatMap((note) => note.evidenceRefs)
+    ]);
+    return {
+        scope: {
+            scopeId: input.scopeId,
+            scopeName: input.scopeName,
+            scopeType: input.scopeType
+        },
+        generatedAt: report.generatedAt,
+        findingHash: buildFindingHash(input.scopeId, findings),
+        review: report.summary,
+        findings,
+        nodes,
+        candidates,
+        attributions,
+        exportRiskNotes,
+        evidenceRefs
+    };
+};
+const parseStrictJsonPlan = (raw) => {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (error) {
+        throw new Error(`Invalid hygiene governance plan JSON: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const result = planSchema.safeParse(parsed);
+    if (!result.success) {
+        throw new Error(`Invalid hygiene governance plan: ${result.error.issues.map((issue) => issue.message).join("; ")}`);
+    }
+    return result.data;
+};
+const chooseCanonicalNode = (nodes) => [...nodes].sort((left, right) => (right.helpedCount - left.helpedCount)
+    || (right.supportCount - left.supportCount)
+    || right.updatedAt.localeCompare(left.updatedAt)
+    || left.id.localeCompare(right.id))[0];
+const exactDuplicateKey = (node) => JSON.stringify({
+    taskType: node.taskType,
+    nodeType: node.nodeType,
+    triggerPattern: node.triggerPattern.trim().toLowerCase(),
+    compactHint: node.compactHint.trim().toLowerCase()
+});
+const buildDeterministicFallbackPlan = (input) => {
+    const clusters = [];
+    const actions = [];
+    const nodesById = new Map(input.nodes.map((node) => [node.id, node]));
+    const duplicateGroups = new Map();
+    for (const node of input.nodes) {
+        if (node.deliveryState === "shadow_only") {
+            continue;
+        }
+        const group = duplicateGroups.get(exactDuplicateKey(node)) ?? [];
+        group.push(node);
+        duplicateGroups.set(exactDuplicateKey(node), group);
+    }
+    for (const nodes of duplicateGroups.values()) {
+        if (nodes.length < 2) {
+            continue;
+        }
+        const sortedIds = uniqueSorted(nodes.map((node) => node.id));
+        const canonical = chooseCanonicalNode(nodes);
+        const clusterId = stableId("hygiene_cluster", `${input.scope.scopeId}:exact:${sortedIds.join(",")}`);
+        clusters.push({
+            clusterId,
+            type: "duplicate_guidance",
+            nodeIds: sortedIds,
+            candidateIds: [],
+            rationale: "Nodes have identical task type, node type, trigger, and compact hint."
+        });
+        actions.push({
+            actionId: stableId("hygiene_action", `${clusterId}:merge_exact_duplicate:${canonical.id}`),
+            actionType: "merge_exact_duplicate",
+            riskLevel: "low",
+            approvalRequired: false,
+            affectedNodeIds: sortedIds,
+            affectedCandidateIds: [],
+            canonicalNodeId: canonical.id,
+            expectedEffect: "Consolidate exact duplicate guidance while preserving evidence on the canonical node.",
+            rationale: "Exact duplicate guidance can be safely proposed for automatic merge subject to validators."
+        });
+    }
+    for (const node of input.nodes) {
+        if ((node.state !== "candidate" && node.state !== "priority_candidate")
+            || node.deliveryState !== "shadow_only"
+            || node.usageCount > 0
+            || node.helpedCount > 0
+            || node.supportCount > 0) {
+            continue;
+        }
+        const clusterId = stableId("hygiene_cluster", `${input.scope.scopeId}:stale_shadow:${node.id}`);
+        if (!nodesById.has(node.id)) {
+            continue;
+        }
+        clusters.push({
+            clusterId,
+            type: "stale_shadow",
+            nodeIds: [node.id],
+            candidateIds: [],
+            rationale: "Shadow-only guidance has no usage, helped, or support evidence."
+        });
+        actions.push({
+            actionId: stableId("hygiene_action", `${clusterId}:retire_stale_shadow`),
+            actionType: "retire_stale_shadow",
+            riskLevel: "low",
+            approvalRequired: false,
+            affectedNodeIds: [node.id],
+            affectedCandidateIds: [],
+            expectedEffect: "Retire stale shadow-only guidance that has no supporting runtime evidence.",
+            rationale: "The action remains subject to stale-retire validators before mutation."
+        });
+    }
+    return {
+        source: "deterministic_fallback",
+        scopeId: input.scope.scopeId,
+        findingHash: input.findingHash,
+        clusters,
+        actions
+    };
+};
+export const planHygieneGovernance = async (input, options = {}) => {
+    if (!options.planner) {
+        return buildDeterministicFallbackPlan(input);
+    }
+    const plan = parseStrictJsonPlan(await options.planner.plan(input));
+    if (plan.scopeId !== input.scope.scopeId || plan.findingHash !== input.findingHash) {
+        throw new Error("Invalid hygiene governance plan: scopeId or findingHash does not match the planner input");
+    }
+    return plan;
+};
+//# sourceMappingURL=hygiene-governance-planner.js.map

package/dist/maintenance/hygiene-governance-planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hygiene-governance-planner.js","sourceRoot":"","sources":["../../src/maintenance/hygiene-governance-planner.ts"],"names":[],"mappings":"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"}