@hivelore/core 0.34.1 → 0.35.1

package/dist/index.d.ts

@@ -55,6 +55,13 @@ declare const SensorSchema: z.ZodObject<{
     autogen: z.ZodDefault<z.ZodBoolean>;
     /** ISO timestamp of the last time this sensor matched a diff. */
     last_fired: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    /**
+     * ISO timestamp of the last manual `sensors promote` back to block. Health assessment ignores
+     * ledger evaluations older than this — without it, a promoted sensor whose oracle was FIXED is
+     * re-quarantined on the next commit for up to 30 days (the stale flaps are still in the window),
+     * making the promotion promised by the quarantine note a no-op.
+     */
+    promoted_at: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     message: string;
     paths: string[];
@@ -67,6 +74,7 @@ declare const SensorSchema: z.ZodObject<{
     flags?: string | undefined;
     command?: string | undefined;
     timeout_ms?: number | undefined;
+    promoted_at?: string | undefined;
 }, {
     message: string;
     paths?: string[] | undefined;
@@ -79,6 +87,7 @@ declare const SensorSchema: z.ZodObject<{
     severity?: "warn" | "block" | undefined;
     autogen?: boolean | undefined;
     last_fired?: string | null | undefined;
+    promoted_at?: string | undefined;
 }>;
 /**
  * Progressive-disclosure activation triggers for a `skill` memory.
@@ -154,6 +163,13 @@ declare const MemoryFrontmatterSchema: z.ZodEffects<z.ZodObject<{
         autogen: z.ZodDefault<z.ZodBoolean>;
         /** ISO timestamp of the last time this sensor matched a diff. */
         last_fired: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        /**
+         * ISO timestamp of the last manual `sensors promote` back to block. Health assessment ignores
+         * ledger evaluations older than this — without it, a promoted sensor whose oracle was FIXED is
+         * re-quarantined on the next commit for up to 30 days (the stale flaps are still in the window),
+         * making the promotion promised by the quarantine note a no-op.
+         */
+        promoted_at: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         message: string;
         paths: string[];
@@ -166,6 +182,7 @@ declare const MemoryFrontmatterSchema: z.ZodEffects<z.ZodObject<{
         flags?: string | undefined;
         command?: string | undefined;
         timeout_ms?: number | undefined;
+        promoted_at?: string | undefined;
     }, {
         message: string;
         paths?: string[] | undefined;
@@ -178,6 +195,7 @@ declare const MemoryFrontmatterSchema: z.ZodEffects<z.ZodObject<{
         severity?: "warn" | "block" | undefined;
         autogen?: boolean | undefined;
         last_fired?: string | null | undefined;
+        promoted_at?: string | undefined;
     }>>;
     /** Optional progressive-disclosure triggers — only meaningful for `type: skill`. */
     activation: z.ZodOptional<z.ZodObject<{
@@ -257,6 +275,7 @@ declare const MemoryFrontmatterSchema: z.ZodEffects<z.ZodObject<{
         flags?: string | undefined;
         command?: string | undefined;
         timeout_ms?: number | undefined;
+        promoted_at?: string | undefined;
     } | undefined;
     activation?: {
         keywords: string[];
@@ -290,6 +309,7 @@ declare const MemoryFrontmatterSchema: z.ZodEffects<z.ZodObject<{
         severity?: "warn" | "block" | undefined;
         autogen?: boolean | undefined;
         last_fired?: string | null | undefined;
+        promoted_at?: string | undefined;
     } | undefined;
     activation?: {
         keywords?: string[] | undefined;
@@ -341,6 +361,7 @@ declare const MemoryFrontmatterSchema: z.ZodEffects<z.ZodObject<{
         flags?: string | undefined;
         command?: string | undefined;
         timeout_ms?: number | undefined;
+        promoted_at?: string | undefined;
     } | undefined;
     activation?: {
         keywords: string[];
@@ -374,6 +395,7 @@ declare const MemoryFrontmatterSchema: z.ZodEffects<z.ZodObject<{
         severity?: "warn" | "block" | undefined;
         autogen?: boolean | undefined;
         last_fired?: string | null | undefined;
+        promoted_at?: string | undefined;
     } | undefined;
     activation?: {
         keywords?: string[] | undefined;
@@ -652,7 +674,12 @@ interface PreventionEvent {
     id: string;
     /** Which gate path recorded it. */
     source: PreventionSource;
+    /** Optional detail for receipts; absent on logs written before v0.35.0. */
+    kind?: "regex" | "shell" | "test";
+    stage?: "pre-commit" | "pre-push" | "ci" | "manual";
+    exit_code?: number;
 }
+type PreventionEventDetail = Pick<PreventionEvent, "kind" | "stage" | "exit_code">;
 declare function preventionLogPath(paths: HaivePaths): string;
 /** Append one catch to the log. Best-effort, creates the dir on demand. */
 declare function appendPreventionEvent(paths: HaivePaths, event: PreventionEvent): Promise<void>;
@@ -668,7 +695,33 @@ declare function appendPreventionEvent(paths: HaivePaths, event: PreventionEvent
  * write must never break a commit, so failures are swallowed. Returns the ids actually recorded
  * (i.e. not debounced), so callers can report "caught for you" without re-counting.
  */
-declare function recordPreventionHits(paths: HaivePaths, firedIds: string[], source: PreventionSource, now?: Date): Promise<string[]>;
+declare function recordPreventionHits(paths: HaivePaths, firedIds: string[], source: PreventionSource, now?: Date, details?: Record<string, PreventionEventDetail>): Promise<string[]>;
+interface PreventionReceiptRow {
+    at: string;
+    id: string;
+    title: string;
+    source: PreventionSource;
+    kind: "regex" | "shell" | "test" | null;
+    stage: "pre-commit" | "pre-push" | "ci" | "manual" | null;
+    exit_code: number | null;
+    message: string | null;
+}
+interface PreventionReceipt {
+    generated_at: string;
+    since: string;
+    window_days: number;
+    total: number;
+    previous_total: number;
+    prevented_count_total: number;
+    trend: PreventionTrend;
+    events: PreventionReceiptRow[];
+}
+/** Stable, deterministic aggregation used by the CLI and the CI PR comment. */
+declare function buildPreventionReceipt(events: PreventionEvent[], memories: LoadedMemory[], usage: UsageIndex, options: {
+    since: Date;
+    now?: Date;
+}): PreventionReceipt;
+declare function renderPreventionReceipt(receipt: PreventionReceipt): string;
 /** Read all catch events (skips malformed lines). */
 declare function loadPreventionEvents(paths: HaivePaths): Promise<PreventionEvent[]>;
 interface PreventionTrend {
@@ -1965,6 +2018,68 @@ declare function extractSensorExamples(body: string): string[];
  */
 declare function addedLinesFromDiff(diff: string): string;
 
+type SensorEvaluationStage = "pre-commit" | "pre-push" | "ci" | "manual";
+type SensorEvaluationOutcome = "fired" | "silent" | "unrunnable";
+interface SensorEvaluation {
+    at: string;
+    memory_id: string;
+    kind: "regex" | "shell" | "test";
+    stage: SensorEvaluationStage;
+    head_sha: string;
+    scope_hash: string;
+    outcome: SensorEvaluationOutcome;
+    exit_code?: number;
+    duration_ms?: number;
+}
+interface SensorFlap {
+    memory_id: string;
+    scope_hash: string;
+    previous: SensorEvaluation;
+    current: SensorEvaluation;
+}
+interface SensorHealth {
+    memory_id: string;
+    flap_count: number;
+    flaps: SensorFlap[];
+    quarantine_pending: boolean;
+    never_fired: boolean;
+    evaluation_count: number;
+}
+declare function sensorLedgerPath(paths: HaivePaths): string;
+/** Append evaluations and compact the rolling window when needed. Never throws. */
+declare function appendSensorEvaluations(paths: HaivePaths, evaluations: SensorEvaluation[]): Promise<void>;
+/** Load valid ledger rows, optionally bounded by an ISO timestamp. Never throws. */
+declare function loadSensorLedger(paths: HaivePaths, opts?: {
+    since?: string;
+}): Promise<SensorEvaluation[]>;
+/** sha256(path + NUL + content), sorted by path. Missing files are ignored; empty scope is "". */
+declare function computeScopeHash(root: string, scopedFiles: string[]): string;
+/**
+ * Deterministic health assessment. A flap is an adjacent fired/silent outcome change for the same
+ * memory and identical scope hash inside the 30-day window. `unrunnable` rows never participate.
+ */
+declare function assessSensorHealth(evaluations: SensorEvaluation[], now?: Date, opts?: {
+    /**
+     * memory_id → ISO timestamp of the sensor's last manual promotion back to block
+     * (sensor.promoted_at). Evaluations at or before it are ignored: the promotion is the
+     * human's assertion that the oracle was fixed, so pre-promotion flaps must not
+     * re-quarantine it.
+     */
+    promotedAt?: ReadonlyMap<string, string>;
+}): SensorHealth[];
+/** Build the promoted_at map for {@link assessSensorHealth} from memory frontmatters. */
+declare function sensorPromotedAtMap(frontmatters: Iterable<{
+    id: string;
+    sensor?: {
+        promoted_at?: string;
+    } | null;
+}>): Map<string, string>;
+declare function quarantineNote(at: string, flapCount: number): string;
+/** Add or replace the single quarantine note. */
+declare function withQuarantineNote(body: string, at: string, flapCount: number): string;
+/** Manual promotion clears the machine-authored quarantine conclusion. */
+declare function withoutQuarantineNote(body: string): string;
+
 interface SensorSuggestionOptions {
     /** Extra paths to put on the sensor. Defaults to the memory anchor paths. */
     paths?: string[];
@@ -2537,6 +2652,10 @@ interface GitCommit {
     subject: string;
     /** Files touched by the commit (optional — improves anchoring). */
     files?: string[];
+    /** Full commit body when available (used to resolve `This reverts commit <sha>`). */
+    body?: string;
+    /** Explicit failed/reverted SHA when a caller already parsed it. */
+    reverted_sha?: string;
 }
 interface SeedProposal {
     /** Kebab-ish slug derived from the reverted subject. */
@@ -2560,6 +2679,45 @@ declare function isNoiseSubject(subject: string): boolean;
  */
 declare function proposeSeedsFromCommits(commits: GitCommit[], limit?: number): SeedProposal[];
 
+interface GitWatchState {
+    last_scanned_sha: string;
+}
+type GitWatchPlan = {
+    action: "initialize";
+    next: GitWatchState;
+} | {
+    action: "idle";
+    next: GitWatchState;
+} | {
+    action: "scan";
+    range: string;
+    next: GitWatchState;
+};
+declare function planGitWatch(state: GitWatchState | null, headSha: string): GitWatchPlan;
+interface GateMissProposal {
+    slug: string;
+    reverted_sha: string;
+    revert_sha: string;
+    subject: string;
+    paths: string[];
+    kind: "revert" | "fixup" | "workaround";
+    gate_passed: boolean;
+    body: string;
+}
+declare function revertedShaFromCommit(commit: GitCommit): string | null;
+declare function existingGateMissShas(memories: LoadedMemory[]): Set<string>;
+declare function gatePassedShas(evaluations: SensorEvaluation[]): Set<string>;
+/** Build proposed, never-validated lessons from incremental revert/hotfix signals. */
+declare function proposeGateMissDrafts(commits: GitCommit[], existingRevertedShas: Set<string>, passedShas: Set<string>, opts?: {
+    /**
+     * Returns true when a repo-relative path still exists on disk. Anchor candidates come from
+     * the REVERT commit's file list — files the revert often just deleted. Anchoring a draft to
+     * a deleted path makes the very next `sync` mark it stale, so the learning loop eats its own
+     * drafts before anyone reviews them. When omitted, paths are kept (pure callers/tests).
+     */
+    pathExists?: (rel: string) => boolean;
+}): GateMissProposal[];
+
 /**
  * Pure stack-detection helpers for cold-start seeding.
  *
@@ -2811,4 +2969,4 @@ interface AgentContext {
 }
 declare function detectAgentContext(env?: Record<string, string | undefined>): AgentContext;
 
-export { AUTOPILOT_DEFAULTS, type Activation, type ActivationContext, ActivationSchema, type AgentContext, type Anchor, AnchorSchema, type AntiPatternGate, type AppliedConflictResolution, type AstExport, type AutoPromoteRule, BRIDGE_MARKERS, BRIDGE_TARGETS, BRIDGE_TARGET_PATH, BRIEFING_MARKER_TTL_MS, BRIEFING_PRESET_DEFAULTS, 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, 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 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_PRIORITY_SIGNALS, type DashboardOptions, type DashboardReport, type DepChange, type DepTrackResult, type DependencySnapshot, type DetectStacksInput, type DetectableStack, 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 FeedbackAdjustment, type FeedbackAdjustmentAction, type FeedbackAdjustmentOptions, type Finding, type FindingFormat, type FindingSeverity, GUESSABLE_THRESHOLD, type GatePrecision, type GatePrecisionDelta, type GatePrecisionMetricDelta, type GateTuningSuggestion, type GenerateBridgesOptions, type GitCommit, HAIVE_DIR, HAIVE_OWNED_FILES, HANDOFF_FILENAME, type HaiveConfig, type HaivePaths, type HotFile, type HotFileSource, type ImpactOptions, type ImpactRow, type ImpactScore, type ImpactSummary, type ImpactTier, type InvalidMemoryFile, 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, type ProposedSensorVerdict, RUNTIME_JOURNAL_FILENAME, type RecurrenceReport, type RecurrenceRow, type ResolveProjectInfo, type RetirementSignal, type RetrievalAggregate, type RetrievalCase, type RetrievalCaseResult, type RuntimeJournalEntry, SEED_QUALITY_FLOOR, SENSOR_ABSENT_LOOKBACK, SENSOR_ABSENT_WINDOW, 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 SensorSeed, type SensorSelfCheck, type SensorSuggestionOptions, type SensorTarget, type SessionHandoffData, 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, applyConflictResolution, applyFeedbackAdjustment, assessBootstrapState, bridgeMemorySummary, briefingMarkerPath, briefingMarkersDir, briefingProofLine, buildCodeMap, buildCoverageIndex, buildDashboard, buildDocFrequency, buildFrontmatter, buildHandoffMarkdown, buildReport, bumpRead, classifyMemoryPriority, codeMapPath, collectTimelineEntries, compactAutoRecapBody, compareEvalReports, compareGatePrecision, compareImpact, compileRegexSensor, componentOf, computeEvalTrend, computeGatePrecision, computeImpact, computePreventionTrend, computeRecurrence, configPath, contractLockPath, countSourceFilesOnDisk, deriveConfidence, detectAgentContext, detectStacksFromManifests, diffContract, diffHasDistinctiveOverlap, distinctiveCap, draftsFromFindings, emptyUsage, emptyUsageIndex, enforcementDir, estimateTokens, evalHistoryPath, evaluateSkillActivation, extractActionsBriefBody, extractReferencedPaths, extractSensorExamples, extractSnippet, filterNewDrafts, findCoverageGaps, findLexicalConflictPairs, findProjectRoot, findTopicStatusConflictPairs, findUncapturedFailures, findingBody, findingToDraft, firstMemoryOneLine, generateBridges, getUsage, globToRegExp, handoffAgeMs, handoffFilePath, hasRecentBriefingMarker, hashProjectContext, inferModulesFromPaths, isAutoPromoteEligible, isAutoRecap, isCovered, isDecaying, isDistinctiveToken, isEnvWorkaroundMemory, isFreshIsoDate, isGlobPath, isLikelyGuessable, isNoiseSubject, isRetiredMemory, isSensorScannablePath, isSkill, isSkillSuppressed, isStackPackSeed, isStylisticRule, isTemplateProjectContext, judgeProposedSensor, listMarkdownFilesRecursive, literalMatchesAllTokens, literalMatchesAnyToken, loadCodeMap, loadConfig, loadConfigSync, loadEvalHistory, loadMemoriesFromDir, loadMemoriesFromDirDetailed, loadMemory, loadPreventionEvents, loadUsageIndex, looksLikeGenericAdvice, meetsSeedQualityFloor, memoryFilePath, memoryHasExcludedTag, memoryMatchesAnchorPaths, mergeHotFiles, mergeMemoryVersions, moduleNameOf, newMemoryId, normalizeFindingSeverity, normalizeSessionId, overallScore, parseEslintJson, parseFileAst, parseFindings, parseMemory, parseNpmAudit, parseSarif, parseSince, parseSonar, pathsOverlap, pickSnippetNeedle, planConflictResolution, prepareBridgeData, preventionLogPath, priorityRank, prioritySignals, projectContextRecentlyEmitted, proposeSeedsFromCommits, pullCrossRepoSources, queryCodeMap, rankMemoriesLexical, readRecentBriefingMarker, readRuntimeJournalTail, readSessionHandoff, readUsageEvents, recommendFeedbackAdjustment, recordApplied, recordPrevention, recordPreventionHits, recordProjectContextEmission, recordRejection, relPathFrom, renderBootstrapChecklist, renderCaughtForYou, resolveBriefingBudget, resolveHaivePaths, resolveManifestFiles, resolveProjectInfo, retirementSignal, runRegexSensor, runSensors, runtimeJournalPath, saveCodeMap, saveConfig, saveUsageIndex, scannableSensorTargets, scoreRetrievalCase, scoreSensorCase, selectCommandSensors, sensorAppliesToPath, sensorPatternBrittleness, sensorSelfCheck, sensorTargetsFromDiff, serializeMemory, snapshotContract, specificityScore, stripPrivate, suggestGate, suggestSensorFromMemory, suggestSensorSeed, suggestTopicKey, summarizeCaughtForYou, summarizeImpact, synthesizeSelfEvalCases, tallyHotFiles, titleFromBody, tokenizeQuery, tokenizeWords, trackDependencies, trackReads, truncateToTokens, usageLogPath, usageLogSize, usagePath, verifyAnchor, watchContracts, writeBriefingMarker, writeSessionHandoff };
+export { AUTOPILOT_DEFAULTS, type Activation, type ActivationContext, ActivationSchema, type AgentContext, type Anchor, AnchorSchema, type AntiPatternGate, type AppliedConflictResolution, type AstExport, type AutoPromoteRule, BRIDGE_MARKERS, BRIDGE_TARGETS, BRIDGE_TARGET_PATH, BRIEFING_MARKER_TTL_MS, BRIEFING_PRESET_DEFAULTS, 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, 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 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_PRIORITY_SIGNALS, type DashboardOptions, type DashboardReport, type DepChange, type DepTrackResult, type DependencySnapshot, type DetectStacksInput, type DetectableStack, 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 FeedbackAdjustment, type FeedbackAdjustmentAction, type FeedbackAdjustmentOptions, type Finding, type FindingFormat, type FindingSeverity, GUESSABLE_THRESHOLD, type GateMissProposal, type GatePrecision, type GatePrecisionDelta, type GatePrecisionMetricDelta, type GateTuningSuggestion, type GenerateBridgesOptions, type GitCommit, type GitWatchPlan, type GitWatchState, HAIVE_DIR, HAIVE_OWNED_FILES, HANDOFF_FILENAME, type HaiveConfig, type HaivePaths, type HotFile, type HotFileSource, type ImpactOptions, type ImpactRow, type ImpactScore, type ImpactSummary, type ImpactTier, type InvalidMemoryFile, 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 PreventionEventDetail, type PreventionReceipt, type PreventionReceiptRow, type PreventionRow, type PreventionSource, type PreventionTrend, type PrioritySignals, type ProposedSensorVerdict, RUNTIME_JOURNAL_FILENAME, type RecurrenceReport, type RecurrenceRow, type ResolveProjectInfo, type RetirementSignal, type RetrievalAggregate, type RetrievalCase, type RetrievalCaseResult, type RuntimeJournalEntry, SEED_QUALITY_FLOOR, SENSOR_ABSENT_LOOKBACK, SENSOR_ABSENT_WINDOW, SESSION_RECAP_TTL_MS, STACK_PACK_TAG, 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 SessionHandoffData, 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, appendSensorEvaluations, appendUsageEvent, applyConflictResolution, applyFeedbackAdjustment, assessBootstrapState, assessSensorHealth, bridgeMemorySummary, briefingMarkerPath, briefingMarkersDir, briefingProofLine, buildCodeMap, buildCoverageIndex, buildDashboard, buildDocFrequency, buildFrontmatter, buildHandoffMarkdown, buildPreventionReceipt, buildReport, bumpRead, classifyMemoryPriority, codeMapPath, collectTimelineEntries, compactAutoRecapBody, compareEvalReports, compareGatePrecision, compareImpact, compileRegexSensor, componentOf, computeEvalTrend, computeGatePrecision, computeImpact, computePreventionTrend, computeRecurrence, computeScopeHash, configPath, contractLockPath, countSourceFilesOnDisk, deriveConfidence, detectAgentContext, detectStacksFromManifests, diffContract, diffHasDistinctiveOverlap, distinctiveCap, draftsFromFindings, emptyUsage, emptyUsageIndex, enforcementDir, estimateTokens, evalHistoryPath, evaluateSkillActivation, existingGateMissShas, extractActionsBriefBody, extractReferencedPaths, extractSensorExamples, extractSnippet, filterNewDrafts, findCoverageGaps, findLexicalConflictPairs, findProjectRoot, findTopicStatusConflictPairs, findUncapturedFailures, findingBody, findingToDraft, firstMemoryOneLine, gatePassedShas, generateBridges, getUsage, globToRegExp, handoffAgeMs, handoffFilePath, hasRecentBriefingMarker, hashProjectContext, inferModulesFromPaths, isAutoPromoteEligible, isAutoRecap, isCovered, isDecaying, isDistinctiveToken, isEnvWorkaroundMemory, isFreshIsoDate, isGlobPath, isLikelyGuessable, isNoiseSubject, isRetiredMemory, isSensorScannablePath, isSkill, isSkillSuppressed, isStackPackSeed, isStylisticRule, isTemplateProjectContext, judgeProposedSensor, listMarkdownFilesRecursive, literalMatchesAllTokens, literalMatchesAnyToken, loadCodeMap, loadConfig, loadConfigSync, loadEvalHistory, loadMemoriesFromDir, loadMemoriesFromDirDetailed, loadMemory, loadPreventionEvents, loadSensorLedger, loadUsageIndex, looksLikeGenericAdvice, meetsSeedQualityFloor, memoryFilePath, memoryHasExcludedTag, memoryMatchesAnchorPaths, mergeHotFiles, mergeMemoryVersions, moduleNameOf, newMemoryId, normalizeFindingSeverity, normalizeSessionId, overallScore, parseEslintJson, parseFileAst, parseFindings, parseMemory, parseNpmAudit, parseSarif, parseSince, parseSonar, pathsOverlap, pickSnippetNeedle, planConflictResolution, planGitWatch, prepareBridgeData, preventionLogPath, priorityRank, prioritySignals, projectContextRecentlyEmitted, proposeGateMissDrafts, proposeSeedsFromCommits, pullCrossRepoSources, quarantineNote, queryCodeMap, rankMemoriesLexical, readRecentBriefingMarker, readRuntimeJournalTail, readSessionHandoff, readUsageEvents, recommendFeedbackAdjustment, recordApplied, recordPrevention, recordPreventionHits, recordProjectContextEmission, recordRejection, relPathFrom, renderBootstrapChecklist, renderCaughtForYou, renderPreventionReceipt, resolveBriefingBudget, resolveHaivePaths, resolveManifestFiles, resolveProjectInfo, retirementSignal, revertedShaFromCommit, runRegexSensor, runSensors, runtimeJournalPath, saveCodeMap, saveConfig, saveUsageIndex, scannableSensorTargets, scoreRetrievalCase, scoreSensorCase, selectCommandSensors, sensorAppliesToPath, sensorLedgerPath, sensorPatternBrittleness, sensorPromotedAtMap, sensorSelfCheck, sensorTargetsFromDiff, serializeMemory, 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 };