@hivelore/core 0.58.1 → 0.60.0

package/dist/index.d.ts

@@ -64,6 +64,14 @@ declare const SensorSchema: z.ZodObject<{
     timeout_ms: z.ZodOptional<z.ZodNumber>;
     /** Glob-ish path prefixes the sensor applies to. Falls back to the memory's anchor paths when empty. */
     paths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * Glob-ish paths the sensor must NOT fire on, even when they fall inside `paths`. Lets a
+     * production-only lesson (e.g. "no `any`") skip test doubles and fixtures without narrowing its
+     * scope file by file — the missing negation that made `paths: ['**']` fire on every `.test.ts`
+     * (field report 2026-09-02 §3.2). A lesson that IS about tests (e.g. "no `LocalDate.now()` in a
+     * test") simply leaves this empty, so it still fires there.
+     */
+    exclude: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     /** LLM-facing self-correction message: what was done wrong and what to do instead. */
     message: z.ZodString;
     /**
@@ -108,6 +116,7 @@ declare const SensorSchema: z.ZodObject<{
     require_present?: boolean | undefined;
     command?: string | undefined;
     timeout_ms?: number | undefined;
+    exclude?: string[] | undefined;
     incident?: string | undefined;
     red_proven?: boolean | undefined;
     promoted_at?: string | undefined;
@@ -123,6 +132,7 @@ declare const SensorSchema: z.ZodObject<{
     require_present?: boolean | undefined;
     command?: string | undefined;
     timeout_ms?: number | undefined;
+    exclude?: string[] | undefined;
     incident?: string | undefined;
     red_proven?: boolean | undefined;
     severity?: "warn" | "block" | undefined;
@@ -213,6 +223,14 @@ declare const MemoryFrontmatterSchema: z.ZodEffects<z.ZodObject<{
         timeout_ms: z.ZodOptional<z.ZodNumber>;
         /** Glob-ish path prefixes the sensor applies to. Falls back to the memory's anchor paths when empty. */
         paths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        /**
+         * Glob-ish paths the sensor must NOT fire on, even when they fall inside `paths`. Lets a
+         * production-only lesson (e.g. "no `any`") skip test doubles and fixtures without narrowing its
+         * scope file by file — the missing negation that made `paths: ['**']` fire on every `.test.ts`
+         * (field report 2026-09-02 §3.2). A lesson that IS about tests (e.g. "no `LocalDate.now()` in a
+         * test") simply leaves this empty, so it still fires there.
+         */
+        exclude: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         /** LLM-facing self-correction message: what was done wrong and what to do instead. */
         message: z.ZodString;
         /**
@@ -257,6 +275,7 @@ declare const MemoryFrontmatterSchema: z.ZodEffects<z.ZodObject<{
         require_present?: boolean | undefined;
         command?: string | undefined;
         timeout_ms?: number | undefined;
+        exclude?: string[] | undefined;
         incident?: string | undefined;
         red_proven?: boolean | undefined;
         promoted_at?: string | undefined;
@@ -272,6 +291,7 @@ declare const MemoryFrontmatterSchema: z.ZodEffects<z.ZodObject<{
         require_present?: boolean | undefined;
         command?: string | undefined;
         timeout_ms?: number | undefined;
+        exclude?: string[] | undefined;
         incident?: string | undefined;
         red_proven?: boolean | undefined;
         severity?: "warn" | "block" | undefined;
@@ -370,6 +390,7 @@ declare const MemoryFrontmatterSchema: z.ZodEffects<z.ZodObject<{
         require_present?: boolean | undefined;
         command?: string | undefined;
         timeout_ms?: number | undefined;
+        exclude?: string[] | undefined;
         incident?: string | undefined;
         red_proven?: boolean | undefined;
         promoted_at?: string | undefined;
@@ -407,6 +428,7 @@ declare const MemoryFrontmatterSchema: z.ZodEffects<z.ZodObject<{
         require_present?: boolean | undefined;
         command?: string | undefined;
         timeout_ms?: number | undefined;
+        exclude?: string[] | undefined;
         incident?: string | undefined;
         red_proven?: boolean | undefined;
         severity?: "warn" | "block" | undefined;
@@ -468,6 +490,7 @@ declare const MemoryFrontmatterSchema: z.ZodEffects<z.ZodObject<{
         require_present?: boolean | undefined;
         command?: string | undefined;
         timeout_ms?: number | undefined;
+        exclude?: string[] | undefined;
         incident?: string | undefined;
         red_proven?: boolean | undefined;
         promoted_at?: string | undefined;
@@ -505,6 +528,7 @@ declare const MemoryFrontmatterSchema: z.ZodEffects<z.ZodObject<{
         require_present?: boolean | undefined;
         command?: string | undefined;
         timeout_ms?: number | undefined;
+        exclude?: string[] | undefined;
         incident?: string | undefined;
         red_proven?: boolean | undefined;
         severity?: "warn" | "block" | undefined;
@@ -2725,6 +2749,11 @@ interface SensorTarget {
  * Does this sensor apply to `path`? A sensor with no explicit `paths` (and whose
  * memory has no anchor paths) applies everywhere. Otherwise it applies to the exact
  * file, a directory prefix, or a glob (`**` / `*.controller.ts` style) scope.
+ *
+ * Two guards keep a rule from firing where it can only be a false positive: an explicit `exclude`
+ * glob list (a production-only lesson skips its own test doubles), and a built-in skip of
+ * DOCUMENTATION files for content sensors — example code in a `.md`/`.rst` is never shipped, so a
+ * regex/ast match there is always wrong unless the sensor names that exact file.
  */
 declare function sensorAppliesToPath(sensor: Sensor, anchorPaths: string[], path: string): boolean;
 /**
@@ -2745,21 +2774,41 @@ declare const SENSOR_ABSENT_LOOKBACK = 2;
 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.
+ * documents it — including MULTI-LINE block comments whose forbidden token sits on a middle line
+ * that starts with neither the opener nor `*` (field report 2026-09-04 §3.1: a `bg-emerald-600` in a
+ * multi-line CSS comment still tripped the sensor because the earlier fix was purely per-line).
+ * Returns `content` unchanged for unknown file types. Pure.
  */
 declare function stripCommentsForScan(content: string, path: string): string;
+/**
+ * An inline waiver a developer wrote to excuse ONE line from ONE sensor, recorded so the exception
+ * is auditable rather than silent. Field report 2026-09-04 §3.1: a false positive had no outlet
+ * other than rewriting correct code or deleting the sensor — and "a linter with no exception
+ * mechanism ends up disabled", which costs the whole rule, not one line.
+ */
+interface SensorWaiver {
+    memory_id: string;
+    /** Project-relative file the waiver was used in. */
+    file?: string;
+    /** The waived line, trimmed and capped. */
+    line: string;
+    /** The reason the author gave after the slug. Never empty — a reasonless waiver does not apply. */
+    reason: string;
+}
+declare function sensorWaiverOnLine(memoryId: string, rawLine: string): string | null;
 /**
  * Run a single regex sensor over one target. Returns the first matching line as a hit,
- * or null. Deterministic and side-effect-free.
+ * or null. Deterministic and side-effect-free — waivers found along the way are pushed into the
+ * optional `waivers` sink so the caller can journal them (the exception stays visible).
  */
-declare function runRegexSensor(memoryId: string, sensor: Sensor, target: SensorTarget): SensorHit | null;
+declare function runRegexSensor(memoryId: string, sensor: Sensor, target: SensorTarget, waivers?: SensorWaiver[]): SensorHit | null;
 /**
  * Run every memory's regex sensor against every applicable target.
  *
  * Memories without a sensor, or with a non-regex sensor, are skipped (non-regex kinds
  * are the CLI's responsibility). At most one hit per (memory, file) pair is returned.
  */
-declare function runSensors(memories: Memory[], targets: SensorTarget[]): SensorHit[];
+declare function runSensors(memories: Memory[], targets: SensorTarget[], waivers?: SensorWaiver[]): SensorHit[];
 /**
  * Parse every touched file path out of a unified diff (`diff --git a/X b/X` headers), including
  * files changed by pure DELETIONS — the case a presence sensor exists for. Pure.
@@ -4189,4 +4238,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 { 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, RECAP_HISTORY_HEADING, RECAP_HISTORY_MAX, 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, buildRecapWithHistory, 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 };
+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, RECAP_HISTORY_HEADING, RECAP_HISTORY_MAX, 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 SensorWaiver, 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, buildRecapWithHistory, 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, sensorWaiverOnLine, 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

@@ -64,6 +64,14 @@ var SensorSchema = z.object({
   timeout_ms: z.number().int().positive().optional(),
   /** Glob-ish path prefixes the sensor applies to. Falls back to the memory's anchor paths when empty. */
   paths: z.array(z.string()).default([]),
+  /**
+   * Glob-ish paths the sensor must NOT fire on, even when they fall inside `paths`. Lets a
+   * production-only lesson (e.g. "no `any`") skip test doubles and fixtures without narrowing its
+   * scope file by file — the missing negation that made `paths: ['**']` fire on every `.test.ts`
+   * (field report 2026-09-02 §3.2). A lesson that IS about tests (e.g. "no `LocalDate.now()` in a
+   * test") simply leaves this empty, so it still fires there.
+   */
+  exclude: z.array(z.string()).optional(),
   /** LLM-facing self-correction message: what was done wrong and what to do instead. */
   message: z.string().min(1),
   /**
@@ -960,7 +968,7 @@ function applyFeedbackAdjustment(fm, adjustment, now = /* @__PURE__ */ new Date(
 }
 
 // src/prevention.ts
-import { appendFile, mkdir as mkdir2, readFile as readFile4, writeFile as writeFile2 } from "fs/promises";
+import { appendFile, mkdir as mkdir2, readFile as readFile4 } from "fs/promises";
 import { existsSync as existsSync4 } from "fs";
 import path6 from "path";
 function preventionLogPath(paths) {
@@ -988,22 +996,8 @@ async function recordPreventionHits(paths, firedIds, source, now = /* @__PURE__
     await appendPreventionEvent(paths, { at, id, source, ...details[id] }).catch(() => {
     });
   }
-  await stampSensorLastFired(paths, recordedIds, at).catch(() => {
-  });
   return recordedIds;
 }
-async function stampSensorLastFired(paths, ids, at) {
-  if (ids.length === 0 || !existsSync4(paths.memoriesDir)) return;
-  const wanted = new Set(ids);
-  const loaded = await loadMemoriesFromDir(paths.memoriesDir);
-  for (const { memory, filePath } of loaded) {
-    const fm = memory.frontmatter;
-    if (!wanted.has(fm.id) || !fm.sensor || fm.sensor.last_fired === at) continue;
-    const next = { ...memory, frontmatter: { ...fm, sensor: { ...fm.sensor, last_fired: at } } };
-    await writeFile2(filePath, serializeMemory(next), "utf8").catch(() => {
-    });
-  }
-}
 function buildPreventionReceipt(events, memories, usage, options) {
   const now = options.now ?? /* @__PURE__ */ new Date();
   const sinceMs = options.since.getTime();
@@ -1704,6 +1698,11 @@ function bridgeMemorySummary(body) {
   const oneLine2 = firstLine.replace(/\s+/g, " ");
   return oneLine2.length > 140 ? oneLine2.slice(0, 137) + "\u2026" : oneLine2;
 }
+function breadcrumbTypeRank(type) {
+  if (type === "attempt") return 0;
+  if (type === "architecture" || type === "decision") return 1;
+  return 2;
+}
 function prepareBridgeData(memories, sensors, opts) {
   const max = opts?.maxMemories ?? 8;
   const topMemories = memories.filter((m) => {
@@ -1713,8 +1712,12 @@ function prepareBridgeData(memories, sensors, opts) {
     if (m.frontmatter.tags?.includes("stack-pack") || m.frontmatter.tags?.includes("seed")) return false;
     return s === "validated" || s === "proposed";
   }).sort((a, b) => {
-    const score = (m) => m.frontmatter.status === "validated" ? 2 : 1;
-    return score(b) - score(a);
+    const statusScore = (m) => m.frontmatter.status === "validated" ? 0 : 1;
+    const s = statusScore(a) - statusScore(b);
+    if (s !== 0) return s;
+    const r = breadcrumbTypeRank(a.frontmatter.type) - breadcrumbTypeRank(b.frontmatter.type);
+    if (r !== 0) return r;
+    return b.frontmatter.id.localeCompare(a.frontmatter.id);
   }).slice(0, max).map((m) => ({
     id: m.frontmatter.id,
     scope: m.frontmatter.scope,
@@ -1753,12 +1756,15 @@ function renderSensorsBlock(blockSensors) {
     "",
     "The patterns below are blocked by the repo enforcement gate.",
     "Introducing them will fail the pre-commit check (`hivelore enforce check`).",
+    "",
+    "Wrong about one specific line? Waive that line \u2014 `// hivelore:allow <memory-id> \u2014 <reason>` at",
+    "end of line \u2014 instead of deleting the rule or rewriting correct code. It covers that line only",
+    "and is reported. Repeating it means the scope is wrong: narrow `paths`/`exclude`/`absent`.",
     ""
   ];
   for (const s of blockSensors) {
     const pathNote = s.paths.length > 0 ? ` _(applies to: ${s.paths.join(", ")})_` : "";
     lines.push(`- **${s.id}**${pathNote}: ${s.message}`);
-    if (s.pattern) lines.push(`  - Pattern: \`${s.pattern}\``);
   }
   lines.push("", BRIDGE_MARKERS.sensorsEnd);
   return lines.join("\n");
@@ -1833,15 +1839,26 @@ function normalizeProjectPath(value) {
   return value.replace(/\\/g, "/").replace(/^\.\//, "").replace(/^[ab]\//, "").replace(/\/+$/g, "");
 }
 function sensorAppliesToPath(sensor, anchorPaths, path22) {
-  const scopes = sensor.paths.length > 0 ? sensor.paths : anchorPaths;
-  if (scopes.length === 0) return true;
   const target = normalizeProjectPath(path22);
-  return scopes.some((rawScope) => {
+  const matchesScope = (rawScope) => {
     const scope = normalizeProjectPath(rawScope);
     if (!scope) return false;
     if (isGlobPath(scope)) return globToRegExp(scope).test(target);
     return target === scope || target.startsWith(`${scope}/`);
-  });
+  };
+  if (sensor.exclude?.some(matchesScope)) return false;
+  const scopes = sensor.paths.length > 0 ? sensor.paths : anchorPaths;
+  if ((sensor.kind === "regex" || sensor.kind === "ast") && isDocumentationPath(target)) {
+    return scopes.map(normalizeProjectPath).includes(target);
+  }
+  if (scopes.length === 0) return true;
+  return scopes.some(matchesScope);
+}
+var DOCUMENTATION_EXTENSIONS = /* @__PURE__ */ new Set(["md", "mdx", "markdown", "rst", "txt", "adoc"]);
+function isDocumentationPath(target) {
+  const base = target.split("/").pop() ?? "";
+  const dot = base.lastIndexOf(".");
+  return dot >= 0 && DOCUMENTATION_EXTENSIONS.has(base.slice(dot + 1).toLowerCase());
 }
 var SENSOR_ABSENT_WINDOW = 6;
 var SENSOR_ABSENT_LOOKBACK = 2;
@@ -1926,13 +1943,21 @@ function commentSyntaxForPath(path22) {
   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);
-  }
+function blankCommentsOnLine(line, syntax, inBlock) {
   let out = "";
   let stringDelim = null;
-  for (let i = 0; i < line.length; i++) {
+  let i = 0;
+  if (inBlock) {
+    if (!syntax.block) return { text: line, inBlock: false };
+    const close = syntax.block[1];
+    const closeIdx = line.indexOf(close);
+    if (closeIdx === -1) return { text: " ".repeat(line.length), inBlock: true };
+    out += " ".repeat(closeIdx + close.length);
+    i = closeIdx + close.length;
+  } else if (syntax.starContinuation && /^\*(\s|\/|$)/.test(line.trimStart())) {
+    return { text: " ".repeat(line.length), inBlock: false };
+  }
+  for (; i < line.length; i++) {
     const ch = line[i];
     if (stringDelim) {
       out += ch;
@@ -1953,9 +1978,12 @@ function blankCommentsOnLine(line, syntax) {
       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;
+        if (closeIdx === -1) {
+          out += " ".repeat(line.length - i);
+          return { text: out, inBlock: true };
+        }
+        const end = closeIdx + close.length;
         out += " ".repeat(end - i);
-        if (closeIdx === -1) break;
         i = end - 1;
         continue;
       }
@@ -1971,14 +1999,32 @@ function blankCommentsOnLine(line, syntax) {
     if (hitLineComment) break;
     out += ch;
   }
-  return out;
+  return { text: out, inBlock: false };
 }
 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) {
+  let inBlock = false;
+  const out = [];
+  for (const line of content.split("\n")) {
+    const res = blankCommentsOnLine(line, syntax, inBlock);
+    out.push(res.text);
+    inBlock = res.inBlock;
+  }
+  return out.join("\n");
+}
+var WAIVER_MARKER = /hivelore:allow\s+([A-Za-z0-9._/-]+)(?=\s|$)\s*[—–:-]*\s*(.*)$/i;
+function sensorWaiverOnLine(memoryId, rawLine) {
+  const m = WAIVER_MARKER.exec(rawLine);
+  if (!m) return null;
+  const slug = (m[1] ?? "").toLowerCase();
+  const reason = (m[2] ?? "").replace(/(?:\*\/|-->|#>)\s*$/, "").trim();
+  if (!slug || !reason) return null;
+  const id = memoryId.toLowerCase();
+  if (id !== slug && !id.includes(slug)) return null;
+  return reason;
+}
+function runRegexSensor(memoryId, sensor, target, waivers) {
   const re = compileRegexSensor(sensor);
   if (!re) return null;
   const absentRe = compileAbsentRegex(sensor);
@@ -1995,6 +2041,16 @@ function runRegexSensor(memoryId, sensor, target) {
       absentRe.lastIndex = 0;
       if (absentRe.test(scanLines.slice(from, to).join("\n"))) continue;
     }
+    const waivedReason = sensorWaiverOnLine(memoryId, rawLine);
+    if (waivedReason) {
+      waivers?.push({
+        memory_id: memoryId,
+        file: target.path,
+        line: rawLine.trim().slice(0, 200),
+        reason: waivedReason
+      });
+      continue;
+    }
     const brittle = sensor.kind === "regex" && sensor.pattern ? sensorPatternBrittleness(sensor.pattern) : null;
     const severity = brittle ? "warn" : sensor.severity;
     return {
@@ -2008,7 +2064,7 @@ function runRegexSensor(memoryId, sensor, target) {
   }
   return null;
 }
-function runSensors(memories, targets) {
+function runSensors(memories, targets, waivers) {
   const hits = [];
   for (const memory of memories) {
     const sensor = memory.frontmatter.sensor;
@@ -2017,7 +2073,7 @@ function runSensors(memories, targets) {
     const anchorPaths = memory.frontmatter.anchor.paths;
     for (const target of targets) {
       if (!sensorAppliesToPath(sensor, anchorPaths, target.path)) continue;
-      const hit = runRegexSensor(memory.frontmatter.id, sensor, target);
+      const hit = runRegexSensor(memory.frontmatter.id, sensor, target, waivers);
       if (hit) hits.push(hit);
     }
   }
@@ -7900,6 +7956,7 @@ export {
   sensorPromotedAtMap,
   sensorSelfCheck,
   sensorTargetsFromDiff,
+  sensorWaiverOnLine,
   serializeCodeMap,
   serializeMemory,
   setFrictionStatus,