snipara-companion 3.2.7 → 3.2.9

package/dist/index.d.ts

@@ -3328,6 +3328,13 @@ interface SessionBootstrapQualityReport {
     total_tokens?: number;
     oldest_memory_age_days?: number;
 }
+interface SessionBootstrapBrief {
+    entries: SessionMemoryEntry[];
+    availableCount: number;
+    hiddenCount: number;
+    estimatedTokens: number;
+    budgetTokens: number;
+}
 interface GeneratedWorkflowPlanDocument {
     mode: "full";
     goal: string;
@@ -3354,6 +3361,12 @@ declare function validatePlanResult(plan: unknown, options?: {
     query?: string;
     cwd?: string;
 }): PlanQualityReport;
+declare function buildSessionBootstrapBrief(result: SessionMemoriesResult, options: {
+    includeSessionContext: boolean;
+    maxTokens?: number;
+    maxEntries?: number;
+    now?: Date;
+}): SessionBootstrapBrief;
 declare function buildSessionBootstrapQuality(result: SessionMemoriesResult, options?: {
     expectedMaxTokens?: number;
     now?: Date;
@@ -4258,4 +4271,4 @@ declare function buildOrchestratorHandoff(options: OrchestratorHandoffOptions):
 declare function buildAdaptiveWorkRoutingRecommendation(options: AdaptiveWorkRoutingOptions): AdaptiveWorkRoutingRecommendation;
 declare function writeOrchestratorHandoff(options: OrchestratorHandoffOptions): WrittenOrchestratorHandoff;
 
-export { AUTOMATION_MANIFEST_RELATIVE_PATH, AutomationInstallConflictError, AutomationUnsupportedHookBundleError, CODING_INTELLIGENCE_LEDGER_VERSION, COLLABORATION_STATE_RELATIVE_PATH, ENGINEERING_LEAD_EXECUTION_RECEIPT_STAGES, ENGINEERING_LEAD_EXECUTION_RECEIPT_STATUSES, ENGINEERING_LEAD_POSTURES, ENGINEERING_LEAD_PROOF_VERIFICATION_SOURCES, ENGINEERING_LEAD_PROOF_VERIFICATION_STATUSES, ENGINEERING_LEAD_ROUTING_MODES, ENGINEERING_LEAD_STATUSES, ENGINEERING_LEAD_SUPERVISION_STATUSES, ENGINEERING_LEAD_WORKER_ROLES, ENGINEERING_LEAD_WORK_PACKAGE_STATUSES, ORCHESTRATOR_HANDOFF_RELATIVE_PATH, PRODUCER_LOOP_ARTIFACT_VERSION, PRODUCER_LOOP_RELATIVE_DIR, PRODUCER_LOOP_REPORT_VERSION, TEAM_SYNC_STATE_RELATIVE_PATH, WHY_OUTCOME_CAPTURE_VERSION, WORKFLOW_PLANS_RELATIVE_DIR, WORKFLOW_STATE_RELATIVE_PATH, addLocalWorker, agentReadinessAuditCommand, appendActivityEvent, archiveInactiveTeamSyncWork, attachLocalContextPackReceipts, autoArchiveTeamSyncState, buildAdaptiveWorkRoutingRecommendation, buildAgentReadinessAuditReport, buildAgenticHandoffMarkdown, buildAgenticTimeline, buildAgenticWorkStatus, buildAutomationInstallPlan, buildCanonicalEvent, buildCodeHooksInstallPlan, buildCodePromotionResult, buildCodeStatusResult, buildCodeSyncResult, buildCodingIntelligenceLedger, buildCollaborationActor, buildCollaborationGuardActionCards, buildCollaborationHooksInstallPlan, buildCompanionEngineeringLeadPlanReport, buildContextPackStats, buildEvalCaseArtifact, buildGeneratedWorkflowPlanDocument, buildHostedCodeOverlayUploadPayload, buildHostedGuardPayload, buildJournalCheckpointEntry, buildLocalCallersResult, buildLocalCodeOverlay, buildLocalContextPackReceipt, buildLocalContextPackReceipts, buildLocalImpactResult, buildLocalImportsResult, buildLocalNeighborsResult, buildLocalProjectRealityCheck, buildLocalShortestPathResult, buildLocalSourceSnapshot, buildLocalSourceStatus, buildLocalSourceSyncResult, buildMemoryAudit, buildOnboardFolderManifest, buildOrchestratorHandoff, buildProducerLoopReport, buildProjectIntelligenceBrief, buildProjectIntelligenceRun, buildProjectJudgmentCard, buildSessionBootstrapQuality, buildSessionSnapshot, buildSyncDocumentsDryRun, buildTeamSyncHandoffRecord, buildTeamSyncStartWorkRecord, buildTeamSyncSummary, buildToolCallPayload, buildToolResultPayload, buildVerificationPlan, buildWhyOutcomeCaptureReport, buildWorkflowImpactGate, buildWorkflowPhaseCommitSummary, buildWorkflowPlanScaffold, categoryFromGuardTag, classifyToolResult, cleanContextPacks, codingLedgerExportCommand, collaborationIdeStatusCommand, collectAgentReadinessLocalSignals, collectSyncDocuments, collectSyncDocumentsInput, compactHostedGuardResources, compareLocalSourceSnapshots, completeTeamSyncStateFromEvidence, completeTeamSyncWorkFromEvidence, contextPackCleanCommand, contextPackPackCommand, contextPackRetrieveCommand, contextPackStatsCommand, createClient, createEmptyCollaborationState, createEmptyTeamSyncState, createLocalQueryCache, deriveLocalCollaborationResourcesFromFiles, detectReleaseSurfacesFromFiles, detectRuntimeEnvironment, evalExportCommand, evalRunCommand, evaluateProjectPolicyGates, extractCommandFromToolInput, extractFilesFromToolInput, formatAgentReadinessAuditReport, formatCompanionEngineeringLeadPlanReport, formatOrchestratorRecommendationReason, formatPolicyGateDecision, formatProjectJudgmentCard, formatStuckGuardDecision, getAutomationManifestPath, getAutomationStatus, getCollaborationStatePath, getConfigPath, getContextPackStoragePaths, getLocalCodeOverlayCachePath, getLocalCodePromotionStatePath, getLocalSourceSnapshotPath, getOrchestratorRecommendation, getPlanStepDisplayTitle, getStagedFiles, getStuckGuardInjection, getTeamSyncStatePath, ingestReferences, installAutomationBundle, leadPlanCommand, listProjectsForApiKey, loadAutomationManifest, loadCollaborationState, loadConfig, loadTeamSyncState, memoryAuditCommand, memoryCleanCandidatesCommand, memoryCompactCommand, memoryHealthCommand, memoryLocalCommand, memoryReviewsCommand, normalizeCollaborationFiles, normalizeGuardTag, normalizeWorkflowPlanInput, outcomeCapturePreviewCommand, packContext, parseCollaborationResources, projectIntelligenceBriefCommand, projectIntelligenceRunCommand, readActivityTimeline, readLocalCodeOverlayCache, readLocalCodePromotionState, readLocalSourceSnapshot, readLocalWorkersConfig, readSessionSnapshot, realityCheckCommand, referencesIngestCommand, referencesScanCommand, resolveAutoWorkflowMode, resolveContextPackRecord, resolveFullWorkflowTokenBudget, resolveLocalWorkerRoutingDefaults, resolveQueryFromToolInput, retrieveContextPack, runMemoryGuardCheck, saveCollaborationState, saveConfig, saveTeamSyncState, scanReferences, shouldSuggestOrchestratorForWorkflow, shouldSuggestRuntimeForWorkflow, summarizeLocalCodeOverlay, teamSyncSweepCommand, validatePlanResult, verifyCommand, workersLocalAddCommand, workersLocalListCommand, workersLocalProbePrintCommand, workersLocalRemoveCommand, workersLocalStatusCommand, writeLocalCodeOverlayCache, writeLocalCodePromotionState, writeLocalSourceSnapshot, writeOrchestratorHandoff, writeProducerLoopArtifact, writeSessionSnapshot };
+export { AUTOMATION_MANIFEST_RELATIVE_PATH, AutomationInstallConflictError, AutomationUnsupportedHookBundleError, CODING_INTELLIGENCE_LEDGER_VERSION, COLLABORATION_STATE_RELATIVE_PATH, ENGINEERING_LEAD_EXECUTION_RECEIPT_STAGES, ENGINEERING_LEAD_EXECUTION_RECEIPT_STATUSES, ENGINEERING_LEAD_POSTURES, ENGINEERING_LEAD_PROOF_VERIFICATION_SOURCES, ENGINEERING_LEAD_PROOF_VERIFICATION_STATUSES, ENGINEERING_LEAD_ROUTING_MODES, ENGINEERING_LEAD_STATUSES, ENGINEERING_LEAD_SUPERVISION_STATUSES, ENGINEERING_LEAD_WORKER_ROLES, ENGINEERING_LEAD_WORK_PACKAGE_STATUSES, ORCHESTRATOR_HANDOFF_RELATIVE_PATH, PRODUCER_LOOP_ARTIFACT_VERSION, PRODUCER_LOOP_RELATIVE_DIR, PRODUCER_LOOP_REPORT_VERSION, TEAM_SYNC_STATE_RELATIVE_PATH, WHY_OUTCOME_CAPTURE_VERSION, WORKFLOW_PLANS_RELATIVE_DIR, WORKFLOW_STATE_RELATIVE_PATH, addLocalWorker, agentReadinessAuditCommand, appendActivityEvent, archiveInactiveTeamSyncWork, attachLocalContextPackReceipts, autoArchiveTeamSyncState, buildAdaptiveWorkRoutingRecommendation, buildAgentReadinessAuditReport, buildAgenticHandoffMarkdown, buildAgenticTimeline, buildAgenticWorkStatus, buildAutomationInstallPlan, buildCanonicalEvent, buildCodeHooksInstallPlan, buildCodePromotionResult, buildCodeStatusResult, buildCodeSyncResult, buildCodingIntelligenceLedger, buildCollaborationActor, buildCollaborationGuardActionCards, buildCollaborationHooksInstallPlan, buildCompanionEngineeringLeadPlanReport, buildContextPackStats, buildEvalCaseArtifact, buildGeneratedWorkflowPlanDocument, buildHostedCodeOverlayUploadPayload, buildHostedGuardPayload, buildJournalCheckpointEntry, buildLocalCallersResult, buildLocalCodeOverlay, buildLocalContextPackReceipt, buildLocalContextPackReceipts, buildLocalImpactResult, buildLocalImportsResult, buildLocalNeighborsResult, buildLocalProjectRealityCheck, buildLocalShortestPathResult, buildLocalSourceSnapshot, buildLocalSourceStatus, buildLocalSourceSyncResult, buildMemoryAudit, buildOnboardFolderManifest, buildOrchestratorHandoff, buildProducerLoopReport, buildProjectIntelligenceBrief, buildProjectIntelligenceRun, buildProjectJudgmentCard, buildSessionBootstrapBrief, buildSessionBootstrapQuality, buildSessionSnapshot, buildSyncDocumentsDryRun, buildTeamSyncHandoffRecord, buildTeamSyncStartWorkRecord, buildTeamSyncSummary, buildToolCallPayload, buildToolResultPayload, buildVerificationPlan, buildWhyOutcomeCaptureReport, buildWorkflowImpactGate, buildWorkflowPhaseCommitSummary, buildWorkflowPlanScaffold, categoryFromGuardTag, classifyToolResult, cleanContextPacks, codingLedgerExportCommand, collaborationIdeStatusCommand, collectAgentReadinessLocalSignals, collectSyncDocuments, collectSyncDocumentsInput, compactHostedGuardResources, compareLocalSourceSnapshots, completeTeamSyncStateFromEvidence, completeTeamSyncWorkFromEvidence, contextPackCleanCommand, contextPackPackCommand, contextPackRetrieveCommand, contextPackStatsCommand, createClient, createEmptyCollaborationState, createEmptyTeamSyncState, createLocalQueryCache, deriveLocalCollaborationResourcesFromFiles, detectReleaseSurfacesFromFiles, detectRuntimeEnvironment, evalExportCommand, evalRunCommand, evaluateProjectPolicyGates, extractCommandFromToolInput, extractFilesFromToolInput, formatAgentReadinessAuditReport, formatCompanionEngineeringLeadPlanReport, formatOrchestratorRecommendationReason, formatPolicyGateDecision, formatProjectJudgmentCard, formatStuckGuardDecision, getAutomationManifestPath, getAutomationStatus, getCollaborationStatePath, getConfigPath, getContextPackStoragePaths, getLocalCodeOverlayCachePath, getLocalCodePromotionStatePath, getLocalSourceSnapshotPath, getOrchestratorRecommendation, getPlanStepDisplayTitle, getStagedFiles, getStuckGuardInjection, getTeamSyncStatePath, ingestReferences, installAutomationBundle, leadPlanCommand, listProjectsForApiKey, loadAutomationManifest, loadCollaborationState, loadConfig, loadTeamSyncState, memoryAuditCommand, memoryCleanCandidatesCommand, memoryCompactCommand, memoryHealthCommand, memoryLocalCommand, memoryReviewsCommand, normalizeCollaborationFiles, normalizeGuardTag, normalizeWorkflowPlanInput, outcomeCapturePreviewCommand, packContext, parseCollaborationResources, projectIntelligenceBriefCommand, projectIntelligenceRunCommand, readActivityTimeline, readLocalCodeOverlayCache, readLocalCodePromotionState, readLocalSourceSnapshot, readLocalWorkersConfig, readSessionSnapshot, realityCheckCommand, referencesIngestCommand, referencesScanCommand, resolveAutoWorkflowMode, resolveContextPackRecord, resolveFullWorkflowTokenBudget, resolveLocalWorkerRoutingDefaults, resolveQueryFromToolInput, retrieveContextPack, runMemoryGuardCheck, saveCollaborationState, saveConfig, saveTeamSyncState, scanReferences, shouldSuggestOrchestratorForWorkflow, shouldSuggestRuntimeForWorkflow, summarizeLocalCodeOverlay, teamSyncSweepCommand, validatePlanResult, verifyCommand, workersLocalAddCommand, workersLocalListCommand, workersLocalProbePrintCommand, workersLocalRemoveCommand, workersLocalStatusCommand, writeLocalCodeOverlayCache, writeLocalCodePromotionState, writeLocalSourceSnapshot, writeOrchestratorHandoff, writeProducerLoopArtifact, writeSessionSnapshot };

package/dist/index.js

@@ -101,6 +101,7 @@ __export(index_exports, {
   buildProjectIntelligenceBrief: () => buildProjectIntelligenceBrief,
   buildProjectIntelligenceRun: () => buildProjectIntelligenceRun,
   buildProjectJudgmentCard: () => buildProjectJudgmentCard,
+  buildSessionBootstrapBrief: () => buildSessionBootstrapBrief,
   buildSessionBootstrapQuality: () => buildSessionBootstrapQuality,
   buildSessionSnapshot: () => buildSessionSnapshot,
   buildSyncDocumentsDryRun: () => buildSyncDocumentsDryRun,
@@ -17096,6 +17097,239 @@ function isLikelyTestMemory(entry) {
   const text = readBootstrapEntryText(entry).toLowerCase();
   return type === "test" || category === "test" || /^test memory\b/.test(text);
 }
+function readBootstrapEntryId(entry) {
+  return stringValue7(entry.id) ?? stringValue7(entry.memory_id) ?? `${stringValue7(entry.type) ?? "memory"}:${readBootstrapEntryText(entry).slice(0, 80)}`;
+}
+function isSessionCarryoverEntry(entry) {
+  const category = typeof entry.category === "string" ? entry.category.toLowerCase() : "";
+  const text = readBootstrapEntryText(entry).toLowerCase();
+  return category.includes("team_sync_handoff") || category.includes("journal:") || category.includes("workflow-phase") || text.includes("checkpoint: workflow:final-commit") || text.includes("final commit") || text.includes("phase-commit") || text.includes("handoff");
+}
+function isLikelyStaleBootstrapEntry(entry, now) {
+  const age = entryAgeDays(entry, now);
+  const text = readBootstrapEntryText(entry).toLowerCase();
+  return typeof age === "number" && age > STALE_BOOTSTRAP_MEMORY_DAYS || typeof entry.confidence === "number" && entry.confidence < 0.5 || text.includes("/users/alopez/devs/snipara/.env") || text.includes("rlm_remember") || text.includes("rlm_recall") || text.includes("railway") || text.includes("vercel") || text.includes("memory injection feature is complete") || text.includes("infotooltip component created") || text.includes("mcp performance optimizations (jan 2026)");
+}
+function scoreBootstrapBriefEntry(entry, source2, now) {
+  let score = source2 === "daily" ? 100 : 0;
+  const age = entryAgeDays(entry, now);
+  const type = typeof entry.type === "string" ? entry.type.toLowerCase() : "";
+  const category = typeof entry.category === "string" ? entry.category.toLowerCase() : "";
+  const text = readBootstrapEntryText(entry).toLowerCase();
+  if (isSessionCarryoverEntry(entry)) {
+    score += 90;
+  }
+  if (type === "decision") {
+    score += 25;
+    const authorityStatus = bootstrapAuthorityStatus(entry);
+    if (authorityStatus === "canonical") {
+      score += 55;
+    } else if (authorityStatus === "approved" || authorityStatus === "authoritative") {
+      score += 20;
+    }
+  } else if (type === "context") {
+    score += 20;
+  } else if (type === "learning") {
+    score += 10;
+  }
+  if (category.includes("journal:") || category.includes("workflow-phase")) {
+    score += 40;
+  }
+  if (category.includes("team_sync_handoff")) {
+    score += 55;
+  }
+  if (text.includes("control plane") || text.includes("control-plane") || text.includes("lite")) {
+    score += 35;
+  }
+  if (text.includes("published") || text.includes("deployed") || text.includes("data-dpl-id")) {
+    score += 25;
+  }
+  if (typeof entry.confidence === "number") {
+    score += Math.max(0, Math.min(25, entry.confidence * 25));
+    if (entry.confidence < 0.5) {
+      score -= 90;
+    }
+  }
+  if (typeof age === "number") {
+    if (age <= 1) {
+      score += 65;
+    } else if (age <= 7) {
+      score += 45;
+    } else if (age <= 30) {
+      score += 20;
+    } else if (age > STALE_BOOTSTRAP_MEMORY_DAYS) {
+      score -= 100;
+    }
+  }
+  if (isLikelyTestMemory(entry)) {
+    score -= 120;
+  }
+  if (isLikelyStaleBootstrapEntry(entry, now)) {
+    score -= 80;
+  }
+  return score;
+}
+function estimateBootstrapEntryTokens(entry) {
+  return Math.max(8, Math.ceil(compactSessionEntryLine(entry).length / 4));
+}
+function bootstrapEntryType(entry) {
+  return typeof entry.type === "string" ? entry.type.toLowerCase() : "";
+}
+function isBootstrapDecisionEntry(entry) {
+  return bootstrapEntryType(entry) === "decision";
+}
+function bootstrapAuthorityStatus(entry) {
+  const authority = isRecord9(entry.authority) ? entry.authority : void 0;
+  return (stringValue7(entry.authority_status) ?? stringValue7(authority?.authorityStatus) ?? stringValue7(authority?.level) ?? "").toLowerCase();
+}
+function bootstrapSimilarityTokens(entry) {
+  const stopWords = /* @__PURE__ */ new Set([
+    "checkpoint",
+    "workflow",
+    "final",
+    "commit",
+    "phase",
+    "summary",
+    "context",
+    "team",
+    "sync",
+    "handoff",
+    "released",
+    "release"
+  ]);
+  const text = readSessionEntryPreview(entry).toLowerCase().replace(/snipara-companion@\d+\.\d+\.\d+/g, "snipara-companion").replace(/[^a-z0-9]+/g, " ");
+  return new Set(text.split(/\s+/).filter((token) => token.length >= 4 && !stopWords.has(token)));
+}
+function buildBootstrapTopicTokens(ranked) {
+  const tokens = /* @__PURE__ */ new Set();
+  for (const candidate of ranked) {
+    if (tokens.size >= 48) {
+      break;
+    }
+    if (candidate.score <= 0 || !isSessionCarryoverEntry(candidate.entry)) {
+      continue;
+    }
+    for (const token of bootstrapSimilarityTokens(candidate.entry)) {
+      tokens.add(token);
+    }
+  }
+  return tokens;
+}
+function isDecisionRelevantToBootstrap(entry, topicTokens, hasCarryoverCandidate) {
+  if (!isBootstrapDecisionEntry(entry)) {
+    return false;
+  }
+  if (!hasCarryoverCandidate) {
+    return true;
+  }
+  const text = readBootstrapEntryText(entry).toLowerCase();
+  const hasExplicitTopic = text.includes("control plane") || text.includes("control-plane") || text.includes("lite") || text.includes("session-bootstrap") || text.includes("bootstrap brief");
+  if (hasExplicitTopic) {
+    return true;
+  }
+  const category = typeof entry.category === "string" ? entry.category.toLowerCase() : "";
+  if (category.includes("workflow-phase") || category.includes("final-commit") || category.includes("journal:") || category.includes("team_sync")) {
+    return false;
+  }
+  let overlap = 0;
+  for (const token of bootstrapSimilarityTokens(entry)) {
+    if (topicTokens.has(token)) {
+      overlap += 1;
+    }
+  }
+  return overlap >= 3;
+}
+function areBootstrapEntriesSimilar(a, b) {
+  const aTokens = bootstrapSimilarityTokens(a);
+  const bTokens = bootstrapSimilarityTokens(b);
+  if (aTokens.size === 0 || bTokens.size === 0) {
+    return false;
+  }
+  let overlap = 0;
+  for (const token of aTokens) {
+    if (bTokens.has(token)) {
+      overlap += 1;
+    }
+  }
+  const smaller = Math.min(aTokens.size, bTokens.size);
+  const larger = Math.max(aTokens.size, bTokens.size);
+  return overlap / smaller >= 0.6 || overlap >= 8 && overlap / larger >= 0.5;
+}
+function buildSessionBootstrapBrief(result, options) {
+  const normalized = normalizeSessionMemoriesResult(result);
+  const now = options.now ?? /* @__PURE__ */ new Date();
+  const maxEntries = Math.max(1, Math.min(options.maxEntries ?? 4, 5));
+  const budgetTokens = normalizePositiveTokenBudget(options.maxTokens, 600, true);
+  const candidates = [
+    ...normalized.critical.memories.map((entry) => ({ entry, source: "critical" })),
+    ...options.includeSessionContext ? normalized.daily.memories.map((entry) => ({ entry, source: "daily" })) : []
+  ];
+  const seen = /* @__PURE__ */ new Set();
+  const ranked = candidates.map((candidate, index) => ({
+    ...candidate,
+    index,
+    score: scoreBootstrapBriefEntry(candidate.entry, candidate.source, now)
+  })).sort((a, b) => b.score - a.score || b.index - a.index);
+  const hasFreshCandidate = ranked.some(
+    (candidate) => candidate.score > 0 && !isLikelyStaleBootstrapEntry(candidate.entry, now) && !isLikelyTestMemory(candidate.entry)
+  );
+  const topicTokens = buildBootstrapTopicTokens(ranked);
+  const hasCarryoverCandidate = ranked.some(
+    (candidate) => candidate.score > 0 && isSessionCarryoverEntry(candidate.entry) && !isLikelyStaleBootstrapEntry(candidate.entry, now) && !isLikelyTestMemory(candidate.entry)
+  );
+  const hasFreshDecisionCandidate = maxEntries >= 4 && ranked.some(
+    (candidate) => candidate.score > 0 && isDecisionRelevantToBootstrap(candidate.entry, topicTokens, hasCarryoverCandidate) && !isLikelyStaleBootstrapEntry(candidate.entry, now) && !isLikelyTestMemory(candidate.entry)
+  );
+  const entries = [];
+  let estimatedTokens = 0;
+  let selectedCarryoverCount = 0;
+  let selectedDecisionCount = 0;
+  for (const candidate of ranked) {
+    if (hasFreshCandidate && (isLikelyStaleBootstrapEntry(candidate.entry, now) || isLikelyTestMemory(candidate.entry))) {
+      continue;
+    }
+    const id = readBootstrapEntryId(candidate.entry);
+    const textKey = readBootstrapEntryText(candidate.entry).slice(0, 140).toLowerCase();
+    const key = id || textKey;
+    if (seen.has(key)) {
+      continue;
+    }
+    if (entries.some((entry) => areBootstrapEntriesSimilar(entry, candidate.entry))) {
+      continue;
+    }
+    const isCarryover = isSessionCarryoverEntry(candidate.entry);
+    const isDecision = isBootstrapDecisionEntry(candidate.entry);
+    if (isDecision && !isDecisionRelevantToBootstrap(candidate.entry, topicTokens, hasCarryoverCandidate)) {
+      continue;
+    }
+    if (hasFreshDecisionCandidate && selectedDecisionCount === 0 && isCarryover && selectedCarryoverCount >= maxEntries - 1) {
+      continue;
+    }
+    const entryTokens = estimateBootstrapEntryTokens(candidate.entry);
+    if (entries.length > 0 && estimatedTokens + entryTokens > budgetTokens) {
+      continue;
+    }
+    seen.add(key);
+    entries.push(candidate.entry);
+    estimatedTokens += entryTokens;
+    if (isCarryover) {
+      selectedCarryoverCount += 1;
+    }
+    if (isDecision) {
+      selectedDecisionCount += 1;
+    }
+    if (entries.length >= maxEntries) {
+      break;
+    }
+  }
+  return {
+    entries,
+    availableCount: candidates.length,
+    hiddenCount: Math.max(0, candidates.length - entries.length),
+    estimatedTokens,
+    budgetTokens
+  };
+}
 function buildSessionBootstrapQuality(result, options = {}) {
   const normalized = normalizeSessionMemoriesResult(result);
   const now = options.now ?? /* @__PURE__ */ new Date();
@@ -20744,6 +20978,30 @@ function printChunkResult(chunkId, result) {
   printJson2(result);
 }
 function readSessionEntryPreview(entry) {
+  for (const value of [entry.summary, entry.text, entry.content, entry.title]) {
+    if (typeof value !== "string") {
+      continue;
+    }
+    const trimmed = value.trim();
+    if (trimmed.startsWith("{") && trimmed.endsWith("}")) {
+      try {
+        const parsed = JSON.parse(trimmed);
+        if (isRecord9(parsed)) {
+          const summary = stringValue7(parsed.summary);
+          const nextStep = stringValue7(parsed.nextStep);
+          const task = stringValue7(parsed.task);
+          const readable = [summary, nextStep ? `Next: ${nextStep}` : void 0, task].filter((item) => Boolean(item)).join(" ");
+          if (readable.length > 0) {
+            return toPreview(readable, 220);
+          }
+        }
+      } catch {
+      }
+    }
+    if (trimmed.length > 0) {
+      return toPreview(trimmed, 220);
+    }
+  }
   return toPreview(entry.text ?? entry.content ?? entry.summary ?? entry.title, 220);
 }
 function compactSessionEntryLine(entry) {
@@ -20751,24 +21009,34 @@ function compactSessionEntryLine(entry) {
   return `- ${label}: ${readSessionEntryPreview(entry)}`;
 }
 function printSessionBootstrap(result, options) {
-  const normalized = normalizeSessionMemoriesResult(result);
-  const entries = [
-    ...normalized.critical.memories,
-    ...options.includeSessionContext ? normalized.daily.memories : []
-  ].slice(0, 5);
+  const brief = buildSessionBootstrapBrief(result, {
+    includeSessionContext: options.includeSessionContext,
+    maxTokens: options.maxTokens
+  });
+  const entries = brief.entries;
   if (entries.length === 0) {
-    return false;
+    return null;
   }
   console.log(import_chalk6.default.bold("Snipara Bootstrap Brief"));
   for (const entry of entries) {
     console.log(compactSessionEntryLine(entry));
   }
-  const hiddenCount = normalized.critical.count + (options.includeSessionContext ? normalized.daily.count : 0) - entries.length;
-  if (hiddenCount > 0) {
-    console.log(`- ${hiddenCount} more available on demand via recall/session-bootstrap --json.`);
-  }
   console.log("");
-  return true;
+  return brief;
+}
+function buildPrintedBootstrapQuality(brief, now) {
+  return buildSessionBootstrapQuality(
+    {
+      critical: {
+        memories: brief.entries,
+        count: brief.entries.length,
+        tokens: brief.estimatedTokens
+      },
+      daily: { memories: [], count: 0, tokens: 0 },
+      total_tokens: brief.estimatedTokens
+    },
+    { expectedMaxTokens: brief.budgetTokens, now }
+  );
 }
 function printSessionBootstrapQuality(report) {
   if (report.warnings.length === 0) {
@@ -22289,13 +22557,12 @@ async function workflowRunCommand(options) {
     const printedBootstrap = printSessionBootstrap(
       payload.session_bootstrap,
       {
-        includeSessionContext: Boolean(workflowBudget?.include_session_context)
+        includeSessionContext: Boolean(workflowBudget?.include_session_context),
+        maxTokens: (workflowBudget?.allocations.critical_memory_tokens ?? DEFAULT_FULL_WORKFLOW_CRITICAL_TOKENS) + (workflowBudget?.allocations.session_context_tokens ?? 0)
       }
     );
     if (printedBootstrap && payload.session_bootstrap_quality && typeof payload.session_bootstrap_quality === "object") {
-      printSessionBootstrapQuality(
-        payload.session_bootstrap_quality
-      );
+      printSessionBootstrapQuality(buildPrintedBootstrapQuality(printedBootstrap));
     }
     if (workflowBudget?.warnings.length) {
       console.log(import_chalk6.default.bold("Workflow Budget Warnings"));
@@ -23239,10 +23506,11 @@ async function workflowResumeCommand(options) {
   console.log(import_chalk6.default.bold("Workflow Resume"));
   printManagedWorkflowState(state);
   const printedBootstrap = printSessionBootstrap(bootstrap, {
-    includeSessionContext: resolvedContextTokens > 0
+    includeSessionContext: resolvedContextTokens > 0,
+    maxTokens: resolvedCriticalTokens + resolvedContextTokens
   });
   if (printedBootstrap) {
-    printSessionBootstrapQuality(bootstrapQuality);
+    printSessionBootstrapQuality(buildPrintedBootstrapQuality(printedBootstrap));
   }
   printWorkflowLocalSessionSnapshot(localSessionSnapshot);
   printWorkflowTeamSyncResume(teamSyncResume);
@@ -23738,7 +24006,25 @@ async function loadDocumentCommand(options) {
   printLoadDocumentResult(options.path, result);
 }
 async function sessionBootstrapCommand(options) {
-  ensureConfigured();
+  if (!isConfigured()) {
+    if (options.json) {
+      printJson2({
+        critical: { memories: [], count: 0, tokens: 0 },
+        daily: { memories: [], count: 0, tokens: 0 },
+        total_tokens: 0,
+        session_context: {
+          included: Boolean(options.includeSessionContext),
+          max_tokens: options.includeSessionContext ? DEFAULT_SESSION_CONTEXT_TOKENS : 0
+        },
+        session_bootstrap_quality: buildSessionBootstrapQuality({
+          critical: { memories: [], count: 0, tokens: 0 },
+          daily: { memories: [], count: 0, tokens: 0 },
+          total_tokens: 0
+        })
+      });
+    }
+    return;
+  }
   const resolvedContextTokens = options.maxContextTokens !== void 0 ? options.maxContextTokens : options.includeSessionContext ? DEFAULT_SESSION_CONTEXT_TOKENS : 0;
   const client = createClient(15e3);
   const result = await client.getSessionMemories(options.maxCriticalTokens, resolvedContextTokens);
@@ -23766,17 +24052,11 @@ async function sessionBootstrapCommand(options) {
     return;
   }
   const printedBootstrap = printSessionBootstrap(result, {
-    includeSessionContext: resolvedContextTokens > 0
+    includeSessionContext: resolvedContextTokens > 0,
+    maxTokens: (options.maxCriticalTokens ?? DEFAULT_FULL_WORKFLOW_CRITICAL_TOKENS) + resolvedContextTokens
   });
   if (printedBootstrap) {
-    printSessionBootstrapQuality(bootstrapQuality);
-  }
-  if (printedBootstrap && warmSnapshot.storedEntries > 0) {
-    printKeyValue2(
-      "Warm cache:",
-      `${warmSnapshot.storedEntries} bootstrap memory/context entries primed locally`
-    );
-    console.log("");
+    printSessionBootstrapQuality(buildPrintedBootstrapQuality(printedBootstrap));
   }
 }
 async function recallCommand(options) {
@@ -33781,6 +34061,7 @@ if (require.main === module) {
   buildProjectIntelligenceBrief,
   buildProjectIntelligenceRun,
   buildProjectJudgmentCard,
+  buildSessionBootstrapBrief,
   buildSessionBootstrapQuality,
   buildSessionSnapshot,
   buildSyncDocumentsDryRun,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "snipara-companion",
-  "version": "3.2.7",
+  "version": "3.2.9",
   "description": "Local-first CLI that asks your repo what breaks before an AI coding agent edits it.",
   "main": "dist/index.js",
   "bin": {