@hiveai/core 0.10.3 → 0.10.4

package/dist/index.d.ts

@@ -326,6 +326,7 @@ declare function buildFrontmatter(input: {
     topic?: string;
     status?: MemoryFrontmatter["status"];
     relatedIds?: string[];
+    sensor?: Sensor;
 }): MemoryFrontmatter;
 
 declare const HAIVE_DIR = ".ai";
@@ -1109,8 +1110,9 @@ 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 when the path
- * starts with, or contains, any configured prefix.
+ * memory has no anchor paths) applies everywhere. Otherwise it applies only to the
+ * exact file or directory prefix. Use an explicit directory path (`src/foo/`) when a
+ * sensor should cover a whole subtree.
  */
 declare function sensorAppliesToPath(sensor: Sensor, anchorPaths: string[], path: string): boolean;
 /**
@@ -1130,6 +1132,8 @@ declare function runRegexSensor(memoryId: string, sensor: Sensor, target: Sensor
  * are the CLI's responsibility). At most one hit per (memory, file) pair is returned.
  */
 declare function runSensors(memories: Memory[], targets: SensorTarget[]): SensorHit[];
+/** Split a unified diff into per-file targets containing only added lines. */
+declare function sensorTargetsFromDiff(diff: string): SensorTarget[];
 /**
  * Extract the added lines from a unified diff (lines starting with a single `+`,
  * excluding the `+++` file header). Mirrors the diff-handling already used by the
@@ -1137,4 +1141,16 @@ declare function runSensors(memories: Memory[], targets: SensorTarget[]): Sensor
  */
 declare function addedLinesFromDiff(diff: string): string;
 
-export { AUTOPILOT_DEFAULTS, type Anchor, AnchorSchema, type AntiPatternGate, type AutoPromoteRule, BRIEFING_MARKER_TTL_MS, BRIEFING_PRESET_DEFAULTS, type BreakingChange, type BriefingBudgetNumbers, type BriefingBudgetPreset, type BriefingMarker, type BudgetPart, type BudgetSlice, type BuildCodeMapOptions, CHARS_PER_TOKEN, CODE_MAP_FILE, CONFIG_FILE, type CodeExport, type CodeExportKind, type CodeFileEntry, type CodeMap, type CodeMapQueryOptions, type CollectTimelineOpts, type ConfidenceLevel, type ConfidenceThresholds, type ConflictCandidatePair, type ConflictCandidatesOpts, type ContractDiffResult, type ContractFile, type ContractSnapshot, CrossRepoProvenanceSchema, type CrossRepoReport, type CrossRepoSource, DECAY_DAYS, DEFAULT_AUTO_PROMOTE_RULE, DEFAULT_CONFIDENCE_THRESHOLDS, DEFAULT_CONFIG, type DepChange, type DepTrackResult, type DependencySnapshot, GUESSABLE_THRESHOLD, HAIVE_DIR, type HaiveConfig, type HaivePaths, type LexicalRankResult, type LoadedMemory, MEMORIES_DIR, type Memory, type MemoryFrontmatter, MemoryFrontmatterSchema, type MemoryScope, MemoryScopeSchema, type MemoryStatus, MemoryStatusSchema, type MemoryType, MemoryTypeSchema, type MemoryUsage, PROJECT_CONTEXT_FILE, RUNTIME_JOURNAL_FILENAME, type ResolveProjectInfo, type RetirementSignal, type RuntimeJournalEntry, SESSION_RECAP_TTL_MS, STACK_PACK_TAG, type Sensor, type SensorHit, SensorSchema, type SensorTarget, type TimelineEntry, type TopicStatusPair, type TruncateOptions, type TruncateResult, USAGE_FILE, USAGE_LOG_DIR, USAGE_LOG_FILE, type UsageAggregate, type UsageEvent, type UsageIndex, type VerifyOptions, type VerifyResult, addedLinesFromDiff, aggregateUsage, allocateBudget, antiPatternGateParams, appendRuntimeJournalEntry, appendUsageEvent, briefingMarkerPath, briefingMarkersDir, buildCodeMap, buildFrontmatter, bumpRead, codeMapPath, collectTimelineEntries, compileRegexSensor, configPath, contractLockPath, deriveConfidence, diffContract, emptyUsage, emptyUsageIndex, enforcementDir, estimateTokens, extractActionsBriefBody, extractSnippet, findLexicalConflictPairs, findProjectRoot, findTopicStatusConflictPairs, firstMemoryOneLine, getUsage, globToRegExp, hasRecentBriefingMarker, inferModulesFromPaths, isAutoPromoteEligible, isDecaying, isFreshIsoDate, isGlobPath, isLikelyGuessable, isRetiredMemory, isStackPackSeed, listMarkdownFilesRecursive, literalMatchesAllTokens, literalMatchesAnyToken, loadCodeMap, loadConfig, loadConfigSync, loadMemoriesFromDir, loadMemory, loadUsageIndex, memoryFilePath, memoryMatchesAnchorPaths, newMemoryId, normalizeSessionId, parseMemory, parseSince, pathsOverlap, pickSnippetNeedle, pullCrossRepoSources, queryCodeMap, rankMemoriesLexical, readRecentBriefingMarker, readRuntimeJournalTail, readUsageEvents, recordRejection, relPathFrom, resolveBriefingBudget, resolveHaivePaths, resolveManifestFiles, resolveProjectInfo, retirementSignal, runRegexSensor, runSensors, runtimeJournalPath, saveCodeMap, saveConfig, saveUsageIndex, sensorAppliesToPath, serializeMemory, snapshotContract, specificityScore, stripPrivate, suggestTopicKey, tokenizeQuery, trackDependencies, trackReads, truncateToTokens, usageLogPath, usageLogSize, usagePath, verifyAnchor, watchContracts, writeBriefingMarker };
+interface SensorSuggestionOptions {
+    /** Extra paths to put on the sensor. Defaults to the memory anchor paths. */
+    paths?: string[];
+}
+/**
+ * Conservatively suggest a regex sensor from a gotcha/attempt body.
+ *
+ * This helper intentionally returns null more often than it guesses. Autogenerated
+ * sensors start as `warn`, never `block`; humans can promote them after seeing them fire.
+ */
+declare function suggestSensorFromMemory(body: string, anchorPaths: string[], options?: SensorSuggestionOptions): Sensor | null;
+
+export { AUTOPILOT_DEFAULTS, type Anchor, AnchorSchema, type AntiPatternGate, type AutoPromoteRule, BRIEFING_MARKER_TTL_MS, BRIEFING_PRESET_DEFAULTS, type BreakingChange, type BriefingBudgetNumbers, type BriefingBudgetPreset, type BriefingMarker, type BudgetPart, type BudgetSlice, type BuildCodeMapOptions, CHARS_PER_TOKEN, CODE_MAP_FILE, CONFIG_FILE, type CodeExport, type CodeExportKind, type CodeFileEntry, type CodeMap, type CodeMapQueryOptions, type CollectTimelineOpts, type ConfidenceLevel, type ConfidenceThresholds, type ConflictCandidatePair, type ConflictCandidatesOpts, type ContractDiffResult, type ContractFile, type ContractSnapshot, CrossRepoProvenanceSchema, type CrossRepoReport, type CrossRepoSource, DECAY_DAYS, DEFAULT_AUTO_PROMOTE_RULE, DEFAULT_CONFIDENCE_THRESHOLDS, DEFAULT_CONFIG, type DepChange, type DepTrackResult, type DependencySnapshot, GUESSABLE_THRESHOLD, HAIVE_DIR, type HaiveConfig, type HaivePaths, type LexicalRankResult, type LoadedMemory, MEMORIES_DIR, type Memory, type MemoryFrontmatter, MemoryFrontmatterSchema, type MemoryScope, MemoryScopeSchema, type MemoryStatus, MemoryStatusSchema, type MemoryType, MemoryTypeSchema, type MemoryUsage, PROJECT_CONTEXT_FILE, RUNTIME_JOURNAL_FILENAME, type ResolveProjectInfo, type RetirementSignal, type RuntimeJournalEntry, SESSION_RECAP_TTL_MS, STACK_PACK_TAG, type Sensor, type SensorHit, SensorSchema, type SensorSuggestionOptions, type SensorTarget, type TimelineEntry, type TopicStatusPair, type TruncateOptions, type TruncateResult, USAGE_FILE, USAGE_LOG_DIR, USAGE_LOG_FILE, type UsageAggregate, type UsageEvent, type UsageIndex, type VerifyOptions, type VerifyResult, addedLinesFromDiff, aggregateUsage, allocateBudget, antiPatternGateParams, appendRuntimeJournalEntry, appendUsageEvent, briefingMarkerPath, briefingMarkersDir, buildCodeMap, buildFrontmatter, bumpRead, codeMapPath, collectTimelineEntries, compileRegexSensor, configPath, contractLockPath, deriveConfidence, diffContract, emptyUsage, emptyUsageIndex, enforcementDir, estimateTokens, extractActionsBriefBody, extractSnippet, findLexicalConflictPairs, findProjectRoot, findTopicStatusConflictPairs, firstMemoryOneLine, getUsage, globToRegExp, hasRecentBriefingMarker, inferModulesFromPaths, isAutoPromoteEligible, isDecaying, isFreshIsoDate, isGlobPath, isLikelyGuessable, isRetiredMemory, isStackPackSeed, listMarkdownFilesRecursive, literalMatchesAllTokens, literalMatchesAnyToken, loadCodeMap, loadConfig, loadConfigSync, loadMemoriesFromDir, loadMemory, loadUsageIndex, memoryFilePath, memoryMatchesAnchorPaths, newMemoryId, normalizeSessionId, parseMemory, parseSince, pathsOverlap, pickSnippetNeedle, pullCrossRepoSources, queryCodeMap, rankMemoriesLexical, readRecentBriefingMarker, readRuntimeJournalTail, readUsageEvents, recordRejection, relPathFrom, resolveBriefingBudget, resolveHaivePaths, resolveManifestFiles, resolveProjectInfo, retirementSignal, runRegexSensor, runSensors, runtimeJournalPath, saveCodeMap, saveConfig, saveUsageIndex, sensorAppliesToPath, sensorTargetsFromDiff, serializeMemory, snapshotContract, specificityScore, stripPrivate, suggestSensorFromMemory, suggestTopicKey, tokenizeQuery, trackDependencies, trackReads, truncateToTokens, usageLogPath, usageLogSize, usagePath, verifyAnchor, watchContracts, writeBriefingMarker };

package/dist/index.js

@@ -148,6 +148,7 @@ function buildFrontmatter(input) {
     created_at: now.toISOString(),
     expires_when: null,
     topic: input.topic,
+    sensor: input.sensor,
     revision_count: 0,
     related_ids: input.relatedIds ?? []
   });
@@ -2465,10 +2466,18 @@ function isRetiredMemory(fm, body = "", now = /* @__PURE__ */ new Date()) {
 }
 
 // src/sensors.ts
+function normalizeProjectPath(value) {
+  return value.replace(/\\/g, "/").replace(/^\.\//, "").replace(/^[ab]\//, "").replace(/\/+$/g, "");
+}
 function sensorAppliesToPath(sensor, anchorPaths, path15) {
   const scopes = sensor.paths.length > 0 ? sensor.paths : anchorPaths;
   if (scopes.length === 0) return true;
-  return scopes.some((p) => path15 === p || path15.startsWith(p) || path15.includes(p));
+  const target = normalizeProjectPath(path15);
+  return scopes.some((rawScope) => {
+    const scope = normalizeProjectPath(rawScope);
+    if (!scope) return false;
+    return target === scope || target.startsWith(`${scope}/`);
+  });
 }
 function compileRegexSensor(sensor) {
   if (sensor.kind !== "regex" || !sensor.pattern) return null;
@@ -2511,9 +2520,147 @@ function runSensors(memories, targets) {
   }
   return hits;
 }
+function sensorTargetsFromDiff(diff) {
+  const targets = [];
+  let currentPath = null;
+  let added = [];
+  const flush = () => {
+    if (!currentPath || added.length === 0) return;
+    targets.push({ path: currentPath, content: added.join("\n") });
+    added = [];
+  };
+  for (const line of diff.split("\n")) {
+    if (line.startsWith("diff --git ")) {
+      flush();
+      currentPath = null;
+      continue;
+    }
+    if (line.startsWith("+++ ")) {
+      flush();
+      const raw = line.slice(4).trim();
+      currentPath = raw === "/dev/null" ? null : normalizeProjectPath(raw);
+      continue;
+    }
+    if (line.startsWith("+") && !line.startsWith("+++")) {
+      if (!currentPath) currentPath = "";
+      added.push(line.slice(1));
+    }
+  }
+  flush();
+  return targets;
+}
 function addedLinesFromDiff(diff) {
+  const targets = sensorTargetsFromDiff(diff);
+  if (targets.length > 0) return targets.map((target) => target.content).join("\n");
   return diff.split("\n").filter((l) => l.startsWith("+") && !l.startsWith("+++")).map((l) => l.slice(1)).join("\n");
 }
+
+// src/sensor-suggest.ts
+var CODE_TOKEN_RE = /`([^`\n]{3,80})`|["']([A-Za-z0-9_.:-]{3,80})["']|\b([A-Za-z][A-Za-z0-9_.:-]{2,79})\b/g;
+var SENSOR_STOPWORDS = /* @__PURE__ */ new Set([
+  "about",
+  "after",
+  "again",
+  "agent",
+  "always",
+  "anchor",
+  "approach",
+  "because",
+  "before",
+  "break",
+  "broken",
+  "cannot",
+  "change",
+  "code",
+  "commit",
+  "correct",
+  "could",
+  "default",
+  "detect",
+  "direct",
+  "directory",
+  "does",
+  "error",
+  "failed",
+  "fails",
+  "file",
+  "files",
+  "future",
+  "instead",
+  "memory",
+  "never",
+  "project",
+  "recorded",
+  "repo",
+  "return",
+  "should",
+  "source",
+  "status",
+  "string",
+  "this",
+  "tried",
+  "true",
+  "type",
+  "undefined",
+  "value",
+  "when",
+  "where",
+  "which",
+  "with",
+  "without"
+]);
+function suggestSensorFromMemory(body, anchorPaths, options = {}) {
+  const paths = options.paths ?? anchorPaths;
+  if (paths.length === 0) return null;
+  const negativeText = body.split(/\*\*Instead,\s*use:\*\*|^##\s+Instead\b/im)[0] ?? body;
+  const token = pickDistinctiveToken(negativeText);
+  if (!token) return null;
+  return {
+    kind: "regex",
+    pattern: escapeRegExp(token),
+    paths,
+    message: sensorMessageFromBody(body, token),
+    severity: "warn",
+    autogen: true,
+    last_fired: null
+  };
+}
+function pickDistinctiveToken(text) {
+  const candidates = /* @__PURE__ */ new Map();
+  for (const match of text.matchAll(CODE_TOKEN_RE)) {
+    const raw = (match[1] ?? match[2] ?? match[3] ?? "").trim();
+    const token = raw.replace(/^[^\w.-]+|[^\w.-]+$/g, "");
+    const isCodeLike = Boolean(match[1] ?? match[2]);
+    if (!isDistinctiveToken(token, isCodeLike)) continue;
+    const key = token.toLowerCase();
+    const codeSpanBonus = match[1] ? 20 : match[2] ? 8 : 0;
+    const shapeBonus = /[-_.:]/.test(token) ? 3 : /[A-Z]/.test(token.slice(1)) ? 2 : /\d/.test(token) ? 1 : 0;
+    const score = token.length + codeSpanBonus + shapeBonus;
+    const existing = candidates.get(key);
+    if (!existing || score > existing.score) candidates.set(key, { raw: token, score });
+  }
+  const best = [...candidates.values()].sort((a, b) => b.score - a.score)[0];
+  return best?.raw ?? null;
+}
+function isDistinctiveToken(token, isCodeLike) {
+  if (token.length < 4 || token.length > 80) return false;
+  if (/^https?:\/\//i.test(token)) return false;
+  if (/^\d+$/.test(token)) return false;
+  const lower = token.toLowerCase();
+  if (SENSOR_STOPWORDS.has(lower)) return false;
+  if (!/[A-Za-z]/.test(token)) return false;
+  const shaped = /[-_.:\d]/.test(token) || /[A-Z]/.test(token.slice(1));
+  return shaped || isCodeLike;
+}
+function sensorMessageFromBody(body, token) {
+  const instead = body.match(/\*\*Instead,\s*use:\*\*\s*([^\n]+)/i)?.[1]?.trim();
+  if (instead) return `Avoid ${token}; ${instead}`;
+  const firstGuidance = body.split("\n").map((line) => line.replace(/^#+\s*/, "").trim()).find((line) => line.length > 0 && !line.startsWith("---"));
+  return firstGuidance?.slice(0, 180) || `Avoid ${token}; this matched an autogenerated hAIve sensor.`;
+}
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
 export {
   AUTOPILOT_DEFAULTS,
   AnchorSchema,
@@ -2618,10 +2765,12 @@ export {
   saveConfig,
   saveUsageIndex,
   sensorAppliesToPath,
+  sensorTargetsFromDiff,
   serializeMemory,
   snapshotContract,
   specificityScore,
   stripPrivate,
+  suggestSensorFromMemory,
   suggestTopicKey,
   tokenizeQuery,
   trackDependencies,