@hiveai/core 0.15.0 → 0.17.0

package/dist/index.d.ts

@@ -795,6 +795,19 @@ declare const STACK_PACK_TAG = "stack-pack";
 declare function isStackPackSeed(fm: {
     tags?: string[];
 } | null | undefined): boolean;
+/**
+ * Tags that mark a memory as a *local dev-environment workaround* (hot-swap, nested node_modules,
+ * global-install quirks) rather than repo-specific team policy. These are real, but they describe
+ * tooling debt, not unguessable team knowledge — and because they get read on almost every session
+ * their read_count inflates and they crowd the briefing. Ranking caps them at `background` UNLESS
+ * they directly anchor a file being edited, so they stop displacing actual policy. The fix for a
+ * recurring one is to repair the environment, not to keep surfacing the note.
+ */
+declare const ENV_WORKAROUND_TAGS: Set<string>;
+/** True when a memory is tagged as a local dev-environment workaround (see {@link ENV_WORKAROUND_TAGS}). */
+declare function isEnvWorkaroundMemory(fm: {
+    tags?: string[];
+} | null | undefined): boolean;
 /**
  * Best-effort inference: given a list of file paths, infer module names from
  * conventional layouts (packages/X/, apps/X/, modules/X/, src/X/).
@@ -1488,6 +1501,14 @@ declare function writeBriefingMarker(paths: HaivePaths, input: {
     source: string;
     memoryIds?: string[];
     files?: string[];
+    /**
+     * Accumulate memory_ids/files with the existing fresh marker for THIS session instead of
+     * overwriting (default true). This is what lets decision-coverage build up as the agent works:
+     * every get_briefing call, every pre-edit injection, every `haive briefing` ADDS to the
+     * session's consulted set — so a broad commit no longer requires one giant briefing covering
+     * every relevant decision at once. Pass false to replace (e.g. starting a brand-new session).
+     */
+    accumulate?: boolean;
 }): Promise<BriefingMarker>;
 declare function hasRecentBriefingMarker(paths: HaivePaths, sessionId?: string, ttlMs?: number): Promise<boolean>;
 declare function readRecentBriefingMarker(paths: HaivePaths, sessionId?: string, ttlMs?: number): Promise<BriefingMarker | null>;
@@ -2027,4 +2048,70 @@ interface MergeResult {
  */
 declare function mergeMemoryVersions(ours: string, theirs: string): MergeResult;
 
-export { AUTOPILOT_DEFAULTS, type Activation, type ActivationContext, ActivationSchema, type Anchor, AnchorSchema, type AntiPatternGate, type AutoPromoteRule, BRIEFING_MARKER_TTL_MS, BRIEFING_PRESET_DEFAULTS, type BreakingChange, type BriefingBudgetNumbers, type BriefingBudgetPreset, type BriefingMarker, type BudgetPart, type BudgetSlice, type BuildCodeMapOptions, CHARS_PER_TOKEN, CODE_MAP_FILE, CODE_STOPWORDS, CONFIG_FILE, type CodeExport, type CodeExportKind, type CodeFileEntry, type CodeMap, type CodeMapQueryOptions, type CollectTimelineOpts, type CommandSensorSpec, type ConfidenceLevel, type ConfidenceThresholds, type ConflictCandidatePair, type ConflictCandidatesOpts, type ConflictResolution, type ContractDiffResult, type ContractFile, type ContractSnapshot, type CoverageGap, type CoverageOptions, CrossRepoProvenanceSchema, type CrossRepoReport, type CrossRepoSource, DECAY_DAYS, DEFAULT_AUTO_PROMOTE_RULE, DEFAULT_CONFIDENCE_THRESHOLDS, DEFAULT_CONFIG, DEFAULT_DORMANT_DAYS, type DashboardOptions, type DashboardReport, type DepChange, type DepTrackResult, type DependencySnapshot, type DocFrequency, type DormantRow, type DraftOptions, type DraftsOptions, type EvalDelta, type EvalHistoryEntry, type EvalReport, type EvalSpec, type EvalTrend, type FailureCoverageOptions, type FailureObservation, type Finding, type FindingSeverity, GUESSABLE_THRESHOLD, type GatePrecision, type GateTuningSuggestion, type GitCommit, HAIVE_DIR, type HaiveConfig, type HaivePaths, type HotFile, type ImpactOptions, type ImpactRow, type ImpactScore, type ImpactSummary, type ImpactTier, type LexicalRankResult, type LoadedMemory, MEMORIES_DIR, MIN_WORD_LEN, type Memory, type MemoryDraft, type MemoryFrontmatter, MemoryFrontmatterSchema, type MemoryScope, MemoryScopeSchema, type MemoryStatus, MemoryStatusSchema, type MemoryType, MemoryTypeSchema, type MemoryUsage, type MergeResult, type MetricDelta, PREVENTION_DEBOUNCE_MS, PROJECT_CONTEXT_FILE, PROJECT_CONTEXT_THROTTLE_MS, type PreventionEvent, type PreventionRow, type PreventionSource, type PreventionTrend, RUNTIME_JOURNAL_FILENAME, type RecurrenceReport, type RecurrenceRow, type ResolveProjectInfo, type RetirementSignal, type RetrievalAggregate, type RetrievalCase, type RetrievalCaseResult, type RuntimeJournalEntry, SESSION_RECAP_TTL_MS, STACK_PACK_TAG, type SeedProposal, type SelfEvalOptions, type Sensor, type SensorAggregate, type SensorCase, type SensorCaseResult, type SensorHit, type SensorRow, SensorSchema, type SensorSuggestionOptions, type SensorTarget, type SkillActivation, type TimelineEntry, type TopicStatusPair, type TruncateOptions, type TruncateResult, USAGE_FILE, USAGE_LOG_DIR, USAGE_LOG_FILE, type UncapturedFailure, type UsageAggregate, type UsageEvent, type UsageIndex, type VerifyOptions, type VerifyResult, addedLinesFromDiff, aggregateRetrieval, aggregateSensors, aggregateUsage, allocateBudget, antiPatternGateParams, appendEvalHistory, appendPreventionEvent, appendRuntimeJournalEntry, appendUsageEvent, briefingMarkerPath, briefingMarkersDir, buildCodeMap, buildCoverageIndex, buildDashboard, buildDocFrequency, buildFrontmatter, buildReport, bumpRead, codeMapPath, collectTimelineEntries, compareEvalReports, compareImpact, compileRegexSensor, computeEvalTrend, computeGatePrecision, computeImpact, computePreventionTrend, computeRecurrence, configPath, contractLockPath, deriveConfidence, diffContract, diffHasDistinctiveOverlap, distinctiveCap, draftsFromFindings, emptyUsage, emptyUsageIndex, enforcementDir, estimateTokens, evalHistoryPath, evaluateSkillActivation, extractActionsBriefBody, extractSnippet, filterNewDrafts, findCoverageGaps, findLexicalConflictPairs, findProjectRoot, findTopicStatusConflictPairs, findUncapturedFailures, findingBody, findingToDraft, firstMemoryOneLine, getUsage, globToRegExp, hasRecentBriefingMarker, hashProjectContext, inferModulesFromPaths, isAutoPromoteEligible, isCovered, isDecaying, isDistinctiveToken, isFreshIsoDate, isGlobPath, isLikelyGuessable, isRetiredMemory, isSkill, isSkillSuppressed, isStackPackSeed, listMarkdownFilesRecursive, literalMatchesAllTokens, literalMatchesAnyToken, loadCodeMap, loadConfig, loadConfigSync, loadEvalHistory, loadMemoriesFromDir, loadMemory, loadPreventionEvents, loadUsageIndex, memoryFilePath, memoryMatchesAnchorPaths, mergeMemoryVersions, newMemoryId, normalizeFindingSeverity, normalizeSessionId, overallScore, parseFindings, parseMemory, parseSarif, parseSince, parseSonar, pathsOverlap, pickSnippetNeedle, planConflictResolution, preventionLogPath, projectContextRecentlyEmitted, proposeSeedsFromCommits, pullCrossRepoSources, queryCodeMap, rankMemoriesLexical, readRecentBriefingMarker, readRuntimeJournalTail, readUsageEvents, recordApplied, recordPrevention, recordProjectContextEmission, recordRejection, relPathFrom, resolveBriefingBudget, resolveHaivePaths, resolveManifestFiles, resolveProjectInfo, retirementSignal, runRegexSensor, runSensors, runtimeJournalPath, saveCodeMap, saveConfig, saveUsageIndex, scoreRetrievalCase, scoreSensorCase, selectCommandSensors, sensorAppliesToPath, sensorTargetsFromDiff, serializeMemory, snapshotContract, specificityScore, stripPrivate, suggestGate, suggestSensorFromMemory, suggestTopicKey, summarizeImpact, synthesizeSelfEvalCases, titleFromBody, tokenizeQuery, tokenizeWords, trackDependencies, trackReads, truncateToTokens, usageLogPath, usageLogSize, usagePath, verifyAnchor, watchContracts, writeBriefingMarker };
+/**
+ * Recap compaction — keep the auto-generated session recap from dominating the briefing head.
+ *
+ * The MCP server auto-saves a minimal recap on exit (goal = "Auto-captured session (N tool calls)",
+ * body = a raw tool-call/file dump). It's low signal, yet get_briefing shows the freshest recap's
+ * full body at the very top of every briefing. A human/post_task recap (with a real Discoveries
+ * section) is far richer. This module detects an auto recap and compresses it to its useful core
+ * (the Discoveries, if any) so it informs without crowding. Pure, unit-tested.
+ */
+/**
+ * True when a recap body looks auto-generated (vs. a human/post_task recap). Auto recaps come in a
+ * couple of shapes, all low-signal: the session-tracker's "Auto-captured session (N tool calls)" and
+ * the run-wrapper's "Edited N files across M tool calls". The common tell is a raw tool-call count.
+ */
+declare function isAutoRecap(body: string): boolean;
+/**
+ * Return a compact version of an auto recap body: a one-line header (the Goal line) plus the
+ * Discoveries section when it carries real content (e.g. detected failures). Non-auto recaps are
+ * returned unchanged.
+ */
+declare function compactAutoRecapBody(body: string, maxChars?: number): string;
+
+type MemoryPriority = "must_read" | "useful" | "background";
+/**
+ * Normalized priority evidence. A caller fills only the signals it can compute; unknown ones default
+ * to false (see {@link DEFAULT_PRIORITY_SIGNALS}). The MCP path has semantic scores; the CLI path has
+ * lexical scores — both reduce to these booleans.
+ */
+interface PrioritySignals {
+    /** Memory type (attempt, gotcha, skill, decision, …). */
+    type: string;
+    /** Memory tags — used for the stack-pack / env-workaround down-rank. */
+    tags: string[];
+    /** The memory demands explicit human approval — always surface first. */
+    requiresHumanApproval: boolean;
+    /** Anchored to a file the agent is editing. */
+    directAnchor: boolean;
+    /** Anchored to a symbol the agent requested. */
+    directSymbol: boolean;
+    /** Exact/literal task match (semantic match_quality "exact", or an exact lexical task hit). */
+    exactTaskMatch: boolean;
+    /** Strong semantic relevance (cosine ≥ 0.65). CLI has no embeddings → passes false. */
+    strongSemantic: boolean;
+    /** Useful-level relevance: semantic ≥ 0.35, a partial task hit, or a high lexical score. */
+    usefulSemantic: boolean;
+    /** Matched an inferred module or domain from the touched files. */
+    moduleOrDomainMatch: boolean;
+    /** A memory tag matched a task token. */
+    tagTaskMatch: boolean;
+}
+declare const DEFAULT_PRIORITY_SIGNALS: PrioritySignals;
+/** Convenience: build a full signal set from a partial one. */
+declare function prioritySignals(partial: Partial<PrioritySignals>): PrioritySignals;
+/**
+ * Classify a memory's briefing priority from its signals. Order matters:
+ *   1. must_read — human-approval gates, direct anchor/symbol matches, and exact/strong hits on
+ *      negative (attempt) or skill memories: the things an agent must not miss.
+ *   2. background (down-rank) — generic stack-pack seeds and local dev-environment workarounds never
+ *      claim `useful` on a semantic/tag match alone; they'd crowd out repo-specific knowledge. (A
+ *      direct anchor already promoted them to must_read above, so genuinely-relevant ones still rank.)
+ *   3. useful — skills, module/domain matches, exact hits, and useful-level relevance.
+ *   4. background — everything else.
+ */
+declare function classifyMemoryPriority(signals: PrioritySignals): MemoryPriority;
+declare function priorityRank(priority: MemoryPriority): number;
+
+export { AUTOPILOT_DEFAULTS, type Activation, type ActivationContext, ActivationSchema, type Anchor, AnchorSchema, type AntiPatternGate, type AutoPromoteRule, BRIEFING_MARKER_TTL_MS, BRIEFING_PRESET_DEFAULTS, type BreakingChange, type BriefingBudgetNumbers, type BriefingBudgetPreset, type BriefingMarker, type BudgetPart, type BudgetSlice, type BuildCodeMapOptions, CHARS_PER_TOKEN, CODE_MAP_FILE, CODE_STOPWORDS, CONFIG_FILE, type CodeExport, type CodeExportKind, type CodeFileEntry, type CodeMap, type CodeMapQueryOptions, type CollectTimelineOpts, type CommandSensorSpec, type ConfidenceLevel, type ConfidenceThresholds, type ConflictCandidatePair, type ConflictCandidatesOpts, type ConflictResolution, type ContractDiffResult, type ContractFile, type ContractSnapshot, type CoverageGap, type CoverageOptions, CrossRepoProvenanceSchema, type CrossRepoReport, type CrossRepoSource, DECAY_DAYS, DEFAULT_AUTO_PROMOTE_RULE, DEFAULT_CONFIDENCE_THRESHOLDS, DEFAULT_CONFIG, DEFAULT_DORMANT_DAYS, DEFAULT_PRIORITY_SIGNALS, type DashboardOptions, type DashboardReport, type DepChange, type DepTrackResult, type DependencySnapshot, type DocFrequency, type DormantRow, type DraftOptions, type DraftsOptions, ENV_WORKAROUND_TAGS, type EvalDelta, type EvalHistoryEntry, type EvalReport, type EvalSpec, type EvalTrend, type FailureCoverageOptions, type FailureObservation, type Finding, type FindingSeverity, GUESSABLE_THRESHOLD, type GatePrecision, type GateTuningSuggestion, type GitCommit, HAIVE_DIR, type HaiveConfig, type HaivePaths, type HotFile, type ImpactOptions, type ImpactRow, type ImpactScore, type ImpactSummary, type ImpactTier, type LexicalRankResult, type LoadedMemory, MEMORIES_DIR, MIN_WORD_LEN, type Memory, type MemoryDraft, type MemoryFrontmatter, MemoryFrontmatterSchema, type MemoryPriority, type MemoryScope, MemoryScopeSchema, type MemoryStatus, MemoryStatusSchema, type MemoryType, MemoryTypeSchema, type MemoryUsage, type MergeResult, type MetricDelta, PREVENTION_DEBOUNCE_MS, PROJECT_CONTEXT_FILE, PROJECT_CONTEXT_THROTTLE_MS, type PreventionEvent, type PreventionRow, type PreventionSource, type PreventionTrend, type PrioritySignals, RUNTIME_JOURNAL_FILENAME, type RecurrenceReport, type RecurrenceRow, type ResolveProjectInfo, type RetirementSignal, type RetrievalAggregate, type RetrievalCase, type RetrievalCaseResult, type RuntimeJournalEntry, SESSION_RECAP_TTL_MS, STACK_PACK_TAG, type SeedProposal, type SelfEvalOptions, type Sensor, type SensorAggregate, type SensorCase, type SensorCaseResult, type SensorHit, type SensorRow, SensorSchema, type SensorSuggestionOptions, type SensorTarget, type SkillActivation, type TimelineEntry, type TopicStatusPair, type TruncateOptions, type TruncateResult, USAGE_FILE, USAGE_LOG_DIR, USAGE_LOG_FILE, type UncapturedFailure, type UsageAggregate, type UsageEvent, type UsageIndex, type VerifyOptions, type VerifyResult, addedLinesFromDiff, aggregateRetrieval, aggregateSensors, aggregateUsage, allocateBudget, antiPatternGateParams, appendEvalHistory, appendPreventionEvent, appendRuntimeJournalEntry, appendUsageEvent, briefingMarkerPath, briefingMarkersDir, buildCodeMap, buildCoverageIndex, buildDashboard, buildDocFrequency, buildFrontmatter, buildReport, bumpRead, classifyMemoryPriority, codeMapPath, collectTimelineEntries, compactAutoRecapBody, compareEvalReports, compareImpact, compileRegexSensor, computeEvalTrend, computeGatePrecision, computeImpact, computePreventionTrend, computeRecurrence, configPath, contractLockPath, deriveConfidence, diffContract, diffHasDistinctiveOverlap, distinctiveCap, draftsFromFindings, emptyUsage, emptyUsageIndex, enforcementDir, estimateTokens, evalHistoryPath, evaluateSkillActivation, extractActionsBriefBody, extractSnippet, filterNewDrafts, findCoverageGaps, findLexicalConflictPairs, findProjectRoot, findTopicStatusConflictPairs, findUncapturedFailures, findingBody, findingToDraft, firstMemoryOneLine, getUsage, globToRegExp, hasRecentBriefingMarker, hashProjectContext, inferModulesFromPaths, isAutoPromoteEligible, isAutoRecap, isCovered, isDecaying, isDistinctiveToken, isEnvWorkaroundMemory, isFreshIsoDate, isGlobPath, isLikelyGuessable, isRetiredMemory, isSkill, isSkillSuppressed, isStackPackSeed, listMarkdownFilesRecursive, literalMatchesAllTokens, literalMatchesAnyToken, loadCodeMap, loadConfig, loadConfigSync, loadEvalHistory, loadMemoriesFromDir, loadMemory, loadPreventionEvents, loadUsageIndex, memoryFilePath, memoryMatchesAnchorPaths, mergeMemoryVersions, newMemoryId, normalizeFindingSeverity, normalizeSessionId, overallScore, parseFindings, parseMemory, parseSarif, parseSince, parseSonar, pathsOverlap, pickSnippetNeedle, planConflictResolution, preventionLogPath, priorityRank, prioritySignals, projectContextRecentlyEmitted, proposeSeedsFromCommits, pullCrossRepoSources, queryCodeMap, rankMemoriesLexical, readRecentBriefingMarker, readRuntimeJournalTail, readUsageEvents, recordApplied, recordPrevention, recordProjectContextEmission, recordRejection, relPathFrom, resolveBriefingBudget, resolveHaivePaths, resolveManifestFiles, resolveProjectInfo, retirementSignal, runRegexSensor, runSensors, runtimeJournalPath, saveCodeMap, saveConfig, saveUsageIndex, scoreRetrievalCase, scoreSensorCase, selectCommandSensors, sensorAppliesToPath, sensorTargetsFromDiff, serializeMemory, snapshotContract, specificityScore, stripPrivate, suggestGate, suggestSensorFromMemory, suggestTopicKey, summarizeImpact, synthesizeSelfEvalCases, titleFromBody, tokenizeQuery, tokenizeWords, trackDependencies, trackReads, truncateToTokens, usageLogPath, usageLogSize, usagePath, verifyAnchor, watchContracts, writeBriefingMarker };

package/dist/index.js

@@ -318,6 +318,16 @@ var STACK_PACK_TAG = "stack-pack";
 function isStackPackSeed(fm) {
   return Boolean(fm?.tags?.includes(STACK_PACK_TAG));
 }
+var ENV_WORKAROUND_TAGS = /* @__PURE__ */ new Set([
+  "dev-workflow",
+  "dev-env",
+  "hotswap",
+  "local-setup",
+  "tooling-debt"
+]);
+function isEnvWorkaroundMemory(fm) {
+  return Boolean(fm?.tags?.some((t) => ENV_WORKAROUND_TAGS.has(t)));
+}
 var MODULE_PATTERNS = [
   /^packages\/([^/]+)\//,
   /^apps\/([^/]+)\//,
@@ -2833,11 +2843,24 @@ function briefingMarkerPath(paths, sessionId) {
   return path16.join(briefingMarkersDir(paths), `${normalizeSessionId(sessionId)}.json`);
 }
 async function writeBriefingMarker(paths, input) {
+  const sessionId = normalizeSessionId(input.sessionId);
+  const accumulate = input.accumulate ?? true;
+  let priorIds = [];
+  let priorFiles = [];
+  if (accumulate) {
+    const existing = await readSessionBriefingMarker(paths, sessionId);
+    if (existing) {
+      priorIds = existing.memory_ids ?? [];
+      priorFiles = existing.files ?? [];
+    }
+  }
+  const mergedIds = [.../* @__PURE__ */ new Set([...priorIds, ...input.memoryIds ?? []])];
+  const mergedFiles = [.../* @__PURE__ */ new Set([...priorFiles, ...input.files ?? []])];
   const marker = {
-    session_id: normalizeSessionId(input.sessionId),
+    session_id: sessionId,
     ...input.task?.trim() ? { task: input.task.trim() } : {},
-    ...input.memoryIds && input.memoryIds.length > 0 ? { memory_ids: [...new Set(input.memoryIds)] } : {},
-    ...input.files && input.files.length > 0 ? { files: [...new Set(input.files)] } : {},
+    ...mergedIds.length > 0 ? { memory_ids: mergedIds } : {},
+    ...mergedFiles.length > 0 ? { files: mergedFiles } : {},
     source: input.source,
     created_at: (/* @__PURE__ */ new Date()).toISOString(),
     root: paths.root
@@ -2850,6 +2873,18 @@ async function writeBriefingMarker(paths, input) {
   );
   return marker;
 }
+async function readSessionBriefingMarker(paths, sessionId, ttlMs = BRIEFING_MARKER_TTL_MS) {
+  const file = briefingMarkerPath(paths, sessionId);
+  if (!existsSync14(file)) return null;
+  try {
+    const marker = JSON.parse(await readFile13(file, "utf8"));
+    const created = Date.parse(marker.created_at);
+    if (!Number.isFinite(created) || Date.now() - created > ttlMs) return null;
+    return marker;
+  } catch {
+    return null;
+  }
+}
 async function hasRecentBriefingMarker(paths, sessionId, ttlMs = BRIEFING_MARKER_TTL_MS) {
   const now = Date.now();
   const candidates = [];
@@ -3823,6 +3858,64 @@ function mergeMemoryVersions(ours, theirs) {
   if (cmp < 0) return { content: ours, winner: "ours", reason: `newer created_at (${ca})` };
   return { content: ours, winner: "ours", reason: "tie \u2014 kept ours" };
 }
+
+// src/recap.ts
+function isAutoRecap(body) {
+  return /Auto-captured session/i.test(body) || /\bEdited \d+ files? across \d+ tool calls?/i.test(body) || /\b\d+ tool calls?\b/i.test(body);
+}
+function compactAutoRecapBody(body, maxChars = 600) {
+  if (!isAutoRecap(body)) return body;
+  const goalMatch = body.match(/##+\s*Goal[^\n]*\n+([^\n]+)/i);
+  const callsMatch = body.match(/Auto-captured session \(([^)]+)\)/i);
+  const header = goalMatch?.[1]?.trim() ? `_${goalMatch[1].trim()}_` : callsMatch ? `_Auto-captured session (${callsMatch[1]})._` : "_Auto-captured session._";
+  const discMatch = body.match(/##+\s*Discoveries[^\n]*\n([\s\S]*?)(?=\n##+\s|\n*$)/i);
+  const discovery = discMatch?.[1]?.trim() ?? "";
+  const trivialDiscovery = discovery === "" || /^no (new memories|surprising)/i.test(discovery) || /No new memories saved this session\.?$/i.test(discovery);
+  if (trivialDiscovery) {
+    return `${header}
+
+_No notable discoveries captured. Run post_task / \`mem_session_end\` for a richer recap._`;
+  }
+  const trimmed = discovery.length > maxChars ? discovery.slice(0, maxChars) + "\u2026" : discovery;
+  return `${header}
+
+**Discoveries:**
+${trimmed}`;
+}
+
+// src/priority.ts
+var DEFAULT_PRIORITY_SIGNALS = {
+  type: "",
+  tags: [],
+  requiresHumanApproval: false,
+  directAnchor: false,
+  directSymbol: false,
+  exactTaskMatch: false,
+  strongSemantic: false,
+  usefulSemantic: false,
+  moduleOrDomainMatch: false,
+  tagTaskMatch: false
+};
+function prioritySignals(partial) {
+  return { ...DEFAULT_PRIORITY_SIGNALS, ...partial };
+}
+function classifyMemoryPriority(signals) {
+  const isNegative = signals.type === "attempt";
+  const isSkill2 = signals.type === "skill";
+  if (signals.requiresHumanApproval || signals.directAnchor || signals.directSymbol || isNegative && (signals.exactTaskMatch || signals.strongSemantic) || isSkill2 && (signals.exactTaskMatch || signals.strongSemantic)) {
+    return "must_read";
+  }
+  if (isStackPackSeed({ tags: signals.tags }) || isEnvWorkaroundMemory({ tags: signals.tags })) {
+    return "background";
+  }
+  if (isSkill2 || signals.moduleOrDomainMatch || signals.exactTaskMatch || signals.usefulSemantic || signals.tagTaskMatch) {
+    return "useful";
+  }
+  return "background";
+}
+function priorityRank(priority) {
+  return priority === "must_read" ? 3 : priority === "useful" ? 2 : 1;
+}
 export {
   AUTOPILOT_DEFAULTS,
   ActivationSchema,
@@ -3839,6 +3932,8 @@ export {
   DEFAULT_CONFIDENCE_THRESHOLDS,
   DEFAULT_CONFIG,
   DEFAULT_DORMANT_DAYS,
+  DEFAULT_PRIORITY_SIGNALS,
+  ENV_WORKAROUND_TAGS,
   GUESSABLE_THRESHOLD,
   HAIVE_DIR,
   MEMORIES_DIR,
@@ -3876,8 +3971,10 @@ export {
   buildFrontmatter,
   buildReport,
   bumpRead,
+  classifyMemoryPriority,
   codeMapPath,
   collectTimelineEntries,
+  compactAutoRecapBody,
   compareEvalReports,
   compareImpact,
   compileRegexSensor,
@@ -3916,9 +4013,11 @@ export {
   hashProjectContext,
   inferModulesFromPaths,
   isAutoPromoteEligible,
+  isAutoRecap,
   isCovered,
   isDecaying,
   isDistinctiveToken,
+  isEnvWorkaroundMemory,
   isFreshIsoDate,
   isGlobPath,
   isLikelyGuessable,
@@ -3953,6 +4052,8 @@ export {
   pickSnippetNeedle,
   planConflictResolution,
   preventionLogPath,
+  priorityRank,
+  prioritySignals,
   projectContextRecentlyEmitted,
   proposeSeedsFromCommits,
   pullCrossRepoSources,