@indexnetwork/protocol 6.12.0-rc.403.1 → 6.13.22-rc.405.1

package/dist/opportunity/application/opportunity.update-admission.d.ts

@@ -0,0 +1,24 @@
+import type { Opportunity, OpportunityGraphDatabase } from '../../shared/interfaces/database.interface.js';
+/** Narrow persistence read port for authorizing a user-driven opportunity update. */
+export type OpportunityUpdateAdmissionPort = Pick<OpportunityGraphDatabase, 'getOpportunity'>;
+export interface OpportunityUpdateAdmissionInput {
+    opportunityId: string;
+    viewerId: string;
+    scopedNetworkId?: string;
+    selectedIntentScope?: {
+        scopeType?: 'intent';
+        scopeId?: string;
+    };
+}
+export type OpportunityUpdateAdmission = {
+    kind: 'admitted';
+    opportunity: Opportunity;
+} | {
+    kind: 'denied';
+    message: string;
+};
+/**
+ * Authorizes mutation only after an opaque existence/actor check, then applies
+ * lifecycle, viewer-network, and selected-intent boundaries in that order.
+ */
+export declare function admitOpportunityUpdate(database: OpportunityUpdateAdmissionPort, input: OpportunityUpdateAdmissionInput): Promise<OpportunityUpdateAdmission>;

package/dist/opportunity/application/opportunity.update-admission.js

@@ -0,0 +1,38 @@
+const BLOCKED_UPDATE_STATUSES = new Set([
+    'accepted',
+    'rejected',
+    'expired',
+    'negotiating',
+]);
+function matchesSelectedIntentScope(opportunity, viewerId, scope) {
+    if (scope?.scopeType !== 'intent' || !scope.scopeId)
+        return true;
+    if (opportunity.detection?.triggeredBy === scope.scopeId)
+        return true;
+    return opportunity.actors?.some((actor) => actor.userId === viewerId && actor.intent === scope.scopeId) ?? false;
+}
+/**
+ * Authorizes mutation only after an opaque existence/actor check, then applies
+ * lifecycle, viewer-network, and selected-intent boundaries in that order.
+ */
+export async function admitOpportunityUpdate(database, input) {
+    const opportunity = await database.getOpportunity(input.opportunityId);
+    if (!opportunity)
+        return { kind: 'denied', message: 'Opportunity not found.' };
+    if (!opportunity.actors?.some((actor) => actor.userId === input.viewerId)) {
+        return { kind: 'denied', message: 'Opportunity not found.' };
+    }
+    if (BLOCKED_UPDATE_STATUSES.has(opportunity.status)) {
+        return {
+            kind: 'denied',
+            message: `This opportunity is already ${opportunity.status} and cannot be updated.`,
+        };
+    }
+    if (input.scopedNetworkId && !opportunity.actors?.some((actor) => actor.userId === input.viewerId && actor.networkId === input.scopedNetworkId)) {
+        return { kind: 'denied', message: 'Opportunity not found.' };
+    }
+    if (!matchesSelectedIntentScope(opportunity, input.viewerId, input.selectedIntentScope)) {
+        return { kind: 'denied', message: 'Opportunity not found.' };
+    }
+    return { kind: 'admitted', opportunity };
+}

package/dist/opportunity/delivery-card.cache.d.ts

@@ -1,26 +1,5 @@
-import type { Cache } from '../shared/interfaces/cache.interface.js';
-import type { OpportunityPresenter, PresenterDatabase } from './opportunity.presenter.js';
-export interface CachedDeliveryCard {
-    opportunityId: string;
-    headline: string;
-    personalizedSummary: string;
-    suggestedAction: string;
-    narratorRemark: string;
-    /** Empty string means presenter did not generate one (LLM error / fallback path). */
-    greeting: string;
-}
-export interface OpportunityWithContext {
-    id: string;
-    status: string;
-    actors: Array<{
-        userId: string;
-        role: string;
-    }>;
-    interpretation?: unknown;
-    detection?: unknown;
-}
-export declare const DELIVERY_CARD_CACHE_TTL: number;
-export declare function getOrCreateDeliveryCardBatch(cache: Cache, presenter: OpportunityPresenter, presenterDb: PresenterDatabase, opportunities: OpportunityWithContext[], viewerId: string, options?: {
-    ttl?: number;
-}): Promise<Map<string, CachedDeliveryCard>>;
-//# sourceMappingURL=delivery-card.cache.d.ts.map
+/**
+ * Thin backward-compat shim — IND-551.
+ * Canonical location: opportunity/application/delivery-card.cache.ts
+ */
+export * from "./application/delivery-card.cache.js";

package/dist/opportunity/delivery-card.cache.js

@@ -1,44 +1,5 @@
-import { gatherPresenterContext } from './opportunity.presenter.js';
-import { buildDeliveryCardPresentationCacheKey } from './opportunity.presentation-cache.js';
-export const DELIVERY_CARD_CACHE_TTL = 24 * 60 * 60; // 24 hours
-export async function getOrCreateDeliveryCardBatch(cache, presenter, presenterDb, opportunities, viewerId, options) {
-    if (opportunities.length === 0) {
-        return new Map();
-    }
-    const ttl = options?.ttl ?? DELIVERY_CARD_CACHE_TTL;
-    const keys = opportunities.map((opp) => buildDeliveryCardPresentationCacheKey(opp.id, opp.status, viewerId));
-    const cached = await cache.mget(keys);
-    const result = new Map();
-    const misses = [];
-    for (let i = 0; i < opportunities.length; i++) {
-        const item = cached[i];
-        if (item) {
-            result.set(opportunities[i].id, item);
-        }
-        else {
-            misses.push({ opp: opportunities[i], index: i });
-        }
-    }
-    // Generate cards for cache misses
-    await Promise.all(misses.map(async ({ opp, index }) => {
-        const presenterInput = await gatherPresenterContext(presenterDb, opp, viewerId);
-        presenterInput.opportunityStatus = opp.status;
-        const presented = await presenter.presentHomeCard(presenterInput);
-        const card = {
-            opportunityId: opp.id,
-            headline: presented.headline,
-            personalizedSummary: presented.personalizedSummary,
-            suggestedAction: presented.suggestedAction,
-            narratorRemark: presented.narratorRemark,
-            greeting: presented.greeting ?? '',
-        };
-        result.set(opp.id, card);
-        // Presenter fallbacks are safe for this request but are deliberately not
-        // persisted for 24 hours; a later request should retry genuine copy.
-        if (!presented.isFallback) {
-            await cache.set(keys[index], card, { ttl });
-        }
-    }));
-    return result;
-}
-//# sourceMappingURL=delivery-card.cache.js.map
+/**
+ * Thin backward-compat shim — IND-551.
+ * Canonical location: opportunity/application/delivery-card.cache.ts
+ */
+export * from "./application/delivery-card.cache.js";

package/dist/opportunity/discovery-question.helper.d.ts

@@ -1,19 +1,5 @@
 /**
- * Pure mapper from opportunity-graph outputs + optional chat digest to a
- * `DiscoveryQuestionInput`. No I/O. Side-effect-free.
+ * Thin backward-compat shim — IND-551.
+ * Canonical location: opportunity/domain/discovery-question.helper.ts
  */
-import type { ChatContextDigest } from "../shared/schemas/chat-context.schema.js";
-import type { DiscoveryNegotiationDigest } from "../shared/schemas/negotiation-digest.schema.js";
-import type { DiscoveryQuestionInput, DiscoverySummary } from "../shared/schemas/discovery-question.schema.js";
-export interface BuildDiscoveryQuestionInputArgs {
-    query: string;
-    /** The seeker's global user_context paragraph (profile-replacing identity text). */
-    userContext: string;
-    negotiationDigests: DiscoveryNegotiationDigest[];
-    summary: DiscoverySummary;
-    chatContext?: ChatContextDigest;
-    now: string;
-}
-/** @deprecated Use QuestionerAgent discovery preset instead. Will be removed in a future version. */
-export declare function buildDiscoveryQuestionInput(args: BuildDiscoveryQuestionInputArgs): DiscoveryQuestionInput;
-//# sourceMappingURL=discovery-question.helper.d.ts.map
+export * from "./domain/discovery-question.helper.js";

package/dist/opportunity/discovery-question.helper.js

@@ -1,16 +1,5 @@
 /**
- * Pure mapper from opportunity-graph outputs + optional chat digest to a
- * `DiscoveryQuestionInput`. No I/O. Side-effect-free.
+ * Thin backward-compat shim — IND-551.
+ * Canonical location: opportunity/domain/discovery-question.helper.ts
  */
-/** @deprecated Use QuestionerAgent discovery preset instead. Will be removed in a future version. */
-export function buildDiscoveryQuestionInput(args) {
-    return {
-        query: args.query,
-        userContext: args.userContext,
-        negotiationDigests: args.negotiationDigests,
-        summary: args.summary,
-        ...(args.chatContext !== undefined ? { chatContext: args.chatContext } : {}),
-        now: args.now,
-    };
-}
-//# sourceMappingURL=discovery-question.helper.js.map
+export * from "./domain/discovery-question.helper.js";

package/dist/opportunity/discriminator/discriminator.adjustments.d.ts

@@ -88,4 +88,3 @@ export declare function planPoolAdjustments(discriminator: QuestionPoolDiscrimin
 export declare function mergePoolAdjustment(metadata: Record<string, unknown> | null | undefined, adjustment: PoolAdjustment): Record<string, unknown>;
 /** Latest scoped user-explainable demotion detail for card presentation. */
 export declare function latestPoolDemotionDetail(metadata: Record<string, unknown> | null | undefined, provenance: PoolAdjustmentProvenance): string | undefined;
-//# sourceMappingURL=discriminator.adjustments.d.ts.map

package/dist/opportunity/discriminator/discriminator.adjustments.js

@@ -139,4 +139,3 @@ export function latestPoolDemotionDetail(metadata, provenance) {
         .find((adjustment) => adjustment.factor < 1 && typeof adjustment.detail === 'string' && adjustment.detail.length > 0)
         ?.detail;
 }
-//# sourceMappingURL=discriminator.adjustments.js.map

package/dist/opportunity/discriminator/discriminator.assigner.d.ts

@@ -9,25 +9,25 @@ declare const AxisSchema: z.ZodObject<{
         evidence: z.ZodNullable<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         evidence: string | null;
-        candidateId: string;
         side: string | null;
+        candidateId: string;
     }, {
         evidence: string | null;
-        candidateId: string;
         side: string | null;
+        candidateId: string;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     assignments: {
         evidence: string | null;
-        candidateId: string;
         side: string | null;
+        candidateId: string;
     }[];
     questionId: string;
 }, {
     assignments: {
         evidence: string | null;
-        candidateId: string;
         side: string | null;
+        candidateId: string;
     }[];
     questionId: string;
 }>;
@@ -76,4 +76,3 @@ export declare class PoolDiscriminatorAssigner {
     }): Promise<PoolDiscriminatorAssignedAxis[]>;
 }
 export {};
-//# sourceMappingURL=discriminator.assigner.d.ts.map

package/dist/opportunity/discriminator/discriminator.assigner.js

@@ -151,4 +151,3 @@ __decorate([
     __metadata("design:paramtypes", [Object, Object]),
     __metadata("design:returntype", Promise)
 ], PoolDiscriminatorAssigner.prototype, "assign", null);
-//# sourceMappingURL=discriminator.assigner.js.map

package/dist/opportunity/discriminator/discriminator.env.d.ts

@@ -101,4 +101,3 @@ export declare const POOL_DISCRIMINATOR_MIN_POOL_SIZE = 5;
 export declare const POOL_DISCRIMINATOR_MAX_CANDIDATES = 24;
 /** Max chars of public context per candidate in the miner prompt. */
 export declare const POOL_DISCRIMINATOR_MAX_PUBLIC_CONTEXT_CHARS = 400;
-//# sourceMappingURL=discriminator.env.d.ts.map

package/dist/opportunity/discriminator/discriminator.env.js

@@ -101,4 +101,3 @@ export const POOL_DISCRIMINATOR_MIN_POOL_SIZE = 5;
 export const POOL_DISCRIMINATOR_MAX_CANDIDATES = 24;
 /** Max chars of public context per candidate in the miner prompt. */
 export const POOL_DISCRIMINATOR_MAX_PUBLIC_CONTEXT_CHARS = 400;
-//# sourceMappingURL=discriminator.env.js.map

package/dist/opportunity/discriminator/discriminator.miner.d.ts

@@ -112,4 +112,3 @@ export declare function buildMiningPrompt(input: DiscriminatorMiningInput): stri
  */
 export declare function verifyAxis(axis: AxisMiningResponse["axes"][number], candidates: DiscriminatorMiningInput["candidates"]): MinedDiscriminator;
 export {};
-//# sourceMappingURL=discriminator.miner.d.ts.map

package/dist/opportunity/discriminator/discriminator.miner.js

@@ -226,4 +226,3 @@ export function verifyAxis(axis, candidates) {
         evidenceRate: proposed > 0 ? verified / proposed : 0,
     };
 }
-//# sourceMappingURL=discriminator.miner.js.map

package/dist/opportunity/discriminator/discriminator.push.d.ts

@@ -11,4 +11,3 @@ export declare function buildPoolQuestionPushMessage(input: {
     intentTitle: string;
     questionPrompt: string;
 }): string;
-//# sourceMappingURL=discriminator.push.d.ts.map

package/dist/opportunity/discriminator/discriminator.push.js

@@ -17,4 +17,3 @@ export function buildPoolQuestionPushMessage(input) {
         : normalizedTitle;
     return `Quick one about [${escapePoolPushMarkdown(boundedTitle)}](/i/${input.intentId}): ${escapePoolPushMarkdown(input.questionPrompt)}`;
 }
-//# sourceMappingURL=discriminator.push.js.map

package/dist/opportunity/discriminator/discriminator.question.d.ts

@@ -56,4 +56,3 @@ export interface SynthesizedPoolQuestion {
  * duplicated here so no caller can bypass them).
  */
 export declare function synthesizePoolQuestion(input: SynthesizePoolQuestionInput): SynthesizedPoolQuestion | null;
-//# sourceMappingURL=discriminator.question.d.ts.map

package/dist/opportunity/discriminator/discriminator.question.js

@@ -153,4 +153,3 @@ export function synthesizePoolQuestion(input) {
         },
     };
 }
-//# sourceMappingURL=discriminator.question.js.map

package/dist/opportunity/discriminator/discriminator.scorer.d.ts

@@ -30,4 +30,3 @@ export declare function computeNovelty(axisEmbedding: number[], referenceEmbeddi
  * @param novelty     Precomputed novelty in [0,1] (see {@link computeNovelty}).
  */
 export declare function scoreDiscriminator(axis: MinedDiscriminator, candidates: PoolCandidate[], novelty: number): ScoredDiscriminator;
-//# sourceMappingURL=discriminator.scorer.d.ts.map

package/dist/opportunity/discriminator/discriminator.scorer.js

@@ -103,4 +103,3 @@ export function scoreDiscriminator(axis, candidates, novelty) {
     const voi = entropy * Math.pow(coverage, 1.5) * clampedNovelty;
     return { ...axis, entropy, coverage, novelty: clampedNovelty, voi };
 }
-//# sourceMappingURL=discriminator.scorer.js.map

package/dist/opportunity/discriminator/discriminator.shadow.d.ts

@@ -30,4 +30,3 @@ export interface DiscriminatorShadowInput {
  * discriminators rather than dropping the pass.
  */
 export declare function runPoolDiscriminatorShadow(input: DiscriminatorShadowInput): Promise<DiscriminatorShadowResult>;
-//# sourceMappingURL=discriminator.shadow.d.ts.map

package/dist/opportunity/discriminator/discriminator.shadow.js

@@ -81,4 +81,3 @@ export async function runPoolDiscriminatorShadow(input) {
         .sort((a, b) => b.voi - a.voi);
     return { poolSize: candidates.length, discriminators };
 }
-//# sourceMappingURL=discriminator.shadow.js.map

package/dist/opportunity/discriminator/discriminator.types.d.ts

@@ -89,4 +89,3 @@ export interface DiscriminatorShadowResult {
     /** Scored discriminators, sorted by VoI descending. */
     discriminators: ScoredDiscriminator[];
 }
-//# sourceMappingURL=discriminator.types.d.ts.map

package/dist/opportunity/discriminator/discriminator.types.js

@@ -16,4 +16,3 @@
  * for question synthesis and answer application.
  */
 export {};
-//# sourceMappingURL=discriminator.types.js.map

package/dist/opportunity/domain/discovery-question.helper.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Pure mapper from opportunity-graph outputs + optional chat digest to a
+ * `DiscoveryQuestionInput`. No I/O. Side-effect-free.
+ */
+import type { ChatContextDigest } from "../../shared/schemas/chat-context.schema.js";
+import type { DiscoveryNegotiationDigest } from "../../shared/schemas/negotiation-digest.schema.js";
+import type { DiscoveryQuestionInput, DiscoverySummary } from "../../shared/schemas/discovery-question.schema.js";
+export interface BuildDiscoveryQuestionInputArgs {
+    query: string;
+    /** The seeker's global user_context paragraph (profile-replacing identity text). */
+    userContext: string;
+    negotiationDigests: DiscoveryNegotiationDigest[];
+    summary: DiscoverySummary;
+    chatContext?: ChatContextDigest;
+    now: string;
+}
+/** @deprecated Use QuestionerAgent discovery preset instead. Will be removed in a future version. */
+export declare function buildDiscoveryQuestionInput(args: BuildDiscoveryQuestionInputArgs): DiscoveryQuestionInput;

package/dist/opportunity/domain/discovery-question.helper.js

@@ -0,0 +1,15 @@
+/**
+ * Pure mapper from opportunity-graph outputs + optional chat digest to a
+ * `DiscoveryQuestionInput`. No I/O. Side-effect-free.
+ */
+/** @deprecated Use QuestionerAgent discovery preset instead. Will be removed in a future version. */
+export function buildDiscoveryQuestionInput(args) {
+    return {
+        query: args.query,
+        userContext: args.userContext,
+        negotiationDigests: args.negotiationDigests,
+        summary: args.summary,
+        ...(args.chatContext !== undefined ? { chatContext: args.chatContext } : {}),
+        now: args.now,
+    };
+}

package/dist/opportunity/domain/index.d.ts

@@ -0,0 +1,55 @@
+/**
+ * opportunity/domain — pure types, predicates, policy, and domain contracts.
+ *
+ * ## What lives here (flat files)
+ * - Graph state schema and interfaces (opportunity.state.ts)
+ * - Discovery result envelope (opportunity.discovery.contracts.ts)
+ * - UI string constants (opportunity.labels.ts)
+ * - Core domain predicates and feed algorithms (opportunity.utils.ts)
+ * - Actor normalization (opportunity.actor.ts)
+ * - Evidence builders and renderers (opportunity.evidence.ts)
+ * - Claim-safety guard (opportunity.claim-safety.ts)
+ * - Pure presentation transforms (opportunity.presentation.ts)
+ * - Safe-presentation pipeline (opportunity.safe-presentation.ts)
+ * - Cache key builders (opportunity.presentation-cache.ts)
+ * - Discovery-run coalescing (opportunity.discovery-run-coalescing.ts)
+ * - Negotiation-summary mappers (negotiation-summary.builder.ts)
+ * - Discovery question input helper (discovery-question.helper.ts)
+ *
+ * ## What lives in subdirectories (exported by path, not moved)
+ * - discriminator/ — pool discriminator types, env, scorer, adjustments, question, push
+ * - negotiation-evidence/ — evidence types, env, extractor, verifier
+ * - outcome/ — outcome types, env, hypotheses
+ * - feed/ — feed state schema, feed health scorer
+ *
+ * IND-551: canonical domain layer for the opportunities capability.
+ */
+export * from "./opportunity.state.js";
+export * from "./opportunity.discovery.contracts.js";
+export * from "./opportunity.labels.js";
+export * from "./opportunity.utils.js";
+export * from "./opportunity.actor.js";
+export * from "./opportunity.evidence.js";
+export * from "./opportunity.claim-safety.js";
+export * from "./opportunity.presentation.js";
+export * from "./opportunity.safe-presentation.js";
+export * from "./opportunity.presentation-cache.js";
+export * from "./opportunity.discovery-run-coalescing.js";
+export * from "./negotiation-summary.builder.js";
+export * from "./discovery-question.helper.js";
+export type { PoolCandidate, DiscriminatorMiningInput, MinedDiscriminator, ScoredDiscriminator, VerifiedAssignment, DiscriminatorShadowResult, } from "../discriminator/discriminator.types.js";
+export { poolQuestionsMiningMode, poolQuestionsMode, poolQuestionsPushMode, poolQuestionsStampNewborn, POOL_DISCRIMINATOR_MIN_POOL_SIZE, POOL_DISCRIMINATOR_MAX_CANDIDATES, POOL_DISCRIMINATOR_MAX_PUBLIC_CONTEXT_CHARS, POOL_QUESTION_MIN_VOI, POOL_QUESTION_MAX_PENDING_PER_INTENT, poolQuestionsRanking, POOL_RERUN_DEBOUNCE_MS, poolQuestionsVisitTrigger, POOL_VISIT_MINING_DEBOUNCE_MS, } from "../discriminator/discriminator.env.js";
+export { buildPoolAdjustment, planPoolAdjustments, mergePoolAdjustment, readActivePoolAdjustments, adjustedConfidence, } from "../discriminator/discriminator.adjustments.js";
+export type { PoolAdjustment, PoolAdjustmentSignal, } from "../discriminator/discriminator.adjustments.js";
+export { synthesizePoolQuestion, selectQuestionDiscriminators, toQuestionDiscriminator, BOTH_MATTER_LABEL, } from "../discriminator/discriminator.question.js";
+export { poolQuestionCycleKey, buildPoolQuestionPushMessage, } from "../discriminator/discriminator.push.js";
+export { scoreDiscriminator } from "../discriminator/discriminator.scorer.js";
+export type { AllowlistedEvidence, RawEvidenceSegment, RawEvidenceTurn, RawEvidenceOutcome, RawEvidenceOwnerAnswer, NegotiationEvidenceShadowResult, } from "../negotiation-evidence/negotiation-evidence.types.js";
+export { negotiationEvidenceQuestionsMode, NEGOTIATION_EVIDENCE_MAX_OPPORTUNITIES, NEGOTIATION_EVIDENCE_MIN_DISTINCT_OPPORTUNITIES, NEGOTIATION_EVIDENCE_MAX_CONTENT_CHARS, } from "../negotiation-evidence/negotiation-evidence.env.js";
+export { extractAllowlistedEvidence } from "../negotiation-evidence/negotiation-evidence.extractor.js";
+export { verifyHypotheses } from "../negotiation-evidence/negotiation-evidence.verifier.js";
+export type { OutcomeLabel, OutcomeExample, OutcomeSideSupport, OutcomeHypothesis, OutcomeShadowResult, JoinOutcomeHypothesesInput, } from "../outcome/outcome.types.js";
+export { isOutcomeQuestionsActivated, OUTCOME_MIN_INDEPENDENT_EXAMPLES, OUTCOME_MAX_CANDIDATES, OUTCOME_MAX_PUBLIC_CONTEXT_CHARS, } from "../outcome/outcome.env.js";
+export { joinOutcomeHypotheses } from "../outcome/outcome.hypotheses.js";
+export { computeFeedHealth } from "../feed/feed.health.js";
+export type { FeedHealthResult } from "../feed/feed.health.js";

package/dist/opportunity/domain/index.js

@@ -0,0 +1,52 @@
+/**
+ * opportunity/domain — pure types, predicates, policy, and domain contracts.
+ *
+ * ## What lives here (flat files)
+ * - Graph state schema and interfaces (opportunity.state.ts)
+ * - Discovery result envelope (opportunity.discovery.contracts.ts)
+ * - UI string constants (opportunity.labels.ts)
+ * - Core domain predicates and feed algorithms (opportunity.utils.ts)
+ * - Actor normalization (opportunity.actor.ts)
+ * - Evidence builders and renderers (opportunity.evidence.ts)
+ * - Claim-safety guard (opportunity.claim-safety.ts)
+ * - Pure presentation transforms (opportunity.presentation.ts)
+ * - Safe-presentation pipeline (opportunity.safe-presentation.ts)
+ * - Cache key builders (opportunity.presentation-cache.ts)
+ * - Discovery-run coalescing (opportunity.discovery-run-coalescing.ts)
+ * - Negotiation-summary mappers (negotiation-summary.builder.ts)
+ * - Discovery question input helper (discovery-question.helper.ts)
+ *
+ * ## What lives in subdirectories (exported by path, not moved)
+ * - discriminator/ — pool discriminator types, env, scorer, adjustments, question, push
+ * - negotiation-evidence/ — evidence types, env, extractor, verifier
+ * - outcome/ — outcome types, env, hypotheses
+ * - feed/ — feed state schema, feed health scorer
+ *
+ * IND-551: canonical domain layer for the opportunities capability.
+ */
+// ── Flat domain files ─────────────────────────────────────────────────────────
+export * from "./opportunity.state.js";
+export * from "./opportunity.discovery.contracts.js";
+export * from "./opportunity.labels.js";
+export * from "./opportunity.utils.js";
+export * from "./opportunity.actor.js";
+export * from "./opportunity.evidence.js";
+export * from "./opportunity.claim-safety.js";
+export * from "./opportunity.presentation.js";
+export * from "./opportunity.safe-presentation.js";
+export * from "./opportunity.presentation-cache.js";
+export * from "./opportunity.discovery-run-coalescing.js";
+export * from "./negotiation-summary.builder.js";
+export * from "./discovery-question.helper.js";
+export { poolQuestionsMiningMode, poolQuestionsMode, poolQuestionsPushMode, poolQuestionsStampNewborn, POOL_DISCRIMINATOR_MIN_POOL_SIZE, POOL_DISCRIMINATOR_MAX_CANDIDATES, POOL_DISCRIMINATOR_MAX_PUBLIC_CONTEXT_CHARS, POOL_QUESTION_MIN_VOI, POOL_QUESTION_MAX_PENDING_PER_INTENT, poolQuestionsRanking, POOL_RERUN_DEBOUNCE_MS, poolQuestionsVisitTrigger, POOL_VISIT_MINING_DEBOUNCE_MS, } from "../discriminator/discriminator.env.js";
+export { buildPoolAdjustment, planPoolAdjustments, mergePoolAdjustment, readActivePoolAdjustments, adjustedConfidence, } from "../discriminator/discriminator.adjustments.js";
+export { synthesizePoolQuestion, selectQuestionDiscriminators, toQuestionDiscriminator, BOTH_MATTER_LABEL, } from "../discriminator/discriminator.question.js";
+export { poolQuestionCycleKey, buildPoolQuestionPushMessage, } from "../discriminator/discriminator.push.js";
+export { scoreDiscriminator } from "../discriminator/discriminator.scorer.js";
+export { negotiationEvidenceQuestionsMode, NEGOTIATION_EVIDENCE_MAX_OPPORTUNITIES, NEGOTIATION_EVIDENCE_MIN_DISTINCT_OPPORTUNITIES, NEGOTIATION_EVIDENCE_MAX_CONTENT_CHARS, } from "../negotiation-evidence/negotiation-evidence.env.js";
+export { extractAllowlistedEvidence } from "../negotiation-evidence/negotiation-evidence.extractor.js";
+export { verifyHypotheses } from "../negotiation-evidence/negotiation-evidence.verifier.js";
+export { isOutcomeQuestionsActivated, OUTCOME_MIN_INDEPENDENT_EXAMPLES, OUTCOME_MAX_CANDIDATES, OUTCOME_MAX_PUBLIC_CONTEXT_CHARS, } from "../outcome/outcome.env.js";
+export { joinOutcomeHypotheses } from "../outcome/outcome.hypotheses.js";
+// feed domain
+export { computeFeedHealth } from "../feed/feed.health.js";

package/dist/opportunity/domain/negotiation-summary.builder.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Pure mappers from raw per-candidate negotiation data to the protocol's
+ * `DiscoveryNegotiation` / `DiscoverySummary` shapes consumed by the question
+ * generator. No DB access, no LLM — safe to import from anywhere.
+ */
+import type { NegotiationTurn, NegotiationOutcome } from "../../capabilities/negotiation.state.facade.js";
+import type { DiscoveryNegotiation, DiscoverySummary } from "../../shared/schemas/discovery-question.schema.js";
+/**
+ * The input shape collected by the opportunity graph's negotiate node for
+ * each candidate that completed a negotiation attempt (accepted, rejected,
+ * stalled, or errored).
+ */
+export interface NegotiationResolution {
+    candidateUserId: string;
+    /** Abstract profile slice for the LLM (e.g. "AI infra founder, Berlin"). */
+    counterpartyHint: string;
+    /** Network/community prompt for the negotiation. */
+    indexContext: string;
+    turns: NegotiationTurn[];
+    outcome: NegotiationOutcome;
+    /** Optional pre-negotiation evaluator score (0..1). */
+    seedAssessmentScore?: number;
+}
+/**
+ * Convert one negotiation resolution to `DiscoveryNegotiation`.
+ *
+ * @param r - The raw resolution from the negotiate node.
+ * @returns A `DiscoveryNegotiation` ready for the question generator.
+ */
+export declare function toDiscoveryNegotiation(r: NegotiationResolution): DiscoveryNegotiation;
+/**
+ * Aggregate counters across all negotiations in a single discovery turn.
+ *
+ * @param resolutions - All resolved negotiations from the negotiate node.
+ * @returns A `DiscoverySummary` with totals and role distribution.
+ */
+export declare function buildDiscoverySummary(resolutions: NegotiationResolution[]): DiscoverySummary;

package/dist/opportunity/domain/negotiation-summary.builder.js

@@ -0,0 +1,66 @@
+/**
+ * Convert one negotiation resolution to `DiscoveryNegotiation`.
+ *
+ * @param r - The raw resolution from the negotiate node.
+ * @returns A `DiscoveryNegotiation` ready for the question generator.
+ */
+export function toDiscoveryNegotiation(r) {
+    const turns = r.turns.map((t) => ({
+        action: t.action,
+        reasoning: t.assessment.reasoning,
+        suggestedRoles: {
+            ownUser: t.assessment.suggestedRoles.ownUser,
+            otherUser: t.assessment.suggestedRoles.otherUser,
+        },
+    }));
+    const outcome = {
+        hasOpportunity: r.outcome.hasOpportunity,
+        reasoning: r.outcome.reasoning,
+        ...(r.outcome.hasOpportunity && r.outcome.agreedRoles.length > 0
+            ? { agreedRoles: r.outcome.agreedRoles.map((a) => ({ userId: a.userId, role: a.role })) }
+            : {}),
+        ...(r.outcome.reason ? { reason: r.outcome.reason } : {}),
+    };
+    return {
+        counterpartyId: r.candidateUserId,
+        counterpartyHint: r.counterpartyHint,
+        indexContext: r.indexContext,
+        turns,
+        outcome,
+        ...(r.seedAssessmentScore !== undefined ? { seedAssessmentScore: r.seedAssessmentScore } : {}),
+    };
+}
+/**
+ * Aggregate counters across all negotiations in a single discovery turn.
+ *
+ * @param resolutions - All resolved negotiations from the negotiate node.
+ * @returns A `DiscoverySummary` with totals and role distribution.
+ */
+export function buildDiscoverySummary(resolutions) {
+    const roleDistribution = {};
+    let opportunitiesFound = 0;
+    let noOpportunityCount = 0;
+    let timeoutCount = 0;
+    for (const r of resolutions) {
+        if (r.outcome.hasOpportunity) {
+            opportunitiesFound += 1;
+            for (const role of r.outcome.agreedRoles) {
+                const key = role.role;
+                roleDistribution[key] = (roleDistribution[key] ?? 0) + 1;
+            }
+        }
+        else {
+            noOpportunityCount += 1;
+            if (r.outcome.reason === "turn_cap" || r.outcome.reason === "timeout") {
+                timeoutCount += 1;
+            }
+        }
+    }
+    return {
+        totalCandidates: resolutions.length,
+        opportunitiesFound,
+        noOpportunityCount,
+        timeoutCount,
+        roleDistribution,
+    };
+}

package/dist/opportunity/domain/opportunity.actor.d.ts

@@ -0,0 +1,15 @@
+import type { CreateOpportunityData, OpportunityActor } from '../../shared/interfaces/database.interface.js';
+/**
+ * Normalize an actor intent value while preserving protocol string IDs.
+ * Null-like model sentinels are represented by absence in persisted actors.
+ */
+export declare function normalizeOpportunityActorIntent(value: unknown): string | undefined;
+/** Resolve the normalized intent from either evaluator or persisted actor fields. */
+export declare function resolveOpportunityActorIntent(actor: {
+    intentId?: unknown;
+    intent?: unknown;
+}): string | undefined;
+/** Return a non-mutating actor copy with a canonical optional intent. */
+export declare function normalizeOpportunityActors(actors: readonly OpportunityActor[]): OpportunityActor[];
+/** Return non-mutating create data whose actor intents are canonical. */
+export declare function normalizeCreateOpportunityActorIntents(data: CreateOpportunityData): CreateOpportunityData;