@alan512/experienceengine 0.3.4 → 0.3.6

package/dist/interaction/surface-tiers.js

@@ -0,0 +1,19 @@
+export const SURFACE_TIER_DEFINITIONS = {
+    routine: {
+        tier: "routine",
+        label: "Routine",
+        summary: "Day-to-day host-first review, status, last-inspection, and helped/harmed feedback."
+    },
+    operator: {
+        tier: "operator",
+        label: "Operator",
+        summary: "Explicit install, repair, upgrade, review, governance approval, hygiene, export-draft, and managed-state workflows."
+    },
+    advanced: {
+        tier: "advanced",
+        label: "Advanced / experimental",
+        summary: "Maintenance, raw evaluation, broker-internal, and developer diagnostic workflows."
+    }
+};
+export const describeSurfaceTier = (tier) => SURFACE_TIER_DEFINITIONS[tier].summary;
+//# sourceMappingURL=surface-tiers.js.map

package/dist/interaction/surface-tiers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-tiers.js","sourceRoot":"","sources":["../../src/interaction/surface-tiers.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,wBAAwB,GAAmE;IACtG,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,oFAAoF;KAC9F;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,UAAU;QACjB,OAAO,EAAE,qHAAqH;KAC/H;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,yBAAyB;QAChC,OAAO,EAAE,mFAAmF;KAC7F;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,IAA2B,EAAU,EAAE,CACzE,wBAAwB,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC"}

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

@@ -0,0 +1,21 @@
+import type { DatabaseSync } from "node:sqlite";
+import type { HygieneGovernanceInput, HygieneGovernancePlan } from "./hygiene-governance-planner.js";
+import type { HygieneGovernanceValidationResult } from "./hygiene-governance-validator.js";
+export type HygieneGovernanceApplyResult = {
+    applied: string[];
+    guardedApplied: string[];
+    skipped: string[];
+    rejected: string[];
+    queuedApprovals: string[];
+};
+type ApplyInput = {
+    input: HygieneGovernanceInput;
+    plan: HygieneGovernancePlan;
+    validation: HygieneGovernanceValidationResult;
+    runId?: string;
+    planId?: string;
+    now: string;
+    maxActions?: number;
+};
+export declare const applyValidatedHygieneGovernanceActions: (db: DatabaseSync, input: ApplyInput) => HygieneGovernanceApplyResult;
+export {};

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

@@ -0,0 +1,246 @@
+import { GovernanceActionRepository, applyGovernanceActionWithSnapshot, computeGovernanceRowHashes } from "../store/sqlite/repositories/hygiene-governance-repo.js";
+import { NodeRepository } from "../store/sqlite/repositories/node-repo.js";
+const unique = (values) => [...new Set(values.filter(Boolean))].sort();
+const maxIso = (values) => values.filter((value) => Boolean(value)).sort().at(-1);
+const nodeRowRef = (nodeId) => ({
+    table: "experience_nodes",
+    primaryKeyColumn: "id",
+    primaryKeyValue: nodeId
+});
+const candidateRowRef = (candidateId) => ({
+    table: "experience_candidates",
+    primaryKeyColumn: "id",
+    primaryKeyValue: candidateId
+});
+const mergeExactDuplicate = (nodeRepo, action, now, guarded) => {
+    const canonicalId = action.canonicalNodeId;
+    if (!canonicalId) {
+        throw new Error(`Cannot apply ${action.actionId}: missing canonical node`);
+    }
+    const nodes = action.affectedNodeIds.map((id) => nodeRepo.getById(id));
+    if (nodes.some((node) => !node)) {
+        throw new Error(`Cannot apply ${action.actionId}: affected node missing`);
+    }
+    const resolvedNodes = nodes;
+    const canonical = resolvedNodes.find((node) => node.id === canonicalId);
+    if (!canonical) {
+        throw new Error(`Cannot apply ${action.actionId}: canonical node missing`);
+    }
+    const merged = {
+        ...canonical,
+        origin_record_ids: unique(resolvedNodes.flatMap((node) => node.origin_record_ids)),
+        helped_record_ids: unique(resolvedNodes.flatMap((node) => node.helped_record_ids)),
+        harmed_record_ids: unique(resolvedNodes.flatMap((node) => node.harmed_record_ids)),
+        usage_count: resolvedNodes.reduce((sum, node) => sum + node.usage_count, 0),
+        helped_count: resolvedNodes.reduce((sum, node) => sum + node.helped_count, 0),
+        harmed_count: resolvedNodes.reduce((sum, node) => sum + node.harmed_count, 0),
+        support_count: resolvedNodes.reduce((sum, node) => sum + node.support_count, 0),
+        last_used_at: maxIso(resolvedNodes.map((node) => node.last_used_at)),
+        last_helped_at: maxIso(resolvedNodes.map((node) => node.last_helped_at)),
+        last_harmed_at: maxIso(resolvedNodes.map((node) => node.last_harmed_at)),
+        delivery_state: guarded && canonical.delivery_state === "eligible" ? "conservative_only" : canonical.delivery_state,
+        merge_decision: "UPDATE",
+        merge_reason: guarded
+            ? `Guarded autonomous hygiene merge from ${action.affectedNodeIds.join(",")}.`
+            : `Autonomous hygiene exact duplicate merge from ${action.affectedNodeIds.join(",")}.`,
+        updated_at: now
+    };
+    nodeRepo.upsert(merged);
+    for (const node of resolvedNodes) {
+        if (node.id === canonicalId) {
+            continue;
+        }
+        nodeRepo.upsert({
+            ...node,
+            state: "retired",
+            delivery_state: "quarantined",
+            merge_decision: "UPDATE",
+            merge_reason: `Merged into ${canonicalId} by autonomous hygiene governance.`,
+            updated_at: now
+        });
+    }
+    return {
+        canonicalNodeId: canonicalId,
+        retiredNodeIds: action.affectedNodeIds.filter((id) => id !== canonicalId),
+        guarded
+    };
+};
+const retireStaleShadow = (nodeRepo, action, now) => {
+    const nodeId = action.affectedNodeIds[0];
+    const node = nodeRepo.getById(nodeId);
+    if (!node) {
+        throw new Error(`Cannot apply ${action.actionId}: affected node missing`);
+    }
+    nodeRepo.upsert({
+        ...node,
+        state: "retired",
+        delivery_state: "quarantined",
+        merge_decision: "NONE",
+        merge_reason: "Retired stale shadow-only guidance by autonomous hygiene governance.",
+        updated_at: now
+    });
+    return { retiredNodeId: nodeId };
+};
+const downgradeDelivery = (nodeRepo, action, now) => {
+    const nodeId = action.affectedNodeIds[0];
+    const node = nodeRepo.getById(nodeId);
+    if (!node) {
+        throw new Error(`Cannot apply ${action.actionId}: affected node missing`);
+    }
+    nodeRepo.upsert({
+        ...node,
+        delivery_state: "conservative_only",
+        merge_decision: "NONE",
+        merge_reason: "Downgraded delivery by autonomous hygiene governance after harmed attribution.",
+        updated_at: now
+    });
+    return { downgradedNodeId: nodeId, deliveryState: "conservative_only" };
+};
+const quarantineNode = (nodeRepo, action, now) => {
+    const nodeId = action.affectedNodeIds[0];
+    const node = nodeRepo.getById(nodeId);
+    if (!node) {
+        throw new Error(`Cannot apply ${action.actionId}: affected node missing`);
+    }
+    nodeRepo.upsert({
+        ...node,
+        state: "cooling",
+        delivery_state: "quarantined",
+        quarantined_at: now,
+        quarantine_reason: "Autonomous hygiene governance observed strong harmed attribution.",
+        merge_decision: "NONE",
+        merge_reason: "Quarantined by autonomous hygiene governance after strong harmed attribution.",
+        updated_at: now
+    });
+    return { quarantinedNodeId: nodeId };
+};
+const promoteDeliveryGuarded = (nodeRepo, action, now) => {
+    const promoted = [];
+    for (const nodeId of action.affectedNodeIds) {
+        const node = nodeRepo.getById(nodeId);
+        if (!node) {
+            throw new Error(`Cannot apply ${action.actionId}: affected node missing`);
+        }
+        nodeRepo.upsert({
+            ...node,
+            state: "active",
+            delivery_state: "conservative_only",
+            merge_decision: "NONE",
+            merge_reason: "Guarded autonomous hygiene promotion to conservative delivery.",
+            updated_at: now
+        });
+        promoted.push(nodeId);
+    }
+    return { promotedNodeIds: promoted, deliveryState: "conservative_only", guarded: true };
+};
+const softRetireRecords = (nodeRepo, action, now) => {
+    const retired = [];
+    for (const nodeId of action.affectedNodeIds) {
+        const node = nodeRepo.getById(nodeId);
+        if (!node) {
+            throw new Error(`Cannot apply ${action.actionId}: affected node missing`);
+        }
+        nodeRepo.upsert({
+            ...node,
+            state: "retired",
+            delivery_state: "quarantined",
+            merge_decision: "NONE",
+            merge_reason: "Guarded autonomous hygiene soft-retire; row retained for rollback and audit.",
+            updated_at: now
+        });
+        retired.push(nodeId);
+    }
+    return { retiredNodeIds: retired, guarded: true };
+};
+const ensurePendingAction = (db, repo, action, input, validatorDecision, rows) => {
+    const existing = repo.get(action.actionId);
+    if (existing) {
+        return existing;
+    }
+    const decision = typeof validatorDecision.decision === "string" ? validatorDecision.decision : "reject";
+    return repo.create({
+        action_id: action.actionId,
+        plan_id: input.planId,
+        run_id: input.runId,
+        scope_id: input.input.scope.scopeId,
+        action_type: action.actionType,
+        status: decision === "accept" || decision === "accept_guarded" ? "pending" : "rejected",
+        affected_ids: [...action.affectedNodeIds, ...action.affectedCandidateIds],
+        affected_row_hashes: computeGovernanceRowHashes(db, rows),
+        action: action,
+        validator_decision: validatorDecision,
+        created_at: input.now,
+        updated_at: input.now
+    });
+};
+export const applyValidatedHygieneGovernanceActions = (db, input) => {
+    const actionRepo = new GovernanceActionRepository(db);
+    const nodeRepo = new NodeRepository(db);
+    const validationByActionId = new Map(input.validation.actions.map((action) => [action.actionId, action]));
+    const result = { applied: [], guardedApplied: [], skipped: [], rejected: [], queuedApprovals: [] };
+    const budget = input.maxActions ?? input.plan.actions.length;
+    for (const action of input.plan.actions) {
+        if (result.applied.length + result.guardedApplied.length >= budget) {
+            break;
+        }
+        const validatorDecision = validationByActionId.get(action.actionId);
+        if (!validatorDecision) {
+            result.rejected.push(action.actionId);
+            continue;
+        }
+        const affectedRows = [
+            ...action.affectedNodeIds.map(nodeRowRef),
+            ...action.affectedCandidateIds.map(candidateRowRef)
+        ];
+        const stored = ensurePendingAction(db, actionRepo, action, input, validatorDecision, affectedRows);
+        if (validatorDecision.decision !== "accept" && validatorDecision.decision !== "accept_guarded") {
+            db.prepare(`UPDATE hygiene_governance_actions
+         SET status = 'rejected', validator_decision_json = ?, updated_at = ?
+         WHERE action_id = ? AND status != 'applied'`).run(JSON.stringify(validatorDecision), input.now, action.actionId);
+            result.rejected.push(action.actionId);
+            continue;
+        }
+        if (stored.status === "applied") {
+            result.skipped.push(action.actionId);
+            continue;
+        }
+        if (stored.status !== "pending") {
+            result.rejected.push(action.actionId);
+            continue;
+        }
+        applyGovernanceActionWithSnapshot(db, {
+            actionId: action.actionId,
+            scopeId: input.input.scope.scopeId,
+            rows: affectedRows,
+            now: input.now,
+            apply: () => {
+                const guarded = validatorDecision.decision === "accept_guarded";
+                switch (action.actionType) {
+                    case "merge_exact_duplicate":
+                    case "merge_near_duplicate":
+                        return mergeExactDuplicate(nodeRepo, action, input.now, guarded);
+                    case "retire_stale_shadow":
+                        return retireStaleShadow(nodeRepo, action, input.now);
+                    case "downgrade_delivery":
+                        return downgradeDelivery(nodeRepo, action, input.now);
+                    case "quarantine":
+                        return quarantineNode(nodeRepo, action, input.now);
+                    case "promote_delivery":
+                        return promoteDeliveryGuarded(nodeRepo, action, input.now);
+                    case "delete_record":
+                        return softRetireRecords(nodeRepo, action, input.now);
+                    default:
+                        throw new Error(`Unsupported automatic hygiene governance action: ${action.actionType}`);
+                }
+            }
+        });
+        if (validatorDecision.decision === "accept_guarded") {
+            result.guardedApplied.push(action.actionId);
+        }
+        else {
+            result.applied.push(action.actionId);
+        }
+    }
+    return result;
+};
+//# sourceMappingURL=hygiene-governance-applicator.js.map

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

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

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

@@ -0,0 +1,41 @@
+import type { DatabaseSync } from "node:sqlite";
+type ApprovalPlan = {
+    approvalId: string;
+    actionId: string;
+    planId?: string;
+    scopeId: string;
+    diffSummary?: string;
+    affectedRowHashes: Record<string, string>;
+    confirmationToken: string;
+    tokenExpiresAt: string;
+};
+export declare class HygieneGovernanceApprovalService {
+    private readonly db;
+    private readonly now;
+    constructor(db: DatabaseSync, now?: () => string);
+    planApproval(approvalId: string): ApprovalPlan;
+    executeApproval(input: {
+        approvalId: string;
+        confirmationToken: string;
+    }): {
+        approvalId: string;
+        actionId: string;
+        status: "approved";
+    } | {
+        approvalId: string;
+        actionId: string;
+        status: "already_approved";
+    } | {
+        approvalId: string;
+        actionId: string;
+        status: "stale_replan_required";
+        reason: "affected_rows_changed";
+    };
+    rejectApproval(approvalId: string): {
+        approvalId: string;
+        actionId: string;
+        status: "rejected" | "already_rejected";
+    };
+    private assertToken;
+}
+export {};

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

@@ -0,0 +1,143 @@
+import { createHash } from "node:crypto";
+import { GovernanceActionRepository, GovernanceApprovalRepository } from "../store/sqlite/repositories/hygiene-governance-repo.js";
+import { createId } from "../utils/ids.js";
+const TOKEN_TTL_MS = 10 * 60 * 1000;
+const hashValue = (value) => createHash("sha256").update(value, "utf8").digest("hex");
+const stableRowHash = (row) => createHash("sha256").update(JSON.stringify(row, Object.keys(row).sort()), "utf8").digest("hex");
+const parseRowRef = (ref) => {
+    const parts = ref.split(":");
+    if (parts.length !== 3) {
+        throw new Error(`Invalid governance row ref: ${ref}`);
+    }
+    return {
+        table: parts[0],
+        primaryKeyColumn: parts[1],
+        primaryKeyValue: parts[2]
+    };
+};
+const assertIdentifier = (value) => {
+    if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(value)) {
+        throw new Error(`Unsafe SQLite identifier: ${value}`);
+    }
+};
+const currentAffectedRowHashes = (db, refs) => {
+    const hashes = {};
+    for (const key of Object.keys(refs)) {
+        const ref = parseRowRef(key);
+        assertIdentifier(ref.table);
+        assertIdentifier(ref.primaryKeyColumn);
+        const row = db.prepare(`SELECT * FROM ${ref.table} WHERE ${ref.primaryKeyColumn} = ? LIMIT 1`).get(ref.primaryKeyValue);
+        if (!row) {
+            hashes[key] = "missing";
+            continue;
+        }
+        hashes[key] = stableRowHash(row);
+    }
+    return hashes;
+};
+const hashesMatch = (left, right) => {
+    const keys = Object.keys(left).sort();
+    if (keys.length !== Object.keys(right).length) {
+        return false;
+    }
+    return keys.every((key) => left[key] === right[key]);
+};
+export class HygieneGovernanceApprovalService {
+    db;
+    now;
+    constructor(db, now = () => new Date().toISOString()) {
+        this.db = db;
+        this.now = now;
+    }
+    planApproval(approvalId) {
+        const approval = new GovernanceApprovalRepository(this.db).get(approvalId);
+        if (!approval) {
+            throw new Error(`Governance approval not found: ${approvalId}`);
+        }
+        if (approval.status !== "pending") {
+            throw new Error(`Governance approval is not pending: ${approval.status}`);
+        }
+        const token = createId("governance_confirm");
+        const expiresAt = new Date(new Date(this.now()).getTime() + TOKEN_TTL_MS).toISOString();
+        this.db
+            .prepare(`UPDATE hygiene_governance_approvals
+         SET confirmation_token_hash = ?, token_expires_at = ?, updated_at = ?
+         WHERE approval_id = ? AND status = 'pending'`)
+            .run(hashValue(token), expiresAt, this.now(), approvalId);
+        return {
+            approvalId: approval.approval_id,
+            actionId: approval.action_id,
+            planId: approval.plan_id,
+            scopeId: approval.scope_id,
+            diffSummary: approval.diff_summary,
+            affectedRowHashes: approval.affected_row_hashes,
+            confirmationToken: token,
+            tokenExpiresAt: expiresAt
+        };
+    }
+    executeApproval(input) {
+        const approvalRepo = new GovernanceApprovalRepository(this.db);
+        const approval = approvalRepo.get(input.approvalId);
+        if (!approval) {
+            throw new Error(`Governance approval not found: ${input.approvalId}`);
+        }
+        if (approval.status === "approved") {
+            return { approvalId: approval.approval_id, actionId: approval.action_id, status: "already_approved" };
+        }
+        this.assertToken(approval, input.confirmationToken);
+        const currentHashes = currentAffectedRowHashes(this.db, approval.affected_row_hashes);
+        if (!hashesMatch(currentHashes, approval.affected_row_hashes)) {
+            this.db
+                .prepare("UPDATE hygiene_governance_approvals SET status = 'stale', updated_at = ? WHERE approval_id = ?")
+                .run(this.now(), approval.approval_id);
+            return {
+                approvalId: approval.approval_id,
+                actionId: approval.action_id,
+                status: "stale_replan_required",
+                reason: "affected_rows_changed"
+            };
+        }
+        this.db
+            .prepare(`UPDATE hygiene_governance_approvals
+         SET status = 'approved', decided_at = ?, updated_at = ?
+         WHERE approval_id = ? AND status = 'pending'`)
+            .run(this.now(), this.now(), approval.approval_id);
+        const action = new GovernanceActionRepository(this.db).get(approval.action_id);
+        if (action) {
+            this.db
+                .prepare("UPDATE hygiene_governance_actions SET status = 'applied', applied_at = ?, updated_at = ? WHERE action_id = ? AND status != 'applied'")
+                .run(this.now(), this.now(), action.action_id);
+        }
+        return { approvalId: approval.approval_id, actionId: approval.action_id, status: "approved" };
+    }
+    rejectApproval(approvalId) {
+        const approval = new GovernanceApprovalRepository(this.db).get(approvalId);
+        if (!approval) {
+            throw new Error(`Governance approval not found: ${approvalId}`);
+        }
+        if (approval.status === "rejected") {
+            return { approvalId: approval.approval_id, actionId: approval.action_id, status: "already_rejected" };
+        }
+        this.db
+            .prepare(`UPDATE hygiene_governance_approvals
+         SET status = 'rejected', decided_at = ?, updated_at = ?
+         WHERE approval_id = ?`)
+            .run(this.now(), this.now(), approval.approval_id);
+        this.db
+            .prepare("UPDATE hygiene_governance_actions SET status = 'rejected', updated_at = ? WHERE action_id = ? AND status != 'applied'")
+            .run(this.now(), approval.action_id);
+        return { approvalId: approval.approval_id, actionId: approval.action_id, status: "rejected" };
+    }
+    assertToken(approval, token) {
+        if (approval.status !== "pending") {
+            throw new Error(`Governance approval is not pending: ${approval.status}`);
+        }
+        if (!approval.confirmation_token_hash || approval.confirmation_token_hash !== hashValue(token)) {
+            throw new Error("Invalid or expired governance approval confirmation token.");
+        }
+        if (approval.token_expires_at && approval.token_expires_at <= this.now()) {
+            throw new Error("Invalid or expired governance approval confirmation token.");
+        }
+    }
+}
+//# sourceMappingURL=hygiene-governance-approvals.js.map

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

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

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

@@ -0,0 +1,26 @@
+import type { DistillerEndpoint } from "../distillation/providers/types.js";
+import type { ExperienceEngineConfig } from "../config/config-schema.js";
+import type { HygieneGovernanceInput, HygieneGovernancePlannerProvider } from "./hygiene-governance-planner.js";
+type LlmHygieneGovernancePlannerConfig = Pick<ExperienceEngineConfig, "distillerProvider" | "distillerModel" | "distillationAuthMode">;
+export type LlmHygieneGovernancePlannerOptions = {
+    config: LlmHygieneGovernancePlannerConfig;
+    env?: NodeJS.ProcessEnv;
+    homeDir?: string;
+    fetchImpl?: typeof fetch;
+    maxRetries?: number;
+    retryDelayMs?: number;
+    resolveEndpoint?: (options?: {
+        env?: NodeJS.ProcessEnv;
+        homeDir?: string;
+        configProvider?: ExperienceEngineConfig["distillerProvider"];
+        configAuthMode?: string;
+        configModel?: string;
+    }) => DistillerEndpoint | null;
+};
+export declare class LlmHygieneGovernancePlanner implements HygieneGovernancePlannerProvider {
+    private readonly options;
+    constructor(options: LlmHygieneGovernancePlannerOptions);
+    hasEndpoint(): boolean;
+    plan(input: HygieneGovernanceInput): Promise<string>;
+}
+export {};