@hivelore/core 0.57.6 → 0.58.0

package/dist/index.d.ts

@@ -1600,6 +1600,23 @@ declare function pathsOverlap(a: string, b: string): boolean;
 declare function memoryMatchesAnchorPaths(memory: LoadedMemory["memory"], inputPaths: string[]): boolean;
 declare function isGlobPath(p: string): boolean;
 declare function globToRegExp(pattern: string): RegExp;
+/** Below this many semantic hits a distribution is not meaningful — behave exactly as before. */
+declare const ADAPTIVE_FLOOR_MIN_SAMPLES = 12;
+/**
+ * A distribution-aware floor for semantic-only hits.
+ *
+ * Field report 2026-09-01 §4.1: on a broad corpus (~40 memories) cosine scores compress into a
+ * narrow band (everything > 0.55), so an ABSOLUTE `min_semantic_score` sorts nothing — the same
+ * three or four unrelated memories surface for every task at ~0.6. The fix the report asks for is
+ * to judge a score against the corpus distribution rather than in the absolute.
+ *
+ * This returns `mean + halfStdDev`, which self-adjusts: on a compressed distribution it rises toward
+ * the mean and trims the undifferentiated mass; on a discriminating one it sits between the winner
+ * and the noise. It NEVER drops below the caller's explicit floor, NEVER excludes the single top
+ * hit, and does nothing at all below {@link ADAPTIVE_FLOOR_MIN_SAMPLES} samples (so small corpora —
+ * and the retrieval eval — are unaffected). Pure.
+ */
+declare function adaptiveSemanticFloor(scores: number[], explicitFloor?: number): number;
 declare function relPathFrom(root: string, abs: string): string;
 
 /**
@@ -2726,6 +2743,11 @@ declare const SENSOR_ABSENT_LOOKBACK = 2;
  * (wrong kind, missing/invalid pattern) so callers can skip it safely.
  */
 declare function compileRegexSensor(sensor: Sensor): RegExp | null;
+/**
+ * Blank comment spans in scannable text so a sensor's regex matches CODE, not the prose that
+ * documents it. Returns `content` unchanged for unknown file types. Pure.
+ */
+declare function stripCommentsForScan(content: string, path: string): string;
 /**
  * Run a single regex sensor over one target. Returns the first matching line as a hit,
  * or null. Deterministic and side-effect-free.
@@ -3976,6 +3998,17 @@ declare function isAutoRecap(body: string): boolean;
  * returned unchanged.
  */
 declare function compactAutoRecapBody(body: string, maxChars?: number): string;
+/**
+ * The excerpt of a recap that belongs at the TOP of every briefing: only what the next session must
+ * act on — the goal in one line and the next steps.
+ *
+ * A full human/post_task recap (goal + accomplished + discoveries + next steps) ran ~3000 tokens and
+ * was re-emitted at the head of EVERY briefing, so a session with five briefings paid five times to
+ * re-read a wall the agent had just written (field report 2026-09-01 §5.6). The full body stays in
+ * the corpus — reachable with `mem_get <id>` — this only trims what the briefing head carries. Auto
+ * recaps still route through {@link compactAutoRecapBody}. Pure.
+ */
+declare function recapBriefingExcerpt(body: string, maxChars?: number): string;
 
 /** Filename of the ephemeral handoff at the repo root. */
 declare const HANDOFF_FILENAME = "NEXT.md";
@@ -4144,4 +4177,4 @@ interface ReviewDraftOptions {
 /** Template review learnings into proposed-memory drafts (reuses the scanner-ingest draft shape). */
 declare function reviewLearningsToDrafts(learnings: ReviewLearning[], options?: ReviewDraftOptions): MemoryDraft[];
 
-export { AUTOPILOT_DEFAULTS, type Activation, type ActivationContext, ActivationSchema, type AgentContext, type Anchor, type AnchorAuditRow, type AnchorChurn, AnchorSchema, type AntiPatternGate, type AppendFrictionInput, type AppendFrictionResult, type AppliedConflictResolution, type AstExport, type AutoPromoteRule, BRIDGE_MARKERS, BRIDGE_TARGETS, BRIDGE_TARGET_PATH, BRIEFING_MARKER_TTL_MS, BRIEFING_PRESET_DEFAULTS, type BaselineHealth, type BehaviourCoverageInput, type BehaviourCoverageMetrics, type BehaviourOracleInfo, type BootstrapAssessment, type BootstrapGap, type BootstrapGate, type BootstrapMetrics, type BootstrapState, type BootstrapStateInput, type BreakingChange, type BridgeFileOutput, type BridgeMemoryEntry, type BridgeSensor, type BridgeTarget, type BriefingBudgetNumbers, type BriefingBudgetPreset, type BriefingMarker, type BriefingProofLineOptions, type BudgetPart, type BudgetSlice, type BuildCodeMapOptions, CHARS_PER_TOKEN, CODE_MAP_DEFAULT_EXCLUDE, CODE_MAP_DEFAULT_INCLUDE, CODE_MAP_FILE, CODE_STOPWORDS, CONFIG_FILE, CONTENT_CATCH_CODES, type CaughtForYouOptions, type CaughtForYouRow, type CaughtForYouSummary, 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 ContractCheck, type ContractDiffResult, type ContractFile, type ContractSnapshot, type CoverageGap, type CoverageOptions, CrossRepoProvenanceSchema, type CrossRepoReport, type CrossRepoSource, DECAY_DAYS, DEFAULT_AUTO_PROMOTE_RULE, DEFAULT_BRIEFING_EXCLUDE_TAGS, DEFAULT_CONFIDENCE_THRESHOLDS, DEFAULT_CONFIG, DEFAULT_DORMANT_DAYS, DEFAULT_POSTURE, DEFAULT_PRIORITY_SIGNALS, DEFAULT_SPECIFICITY, type DashboardOptions, type DashboardReport, type DepChange, type DepTrackResult, type DependencySnapshot, type DetectStacksInput, type DetectableStack, type DistilledFailureLesson, type DocFrequency, type DormantRow, type DraftOptions, type DraftsOptions, ENV_WORKAROUND_TAGS, type EvalDelta, type EvalHistoryEntry, type EvalReport, type EvalSpec, type EvalTrend, FRICTION_FIELD_MAX, FRICTION_LOG_FILE, FRICTION_STATE_FILE, type FailureCoverageOptions, type FailureObservation, type FeedbackAdjustment, type FeedbackAdjustmentAction, type FeedbackAdjustmentOptions, type Finding, type FindingFormat, type FindingSeverity, type FrictionGroup, type FrictionKind, type FrictionReport, type FrictionState, type FrictionStateEntry, type FrictionStatus, GATE_REMINDER_WINDOW_MS, GUESSABLE_THRESHOLD, type GateFinding, type GateMissProposal, type GatePolicy, type GatePolicyInput, type GatePosture, type GatePrecision, type GatePrecisionDelta, type GatePrecisionMetricDelta, type GateSeverity, type GateStage, type GateTuningSuggestion, type GateVerdict, type GateVerdictInput, type GenerateBridgesOptions, type GitCommit, type GitWatchPlan, type GitWatchState, type GithubReleaseCode, type GithubReleaseInput, type GithubReleaseVerdict, HAIVE_DIR, HAIVE_OWNED_FILES, HANDOFF_FILENAME, HIVELORE_ATTRIBUTION, type HaiveConfig, type HaivePaths, type HotFile, type HotFileSource, type ImpactOptions, type ImpactRow, type ImpactScore, type ImpactSummary, type ImpactTier, type IncidentHints, type InvalidMemoryFile, LEGACY_CONFIG_FILE, 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, type NpmPublicationCode, type NpmPublicationInput, type NpmPublicationVerdict, PREVENTION_DEBOUNCE_MS, PREVENTION_RECEIPT_MARKER, PROCESS_GATE_CODES, PROJECT_CONTEXT_FILE, PROJECT_CONTEXT_THROTTLE_MS, type PostIncidentLesson, type PreventionCommentFinding, type PreventionEvent, type PreventionEventDetail, type PreventionReceipt, type PreventionReceiptRow, type PreventionRow, type PreventionSource, type PreventionTrend, type PrioritySignals, type ProposedEvalSpec, type ProposedSensorVerdict, REVIEW_LEARNING_MARKER, RUNTIME_JOURNAL_FILENAME, type RecurrenceReport, type RecurrenceRow, type ResolveProjectInfo, type RetirementSignal, type RetrievalAggregate, type RetrievalCase, type RetrievalCaseResult, type ReviewDraftOptions, type ReviewLearning, type RuntimeJournalEntry, SCAFFOLD_MARKER_RE, SEED_QUALITY_FLOOR, SENSOR_ABSENT_LOOKBACK, SENSOR_ABSENT_WINDOW, SESSION_RECAP_TTL_MS, SETUP_GATE_CODES, STACK_PACK_TAG, type ScaffoldLoopGap, type ScaffoldOptions, type ScaffoldStyle, type SeedProposal, type SelfEvalOptions, type Sensor, type SensorAggregate, type SensorCase, type SensorCaseResult, type SensorEvaluation, type SensorEvaluationOutcome, type SensorEvaluationStage, type SensorFlap, type SensorHealth, type SensorHit, type SensorRow, SensorSchema, type SensorSeed, type SensorSelfCheck, type SensorSuggestionOptions, type SensorTarget, type SensorWeakening, type SessionHandoffData, type SkillActivation, TEST_FRAMEWORKS, type TestFramework, type TestScaffold, type TierContractCheck, type TimelineEntry, type TopicStatusPair, type TruncateOptions, type TruncateResult, USAGE_FILE, USAGE_LOG_DIR, USAGE_LOG_FILE, type UncapturedFailure, type UncoveredAreaSuggestion, type UsageAggregate, type UsageEvent, type UsageIndex, type VerifyOptions, type VerifyResult, WEAK_ANCHOR_CHURN_RATIO, addedLineNumbersFromDiff, addedLinesFromDiff, aggregateRetrieval, aggregateSensors, aggregateUsage, allocateBudget, anchorMatchesComponent, anchorSpecificity, antiPatternGateParams, appendEvalHistory, appendFrictionReport, appendPreventionEvent, appendProposedRetrievalCases, appendRuntimeJournalEntry, appendSensorEvaluations, appendUsageEvent, applyConflictResolution, applyFeedbackAdjustment, approveProposedCases, assessBehaviourCoverage, assessBootstrapState, assessScaffoldLoop, assessSensorHealth, auditAnchorSpecificity, bridgeMemorySummary, briefingMarkerPath, briefingMarkersDir, briefingProofLine, buildBaselineHealthFinding, buildCodeMap, buildCoverageIndex, buildDashboard, buildDocFrequency, buildFrontmatter, buildHandoffMarkdown, buildPreventionReceipt, buildProposeCommand, buildReport, bumpRead, changedPathsFromDiff, churnForAnchors, classifyGithubRelease, classifyMemoryPriority, classifyNpmPublication, codeMapContentHash, codeMapPath, collectTimelineEntries, compactAutoRecapBody, compareEvalReports, compareGatePrecision, compareImpact, compareVersions, compileRegexSensor, componentOf, computeBaselineHealth, computeEvalTrend, computeGatePrecision, computeImpact, computePreventionTrend, computeRecurrence, computeScopeHash, configPath, contractLockPath, countSourceFilesOnDisk, decideVerdict, dedupeRefusals, deriveConfidence, deriveMainAreas, describePosture, detectAgentContext, detectSensorWeakening, detectStacksFromManifests, diffContract, diffHasDistinctiveOverlap, distillFailureObservations, distinctiveCap, draftsFromFindings, emptyUsage, emptyUsageIndex, enforcementDir, estimateTokens, evalHistoryPath, evaluateSkillActivation, existingGateMissShas, explainSensorRejection, extractActionsBriefBody, extractCorrectApproachExamples, extractReferencedPaths, extractReviewLearnings, extractSensorExamples, extractSnippet, extractTestFilePathsFromCommand, filterNewDrafts, findCoverageGaps, findLexicalConflictPairs, findProjectRoot, findTopicStatusConflictPairs, findUncapturedFailures, findingBody, findingToDraft, firstMemoryOneLine, formatFrictionIssue, frictionFingerprint, frictionLogPath, frictionStatePath, gatePassedShas, generateBridges, getUsage, globToRegExp, groupFriction, handoffAgeMs, handoffFilePath, hasPendingTestMarker, hasRecentBriefingMarker, hashProjectContext, incidentHintsFromDiff, incidentSuffix, inferModulesFromPaths, isAutoPromoteEligible, isAutoRecap, isCovered, isDecaying, isDistinctiveToken, isEnvWorkaroundMemory, isFreshIsoDate, isGlobPath, isHarnessErrorOutput, isLikelyGuessable, isNoiseSubject, isProductionCodeFile, isRetiredMemory, isSensorScannablePath, isSkill, isSkillSuppressed, isStackPackSeed, isStylisticRule, isTemplateProjectContext, isWeakAnchor, judgeProposedSensor, lessonShortName, listMarkdownFilesRecursive, literalMatchesAllTokens, literalMatchesAnyToken, loadCodeMap, loadConfig, loadConfigSync, loadEvalHistory, loadFrictionState, loadMemoriesFromDir, loadMemoriesFromDirDetailed, loadMemory, loadPreventionEvents, loadSensorLedger, loadUsageIndex, looksLikeGenericAdvice, meetsSeedQualityFloor, memoryFilePath, memoryHasExcludedTag, memoryMatchesAnchorPaths, mergeHotFiles, mergeMemoryVersions, mineSensorSeedFromDiff, moduleNameOf, newMemoryId, normalizeChurnPath, normalizeFindingSeverity, normalizeFramework, normalizeFrictionSummary, normalizeKind, normalizeScaffoldStyle, normalizeSessionId, overallScore, parseEslintJson, parseFileAst, parseFindings, parseLessonFields, parseMemory, parseNpmAudit, parseSarif, parseSince, parseSonar, pathsOverlap, pickSnippetNeedle, pickTestFramework, planConflictResolution, planGitWatch, prepareBridgeData, preventionLogPath, priorityRank, prioritySignals, projectContextRecentlyEmitted, proposeGateMissDrafts, proposeSeedsFromCommits, pullCrossRepoSources, quarantineNote, queryCodeMap, rankMemoriesLexical, readFrictionReports, readRecentBriefingMarker, readRuntimeJournalTail, readSessionHandoff, readUsageEvents, recommendFeedbackAdjustment, recordApplied, recordGateReminder, recordPrevention, recordPreventionHits, recordProjectContextEmission, recordRejection, relPathFrom, renderBehaviourCoverageLine, renderBootstrapChecklist, renderCaughtForYou, renderPreventionComment, renderPreventionReceipt, renderPreventionReceiptShare, resolveBriefingBudget, resolveConfigPath, resolveGatePolicy, resolveHaivePaths, resolveManifestFiles, resolveProjectInfo, retirementSignal, revertedShaFromCommit, reviewLearningsToDrafts, runPresenceSensors, runRegexSensor, runSensors, runTierContract, runValidationContract, runtimeJournalPath, saveCodeMap, saveConfig, saveFrictionState, saveUsageIndex, scaffoldPostIncidentTest, scannableSensorTargets, scoreRetrievalCase, scoreSensorCase, scrubbedCommandEnv, selectCommandSensors, sensorAppliesToPath, sensorLedgerPath, sensorPatternBrittleness, sensorPromotedAtMap, sensorSelfCheck, sensorTargetsFromDiff, serializeCodeMap, serializeMemory, setFrictionStatus, shouldExpandGateReminder, snapshotContract, specificityScore, stripPrivate, suggestGate, suggestSensorFromMemory, suggestSensorSeed, suggestTopicKey, summarizeCaughtForYou, summarizeImpact, synthesizeSelfEvalCases, tallyHotFiles, titleFromBody, tokenizeQuery, tokenizeWords, trackDependencies, trackReads, truncateToTokens, usageLogPath, usageLogSize, usagePath, verifyAnchor, watchContracts, withQuarantineNote, withoutQuarantineNote, writeBriefingMarker, writeSessionHandoff };
+export { ADAPTIVE_FLOOR_MIN_SAMPLES, AUTOPILOT_DEFAULTS, type Activation, type ActivationContext, ActivationSchema, type AgentContext, type Anchor, type AnchorAuditRow, type AnchorChurn, AnchorSchema, type AntiPatternGate, type AppendFrictionInput, type AppendFrictionResult, type AppliedConflictResolution, type AstExport, type AutoPromoteRule, BRIDGE_MARKERS, BRIDGE_TARGETS, BRIDGE_TARGET_PATH, BRIEFING_MARKER_TTL_MS, BRIEFING_PRESET_DEFAULTS, type BaselineHealth, type BehaviourCoverageInput, type BehaviourCoverageMetrics, type BehaviourOracleInfo, type BootstrapAssessment, type BootstrapGap, type BootstrapGate, type BootstrapMetrics, type BootstrapState, type BootstrapStateInput, type BreakingChange, type BridgeFileOutput, type BridgeMemoryEntry, type BridgeSensor, type BridgeTarget, type BriefingBudgetNumbers, type BriefingBudgetPreset, type BriefingMarker, type BriefingProofLineOptions, type BudgetPart, type BudgetSlice, type BuildCodeMapOptions, CHARS_PER_TOKEN, CODE_MAP_DEFAULT_EXCLUDE, CODE_MAP_DEFAULT_INCLUDE, CODE_MAP_FILE, CODE_STOPWORDS, CONFIG_FILE, CONTENT_CATCH_CODES, type CaughtForYouOptions, type CaughtForYouRow, type CaughtForYouSummary, 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 ContractCheck, type ContractDiffResult, type ContractFile, type ContractSnapshot, type CoverageGap, type CoverageOptions, CrossRepoProvenanceSchema, type CrossRepoReport, type CrossRepoSource, DECAY_DAYS, DEFAULT_AUTO_PROMOTE_RULE, DEFAULT_BRIEFING_EXCLUDE_TAGS, DEFAULT_CONFIDENCE_THRESHOLDS, DEFAULT_CONFIG, DEFAULT_DORMANT_DAYS, DEFAULT_POSTURE, DEFAULT_PRIORITY_SIGNALS, DEFAULT_SPECIFICITY, type DashboardOptions, type DashboardReport, type DepChange, type DepTrackResult, type DependencySnapshot, type DetectStacksInput, type DetectableStack, type DistilledFailureLesson, type DocFrequency, type DormantRow, type DraftOptions, type DraftsOptions, ENV_WORKAROUND_TAGS, type EvalDelta, type EvalHistoryEntry, type EvalReport, type EvalSpec, type EvalTrend, FRICTION_FIELD_MAX, FRICTION_LOG_FILE, FRICTION_STATE_FILE, type FailureCoverageOptions, type FailureObservation, type FeedbackAdjustment, type FeedbackAdjustmentAction, type FeedbackAdjustmentOptions, type Finding, type FindingFormat, type FindingSeverity, type FrictionGroup, type FrictionKind, type FrictionReport, type FrictionState, type FrictionStateEntry, type FrictionStatus, GATE_REMINDER_WINDOW_MS, GUESSABLE_THRESHOLD, type GateFinding, type GateMissProposal, type GatePolicy, type GatePolicyInput, type GatePosture, type GatePrecision, type GatePrecisionDelta, type GatePrecisionMetricDelta, type GateSeverity, type GateStage, type GateTuningSuggestion, type GateVerdict, type GateVerdictInput, type GenerateBridgesOptions, type GitCommit, type GitWatchPlan, type GitWatchState, type GithubReleaseCode, type GithubReleaseInput, type GithubReleaseVerdict, HAIVE_DIR, HAIVE_OWNED_FILES, HANDOFF_FILENAME, HIVELORE_ATTRIBUTION, type HaiveConfig, type HaivePaths, type HotFile, type HotFileSource, type ImpactOptions, type ImpactRow, type ImpactScore, type ImpactSummary, type ImpactTier, type IncidentHints, type InvalidMemoryFile, LEGACY_CONFIG_FILE, 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, type NpmPublicationCode, type NpmPublicationInput, type NpmPublicationVerdict, PREVENTION_DEBOUNCE_MS, PREVENTION_RECEIPT_MARKER, PROCESS_GATE_CODES, PROJECT_CONTEXT_FILE, PROJECT_CONTEXT_THROTTLE_MS, type PostIncidentLesson, type PreventionCommentFinding, type PreventionEvent, type PreventionEventDetail, type PreventionReceipt, type PreventionReceiptRow, type PreventionRow, type PreventionSource, type PreventionTrend, type PrioritySignals, type ProposedEvalSpec, type ProposedSensorVerdict, REVIEW_LEARNING_MARKER, RUNTIME_JOURNAL_FILENAME, type RecurrenceReport, type RecurrenceRow, type ResolveProjectInfo, type RetirementSignal, type RetrievalAggregate, type RetrievalCase, type RetrievalCaseResult, type ReviewDraftOptions, type ReviewLearning, type RuntimeJournalEntry, SCAFFOLD_MARKER_RE, SEED_QUALITY_FLOOR, SENSOR_ABSENT_LOOKBACK, SENSOR_ABSENT_WINDOW, SESSION_RECAP_TTL_MS, SETUP_GATE_CODES, STACK_PACK_TAG, type ScaffoldLoopGap, type ScaffoldOptions, type ScaffoldStyle, type SeedProposal, type SelfEvalOptions, type Sensor, type SensorAggregate, type SensorCase, type SensorCaseResult, type SensorEvaluation, type SensorEvaluationOutcome, type SensorEvaluationStage, type SensorFlap, type SensorHealth, type SensorHit, type SensorRow, SensorSchema, type SensorSeed, type SensorSelfCheck, type SensorSuggestionOptions, type SensorTarget, type SensorWeakening, type SessionHandoffData, type SkillActivation, TEST_FRAMEWORKS, type TestFramework, type TestScaffold, type TierContractCheck, type TimelineEntry, type TopicStatusPair, type TruncateOptions, type TruncateResult, USAGE_FILE, USAGE_LOG_DIR, USAGE_LOG_FILE, type UncapturedFailure, type UncoveredAreaSuggestion, type UsageAggregate, type UsageEvent, type UsageIndex, type VerifyOptions, type VerifyResult, WEAK_ANCHOR_CHURN_RATIO, adaptiveSemanticFloor, addedLineNumbersFromDiff, addedLinesFromDiff, aggregateRetrieval, aggregateSensors, aggregateUsage, allocateBudget, anchorMatchesComponent, anchorSpecificity, antiPatternGateParams, appendEvalHistory, appendFrictionReport, appendPreventionEvent, appendProposedRetrievalCases, appendRuntimeJournalEntry, appendSensorEvaluations, appendUsageEvent, applyConflictResolution, applyFeedbackAdjustment, approveProposedCases, assessBehaviourCoverage, assessBootstrapState, assessScaffoldLoop, assessSensorHealth, auditAnchorSpecificity, bridgeMemorySummary, briefingMarkerPath, briefingMarkersDir, briefingProofLine, buildBaselineHealthFinding, buildCodeMap, buildCoverageIndex, buildDashboard, buildDocFrequency, buildFrontmatter, buildHandoffMarkdown, buildPreventionReceipt, buildProposeCommand, buildReport, bumpRead, changedPathsFromDiff, churnForAnchors, classifyGithubRelease, classifyMemoryPriority, classifyNpmPublication, codeMapContentHash, codeMapPath, collectTimelineEntries, compactAutoRecapBody, compareEvalReports, compareGatePrecision, compareImpact, compareVersions, compileRegexSensor, componentOf, computeBaselineHealth, computeEvalTrend, computeGatePrecision, computeImpact, computePreventionTrend, computeRecurrence, computeScopeHash, configPath, contractLockPath, countSourceFilesOnDisk, decideVerdict, dedupeRefusals, deriveConfidence, deriveMainAreas, describePosture, detectAgentContext, detectSensorWeakening, detectStacksFromManifests, diffContract, diffHasDistinctiveOverlap, distillFailureObservations, distinctiveCap, draftsFromFindings, emptyUsage, emptyUsageIndex, enforcementDir, estimateTokens, evalHistoryPath, evaluateSkillActivation, existingGateMissShas, explainSensorRejection, extractActionsBriefBody, extractCorrectApproachExamples, extractReferencedPaths, extractReviewLearnings, extractSensorExamples, extractSnippet, extractTestFilePathsFromCommand, filterNewDrafts, findCoverageGaps, findLexicalConflictPairs, findProjectRoot, findTopicStatusConflictPairs, findUncapturedFailures, findingBody, findingToDraft, firstMemoryOneLine, formatFrictionIssue, frictionFingerprint, frictionLogPath, frictionStatePath, gatePassedShas, generateBridges, getUsage, globToRegExp, groupFriction, handoffAgeMs, handoffFilePath, hasPendingTestMarker, hasRecentBriefingMarker, hashProjectContext, incidentHintsFromDiff, incidentSuffix, inferModulesFromPaths, isAutoPromoteEligible, isAutoRecap, isCovered, isDecaying, isDistinctiveToken, isEnvWorkaroundMemory, isFreshIsoDate, isGlobPath, isHarnessErrorOutput, isLikelyGuessable, isNoiseSubject, isProductionCodeFile, isRetiredMemory, isSensorScannablePath, isSkill, isSkillSuppressed, isStackPackSeed, isStylisticRule, isTemplateProjectContext, isWeakAnchor, judgeProposedSensor, lessonShortName, listMarkdownFilesRecursive, literalMatchesAllTokens, literalMatchesAnyToken, loadCodeMap, loadConfig, loadConfigSync, loadEvalHistory, loadFrictionState, loadMemoriesFromDir, loadMemoriesFromDirDetailed, loadMemory, loadPreventionEvents, loadSensorLedger, loadUsageIndex, looksLikeGenericAdvice, meetsSeedQualityFloor, memoryFilePath, memoryHasExcludedTag, memoryMatchesAnchorPaths, mergeHotFiles, mergeMemoryVersions, mineSensorSeedFromDiff, moduleNameOf, newMemoryId, normalizeChurnPath, normalizeFindingSeverity, normalizeFramework, normalizeFrictionSummary, normalizeKind, normalizeScaffoldStyle, normalizeSessionId, overallScore, parseEslintJson, parseFileAst, parseFindings, parseLessonFields, parseMemory, parseNpmAudit, parseSarif, parseSince, parseSonar, pathsOverlap, pickSnippetNeedle, pickTestFramework, planConflictResolution, planGitWatch, prepareBridgeData, preventionLogPath, priorityRank, prioritySignals, projectContextRecentlyEmitted, proposeGateMissDrafts, proposeSeedsFromCommits, pullCrossRepoSources, quarantineNote, queryCodeMap, rankMemoriesLexical, readFrictionReports, readRecentBriefingMarker, readRuntimeJournalTail, readSessionHandoff, readUsageEvents, recapBriefingExcerpt, recommendFeedbackAdjustment, recordApplied, recordGateReminder, recordPrevention, recordPreventionHits, recordProjectContextEmission, recordRejection, relPathFrom, renderBehaviourCoverageLine, renderBootstrapChecklist, renderCaughtForYou, renderPreventionComment, renderPreventionReceipt, renderPreventionReceiptShare, resolveBriefingBudget, resolveConfigPath, resolveGatePolicy, resolveHaivePaths, resolveManifestFiles, resolveProjectInfo, retirementSignal, revertedShaFromCommit, reviewLearningsToDrafts, runPresenceSensors, runRegexSensor, runSensors, runTierContract, runValidationContract, runtimeJournalPath, saveCodeMap, saveConfig, saveFrictionState, saveUsageIndex, scaffoldPostIncidentTest, scannableSensorTargets, scoreRetrievalCase, scoreSensorCase, scrubbedCommandEnv, selectCommandSensors, sensorAppliesToPath, sensorLedgerPath, sensorPatternBrittleness, sensorPromotedAtMap, sensorSelfCheck, sensorTargetsFromDiff, serializeCodeMap, serializeMemory, setFrictionStatus, shouldExpandGateReminder, snapshotContract, specificityScore, stripCommentsForScan, stripPrivate, suggestGate, suggestSensorFromMemory, suggestSensorSeed, suggestTopicKey, summarizeCaughtForYou, summarizeImpact, synthesizeSelfEvalCases, tallyHotFiles, titleFromBody, tokenizeQuery, tokenizeWords, trackDependencies, trackReads, truncateToTokens, usageLogPath, usageLogSize, usagePath, verifyAnchor, watchContracts, withQuarantineNote, withoutQuarantineNote, writeBriefingMarker, writeSessionHandoff };

package/dist/index.js

@@ -517,6 +517,22 @@ function globLiteralPrefix(pattern) {
   const slash = norm.slice(0, firstGlob).lastIndexOf("/");
   return slash < 0 ? "" : norm.slice(0, slash);
 }
+var ADAPTIVE_FLOOR_MIN_SAMPLES = 12;
+function adaptiveSemanticFloor(scores, explicitFloor = 0) {
+  if (scores.length < ADAPTIVE_FLOOR_MIN_SAMPLES) return explicitFloor;
+  let sum = 0;
+  let top = -Infinity;
+  for (const s of scores) {
+    sum += s;
+    if (s > top) top = s;
+  }
+  const mean = sum / scores.length;
+  let variance = 0;
+  for (const s of scores) variance += (s - mean) ** 2;
+  const std = Math.sqrt(variance / scores.length);
+  const distributional = mean + 0.5 * std;
+  return Math.max(explicitFloor, Math.min(distributional, top - 1e-6));
+}
 function relPathFrom(root, abs) {
   return path3.relative(root, abs).replace(/\\/g, "/");
 }
@@ -1096,6 +1112,7 @@ function renderPreventionReceiptShare(receipt) {
 var PREVENTION_RECEIPT_MARKER = "<!-- haive:prevention-receipt -->";
 function renderPreventionComment(receipt, findings = []) {
   const fired = findings.filter((f) => f.code === "sensor-block" || f.code === "sensor-warn");
+  if (fired.length === 0 && receipt.total === 0) return "";
   const lines = [PREVENTION_RECEIPT_MARKER, "", "## Hivelore prevention receipt", ""];
   if (fired.length === 0) {
     lines.push("No documented sensor fired on this PR.", "");
@@ -1803,7 +1820,7 @@ function generateBridges(memories, sensors, opts) {
 
 // src/sensors.ts
 function sensorPatternBrittleness(pattern) {
-  const literal = pattern.replace(/\\[a-zA-Z]/g, " ").replace(/\[[^\]]*\]/g, " ").replace(/\{[^}]*\}/g, " ").replace(/\b\d{1,3}(?:\s*\\?\.\s*\d{1,3}){2,3}\b/g, " ");
+  const literal = pattern.replace(/(?:\/|%|\\[/*]|\[[^\]]*[/*][^\]]*\])[^\d]{0,4}\d{3,}/g, " ").replace(/\\[a-zA-Z]/g, " ").replace(/\[[^\]]*\]/g, " ").replace(/\{[^}]*\}/g, " ").replace(/\b\d{1,3}(?:\s*\\?\.\s*\d{1,3}){2,3}\b/g, " ");
   const range = literal.match(/\d{2,}\s*-\s*\d{2,}/);
   if (range) return `hardcoded line/number range "${range[0].replace(/\s+/g, "")}" \u2014 rots when code shifts`;
   const numeric = literal.match(/\d{3,}/);
@@ -1846,20 +1863,137 @@ function compileAbsentRegex(sensor) {
     return null;
   }
 }
+var C_FAMILY = { line: ["//"], block: ["/*", "*/"], starContinuation: true };
+var HASH_FAMILY = { line: ["#"], block: null, starContinuation: false };
+var CSS_FAMILY = { line: [], block: ["/*", "*/"], starContinuation: true };
+var SCSS_FAMILY = { line: ["//"], block: ["/*", "*/"], starContinuation: true };
+var SQL_FAMILY = { line: ["--"], block: ["/*", "*/"], starContinuation: false };
+var HTML_FAMILY = { line: [], block: ["<!--", "-->"], starContinuation: false };
+var COMMENT_SYNTAX_BY_EXT = {
+  ts: C_FAMILY,
+  tsx: C_FAMILY,
+  js: C_FAMILY,
+  jsx: C_FAMILY,
+  mjs: C_FAMILY,
+  cjs: C_FAMILY,
+  java: C_FAMILY,
+  c: C_FAMILY,
+  h: C_FAMILY,
+  cpp: C_FAMILY,
+  hpp: C_FAMILY,
+  cc: C_FAMILY,
+  hh: C_FAMILY,
+  cs: C_FAMILY,
+  go: C_FAMILY,
+  rs: C_FAMILY,
+  kt: C_FAMILY,
+  kts: C_FAMILY,
+  swift: C_FAMILY,
+  scala: C_FAMILY,
+  php: C_FAMILY,
+  dart: C_FAMILY,
+  m: C_FAMILY,
+  mm: C_FAMILY,
+  py: HASH_FAMILY,
+  rb: HASH_FAMILY,
+  sh: HASH_FAMILY,
+  bash: HASH_FAMILY,
+  zsh: HASH_FAMILY,
+  yml: HASH_FAMILY,
+  yaml: HASH_FAMILY,
+  toml: HASH_FAMILY,
+  properties: HASH_FAMILY,
+  conf: HASH_FAMILY,
+  cfg: HASH_FAMILY,
+  pl: HASH_FAMILY,
+  pm: HASH_FAMILY,
+  r: HASH_FAMILY,
+  css: CSS_FAMILY,
+  scss: SCSS_FAMILY,
+  less: SCSS_FAMILY,
+  sql: SQL_FAMILY,
+  html: HTML_FAMILY,
+  htm: HTML_FAMILY,
+  xml: HTML_FAMILY,
+  vue: HTML_FAMILY,
+  svelte: HTML_FAMILY,
+  md: HTML_FAMILY,
+  markdown: HTML_FAMILY
+};
+function commentSyntaxForPath(path22) {
+  const base = path22.split(/[\\/]/).pop() ?? "";
+  const dot = base.lastIndexOf(".");
+  if (dot < 0) return null;
+  return COMMENT_SYNTAX_BY_EXT[base.slice(dot + 1).toLowerCase()] ?? null;
+}
+function blankCommentsOnLine(line, syntax) {
+  if (syntax.starContinuation && /^\*(\s|\/|$)/.test(line.trimStart())) {
+    return " ".repeat(line.length);
+  }
+  let out = "";
+  let stringDelim = null;
+  for (let i = 0; i < line.length; i++) {
+    const ch = line[i];
+    if (stringDelim) {
+      out += ch;
+      if (ch === "\\" && i + 1 < line.length) {
+        out += line[i + 1];
+        i++;
+        continue;
+      }
+      if (ch === stringDelim) stringDelim = null;
+      continue;
+    }
+    if (ch === '"' || ch === "'" || ch === "`") {
+      stringDelim = ch;
+      out += ch;
+      continue;
+    }
+    if (syntax.block) {
+      const [open, close] = syntax.block;
+      if (line.startsWith(open, i)) {
+        const closeIdx = line.indexOf(close, i + open.length);
+        const end = closeIdx === -1 ? line.length : closeIdx + close.length;
+        out += " ".repeat(end - i);
+        if (closeIdx === -1) break;
+        i = end - 1;
+        continue;
+      }
+    }
+    let hitLineComment = false;
+    for (const lc of syntax.line) {
+      if (line.startsWith(lc, i)) {
+        out += " ".repeat(line.length - i);
+        hitLineComment = true;
+        break;
+      }
+    }
+    if (hitLineComment) break;
+    out += ch;
+  }
+  return out;
+}
+function stripCommentsForScan(content, path22) {
+  const syntax = commentSyntaxForPath(path22);
+  if (!syntax) return content;
+  return content.split("\n").map((l) => blankCommentsOnLine(l, syntax)).join("\n");
+}
 function runRegexSensor(memoryId, sensor, target) {
   const re = compileRegexSensor(sensor);
   if (!re) return null;
   const absentRe = compileAbsentRegex(sensor);
-  const lines = target.content.split("\n");
-  for (let i = 0; i < lines.length; i++) {
-    const rawLine = lines[i];
+  const rawLines = target.content.split("\n");
+  const scanLines = stripCommentsForScan(target.content, target.path).split("\n");
+  for (let i = 0; i < rawLines.length; i++) {
+    const rawLine = rawLines[i];
+    const scanLine = scanLines[i] ?? rawLine;
     re.lastIndex = 0;
-    if (!re.test(rawLine)) continue;
+    if (!re.test(scanLine)) continue;
     if (absentRe) {
       const from = Math.max(0, i - SENSOR_ABSENT_LOOKBACK);
-      const to = Math.min(lines.length, i + SENSOR_ABSENT_WINDOW + 1);
+      const to = Math.min(scanLines.length, i + SENSOR_ABSENT_WINDOW + 1);
       absentRe.lastIndex = 0;
-      if (absentRe.test(lines.slice(from, to).join("\n"))) continue;
+      if (absentRe.test(scanLines.slice(from, to).join("\n"))) continue;
     }
     const brittle = sensor.kind === "regex" && sensor.pattern ? sensorPatternBrittleness(sensor.pattern) : null;
     const severity = brittle ? "warn" : sensor.severity;
@@ -5016,8 +5150,20 @@ function extractActionsBriefBody(markdown, maxChars = MAX_DEFAULT_CHARS) {
     buf.push(t);
   }
   if (buf.length) paragraphs.push(buf.join(" ").trim());
-  let out = paragraphs[0] ?? stripped.slice(0, maxChars);
-  if (!out.trim()) out = stripped.slice(0, maxChars);
+  if (paragraphs.length === 0) {
+    let out2 = stripped.slice(0, maxChars);
+    if (out2.length > maxChars) out2 = out2.slice(0, maxChars).trimEnd() + "\u2026";
+    return out2;
+  }
+  const collected = [];
+  let length = 0;
+  for (const paragraph of paragraphs) {
+    const cost = (collected.length ? 2 : 0) + paragraph.length;
+    if (collected.length > 0 && length + cost > maxChars) break;
+    collected.push(paragraph);
+    length += cost;
+  }
+  let out = collected.join("\n\n");
   if (out.length > maxChars) out = out.slice(0, maxChars).trimEnd() + "\u2026";
   return out;
 }
@@ -7080,10 +7226,7 @@ Subject: ${seed.what}
 **Why it failed / do NOT use:** ${seed.why_failed}
 `;
     const gateLine = gatePassed ? "\nThe gate PASSED this commit \u2014 a validated sensor here upgrades the harness.\n" : "";
-    const candidate = suggestSensorSeed(seed.what, paths);
-    const sensorHint = candidate ? `
-proposed_sensor_seed: ${JSON.stringify(candidate)}
-` : "\nproposed_sensor_seed: inspect the revert diff, then author a deterministic candidate with `hivelore sensors propose <id>`.\n";
+    const sensorHint = "\nproposed_sensor_seed: inspect the revert diff, then author a deterministic candidate with `hivelore sensors propose --from-fix <revert-sha>` (it mines the fix diff and validates).\n";
     out.push({
       slug: `gate-miss-${failedSha.slice(0, 12)}`,
       reverted_sha: failedSha,
@@ -7220,6 +7363,20 @@ _No notable discoveries captured. Run post_task / \`mem_session_end\` for a rich
 **Discoveries:**
 ${trimmed}`;
 }
+function recapBriefingExcerpt(body, maxChars = 700) {
+  if (isAutoRecap(body)) return compactAutoRecapBody(body);
+  const section = (name) => body.match(name)?.[1]?.trim() ?? "";
+  const goal = section(/##+\s*Goal[^\n]*\n+([\s\S]*?)(?=\n##+\s|\n*$)/i);
+  const next = section(/##+\s*Next steps?[^\n]*\n([\s\S]*?)(?=\n##+\s|\n*$)/i);
+  if (!goal && !next) return body.length > maxChars ? body.slice(0, maxChars).trimEnd() + "\u2026" : body;
+  const parts = [];
+  if (goal) parts.push(`_${goal.split("\n")[0].trim()}_`);
+  parts.push(next ? `**Next steps:**
+${next}` : "_No next steps recorded \u2014 `mem_get <id>` for the full recap._");
+  let out = parts.join("\n\n");
+  if (out.length > maxChars) out = out.slice(0, maxChars).trimEnd() + "\u2026";
+  return out;
+}
 
 // src/handoff.ts
 import { writeFile as writeFile13, readFile as readFile18, stat as stat4 } from "fs/promises";
@@ -7400,6 +7557,7 @@ ${learning.instruction}
   return drafts;
 }
 export {
+  ADAPTIVE_FLOOR_MIN_SAMPLES,
   AUTOPILOT_DEFAULTS,
   ActivationSchema,
   AnchorSchema,
@@ -7462,6 +7620,7 @@ export {
   USAGE_LOG_DIR,
   USAGE_LOG_FILE,
   WEAK_ANCHOR_CHURN_RATIO,
+  adaptiveSemanticFloor,
   addedLineNumbersFromDiff,
   addedLinesFromDiff,
   aggregateRetrieval,
@@ -7664,6 +7823,7 @@ export {
   readRuntimeJournalTail,
   readSessionHandoff,
   readUsageEvents,
+  recapBriefingExcerpt,
   recommendFeedbackAdjustment,
   recordApplied,
   recordGateReminder,
@@ -7715,6 +7875,7 @@ export {
   shouldExpandGateReminder,
   snapshotContract,
   specificityScore,
+  stripCommentsForScan,
   stripPrivate,
   suggestGate,
   suggestSensorFromMemory,