@indexnetwork/protocol 4.5.0-rc.322.1 → 4.5.0-rc.324.1

package/dist/opportunity/opportunity.graph.js

@@ -30,6 +30,24 @@ import { renderNetworkContext } from '../shared/network/metadata.renderer.js';
 import { requestContext } from "../shared/observability/request-context.js";
 import { mergeOpportunityEvidence, withCandidateEvidence, withMatchedStrategies } from './opportunity.evidence.js';
 const logger = protocolLogger('OpportunityGraph');
+const prepLog = protocolLogger('OpportunityGraph:Prep');
+const scopeLog = protocolLogger('OpportunityGraph:Scope');
+const resolveLog = protocolLogger('OpportunityGraph:Resolve');
+const discoveryLog = protocolLogger('OpportunityGraph:Discovery');
+const evaluationLog = protocolLogger('OpportunityGraph:Evaluation');
+const negotiateLog = protocolLogger('OpportunityGraph:Negotiate');
+const rankingLog = protocolLogger('OpportunityGraph:Ranking');
+const introValidationLog = protocolLogger('OpportunityGraph:IntroValidation');
+const introEvaluationLog = protocolLogger('OpportunityGraph:IntroEvaluation');
+const persistLog = protocolLogger('OpportunityGraph:Persist');
+const persistPathLog = protocolLogger('OpportunityGraph:Persist:PathSelect');
+const persistDedupLog = protocolLogger('OpportunityGraph:Persist:Dedup');
+const readLog = protocolLogger('OpportunityGraph:Read');
+const updateLog = protocolLogger('OpportunityGraph:Update');
+const deleteLog = protocolLogger('OpportunityGraph:Delete');
+const sendLog = protocolLogger('OpportunityGraph:Send');
+const negotiateExistingLog = protocolLogger('OpportunityGraph:NegotiateExisting');
+const routingLog = protocolLogger('OpportunityGraph:Routing');
 /** Time window for persist-node dedup. Suppresses a second opportunity with the same person while a recent one (within 30 days) is still in flight, so a person is not re-surfaced multiple times within a month (EDG-23). */
 const DEDUP_WINDOW_MS = 30 * 24 * 60 * 60 * 1000;
 /** Default cap for source premises used by premise-to-premise discovery. Prevents BACKEND-5-style fan-out. */
@@ -173,7 +191,7 @@ export class OpportunityGraphFactory {
          * Fetches user's network memberships and validates requirements.
          * Returns empty if user has no network memberships (requirement).
          */
-        const prepNode = withNodeTrace("opportunity-prep", async (state) => timed("OpportunityGraph.prep", async () => withCallLogging(logger, '[Graph:Prep] prepNode', {
+        const prepNode = withNodeTrace("opportunity-prep", async (state) => timed("OpportunityGraph.prep", async () => withCallLogging(prepLog, 'prepNode', {
             userId: state.userId,
             hasSearchQuery: !!state.searchQuery,
             requestedIndexId: state.networkId ?? undefined,
@@ -183,7 +201,7 @@ export class OpportunityGraphFactory {
             const memberships = await this.database.getNetworkMemberships(state.userId);
             const userNetworkIds = memberships.map(m => m.networkId);
             if (userNetworkIds.length === 0) {
-                logger.verbose('[Graph:Prep] User has no network memberships - cannot find opportunities');
+                prepLog.verbose('User has no network memberships - cannot find opportunities');
                 return {
                     userNetworks: [],
                     sourceProfile: null,
@@ -238,7 +256,7 @@ export class OpportunityGraphFactory {
             };
         }, { context: { userId: state.userId }, logOutput: true }).catch((error) => {
             const errMsg = error instanceof Error ? error.message : String(error);
-            logger.error('[Graph:Prep] Failed', { error });
+            prepLog.error('Failed', { error });
             return {
                 error: 'Failed to prepare opportunity search. Please try again.',
                 trace: [{
@@ -263,7 +281,7 @@ export class OpportunityGraphFactory {
          */
         const scopeNode = withNodeTrace("opportunity-scope", async (state) => {
             return timed("OpportunityGraph.scope", async () => {
-                logger.verbose('[Graph:Scope] Determining search scope', {
+                scopeLog.verbose('Determining search scope', {
                     requestedIndexId: state.networkId,
                     userNetworksCount: state.userNetworks.length,
                 });
@@ -274,7 +292,7 @@ export class OpportunityGraphFactory {
                         const isInScope = state.userNetworks.includes(state.networkId);
                         const isOwner = !isInScope && await this.database.isIndexOwner(state.networkId, state.userId);
                         if (!isInScope && !isOwner) {
-                            logger.warn('[Graph:Scope] User not member of requested network', {
+                            scopeLog.warn('User not member of requested network', {
                                 networkId: state.networkId,
                             });
                             return {
@@ -290,7 +308,7 @@ export class OpportunityGraphFactory {
                         // reaches networks outside the agent's bound scope.
                         const allowed = new Set(state.indexScope);
                         targetIndexIds = state.userNetworks.filter((n) => allowed.has(n));
-                        logger.verbose('[Graph:Scope] Applied indexScope intersection', {
+                        scopeLog.verbose('Applied indexScope intersection', {
                             indexScopeCount: state.indexScope.length,
                             userNetworksCount: state.userNetworks.length,
                             targetCount: targetIndexIds.length,
@@ -310,7 +328,7 @@ export class OpportunityGraphFactory {
                             memberCount,
                         };
                     }));
-                    logger.verbose('[Graph:Scope] Scope determined', {
+                    scopeLog.verbose('Scope determined', {
                         targetIndexesCount: targetNetworks.length,
                         indexes: targetNetworks.map(i => i.title),
                     });
@@ -327,7 +345,7 @@ export class OpportunityGraphFactory {
                             }
                         }
                         catch (err) {
-                            logger.warn('[Graph:Scope] Failed to load intent index scores', { triggerIntentId: state.triggerIntentId, error: err });
+                            scopeLog.warn('Failed to load intent index scores', { triggerIntentId: state.triggerIntentId, error: err });
                         }
                     }
                     else if (state.searchQuery?.trim()) {
@@ -382,7 +400,7 @@ export class OpportunityGraphFactory {
                             }
                         }
                         catch (err) {
-                            logger.warn('[Graph:Scope] Failed to score query against indexes', { error: err });
+                            scopeLog.warn('Failed to score query against indexes', { error: err });
                         }
                     }
                     const totalMembers = targetNetworks.reduce((sum, i) => sum + i.memberCount, 0);
@@ -398,7 +416,7 @@ export class OpportunityGraphFactory {
                 }
                 catch (error) {
                     const errMsg = error instanceof Error ? error.message : String(error);
-                    logger.error('[Graph:Scope] Failed', { error });
+                    scopeLog.error('Failed', { error });
                     return {
                         targetNetworks: [],
                         error: 'Failed to determine search scope.',
@@ -424,7 +442,7 @@ export class OpportunityGraphFactory {
          */
         const resolveNode = withNodeTrace("opportunity-resolve", async (state) => {
             return timed("OpportunityGraph.resolve", async () => {
-                logger.verbose('[Graph:Resolve] Resolving intent and network membership', {
+                resolveLog.verbose('Resolving intent and network membership', {
                     triggerIntentId: state.triggerIntentId,
                     hasSearchQuery: !!state.searchQuery,
                     indexedIntentsCount: state.indexedIntents.length,
@@ -458,7 +476,7 @@ export class OpportunityGraphFactory {
                                 discoverySource,
                             };
                         }
-                        logger.warn('[Graph:Resolve] No intent matched search query; leaving resolvedIntentId unset', {
+                        resolveLog.warn('No intent matched search query; leaving resolvedIntentId unset', {
                             searchQuery: state.searchQuery,
                             indexedIntentsCount: state.indexedIntents.length,
                         });
@@ -471,7 +489,7 @@ export class OpportunityGraphFactory {
                 }
                 catch (err) {
                     const errMsg = err instanceof Error ? err.message : String(err);
-                    logger.error('[Graph:Resolve] Failed', {
+                    resolveLog.error('Failed', {
                         triggerIntentId: state.triggerIntentId,
                         searchQuery: state.searchQuery,
                         error: err,
@@ -509,7 +527,7 @@ export class OpportunityGraphFactory {
                     if (!state.targetUserId)
                         return candidates;
                     const filtered = candidates.filter(c => c.candidateUserId === state.targetUserId);
-                    logger.verbose('[Graph:Discovery] targetUserId filter applied', {
+                    discoveryLog.verbose('targetUserId filter applied', {
                         targetUserId: state.targetUserId,
                         before: candidates.length,
                         after: filtered.length,
@@ -520,14 +538,14 @@ export class OpportunityGraphFactory {
                 let discoveryLensInput;
                 // Shared variable to capture HyDE output (lenses + documents) for trace entries
                 let discoveryHydeOutput;
-                logger.verbose('[Graph:Discovery] Starting semantic search', {
+                discoveryLog.verbose('Starting semantic search', {
                     targetIndexesCount: state.targetNetworks.length,
                     discoverySource: state.discoverySource,
                     searchQueryPreview: state.searchQuery?.trim().slice(0, 60) ?? '(none)',
                 });
                 try {
                     if (state.targetNetworks.length === 0) {
-                        logger.warn('[Graph:Discovery] No target indexes for search');
+                        discoveryLog.warn('No target indexes for search');
                         return { candidates: [] };
                     }
                     // ── Direct-connection fast path ──
@@ -535,7 +553,7 @@ export class OpportunityGraphFactory {
                     // and construct candidates directly from shared networks.
                     if (state.targetUserId) {
                         if (state.targetUserId === discoveryUserId) {
-                            logger.warn('[Graph:Discovery] Direct-connection target matches discoverer; skipping self-match', {
+                            discoveryLog.warn('Direct-connection target matches discoverer; skipping self-match', {
                                 targetUserId: state.targetUserId,
                             });
                             return {
@@ -547,7 +565,7 @@ export class OpportunityGraphFactory {
                                     }],
                             };
                         }
-                        logger.verbose('[Graph:Discovery] Direct-connection mode — bypassing vector search', {
+                        discoveryLog.verbose('Direct-connection mode — bypassing vector search', {
                             targetUserId: state.targetUserId,
                         });
                         const targetMemberships = await this.database.getNetworkMemberships(state.targetUserId);
@@ -556,7 +574,7 @@ export class OpportunityGraphFactory {
                             .filter(ti => targetUserIndexIds.includes(ti.networkId))
                             .map(ti => ti.networkId);
                         if (sharedIndexIds.length === 0) {
-                            logger.warn('[Graph:Discovery] Target user shares no indexes with discoverer', {
+                            discoveryLog.warn('Target user shares no indexes with discoverer', {
                                 targetUserId: state.targetUserId,
                                 discovererIndexes: state.targetNetworks.map(ti => ti.networkId),
                             });
@@ -603,7 +621,7 @@ export class OpportunityGraphFactory {
                                 discoverySource: 'query',
                             }));
                         }
-                        logger.verbose('[Graph:Discovery] Direct candidates constructed', {
+                        discoveryLog.verbose('Direct candidates constructed', {
                             count: directCandidates.length,
                             sharedIndexes: sharedIndexIds.length,
                             targetIntents: targetIntents.length,
@@ -631,11 +649,11 @@ export class OpportunityGraphFactory {
                     if (state.discoverySource === 'context') {
                         // Context discovery: HyDE (when search query exists) + premise-to-premise.
                         if (state.searchQuery?.trim()) {
-                            logger.verbose('[Graph:Discovery] Context source with searchQuery → running query HyDE + premise paths', {
+                            discoveryLog.verbose('Context source with searchQuery → running query HyDE + premise paths', {
                                 searchQuery: state.searchQuery.trim().substring(0, 80),
                             });
                             const queryCandidates = await runQueryHydeDiscovery();
-                            logger.verbose('[Graph:Discovery] Query HyDE path complete', { candidatesFound: queryCandidates.length });
+                            discoveryLog.verbose('Query HyDE path complete', { candidatesFound: queryCandidates.length });
                             // Build trace entries for this path
                             const traceEntries = [];
                             // Lens input trace (captured from runQueryHydeDiscovery)
@@ -727,7 +745,7 @@ export class OpportunityGraphFactory {
                         const searchText = state.searchQuery?.trim() ?? '';
                         if (!searchText)
                             return [];
-                        logger.verbose('[Graph:Discovery] runQueryHydeDiscovery start', { searchText: searchText.slice(0, 80) });
+                        discoveryLog.verbose('runQueryHydeDiscovery start', { searchText: searchText.slice(0, 80) });
                         const discovererContext = buildDiscovererContext(state.sourceProfile, state.indexedIntents);
                         discoveryLensInput = {
                             profileContext: discovererContext,
@@ -746,7 +764,7 @@ export class OpportunityGraphFactory {
                             hydeDocuments: (hydeResult.hydeDocuments ?? {}),
                         };
                         const embeddingKeys = hydeEmbeddings ? Object.keys(hydeEmbeddings) : [];
-                        logger.verbose('[Graph:Discovery] HyDE generator result', {
+                        discoveryLog.verbose('HyDE generator result', {
                             lensCount: embeddingKeys.length,
                             lenses: embeddingKeys,
                         });
@@ -796,7 +814,7 @@ export class OpportunityGraphFactory {
                         }));
                         const intentCount = all.filter((c) => c.candidateIntentId).length;
                         const premiseCount = all.filter((c) => c.candidatePremiseId).length;
-                        logger.verbose('[Graph:Discovery] searchWithHydeEmbeddings raw results', {
+                        discoveryLog.verbose('searchWithHydeEmbeddings raw results', {
                             total: all.length,
                             fromIntent: intentCount,
                             fromPremise: premiseCount,
@@ -824,7 +842,7 @@ export class OpportunityGraphFactory {
                             return [];
                         const sourceLimit = getSourcePremiseDiscoveryLimit();
                         if (sourceLimit === 0) {
-                            logger.verbose('[Graph:Discovery] runPremiseDiscovery disabled by DISCOVERY_SOURCE_PREMISE_LIMIT=0');
+                            discoveryLog.verbose('runPremiseDiscovery disabled by DISCOVERY_SOURCE_PREMISE_LIMIT=0');
                             return [];
                         }
                         const sourcePremisesFromDb = self.database.getPremisesForUserInNetworks
@@ -838,7 +856,7 @@ export class OpportunityGraphFactory {
                             : (state.sourcePremises ?? []).slice(0, sourceLimit));
                         if (sourcePremises.length === 0)
                             return [];
-                        logger.verbose('[Graph:Discovery] runPremiseDiscovery start', {
+                        discoveryLog.verbose('runPremiseDiscovery start', {
                             premiseCount: sourcePremises.length,
                             sourceLimit,
                             targetNetworks: targetNetworkIds.length,
@@ -882,7 +900,7 @@ export class OpportunityGraphFactory {
                             }
                         }
                         const deduped = Array.from(byKey.values());
-                        logger.verbose('[Graph:Discovery] runPremiseDiscovery complete', {
+                        discoveryLog.verbose('runPremiseDiscovery complete', {
                             sourcePremiseCount: sourcePremises.length,
                             rawCount: premiseCandidates.length,
                             dedupedCount: deduped.length,
@@ -904,7 +922,7 @@ export class OpportunityGraphFactory {
                         const targetNetworkIds = state.targetNetworks.map(t => t.networkId);
                         if (targetNetworkIds.length === 0)
                             return [];
-                        logger.verbose('[Graph:Discovery] runContextToIntentDiscovery start', {
+                        discoveryLog.verbose('runContextToIntentDiscovery start', {
                             contextCount: state.sourceContexts.length,
                             targetNetworks: targetNetworkIds.length,
                         });
@@ -974,7 +992,7 @@ export class OpportunityGraphFactory {
                             }
                         }
                         const deduped = Array.from(byKey.values());
-                        logger.verbose('[Graph:Discovery] runContextToIntentDiscovery complete', {
+                        discoveryLog.verbose('runContextToIntentDiscovery complete', {
                             rawCount: contextCandidates.length,
                             dedupedCount: deduped.length,
                         });
@@ -1024,7 +1042,7 @@ export class OpportunityGraphFactory {
                         : state.indexedIntents[0];
                     const searchText = state.searchQuery ?? resolvedIntent?.payload ?? '';
                     if (!searchText) {
-                        logger.warn('[Graph:Discovery] No search text available for intent path');
+                        discoveryLog.warn('No search text available for intent path');
                         const [premiseCands, contextCands] = await Promise.all([
                             runPremiseDiscovery(),
                             runContextToIntentDiscovery(),
@@ -1117,7 +1135,7 @@ export class OpportunityGraphFactory {
                         }
                     }
                     const candidates = Array.from(byUserAndIndex.values());
-                    logger.verbose('[Graph:Discovery] Intent-path discovery complete', { candidatesFound: candidates.length });
+                    discoveryLog.verbose('Intent-path discovery complete', { candidatesFound: candidates.length });
                     const usedLenses = Object.keys(hydeEmbeddings);
                     // Build trace with individual candidate similarity scores
                     const traceEntries = [];
@@ -1210,7 +1228,7 @@ export class OpportunityGraphFactory {
                 }
                 catch (error) {
                     const errMsg = error instanceof Error ? error.message : String(error);
-                    logger.error('[Graph:Discovery] Failed', { error });
+                    discoveryLog.error('Failed', { error });
                     return {
                         candidates: [],
                         error: 'Failed to search for candidates.',
@@ -1236,11 +1254,11 @@ export class OpportunityGraphFactory {
         const evaluationNode = async (state) => {
             return timed("OpportunityGraph.evaluation", async () => {
                 const startTime = Date.now();
-                logger.verbose('[Graph:Evaluation] Starting evaluation', {
+                evaluationLog.verbose('Starting evaluation', {
                     candidatesCount: state.candidates.length,
                 });
                 if (state.candidates.length === 0) {
-                    logger.verbose('[Graph:Evaluation] No candidates to evaluate');
+                    evaluationLog.verbose('No candidates to evaluate');
                     return { evaluatedOpportunities: [], agentTimings: [] };
                 }
                 // Batch candidates to avoid timeout - evaluate top 25 per batch, store remaining
@@ -1270,7 +1288,7 @@ export class OpportunityGraphFactory {
                 // Re-sort by similarity descending (Map iteration order doesn't guarantee sort)
                 dedupedCandidates.sort((a, b) => b.similarity - a.similarity);
                 if (dedupedCandidates.length < sortedCandidates.length) {
-                    logger.info("[Graph:Evaluation] Deduped candidates by userId", {
+                    evaluationLog.info("Deduped candidates by userId", {
                         before: sortedCandidates.length,
                         after: dedupedCandidates.length,
                         removed: sortedCandidates.length - dedupedCandidates.length,
@@ -1284,12 +1302,12 @@ export class OpportunityGraphFactory {
                 const queryRemaining = remaining.filter((c) => c.discoverySource === 'query' || c.discoverySource == null);
                 const effectiveRemaining = isQueryDriven && queryRemaining.length === 0 ? [] : remaining;
                 if (isQueryDriven && remaining.length > 0 && queryRemaining.length === 0) {
-                    logger.info("[Graph:Evaluation] Early termination: no query-sourced candidates remain", {
+                    evaluationLog.info("Early termination: no query-sourced candidates remain", {
                         droppedCandidates: remaining.length,
                     });
                 }
                 if (effectiveRemaining.length > 0) {
-                    logger.verbose('[Graph:Evaluation] Batched candidates for evaluation', {
+                    evaluationLog.verbose('Batched candidates for evaluation', {
                         evaluating: batchToEvaluate.length,
                         remaining: effectiveRemaining.length,
                         total: sortedCandidates.length,
@@ -1384,7 +1402,7 @@ export class OpportunityGraphFactory {
                     let pairwiseOpportunities;
                     if (runParallel) {
                         // Experimental: one LLM call per candidate, all fired in parallel
-                        logger.verbose('[Graph:Evaluation] Running parallel evaluation', { candidates: candidateEntities.length });
+                        evaluationLog.verbose('Running parallel evaluation', { candidates: candidateEntities.length });
                         const parallelResults = await Promise.all(candidateEntities.map((candidateEntity) => {
                             const input = {
                                 discovererId: discoveryUserId,
@@ -1411,7 +1429,7 @@ export class OpportunityGraphFactory {
                                 const _errMsg = err instanceof Error ? err.message : String(err);
                                 agentTimingsAccum.push({ name: 'opportunity.evaluator', durationMs: _evalDuration });
                                 _traceEmitter?.({ type: "agent_end", name: "opportunity-evaluator", durationMs: _evalDuration, summary: `${_candidateName}: error — ${_errMsg}` });
-                                logger.warn('[Graph:Evaluation] Parallel eval failed for candidate', {
+                                evaluationLog.warn('Parallel eval failed for candidate', {
                                     candidateUserId: candidateEntity.userId,
                                     error: err,
                                 });
@@ -1484,7 +1502,7 @@ export class OpportunityGraphFactory {
                                 pairwiseOpportunities.push(op);
                             }
                             else {
-                                logger.warn('[Graph:Evaluation] Splitting multi-actor opportunity; LLM returned bundled actors instead of one-per-candidate', {
+                                evaluationLog.warn('Splitting multi-actor opportunity; LLM returned bundled actors instead of one-per-candidate', {
                                     actorCount: nonViewerActors.length,
                                     userIds: nonViewerActors.map(a => a.userId),
                                 });
@@ -1555,7 +1573,7 @@ export class OpportunityGraphFactory {
                         }),
                     }));
                     const passed = evaluatedOpportunities.filter((o) => o.score >= minScore);
-                    logger.verbose('[Graph:Evaluation] Evaluation complete', {
+                    evaluationLog.verbose('Evaluation complete', {
                         evaluatedCount: evaluatedOpportunities.length,
                         passed: passed.length,
                     });
@@ -1644,7 +1662,7 @@ export class OpportunityGraphFactory {
                 }
                 catch (error) {
                     const errMsg = error instanceof Error ? error.message : String(error);
-                    logger.error('[Graph:Evaluation] Failed', { error });
+                    evaluationLog.error('Failed', { error });
                     return {
                         evaluatedOpportunities: [],
                         error: 'Failed to evaluate candidates.',
@@ -1700,7 +1718,7 @@ export class OpportunityGraphFactory {
                 };
                 // Build candidates from persisted opportunities. Each opportunity carries its DB id
                 // so the negotiation graph's finalize node can update its status from the outcome.
-                logger.verbose('[Graph:Negotiate] Building candidates from opportunities', {
+                negotiateLog.verbose('Building candidates from opportunities', {
                     opportunityCount: state.opportunities.length,
                     discoveryUserId,
                 });
@@ -1710,7 +1728,7 @@ export class OpportunityGraphFactory {
                     const introducerActors = opp.actors
                         .filter(a => a.role === 'introducer');
                     if (introducerActors.length > 0 && !introducerActors.every(a => a.approved === true)) {
-                        logger.verbose('[Graph:Negotiate] Skipping opportunity: introducer not approved', {
+                        negotiateLog.verbose('Skipping opportunity: introducer not approved', {
                             opportunityId: opp.id,
                             introducerCount: introducerActors.length,
                             approvedCount: introducerActors.filter(a => a.approved === true).length,
@@ -1720,7 +1738,7 @@ export class OpportunityGraphFactory {
                     const candidateActor = opp.actors
                         .find(a => a.userId !== discoveryUserId);
                     if (!candidateActor) {
-                        logger.verbose('[Graph:Negotiate] Skipping opportunity: no candidateActor found', {
+                        negotiateLog.verbose('Skipping opportunity: no candidateActor found', {
                             opportunityId: opp.id,
                             discoveryUserId,
                             actors: opp.actors?.map(a => ({ userId: a.userId, role: a.role })) ?? [],
@@ -1730,7 +1748,7 @@ export class OpportunityGraphFactory {
                     return { opp, candidateActor };
                 })
                     .filter((e) => e !== null);
-                logger.verbose('[Graph:Negotiate] Candidate filtering complete', {
+                negotiateLog.verbose('Candidate filtering complete', {
                     inputOpportunities: state.opportunities.length,
                     outputCandidates: candidateEntries.length,
                 });
@@ -1879,7 +1897,7 @@ export class OpportunityGraphFactory {
                     const updated = await this.database
                         .updateOpportunityStatus(candidate.opportunityId, 'draft')
                         .catch((err) => {
-                        logger.warn('[Graph:Negotiate] failed to flip opp to draft; suppressing draft-ready event', {
+                        negotiateLog.warn('failed to flip opp to draft; suppressing draft-ready event', {
                             opportunityId: candidate.opportunityId,
                             error: err,
                         });
@@ -1941,9 +1959,9 @@ export class OpportunityGraphFactory {
                     if (raced === NEGOTIATE_TIMER_SENTINEL) {
                         // Floating promise is intentional — see comment above.
                         void negotiationWork.catch((err) => {
-                            logger.warn('[Graph:Negotiate] background negotiation failed after timer fired', { error: err });
+                            negotiateLog.warn('background negotiation failed after timer fired', { error: err });
                         });
-                        logger.warn('[Graph:Negotiate] timed out — returning partial results to caller', {
+                        negotiateLog.warn('timed out — returning partial results to caller', {
                             discoveryUserId,
                             candidateCount: candidates.length,
                             negotiateTimeoutMs: budgetMs,
@@ -2023,7 +2041,7 @@ export class OpportunityGraphFactory {
                 };
             }
             catch (err) {
-                logger.error("[Graph:Negotiate] Negotiation stage failed", { error: err });
+                negotiateLog.error("Negotiation stage failed", { error: err });
                 traceEmitter?.({ type: "graph_end", name: "Negotiation graph", durationMs: Date.now() - graphStart });
                 return {
                     trace: [{
@@ -2042,7 +2060,7 @@ export class OpportunityGraphFactory {
          */
         const rankingNode = withNodeTrace("opportunity-ranking", async (state) => {
             return timed("OpportunityGraph.ranking", async () => {
-                logger.verbose('[Graph:Ranking] Starting ranking', {
+                rankingLog.verbose('Starting ranking', {
                     evaluatedCount: state.evaluatedOpportunities.length,
                 });
                 try {
@@ -2061,7 +2079,7 @@ export class OpportunityGraphFactory {
                         seen.add(key);
                         return true;
                     });
-                    logger.verbose('[Graph:Ranking] Ranking complete', {
+                    rankingLog.verbose('Ranking complete', {
                         sorted: sorted.length,
                         afterLimit: ranked.length,
                         afterDedup: deduplicated.length,
@@ -2070,7 +2088,7 @@ export class OpportunityGraphFactory {
                 }
                 catch (error) {
                     const errMsg = error instanceof Error ? error.message : String(error);
-                    logger.error('[Graph:Ranking] Failed', { error });
+                    rankingLog.error('Failed', { error });
                     return {
                         evaluatedOpportunities: [],
                         error: 'Failed to rank opportunities.',
@@ -2095,7 +2113,7 @@ export class OpportunityGraphFactory {
          */
         const introValidationNode = async (state) => {
             return timed("OpportunityGraph.introValidation", async () => {
-                logger.verbose('[Graph:IntroValidation] Starting', {
+                introValidationLog.verbose('Starting', {
                     userId: state.userId,
                     networkId: state.networkId,
                     entitiesCount: state.introductionEntities?.length ?? 0,
@@ -2140,12 +2158,12 @@ export class OpportunityGraphFactory {
                     if (exists) {
                         return { error: 'An opportunity already exists between these people.' };
                     }
-                    logger.verbose('[Graph:IntroValidation] Validation passed');
+                    introValidationLog.verbose('Validation passed');
                     return {};
                 }
                 catch (err) {
                     const errMsg = err instanceof Error ? err.message : String(err);
-                    logger.error('[Graph:IntroValidation] Failed', {
+                    introValidationLog.error('Failed', {
                         userId: state.userId,
                         networkId: state.networkId,
                         error: err,
@@ -2182,7 +2200,7 @@ export class OpportunityGraphFactory {
          */
         const introEvaluationNode = async (state) => {
             return timed("OpportunityGraph.introEvaluation", async () => {
-                logger.verbose('[Graph:IntroEvaluation] Starting', { userId: state.userId });
+                introEvaluationLog.verbose('Starting', { userId: state.userId });
                 if (state.error) {
                     return { evaluatedOpportunities: [], agentTimings: [] };
                 }
@@ -2244,7 +2262,7 @@ export class OpportunityGraphFactory {
                         _traceEmitterIntro?.({ type: "agent_end", name: "intro-evaluator", durationMs: _introErrDuration, summary: `error — ${errMsg}` });
                         agentTimingsAccum.push({ name: 'opportunity.evaluator', durationMs: _introErrDuration });
                     }
-                    logger.warn('[Graph:IntroEvaluation] Evaluator or getUser failed, using fallback', { error: evalErr });
+                    introEvaluationLog.warn('Evaluator or getUser failed, using fallback', { error: evalErr });
                     const fallback = buildIntroFallback(entities, state, primaryNetworkId, introducerName);
                     reasoning = fallback.reasoning;
                     score = fallback.score;
@@ -2282,13 +2300,13 @@ export class OpportunityGraphFactory {
             return timed("OpportunityGraph.persist", async () => {
                 const startTime = Date.now();
                 const initialStatus = resolveInitialStatus(state.trigger, state.options.initialStatus);
-                logger.verbose('[Graph:Persist] Starting persistence (dedup-v2)', {
+                persistLog.verbose('Starting persistence (dedup-v2)', {
                     opportunitiesToCreate: state.evaluatedOpportunities.length,
                     trigger: state.trigger,
                     initialStatus,
                 });
                 if (state.evaluatedOpportunities.length === 0) {
-                    logger.verbose('[Graph:Persist] No opportunities to persist');
+                    persistLog.verbose('No opportunities to persist');
                     return { opportunities: [] };
                 }
                 try {
@@ -2328,7 +2346,7 @@ export class OpportunityGraphFactory {
                             const accepted = await this.database
                                 .findOpportunitiesByActors([dedupUserId, counterpartyUserId], { includeIntroducers: true, statuses: ['accepted'] })
                                 .catch((err) => {
-                                logger.warn('[Graph:Persist] findOpportunitiesByActors (sibling-accept) failed', {
+                                persistLog.warn('findOpportunitiesByActors (sibling-accept) failed', {
                                     userId: dedupUserId,
                                     counterpartyUserId,
                                     error: err,
@@ -2343,7 +2361,7 @@ export class OpportunityGraphFactory {
                         const indexIdForActors = state.networkId ?? evaluated.actors[0]?.networkId;
                         let actors;
                         let data;
-                        logger.verbose('[Graph:Persist:PathSelect]', {
+                        persistPathLog.verbose('Selecting persistence path', {
                             isIntroduction: !!state.introductionContext,
                             stateUserId: state.userId,
                             stateIndexId: state.networkId,
@@ -2351,7 +2369,7 @@ export class OpportunityGraphFactory {
                         });
                         if (state.introductionContext) {
                             if (indexIdForActors === undefined) {
-                                logger.warn('[Graph:Persist] Introduction path missing networkId; skipping opportunity', {
+                                persistLog.warn('Introduction path missing networkId; skipping opportunity', {
                                     userId: state.userId,
                                     actorsCount: evaluated.actors.length,
                                 });
@@ -2401,7 +2419,7 @@ export class OpportunityGraphFactory {
                         }
                         else if (state.onBehalfOfUserId) {
                             if (indexIdForActors === undefined) {
-                                logger.warn('[Graph:Persist] Introducer discovery path missing networkId; skipping opportunity', {
+                                persistLog.warn('Introducer discovery path missing networkId; skipping opportunity', {
                                     userId: state.userId,
                                     actorsCount: evaluated.actors.length,
                                 });
@@ -2440,7 +2458,7 @@ export class OpportunityGraphFactory {
                                         // initialStatus, because introductions are always chat-initiated, not background-discovered.
                                         const reactivated = await this.database.updateOpportunityStatus(existing.id, 'draft');
                                         if (reactivated) {
-                                            logger.verbose('[Graph:Persist] Reactivated opportunity (introduction path)', {
+                                            persistLog.verbose('Reactivated opportunity (introduction path)', {
                                                 opportunityId: existing.id,
                                                 candidateUserId,
                                                 previousStatus: existing.status,
@@ -2463,7 +2481,7 @@ export class OpportunityGraphFactory {
                                                 existingOpportunityId: existing.id,
                                                 existingStatus: existing.status,
                                             });
-                                            logger.verbose('[Graph:Persist] Skipping negotiating opportunity with active task (introduction path)', {
+                                            persistLog.verbose('Skipping negotiating opportunity with active task (introduction path)', {
                                                 opportunityId: existing.id,
                                                 candidateUserId,
                                                 taskState: priorTask.state,
@@ -2473,7 +2491,7 @@ export class OpportunityGraphFactory {
                                     }
                                     const reactivated = await this.database.updateOpportunityStatus(existing.id, 'draft');
                                     if (reactivated) {
-                                        logger.info('[Graph:Persist] Resuming orphaned negotiating opportunity (introduction path)', {
+                                        persistLog.info('Resuming orphaned negotiating opportunity (introduction path)', {
                                             opportunityId: existing.id,
                                             candidateUserId,
                                             priorTaskState: priorTask?.state,
@@ -2486,7 +2504,7 @@ export class OpportunityGraphFactory {
                                     // Upgrade latent to draft for introduction path
                                     const upgraded = await this.database.updateOpportunityStatus(existing.id, 'draft');
                                     if (upgraded) {
-                                        logger.verbose('[Graph:Persist] Upgraded latent opportunity to draft (introduction path)', {
+                                        persistLog.verbose('Upgraded latent opportunity to draft (introduction path)', {
                                             opportunityId: existing.id,
                                             candidateUserId,
                                         });
@@ -2502,7 +2520,7 @@ export class OpportunityGraphFactory {
                                         existingOpportunityId: existing.id,
                                         existingStatus: existing.status,
                                     });
-                                    logger.verbose('[Graph:Persist] Skipping recent duplicate (introduction path)', {
+                                    persistLog.verbose('Skipping recent duplicate (introduction path)', {
                                         candidateUserId,
                                         existingStatus: existing.status,
                                         existingOpportunityId: existing.id,
@@ -2510,7 +2528,7 @@ export class OpportunityGraphFactory {
                                     continue;
                                 }
                                 // Else: existing opportunity is old enough, allow new opportunity creation
-                                logger.verbose('[Graph:Persist] Allowing new opportunity; existing is outside dedup window (introduction path)', {
+                                persistLog.verbose('Allowing new opportunity; existing is outside dedup window (introduction path)', {
                                     candidateUserId,
                                     existingStatus: existing.status,
                                     existingOpportunityId: existing.id,
@@ -2572,7 +2590,7 @@ export class OpportunityGraphFactory {
                                     if (counterpartIdx >= 0) {
                                         actors[counterpartIdx] = { ...actors[counterpartIdx], role: 'agent' };
                                     }
-                                    logger.verbose('[Graph:Persist] Swapped discoverer from agent to patient for lifecycle visibility', {
+                                    persistLog.verbose('Swapped discoverer from agent to patient for lifecycle visibility', {
                                         discovererId: state.userId,
                                     });
                                 }
@@ -2580,7 +2598,7 @@ export class OpportunityGraphFactory {
                             // Index-agnostic dedup: find ANY existing opportunity between these users,
                             // regardless of which index it was created in or whether a focused network scope is set.
                             const candidateUserId = evaluated.actors.find((a) => a.userId !== state.userId)?.userId;
-                            logger.verbose('[Graph:Persist:Dedup] Checking overlapping opportunities', {
+                            persistDedupLog.verbose('Checking overlapping opportunities', {
                                 stateUserId: state.userId,
                                 candidateUserId: candidateUserId ?? 'NONE',
                                 evaluatedActors: evaluated.actors.map(a => ({ userId: a.userId, role: a.role })),
@@ -2588,7 +2606,7 @@ export class OpportunityGraphFactory {
                             const overlapping = candidateUserId
                                 ? await this.database.findOpportunitiesByActors([state.userId, candidateUserId], { excludeStatuses: DEDUP_SKIP_STATUSES })
                                 : [];
-                            logger.verbose('[Graph:Persist:Dedup] findOpportunitiesByActors result', {
+                            persistDedupLog.verbose('findOpportunitiesByActors result', {
                                 count: overlapping.length,
                                 results: overlapping.map(o => ({ id: o.id, status: o.status, actors: o.actors?.map((a) => ({ userId: a.userId, role: a.role })) })),
                             });
@@ -2602,7 +2620,7 @@ export class OpportunityGraphFactory {
                                     // is still in-flight for this pair, so we resume it rather than create a parallel one.
                                     const reactivated = await this.database.updateOpportunityStatus(existing.id, initialStatus);
                                     if (reactivated) {
-                                        logger.verbose('[Graph:Persist] Reactivated opportunity', {
+                                        persistLog.verbose('Reactivated opportunity', {
                                             opportunityId: existing.id,
                                             candidateUserId,
                                             previousStatus: existing.status,
@@ -2627,7 +2645,7 @@ export class OpportunityGraphFactory {
                                                 existingOpportunityId: existing.id,
                                                 existingStatus: existing.status,
                                             });
-                                            logger.verbose('[Graph:Persist] Skipping negotiating opportunity with active task', {
+                                            persistLog.verbose('Skipping negotiating opportunity with active task', {
                                                 opportunityId: existing.id,
                                                 candidateUserId,
                                                 taskState: priorTask.state,
@@ -2638,7 +2656,7 @@ export class OpportunityGraphFactory {
                                     // Task is stale or missing — reactivate the orphaned negotiating opportunity
                                     const reactivated = await this.database.updateOpportunityStatus(existing.id, initialStatus);
                                     if (reactivated) {
-                                        logger.info('[Graph:Persist] Resuming orphaned negotiating opportunity', {
+                                        persistLog.info('Resuming orphaned negotiating opportunity', {
                                             opportunityId: existing.id,
                                             candidateUserId,
                                             priorTaskState: priorTask?.state,
@@ -2651,7 +2669,7 @@ export class OpportunityGraphFactory {
                                     // Upgrade latent (background-discovered) to the higher-priority status (e.g. pending)
                                     const upgraded = await this.database.updateOpportunityStatus(existing.id, initialStatus);
                                     if (upgraded) {
-                                        logger.verbose('[Graph:Persist] Upgraded latent opportunity to higher-priority status', {
+                                        persistLog.verbose('Upgraded latent opportunity to higher-priority status', {
                                             opportunityId: existing.id,
                                             candidateUserId,
                                             previousStatus: 'latent',
@@ -2670,7 +2688,7 @@ export class OpportunityGraphFactory {
                                         existingOpportunityId: existing.id,
                                         existingStatus: existing.status,
                                     });
-                                    logger.verbose('[Graph:Persist] Skipping recent duplicate; opportunity created within dedup window', {
+                                    persistLog.verbose('Skipping recent duplicate; opportunity created within dedup window', {
                                         candidateUserId,
                                         existingStatus: existing.status,
                                         existingOpportunityId: existing.id,
@@ -2679,7 +2697,7 @@ export class OpportunityGraphFactory {
                                     continue;
                                 }
                                 // Else: existing opportunity is old enough (outside the 30-day dedup window), allow new opportunity creation
-                                logger.verbose('[Graph:Persist] Allowing new opportunity; existing is outside dedup window', {
+                                persistLog.verbose('Allowing new opportunity; existing is outside dedup window', {
                                     candidateUserId,
                                     existingStatus: existing.status,
                                     existingOpportunityId: existing.id,
@@ -2723,7 +2741,7 @@ export class OpportunityGraphFactory {
                             validateOpportunityActors(data.actors);
                         }
                         catch (err) {
-                            logger.warn('[Graph:Persist] Skipping opportunity with invalid actors', {
+                            persistLog.warn('Skipping opportunity with invalid actors', {
                                 error: err instanceof Error ? err.message : String(err),
                                 opportunityReasoning: evaluated.reasoning?.slice(0, 80),
                             });
@@ -2737,7 +2755,7 @@ export class OpportunityGraphFactory {
                         items: itemsToPersist,
                     });
                     const allOpportunities = [...reactivatedOpportunities, ...createdList];
-                    logger.verbose('[Graph:Persist] Persistence complete', {
+                    persistLog.verbose('Persistence complete', {
                         created: createdList.length,
                         reactivated: reactivatedOpportunities.length,
                         existingBetweenActorsCount: existingBetweenActors.length,
@@ -2763,7 +2781,7 @@ export class OpportunityGraphFactory {
                 }
                 catch (error) {
                     const errMsg = error instanceof Error ? error.message : String(error);
-                    logger.error('[Graph:Persist] Failed', { error });
+                    persistLog.error('Failed', { error });
                     return {
                         opportunities: [],
                         existingBetweenActors: [],
@@ -2792,7 +2810,7 @@ export class OpportunityGraphFactory {
          */
         const readNode = async (state) => {
             return timed("OpportunityGraph.read", async () => {
-                logger.verbose('[Graph:Read] Listing opportunities', {
+                readLog.verbose('Listing opportunities', {
                     userId: state.userId,
                     networkId: state.networkId,
                 });
@@ -2900,7 +2918,7 @@ export class OpportunityGraphFactory {
                     };
                 }
                 catch (err) {
-                    logger.error('[Graph:Read] Failed', { error: err });
+                    readLog.error('Failed', { error: err });
                     return {
                         readResult: { count: 0, opportunities: [], message: 'Failed to list opportunities.' },
                     };
@@ -2916,7 +2934,7 @@ export class OpportunityGraphFactory {
          */
         const updateNode = async (state) => {
             return timed("OpportunityGraph.update", async () => {
-                logger.verbose('[Graph:Update] Updating opportunity status', {
+                updateLog.verbose('Updating opportunity status', {
                     userId: state.userId,
                     opportunityId: state.opportunityId,
                     newStatus: state.newStatus,
@@ -2972,7 +2990,7 @@ export class OpportunityGraphFactory {
                     };
                 }
                 catch (err) {
-                    logger.error('[Graph:Update] Failed', { error: err });
+                    updateLog.error('Failed', { error: err });
                     return { mutationResult: { success: false, error: 'Failed to update opportunity.' } };
                 }
             });
@@ -2982,7 +3000,7 @@ export class OpportunityGraphFactory {
          */
         const deleteNode = async (state) => {
             return timed("OpportunityGraph.delete", async () => {
-                logger.verbose('[Graph:Delete] Expiring opportunity', {
+                deleteLog.verbose('Expiring opportunity', {
                     userId: state.userId,
                     opportunityId: state.opportunityId,
                 });
@@ -3008,7 +3026,7 @@ export class OpportunityGraphFactory {
                     };
                 }
                 catch (err) {
-                    logger.error('[Graph:Delete] Failed', { error: err });
+                    deleteLog.error('Failed', { error: err });
                     return { mutationResult: { success: false, error: 'Failed to delete opportunity.' } };
                 }
             });
@@ -3018,7 +3036,7 @@ export class OpportunityGraphFactory {
          */
         const sendNode = async (state) => {
             return timed("OpportunityGraph.send", async () => {
-                logger.verbose('[Graph:Send] Sending opportunity', {
+                sendLog.verbose('Sending opportunity', {
                     userId: state.userId,
                     opportunityId: state.opportunityId,
                 });
@@ -3081,7 +3099,7 @@ export class OpportunityGraphFactory {
                     };
                 }
                 catch (err) {
-                    logger.error('[Graph:Send] Failed', { error: err });
+                    sendLog.error('Failed', { error: err });
                     return { mutationResult: { success: false, error: 'Failed to send opportunity.' } };
                 }
             });
@@ -3094,7 +3112,7 @@ export class OpportunityGraphFactory {
             if (!state.opportunityId)
                 return {};
             if (!this.negotiationGraph) {
-                logger.warn('[Graph:NegotiateExisting] No negotiationGraph wired; skipping', {
+                negotiateExistingLog.warn('No negotiationGraph wired; skipping', {
                     opportunityId: state.opportunityId,
                 });
                 return {};
@@ -3102,7 +3120,7 @@ export class OpportunityGraphFactory {
             try {
                 const opp = await this.database.getOpportunity(state.opportunityId);
                 if (!opp) {
-                    logger.warn('[Graph:NegotiateExisting] Opportunity not found', { opportunityId: state.opportunityId });
+                    negotiateExistingLog.warn('Opportunity not found', { opportunityId: state.opportunityId });
                     return {};
                 }
                 const actors = opp.actors;
@@ -3111,13 +3129,13 @@ export class OpportunityGraphFactory {
                 const sourceActor = nonIntroducerActors.find(a => a.role === 'patient' || a.role === 'party')
                     ?? nonIntroducerActors[0];
                 if (!sourceActor) {
-                    logger.warn('[Graph:NegotiateExisting] No source actor found', { opportunityId: state.opportunityId });
+                    negotiateExistingLog.warn('No source actor found', { opportunityId: state.opportunityId });
                     return {};
                 }
                 // Find the candidateActor: non-introducer that is NOT the sourceActor
                 const candidateActor = nonIntroducerActors.find(a => a.userId !== sourceActor.userId);
                 if (!candidateActor) {
-                    logger.warn('[Graph:NegotiateExisting] No candidate actor found', { opportunityId: state.opportunityId });
+                    negotiateExistingLog.warn('No candidate actor found', { opportunityId: state.opportunityId });
                     return {};
                 }
                 // Load user data for both actors in parallel
@@ -3181,17 +3199,17 @@ export class OpportunityGraphFactory {
                 if (acceptedResults.length > 0 && this.queueNotification) {
                     for (const actor of nonIntroducerActors) {
                         await this.queueNotification(opp.id, actor.userId, 'high').catch((err) => {
-                            logger.warn('[Graph:NegotiateExisting] Failed to queue notification', { actorId: actor.userId, error: err });
+                            negotiateExistingLog.warn('Failed to queue notification', { actorId: actor.userId, error: err });
                         });
                     }
                 }
-                logger.info('[Graph:NegotiateExisting] Negotiation complete', {
+                negotiateExistingLog.info('Negotiation complete', {
                     opportunityId: opp.id,
                     accepted: acceptedResults.length > 0,
                 });
             }
             catch (err) {
-                logger.error('[Graph:NegotiateExisting] Failed', { opportunityId: state.opportunityId, error: err });
+                negotiateExistingLog.error('Failed', { opportunityId: state.opportunityId, error: err });
                 return { error: `Failed to load opportunity: ${err instanceof Error ? err.message : String(err)}` };
             }
             return {};
@@ -3265,17 +3283,17 @@ export class OpportunityGraphFactory {
          */
         const shouldContinueAfterPrep = (state) => {
             if (state.error) {
-                logger.verbose('[Graph:Routing] Error in prep - ending early');
+                routingLog.verbose('Error in prep - ending early');
                 return END;
             }
             // Continuation mode: skip scope/resolve/discovery, go straight to evaluation
             if (state.operationMode === 'continue_discovery') {
-                logger.verbose('[Graph:Routing] Continue discovery → skipping to evaluation', {
+                routingLog.verbose('Continue discovery → skipping to evaluation', {
                     candidatesLoaded: state.candidates.length,
                 });
                 return 'evaluation';
             }
-            logger.verbose('[Graph:Routing] Continuing to scope');
+            routingLog.verbose('Continuing to scope');
             return 'scope';
         };
         /**
@@ -3283,10 +3301,10 @@ export class OpportunityGraphFactory {
          */
         const shouldContinueAfterScope = (state) => {
             if (state.error || state.targetNetworks.length === 0) {
-                logger.verbose('[Graph:Routing] No target indexes - ending early');
+                routingLog.verbose('No target indexes - ending early');
                 return END;
             }
-            logger.verbose('[Graph:Routing] Continuing to resolve');
+            routingLog.verbose('Continuing to resolve');
             return 'resolve';
         };
         /**
@@ -3294,7 +3312,7 @@ export class OpportunityGraphFactory {
          */
         const shouldContinueAfterDiscovery = (state) => {
             if (state.createIntentSuggested) {
-                logger.verbose('[Graph:Routing] Create-intent suggested - ending for tool signal');
+                routingLog.verbose('Create-intent suggested - ending for tool signal');
                 return END;
             }
             return 'evaluation';
@@ -3304,7 +3322,7 @@ export class OpportunityGraphFactory {
          */
         const routeAfterIntroValidation = (state) => {
             if (state.error) {
-                logger.verbose('[Graph:Routing] Intro validation error - ending early');
+                routingLog.verbose('Intro validation error - ending early');
                 return END;
             }
             return 'intro_evaluation';