@alan512/experienceengine 0.3.5 → 0.4.0

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

@@ -0,0 +1,212 @@
+const STALE_SHADOW_MIN_AGE_DAYS = 90;
+const sameGuidanceIdentity = (nodes) => {
+    if (nodes.length < 2) {
+        return false;
+    }
+    const [first] = nodes;
+    return nodes.every((node) => node.taskType === first.taskType
+        && node.nodeType === first.nodeType
+        && node.triggerPattern.trim().toLowerCase() === first.triggerPattern.trim().toLowerCase()
+        && node.compactHint.trim().toLowerCase() === first.compactHint.trim().toLowerCase());
+};
+const sameMergeFamily = (nodes) => {
+    if (nodes.length < 2) {
+        return false;
+    }
+    const [first] = nodes;
+    return nodes.every((node) => node.taskType === first.taskType
+        && node.nodeType === first.nodeType);
+};
+const hasConflictedEvidence = (nodes) => nodes.some((node) => node.helpedRecordIds.length > 0 || node.helpedCount > 0)
+    && nodes.some((node) => node.harmedRecordIds.length > 0 || node.harmedCount > 0);
+const hasNoFeedbackHistory = (node) => node.helpedCount === 0
+    && node.harmedCount === 0
+    && node.helpedRecordIds.length === 0
+    && node.harmedRecordIds.length === 0;
+const nodesForAction = (input, action) => {
+    const nodesById = new Map(input.nodes.map((node) => [node.id, node]));
+    const nodes = action.affectedNodeIds.map((id) => nodesById.get(id));
+    return nodes.every(Boolean) ? nodes : undefined;
+};
+const actionCrossesScope = (input, nodes) => nodes.some((node) => node.scopeId !== input.scope.scopeId);
+const missingEvidenceRefs = (input, nodes) => {
+    const provided = new Set(input.evidenceRefs);
+    return nodes
+        .flatMap((node) => [...node.originRecordIds, ...node.helpedRecordIds, ...node.harmedRecordIds])
+        .some((ref) => !provided.has(ref));
+};
+const ageDays = (now, value) => {
+    const nowMs = Date.parse(now);
+    const valueMs = Date.parse(value);
+    if (!Number.isFinite(nowMs) || !Number.isFinite(valueMs)) {
+        return 0;
+    }
+    return Math.max(0, Math.floor((nowMs - valueMs) / 86_400_000));
+};
+const validateExactMerge = (input, action) => {
+    const nodes = nodesForAction(input, action);
+    if (!nodes || !action.canonicalNodeId || !action.affectedNodeIds.includes(action.canonicalNodeId)) {
+        return reject(action, "missing_or_unknown_merge_node");
+    }
+    if (actionCrossesScope(input, nodes)) {
+        return reject(action, "scope_crossing_action");
+    }
+    if (missingEvidenceRefs(input, nodes)) {
+        return reject(action, "missing_evidence_refs");
+    }
+    if (!sameGuidanceIdentity(nodes)) {
+        return reject(action, "merge_identity_mismatch");
+    }
+    if (hasConflictedEvidence(nodes)) {
+        return guarded(action, "conflicted_helped_harmed_merge_guarded");
+    }
+    return accept(action, "exact_duplicate_merge_validated");
+};
+const validateStaleShadowRetire = (input, action) => {
+    const nodes = nodesForAction(input, action);
+    if (!nodes || nodes.length !== 1) {
+        return reject(action, "missing_or_unknown_stale_shadow_node");
+    }
+    const [node] = nodes;
+    if (actionCrossesScope(input, nodes)
+        || missingEvidenceRefs(input, nodes)
+        || (node.state !== "candidate" && node.state !== "priority_candidate")
+        || node.deliveryState !== "shadow_only"
+        || node.usageCount > 0
+        || node.helpedCount > 0
+        || node.supportCount > 0
+        || ageDays(input.generatedAt, node.updatedAt) < STALE_SHADOW_MIN_AGE_DAYS) {
+        return reject(action, "stale_shadow_retire_criteria_not_met");
+    }
+    return accept(action, "stale_shadow_retire_validated");
+};
+const validateNearDuplicateMerge = (input, action) => {
+    const nodes = nodesForAction(input, action);
+    if (!nodes || !action.canonicalNodeId || !action.affectedNodeIds.includes(action.canonicalNodeId)) {
+        return reject(action, "missing_or_unknown_merge_node");
+    }
+    if (actionCrossesScope(input, nodes)) {
+        return reject(action, "scope_crossing_action");
+    }
+    if (missingEvidenceRefs(input, nodes)) {
+        return reject(action, "missing_evidence_refs");
+    }
+    if (!sameMergeFamily(nodes)) {
+        return reject(action, "merge_identity_mismatch");
+    }
+    if (!nodes.some((node) => node.deliveryState === "shadow_only" || hasNoFeedbackHistory(node))) {
+        return guarded(action, "near_duplicate_merge_guarded");
+    }
+    if (hasConflictedEvidence(nodes)) {
+        return guarded(action, "conflicted_helped_harmed_merge_guarded");
+    }
+    return accept(action, "near_duplicate_merge_validated");
+};
+const hasHarmedAttribution = (input, nodeId, verdicts) => input.attributions.some((record) => record.nodeId === nodeId
+    && verdicts.includes(record.verdict)
+    && record.evidenceRefs.every((ref) => input.evidenceRefs.includes(ref)));
+const validateSafetyAction = (input, action) => {
+    const nodes = nodesForAction(input, action);
+    if (!nodes || nodes.length !== 1) {
+        return reject(action, "missing_or_unknown_safety_node");
+    }
+    if (actionCrossesScope(input, nodes) || missingEvidenceRefs(input, nodes)) {
+        return reject(action, actionCrossesScope(input, nodes) ? "scope_crossing_action" : "missing_evidence_refs");
+    }
+    const [node] = nodes;
+    if (action.actionType === "downgrade_delivery") {
+        if (node.deliveryState !== "eligible" || !hasHarmedAttribution(input, node.id, ["weak_harmed", "strong_harmed"])) {
+            return reject(action, "safety_downgrade_criteria_not_met");
+        }
+        return accept(action, "safety_delivery_downgrade_validated");
+    }
+    if (action.actionType === "quarantine") {
+        if ((node.deliveryState !== "eligible" && node.deliveryState !== "conservative_only")
+            || !hasHarmedAttribution(input, node.id, ["strong_harmed"])) {
+            return reject(action, "safety_quarantine_criteria_not_met");
+        }
+        return accept(action, "safety_quarantine_validated");
+    }
+    return reject(action, "unsupported_safety_action");
+};
+const accept = (action, reasonCode) => ({
+    actionId: action.actionId,
+    actionType: action.actionType,
+    decision: "accept",
+    reasonCode,
+    affectedNodeIds: action.affectedNodeIds
+});
+const reject = (action, reasonCode) => ({
+    actionId: action.actionId,
+    actionType: action.actionType,
+    decision: "reject",
+    reasonCode,
+    affectedNodeIds: action.affectedNodeIds
+});
+const guarded = (action, reasonCode) => ({
+    actionId: action.actionId,
+    actionType: action.actionType,
+    decision: "accept_guarded",
+    reasonCode,
+    affectedNodeIds: action.affectedNodeIds
+});
+const validateGuardedNodeAction = (input, action) => {
+    const nodes = nodesForAction(input, action);
+    if (!nodes || nodes.length < 1) {
+        return reject(action, "missing_or_unknown_guarded_node");
+    }
+    if (actionCrossesScope(input, nodes) || missingEvidenceRefs(input, nodes)) {
+        return reject(action, actionCrossesScope(input, nodes) ? "scope_crossing_action" : "missing_evidence_refs");
+    }
+    if (action.actionType === "promote_delivery") {
+        return guarded(action, "promotion_guarded_to_conservative_delivery");
+    }
+    if (action.actionType === "delete_record") {
+        return guarded(action, "delete_record_guarded_soft_retire");
+    }
+    return reject(action, "unsupported_guarded_action");
+};
+const validateAction = (input, action) => {
+    if ((action.actionType === "downgrade_delivery" || action.actionType === "quarantine")
+        && action.affectedNodeIds.length !== 1) {
+        return reject(action, "safety_action_requires_single_node");
+    }
+    if ((action.actionType === "merge_exact_duplicate" || action.actionType === "merge_near_duplicate")
+        && action.affectedNodeIds.length < 2) {
+        return reject(action, "merge_requires_multiple_nodes");
+    }
+    switch (action.actionType) {
+        case "merge_exact_duplicate":
+            return validateExactMerge(input, action);
+        case "retire_stale_shadow":
+            return validateStaleShadowRetire(input, action);
+        case "merge_near_duplicate":
+            return validateNearDuplicateMerge(input, action);
+        case "downgrade_delivery":
+        case "quarantine":
+            return validateSafetyAction(input, action);
+        case "promote_delivery":
+        case "delete_record":
+            return validateGuardedNodeAction(input, action);
+        case "rewrite_guidance":
+            return reject(action, "rewrite_requires_replacement_contract");
+        case "export_guidance":
+        case "change_repo_policy":
+        case "restore_guidance":
+            return reject(action, "non_experience_store_action_not_auto_governed");
+        default:
+            return reject(action, "unsupported_automatic_action");
+    }
+};
+export const validateHygieneGovernancePlan = (input, plan) => {
+    if (plan.scopeId !== input.scope.scopeId || plan.findingHash !== input.findingHash) {
+        const actions = plan.actions.map((action) => reject(action, "plan_scope_or_hash_mismatch"));
+        return { accepted: false, actions };
+    }
+    const actions = plan.actions.map((action) => validateAction(input, action));
+    return {
+        accepted: actions.length > 0 && actions.every((action) => action.decision === "accept" || action.decision === "accept_guarded"),
+        actions
+    };
+};
+//# sourceMappingURL=hygiene-governance-validator.js.map

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

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

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

@@ -2,7 +2,7 @@ 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 OperatorReviewSource = "repo_policy" | "hygiene" | "export_drafts" | "governance";
 export type RepoPolicyReviewHealth = "clear" | "attention" | "tripped";
 export type OperatorReviewDrillDown = {
     cli: string;
@@ -66,15 +66,26 @@ export type OperatorReviewReport = {
             }>;
             drillDown: OperatorReviewDrillDown;
         };
+        governance?: OperatorReviewGovernanceSummary;
     };
     reviewItems: OperatorReviewItem[];
     recommendedReviewOrder: OperatorReviewSource[];
     reviewOnlyNextActions: OperatorReviewNextAction[];
 };
+export type OperatorReviewGovernanceSummary = {
+    status: "clear" | "attention";
+    recentAutomaticActions: number;
+    failedRuns: number;
+    pendingApprovals: number;
+    lastRunStatus?: string;
+    lastFailureClass?: string;
+    drillDown: OperatorReviewDrillDown;
+};
 export type BuildOperatorReviewFlowInput = {
     repo: ExperienceRepoSummary;
     hygiene: HygieneReviewReport;
     exportDrafts: ExperienceExportDraftReport;
+    governance?: OperatorReviewGovernanceSummary;
     limit?: number;
     generatedAt?: string;
 };

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

@@ -1,6 +1,6 @@
 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 SOURCE_RANK = { governance: 0, repo_policy: 1, hygiene: 2, export_drafts: 3 };
 const drillDowns = () => ({
     repo_policy: {
         cli: "ee inspect repo",
@@ -15,6 +15,11 @@ const drillDowns = () => ({
         cli: "ee inspect export-drafts",
         mcpResource: "experienceengine://export-drafts",
         brokerAction: "inspect_export_drafts"
+    },
+    governance: {
+        cli: "ee inspect governance",
+        mcpResource: "experienceengine://governance",
+        brokerAction: "inspect_governance"
     }
 });
 const policyHealth = (repo) => {
@@ -65,6 +70,16 @@ export const buildOperatorReviewFlow = (input) => {
     const drillDown = drillDowns();
     const health = policyHealth(input.repo);
     const items = [];
+    if (input.governance && input.governance.status !== "clear") {
+        const hasFailedRuns = input.governance.failedRuns > 0;
+        addReviewItem(items, {
+            priority: hasFailedRuns ? "medium" : "low",
+            source: "governance",
+            title: "Autonomous governance needs attention",
+            summary: `Governance status=${input.governance.status}, failedRuns=${input.governance.failedRuns}, pendingApprovals=${input.governance.pendingApprovals}, recentAutomaticActions=${input.governance.recentAutomaticActions}.`,
+            drillDown: input.governance.drillDown
+        });
+    }
     if (health === "tripped") {
         addReviewItem(items, {
             priority: "high",
@@ -162,7 +177,8 @@ export const buildOperatorReviewFlow = (input) => {
                     summary: draft.evidenceSummary
                 })),
                 drillDown: drillDown.export_drafts
-            }
+            },
+            governance: input.governance
         },
         reviewItems,
         recommendedReviewOrder: reviewOrder(reviewItems),

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

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

package/dist/maintenance/vector-migrator.d.ts

@@ -0,0 +1,37 @@
+import type { DatabaseSync } from "node:sqlite";
+import type { EmbeddingSpace } from "../store/vector/embeddings.js";
+import type { ExperienceEngineConfig } from "../config/config-schema.js";
+export type MigrationOptions = {
+    config: ExperienceEngineConfig;
+    batchSize?: number;
+    throttleGapMs?: number;
+    maxTotalToProcess?: number;
+};
+export type MigrationReport = {
+    totalDiscovered: number;
+    processed: number;
+    succeeded: number;
+    failed: number;
+};
+export declare class VectorMigrationPipeline {
+    /**
+     * Automatically discovers experience nodes that need migration and marks their status as 'pending'.
+     */
+    discoverPendingNodes(db: DatabaseSync, currentSpace: EmbeddingSpace): number;
+    /**
+     * Migrates a single batch of pending experience nodes.
+     * To prevent long-held SQLite exclusive locks:
+     * 1. A short transaction locks the batch's target nodes to 'migrating' status.
+     * 2. Asynchronous embedding generation is performed outside the transaction.
+     * 3. Successful/failed node updates are committed one-by-one with small transactions.
+     */
+    migrateBatch(db: DatabaseSync, currentSpace: EmbeddingSpace, options: MigrationOptions): Promise<{
+        processed: number;
+        succeeded: number;
+        failed: number;
+    }>;
+    /**
+     * Automatically initiates the entire vector migration pipeline.
+     */
+    runMigration(db: DatabaseSync, currentSpace: EmbeddingSpace, options: MigrationOptions): Promise<MigrationReport>;
+}

package/dist/maintenance/vector-migrator.js

@@ -0,0 +1,170 @@
+import { embedPassageText } from "../store/vector/embeddings.js";
+import { withTransaction } from "../store/sqlite/db.js";
+import { NodeRepository } from "../store/sqlite/repositories/node-repo.js";
+export class VectorMigrationPipeline {
+    /**
+     * Automatically discovers experience nodes that need migration and marks their status as 'pending'.
+     */
+    discoverPendingNodes(db, currentSpace) {
+        const nodeRepo = new NodeRepository(db);
+        const allNodes = nodeRepo.listAll();
+        let pendingCount = 0;
+        withTransaction(db, () => {
+            for (const node of allNodes) {
+                const spaceMismatched = node.embedding_provider !== currentSpace.provider ||
+                    node.embedding_model !== currentSpace.model ||
+                    node.embedding_version !== currentSpace.version ||
+                    node.embedding_dimensions !== currentSpace.dimensions ||
+                    (node.embedding_manifest_id ?? undefined) !== (currentSpace.manifestId ?? undefined);
+                const needsStatusUpdate = node.migration_status !== "current";
+                if (spaceMismatched || needsStatusUpdate) {
+                    // If the node status is current but its space is mismatched, or if its status is empty
+                    if (node.migration_status !== "pending") {
+                        const updatedNode = {
+                            ...node,
+                            migration_status: "pending",
+                            migration_updated_at: new Date().toISOString()
+                        };
+                        nodeRepo.upsert(updatedNode);
+                        pendingCount += 1;
+                    }
+                    else {
+                        pendingCount += 1;
+                    }
+                }
+            }
+        });
+        return pendingCount;
+    }
+    /**
+     * Migrates a single batch of pending experience nodes.
+     * To prevent long-held SQLite exclusive locks:
+     * 1. A short transaction locks the batch's target nodes to 'migrating' status.
+     * 2. Asynchronous embedding generation is performed outside the transaction.
+     * 3. Successful/failed node updates are committed one-by-one with small transactions.
+     */
+    async migrateBatch(db, currentSpace, options) {
+        const nodeRepo = new NodeRepository(db);
+        const batchSize = options.batchSize ?? 10;
+        const config = options.config;
+        // 1. Retrieve and lock this batch of nodes
+        const nodesToLock = withTransaction(db, () => {
+            const pendingRows = db
+                .prepare(`SELECT * FROM experience_nodes
+           WHERE migration_status = 'pending'
+           LIMIT ?`)
+                .all(batchSize);
+            const nodes = pendingRows.map((row) => {
+                // Deserialize the database row using NodeRepository.
+                // Since mapNode is private to NodeRepository, we retrieve via nodeRepo.getById.
+                // Because the batchSize is small, loading individually by ID is simple and safe.
+                return nodeRepo.getById(row.id);
+            }).filter(Boolean);
+            for (const node of nodes) {
+                nodeRepo.upsert({
+                    ...node,
+                    migration_status: "migrating",
+                    migration_updated_at: new Date().toISOString()
+                });
+            }
+            return nodes;
+        });
+        if (nodesToLock.length === 0) {
+            return { processed: 0, succeeded: 0, failed: 0 };
+        }
+        let succeeded = 0;
+        let failed = 0;
+        // 2. Perform asynchronous re-encoding one by one and commit with individual transactions
+        for (const node of nodesToLock) {
+            const retrievalText = node.retrieval_text?.trim() || `${node.trigger_pattern} ${node.compact_hint}`;
+            try {
+                // Call embedPassageText to re-encode the text
+                const embeddingResult = await embedPassageText(retrievalText, { config });
+                const spaceMatched = embeddingResult.space.provider === currentSpace.provider &&
+                    embeddingResult.space.model === currentSpace.model &&
+                    embeddingResult.space.version === currentSpace.version &&
+                    embeddingResult.space.dimensions === currentSpace.dimensions &&
+                    (embeddingResult.space.manifestId ?? undefined) === (currentSpace.manifestId ?? undefined);
+                if (!spaceMatched) {
+                    throw new Error(`Migration fallback detected: re-encoded space ${embeddingResult.space.provider}/${embeddingResult.space.model} does not match target space ${currentSpace.provider}/${currentSpace.model}`);
+                }
+                // 3. Commit successful migration in a small transaction
+                withTransaction(db, () => {
+                    const freshNode = nodeRepo.getById(node.id);
+                    if (freshNode) {
+                        nodeRepo.upsert({
+                            ...freshNode,
+                            embedding: embeddingResult.embedding,
+                            embedding_provider: embeddingResult.space.provider,
+                            embedding_model: embeddingResult.space.model,
+                            embedding_version: embeddingResult.space.version,
+                            embedding_dimensions: embeddingResult.space.dimensions,
+                            embedding_manifest_id: embeddingResult.space.manifestId,
+                            migration_status: "current",
+                            migration_last_error: undefined,
+                            migration_updated_at: new Date().toISOString()
+                        });
+                    }
+                });
+                succeeded += 1;
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.stack || error.message : String(error);
+                // 3. Commit failed migration status in a small transaction
+                withTransaction(db, () => {
+                    const freshNode = nodeRepo.getById(node.id);
+                    if (freshNode) {
+                        nodeRepo.upsert({
+                            ...freshNode,
+                            migration_status: "failed",
+                            migration_last_error: errorMessage,
+                            migration_updated_at: new Date().toISOString()
+                        });
+                    }
+                });
+                failed += 1;
+            }
+        }
+        return {
+            processed: nodesToLock.length,
+            succeeded,
+            failed
+        };
+    }
+    /**
+     * Automatically initiates the entire vector migration pipeline.
+     */
+    async runMigration(db, currentSpace, options) {
+        const totalDiscovered = this.discoverPendingNodes(db, currentSpace);
+        let processed = 0;
+        let succeeded = 0;
+        let failed = 0;
+        const maxTotalToProcess = options.maxTotalToProcess ?? Infinity;
+        const throttleGapMs = options.throttleGapMs ?? 50;
+        while (processed < maxTotalToProcess) {
+            const remainingLimit = maxTotalToProcess - processed;
+            const currentBatchSize = Math.min(options.batchSize ?? 10, remainingLimit);
+            const batchResult = await this.migrateBatch(db, currentSpace, {
+                ...options,
+                batchSize: currentBatchSize
+            });
+            if (batchResult.processed === 0) {
+                break;
+            }
+            processed += batchResult.processed;
+            succeeded += batchResult.succeeded;
+            failed += batchResult.failed;
+            // Apply throttling to yield execution back to the event loop
+            if (throttleGapMs > 0) {
+                await new Promise((resolve) => setTimeout(resolve, throttleGapMs));
+            }
+        }
+        return {
+            totalDiscovered,
+            processed,
+            succeeded,
+            failed
+        };
+    }
+}
+//# sourceMappingURL=vector-migrator.js.map

package/dist/maintenance/vector-migrator.js.map

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