@opengeni/core 0.28.0 → 1.0.0

package/src/domain/durable-learning-slack-publication.ts

@@ -1,202 +0,0 @@
-import {
-  enqueueMemorySlackPublication,
-  getCurrentMemorySlackPublicationConfiguration,
-  type Database,
-  type EnqueueMemorySlackPublicationResult,
-} from "@opengeni/db";
-import { sanitizeSlackPublicationText } from "./slack-publication-secret-safety";
-
-/**
- * Narrow post-persistence port for the immutable durable-learning v1 attempt/receipt contract.
- * The router owns validation, authority, routing, and persistence. This adapter
- * consumes only the fields required to create a bounded notification projection.
- */
-export type DurableLearningSlackOutcome = {
-  attempt: {
-    id: string;
-    accountId: string;
-    workspaceId: string;
-    inputHash: string;
-    actor: { kind: "human" | "agent" | "service"; subjectId: string };
-    initiatingHumanSubjectId: string | null;
-    sessionId: string | null;
-    request:
-      | {
-          operation: "write";
-          subject: {
-            kind: string;
-            summary: string | null;
-          };
-          evidence: Array<{ kind: string }>;
-        }
-      | {
-          operation: "rollback";
-          targetAttemptId: string;
-        };
-  };
-  receipt: {
-    attemptId: string;
-    inputHash: string;
-    outcome:
-      | "applied"
-      | "proposed"
-      | "evidence_recorded"
-      | "noop"
-      | "clarification_required"
-      | "rejected"
-      | "rolled_back"
-      | "failed";
-    decision: {
-      code: string;
-      destination: string | null;
-      scope: { kind: string } | null;
-      authority: string | null;
-    };
-    resource: {
-      surface: string;
-      id: string;
-      version: string | null;
-      status: string;
-    } | null;
-    createdAt: string;
-  };
-};
-
-export type DurableLearningSlackPublicationResult =
-  | {
-      kind:
-        | "contract_mismatch"
-        | "not_workspace_scoped"
-        | "connector_evidence_untrusted"
-        | "summary_required"
-        | "policy_quiet";
-      enqueue: null;
-    }
-  | { kind: "enqueued"; enqueue: EnqueueMemorySlackPublicationResult };
-
-export type DurableLearningSlackProjection = {
-  summary: string;
-  outcome: DurableLearningSlackOutcome["receipt"]["outcome"];
-  decisionCode: string;
-  destination: string | null;
-  authority: string | null;
-  resource: DurableLearningSlackOutcome["receipt"]["resource"];
-  occurredAt: string;
-};
-
-export async function publishDurableLearningOutcomeToSlack(
-  db: Database,
-  outcome: DurableLearningSlackOutcome,
-): Promise<DurableLearningSlackPublicationResult> {
-  const { attempt, receipt } = outcome;
-  if (attempt.id !== receipt.attemptId || attempt.inputHash !== receipt.inputHash) {
-    return { kind: "contract_mismatch", enqueue: null };
-  }
-  if (receipt.decision.scope?.kind !== "workspace") {
-    return { kind: "not_workspace_scoped", enqueue: null };
-  }
-  if (
-    attempt.request.operation === "write" &&
-    attempt.request.evidence.some((evidence) => evidence.kind === "connector")
-  ) {
-    // The v1 router contract intentionally does not identify connector providers.
-    // Fail closed rather than risk republishing a Slack-derived learning outcome.
-    return { kind: "connector_evidence_untrusted", enqueue: null };
-  }
-
-  const projection = durableLearningSlackProjection(outcome);
-  if (!projection) return { kind: "summary_required", enqueue: null };
-  const importance = durableLearningImportance(outcome);
-  const configuration = await getCurrentMemorySlackPublicationConfiguration(
-    db,
-    attempt.workspaceId,
-  );
-  const deliveryMode = configuration?.autoImportances.includes(importance)
-    ? "auto"
-    : configuration?.reviewImportances.includes(importance)
-      ? "review"
-      : null;
-  if (!configuration?.enabled || !deliveryMode) {
-    return { kind: "policy_quiet", enqueue: null };
-  }
-
-  const enqueue = await enqueueMemorySlackPublication(db, {
-    accountId: attempt.accountId,
-    workspaceId: attempt.workspaceId,
-    sourceType: "durable_learning",
-    sourceId: receipt.attemptId,
-    sourceVersion: receipt.inputHash,
-    sourceIdempotencyKey: `durable-learning:${receipt.attemptId}`,
-    projection,
-    importance,
-    deliveryMode,
-    actor: {
-      kind: attempt.actor.kind,
-      subjectId: attempt.actor.subjectId,
-      initiatingHumanSubjectId: attempt.initiatingHumanSubjectId,
-      sessionId: attempt.sessionId,
-      attemptId: attempt.id,
-    },
-  });
-  return { kind: "enqueued", enqueue };
-}
-
-export function durableLearningImportance(
-  outcome: DurableLearningSlackOutcome,
-): "major" | "normal" | "minor" {
-  if (outcome.receipt.outcome === "failed" || outcome.receipt.outcome === "rolled_back") {
-    return "major";
-  }
-  if (outcome.receipt.outcome === "noop" || outcome.receipt.outcome === "clarification_required") {
-    return "minor";
-  }
-  if (
-    outcome.attempt.request.operation === "write" &&
-    ["decision", "workspace_charter", "mandatory_operating_context", "workspace_goal"].includes(
-      outcome.attempt.request.subject.kind,
-    )
-  ) {
-    return "major";
-  }
-  return "normal";
-}
-
-export function durableLearningSlackProjection(
-  outcome: DurableLearningSlackOutcome,
-): DurableLearningSlackProjection | null {
-  const summary = durableLearningSummary(outcome);
-  if (!summary) return null;
-  return {
-    summary,
-    outcome: outcome.receipt.outcome,
-    decisionCode: outcome.receipt.decision.code,
-    destination: boundedSlackPublicationText(outcome.receipt.decision.destination, 128),
-    authority: outcome.receipt.decision.authority,
-    resource: outcome.receipt.resource
-      ? {
-          surface: outcome.receipt.resource.surface,
-          id: outcome.receipt.resource.id,
-          version: outcome.receipt.resource.version,
-          status: outcome.receipt.resource.status,
-        }
-      : null,
-    occurredAt: outcome.receipt.createdAt,
-  };
-}
-
-function durableLearningSummary(outcome: DurableLearningSlackOutcome): string | null {
-  if (outcome.attempt.request.operation === "rollback") {
-    const destination =
-      boundedSlackPublicationText(outcome.receipt.decision.destination, 128) ??
-      "governed knowledge";
-    return `Rolled back a durable learning change for ${destination}.`;
-  }
-  const summary = outcome.attempt.request.subject.summary?.replace(/\s+/g, " ").trim();
-  return summary ? sanitizeSlackPublicationText(summary).slice(0, 512) : null;
-}
-
-function boundedSlackPublicationText(value: string | null, maxChars: number): string | null {
-  if (!value) return null;
-  const sanitized = sanitizeSlackPublicationText(value.replace(/\s+/g, " ").trim());
-  return sanitized ? sanitized.slice(0, maxChars) : null;
-}