@hivelore/core 0.36.0 → 0.38.0

package/dist/index.d.ts

@@ -2166,6 +2166,85 @@ declare function suggestSensorSeed(body: string, anchorPaths: string[], options?
  */
 declare function suggestSensorFromMemory(body: string, anchorPaths: string[], options?: SensorSuggestionOptions): Sensor | null;
 
+/**
+ * Post-incident test scaffolding — turn a captured lesson (`mem_tried` / attempt / gotcha) into a
+ * PENDING test file the team fills in, then arms as a command-sensor oracle.
+ *
+ * This is the behaviour-harness bridge's on-ramp: `mem_tried` records *what* failed and *why*, but a
+ * command sensor needs the team's own test as the oracle — and someone has to write it. This module
+ * removes that friction by generating the test skeleton (header provenance + a pending test + a
+ * commented example derived from the lesson) plus the exact `sensors propose --kind test` line.
+ *
+ * DOCTRINE: this NEVER arms a sensor. It only writes a stub and prints the wiring command. Arming
+ * stays with `propose_sensor`, the sole validated writer of live sensors (silent-on-current /
+ * fires-on-bad). The generated test is deliberately PENDING (todo/skip) so the suite stays green and
+ * an empty stub can't masquerade as a passing oracle. Pure: no I/O — the caller writes the file.
+ */
+type TestFramework = "vitest" | "jest" | "pytest" | "gotest";
+declare const TEST_FRAMEWORKS: readonly TestFramework[];
+interface PostIncidentLesson {
+    /** Memory id the scaffold is generated from. */
+    memoryId: string;
+    /** Short "what was tried / what failed" title (the lesson's heading). */
+    title: string;
+    /** Why it failed / must not be used. */
+    whyFailed?: string;
+    /** The correct approach / expected behaviour. */
+    instead?: string;
+    /** Incident provenance (ticket/prod ref) carried into the sensor when armed. */
+    incident?: string;
+    /** Anchor paths — used to scope the sensor and to place the test near the code. */
+    paths?: string[];
+}
+interface TestScaffold {
+    framework: TestFramework;
+    /** Suggested project-relative path for the generated test file. */
+    relPath: string;
+    /** File contents (a pending test with provenance + a commented example). */
+    content: string;
+    /** Command that runs ONLY this test — becomes the sensor's oracle command once filled in. */
+    runCommand: string;
+    /** Ready-to-run wiring command: arms the test as a deterministic gate AFTER it is written. */
+    proposeCommand: string;
+}
+interface ScaffoldOptions {
+    framework: TestFramework;
+    /** Override the generated file path (project-relative). Wins over baseDir. */
+    outPath?: string;
+    /**
+     * Repo-relative directory of the package that owns the incident (monorepo awareness). The default
+     * test path and run command are placed inside it. Empty/omitted → repo root.
+     */
+    baseDir?: string;
+}
+/** Map a user-supplied framework string (with common aliases) to a TestFramework, or null. */
+declare function normalizeFramework(input: string): TestFramework | null;
+/**
+ * Pure framework decision from already-gathered facts (a package.json's deps + non-JS signals). The
+ * FS walking that produces these facts is I/O and lives in the caller (cli/mcp), keeping core pure.
+ */
+declare function pickTestFramework(pkg: {
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+} | null, signals?: {
+    goMod?: boolean;
+    pySignal?: boolean;
+}): TestFramework;
+/** Strip the `YYYY-MM-DD-<type>-` id prefix to the descriptive slug (`importing-momentjs`). */
+declare function lessonShortName(memoryId: string): string;
+/**
+ * Parse the "what / why / instead" fields out of an attempt/gotcha memory body — the shape written
+ * by `mem_tried` (`# <what>`, `**Why it failed / do NOT use:** …`, `**Instead, use:** …`). Pure so
+ * the CLI can hand it a loaded body without re-implementing the parse.
+ */
+declare function parseLessonFields(body: string): {
+    title?: string;
+    whyFailed?: string;
+    instead?: string;
+};
+/** Build a scaffold for the given lesson + framework. Pure — the caller writes `content` to `relPath`. */
+declare function scaffoldPostIncidentTest(lesson: PostIncidentLesson, options: ScaffoldOptions): TestScaffold;
+
 /**
  * First-agent bootstrap state — is the repo's knowledge layer filled enough for later agents to rely on?
  *
@@ -3014,4 +3093,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 GateMissProposal, type GatePrecision, type GatePrecisionDelta, type GatePrecisionMetricDelta, type GateTuningSuggestion, type GenerateBridgesOptions, type GitCommit, type GitWatchPlan, type GitWatchState, 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 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, incidentSuffix, 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, renderPreventionReceiptShare, 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 };
+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, HIVELORE_ATTRIBUTION, 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 PostIncidentLesson, 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 ScaffoldOptions, 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, TEST_FRAMEWORKS, type TestFramework, type TestScaffold, 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, incidentSuffix, inferModulesFromPaths, isAutoPromoteEligible, isAutoRecap, isCovered, isDecaying, isDistinctiveToken, isEnvWorkaroundMemory, isFreshIsoDate, isGlobPath, isLikelyGuessable, isNoiseSubject, isRetiredMemory, isSensorScannablePath, isSkill, isSkillSuppressed, isStackPackSeed, isStylisticRule, isTemplateProjectContext, judgeProposedSensor, lessonShortName, listMarkdownFilesRecursive, literalMatchesAllTokens, literalMatchesAnyToken, loadCodeMap, loadConfig, loadConfigSync, loadEvalHistory, loadMemoriesFromDir, loadMemoriesFromDirDetailed, loadMemory, loadPreventionEvents, loadSensorLedger, loadUsageIndex, looksLikeGenericAdvice, meetsSeedQualityFloor, memoryFilePath, memoryHasExcludedTag, memoryMatchesAnchorPaths, mergeHotFiles, mergeMemoryVersions, moduleNameOf, newMemoryId, normalizeFindingSeverity, normalizeFramework, 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, readRecentBriefingMarker, readRuntimeJournalTail, readSessionHandoff, readUsageEvents, recommendFeedbackAdjustment, recordApplied, recordPrevention, recordPreventionHits, recordProjectContextEmission, recordRejection, relPathFrom, renderBootstrapChecklist, renderCaughtForYou, renderPreventionReceipt, renderPreventionReceiptShare, resolveBriefingBudget, resolveHaivePaths, resolveManifestFiles, resolveProjectInfo, retirementSignal, revertedShaFromCommit, runRegexSensor, runSensors, runtimeJournalPath, saveCodeMap, saveConfig, saveUsageIndex, scaffoldPostIncidentTest, 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 };

package/dist/index.js

@@ -3758,8 +3758,8 @@ var BRIDGE_MARKERS = {
 };
 function bridgeMemorySummary(body) {
   const firstLine = body.split("\n").map((l) => l.replace(/^#+\s*/, "").trim()).find((l) => l.length > 0) ?? "";
-  const oneLine = firstLine.replace(/\s+/g, " ");
-  return oneLine.length > 140 ? oneLine.slice(0, 137) + "\u2026" : oneLine;
+  const oneLine2 = firstLine.replace(/\s+/g, " ");
+  return oneLine2.length > 140 ? oneLine2.slice(0, 137) + "\u2026" : oneLine2;
 }
 function prepareBridgeData(memories, sensors, opts) {
   const max = opts?.maxMemories ?? 8;
@@ -4486,6 +4486,139 @@ function escapeRegExp(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 
+// src/test-scaffold.ts
+var TEST_FRAMEWORKS = ["vitest", "jest", "pytest", "gotest"];
+function normalizeFramework(input) {
+  const v = input.trim().toLowerCase();
+  if (v === "vitest") return "vitest";
+  if (v === "jest") return "jest";
+  if (v === "pytest" || v === "py" || v === "python") return "pytest";
+  if (v === "go" || v === "gotest" || v === "go-test") return "gotest";
+  return null;
+}
+function pickTestFramework(pkg, signals = {}) {
+  const deps = { ...pkg?.dependencies, ...pkg?.devDependencies };
+  if (deps.vitest) return "vitest";
+  if (deps.jest || deps["ts-jest"]) return "jest";
+  if (signals.goMod) return "gotest";
+  if (signals.pySignal) return "pytest";
+  return "vitest";
+}
+function joinRel(baseDir, rest) {
+  const base = (baseDir ?? "").replace(/^\/+|\/+$/g, "");
+  return base ? `${base}/${rest}` : rest;
+}
+function lessonShortName(memoryId) {
+  const stripped = memoryId.replace(
+    /^\d{4}-\d{2}-\d{2}-(?:attempt|gotcha|decision|convention|architecture|glossary|skill|session_recap)-/,
+    ""
+  );
+  const slug = (stripped || memoryId).toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  return slug || "incident";
+}
+function snake(slug) {
+  return slug.replace(/-/g, "_").replace(/[^a-z0-9_]/gi, "").replace(/^_+|_+$/g, "") || "incident";
+}
+function pascal(slug) {
+  return slug.split(/[^a-z0-9]+/i).filter(Boolean).map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join("") || "Incident";
+}
+function oneLine(text) {
+  return (text ?? "").replace(/\s+/g, " ").trim();
+}
+function parseLessonFields(body) {
+  const title = body.match(/^#\s+(.+?)\s*$/m)?.[1]?.trim();
+  const whyFailed = body.match(/\*\*Why it failed[^:]*:\*\*\s*([^\n]+)/i)?.[1]?.trim();
+  const instead = body.match(/\*\*Instead,\s*use:\*\*\s*([^\n]+)/i)?.[1]?.trim();
+  return { title, whyFailed, instead };
+}
+function proposeCommand(lesson, runCommand) {
+  const parts = [
+    `hivelore sensors propose ${lesson.memoryId}`,
+    "--kind test",
+    `--command ${JSON.stringify(runCommand)}`
+  ];
+  if (lesson.incident) parts.push(`--incident ${JSON.stringify(lesson.incident)}`);
+  const scope = (lesson.paths ?? []).filter(Boolean);
+  if (scope.length > 0) parts.push(`--paths ${JSON.stringify(scope.join(","))}`);
+  return parts.join(" ");
+}
+function header(lesson, comment) {
+  const lines = [
+    `Post-incident guard generated by Hivelore from ${lesson.memoryId}.`,
+    ...lesson.incident ? [`Incident: ${lesson.incident}`] : [],
+    `What failed: ${oneLine(lesson.title)}`,
+    ...lesson.whyFailed ? [`Why: ${oneLine(lesson.whyFailed)}`] : [],
+    ...lesson.instead ? [`Expected / fix: ${oneLine(lesson.instead)}`] : [],
+    "",
+    "TODO: replace the pending test with a real check that FAILS on the incident and",
+    "PASSES once the fix is in place. Then arm it as a deterministic gate:"
+  ];
+  return lines.map(comment).join("\n");
+}
+function scaffoldPostIncidentTest(lesson, options) {
+  const framework = options.framework;
+  const short = lessonShortName(lesson.memoryId);
+  const desc = oneLine(lesson.title) || short;
+  let relPath;
+  let runCommand;
+  let content;
+  if (framework === "vitest" || framework === "jest") {
+    relPath = options.outPath ?? joinRel(options.baseDir, `tests/incidents/${short}.test.ts`);
+    runCommand = framework === "vitest" ? `npx vitest run ${relPath}` : `npx jest ${relPath}`;
+    const hc = (l) => l ? `// ${l}` : "//";
+    const importLine = framework === "vitest" ? `import { describe, it, expect } from "vitest";
+
+` : "";
+    content = `${header(lesson, hc)}
+//   ${proposeCommand(lesson, runCommand)}
+
+` + importLine + `describe(${JSON.stringify(desc)}, () => {
+  it.todo("reproduces ${lesson.memoryId} and stays fixed");
+
+  // it("guards the incident", () => {
+  //   // Arrange the state that caused the incident, then assert the fixed behaviour.
+  //   expect(subjectUnderTest()).toBe(/* expected */);
+  // });
+});
+`;
+  } else if (framework === "pytest") {
+    const fn = snake(short);
+    relPath = options.outPath ?? joinRel(options.baseDir, `tests/incidents/test_${fn}.py`);
+    runCommand = `pytest ${relPath}`;
+    const hc = (l) => l ? `# ${l}` : "#";
+    content = `${header(lesson, hc)}
+#   ${proposeCommand(lesson, runCommand)}
+
+import pytest
+
+
+@pytest.mark.skip(reason="TODO: write the post-incident assertion, then arm the sensor")
+def test_${fn}():
+    # Arrange the state that caused the incident, then assert the fixed behaviour.
+    assert subject_under_test() == expected
+`;
+  } else {
+    const fn = pascal(short);
+    const dir = options.outPath ? options.outPath.replace(/\/[^/]+$/, "") : joinRel(options.baseDir, "incidents");
+    relPath = options.outPath ?? joinRel(options.baseDir, `incidents/incident_${snake(short)}_test.go`);
+    runCommand = `go test ./${dir}/`;
+    const hc = (l) => l ? `// ${l}` : "//";
+    content = `${header(lesson, hc)}
+//   ${proposeCommand(lesson, runCommand)}
+
+package incidents
+
+import "testing"
+
+func Test${fn}(t *testing.T) {
+	t.Skip("TODO: write the post-incident assertion, then arm the sensor")
+	// Arrange the state that caused the incident, then assert the fixed behaviour.
+}
+`;
+  }
+  return { framework, relPath, content, runCommand, proposeCommand: proposeCommand(lesson, runCommand) };
+}
+
 // src/bootstrap-state.ts
 var CONTAINER_DIRS = /* @__PURE__ */ new Set([
   "packages",
@@ -5562,17 +5695,17 @@ function compactAutoRecapBody(body, maxChars = 600) {
   if (!isAutoRecap(body)) return body;
   const goalMatch = body.match(/##+\s*Goal[^\n]*\n+([^\n]+)/i);
   const callsMatch = body.match(/Auto-captured session \(([^)]+)\)/i);
-  const header = goalMatch?.[1]?.trim() ? `_${goalMatch[1].trim()}_` : callsMatch ? `_Auto-captured session (${callsMatch[1]})._` : "_Auto-captured session._";
+  const header2 = goalMatch?.[1]?.trim() ? `_${goalMatch[1].trim()}_` : callsMatch ? `_Auto-captured session (${callsMatch[1]})._` : "_Auto-captured session._";
   const discMatch = body.match(/##+\s*Discoveries[^\n]*\n([\s\S]*?)(?=\n##+\s|\n*$)/i);
   const discovery = discMatch?.[1]?.trim() ?? "";
   const trivialDiscovery = discovery === "" || /^no (new memories|surprising)/i.test(discovery) || /No new memories saved this session\.?$/i.test(discovery);
   if (trivialDiscovery) {
-    return `${header}
+    return `${header2}
 
 _No notable discoveries captured. Run post_task / \`mem_session_end\` for a richer recap._`;
   }
   const trimmed = discovery.length > maxChars ? discovery.slice(0, maxChars) + "\u2026" : discovery;
-  return `${header}
+  return `${header2}
 
 **Discoveries:**
 ${trimmed}`;
@@ -5749,6 +5882,7 @@ export {
   SESSION_RECAP_TTL_MS,
   STACK_PACK_TAG,
   SensorSchema,
+  TEST_FRAMEWORKS,
   USAGE_FILE,
   USAGE_LOG_DIR,
   USAGE_LOG_FILE,
@@ -5853,6 +5987,7 @@ export {
   isStylisticRule,
   isTemplateProjectContext,
   judgeProposedSensor,
+  lessonShortName,
   listMarkdownFilesRecursive,
   literalMatchesAllTokens,
   literalMatchesAnyToken,
@@ -5876,11 +6011,13 @@ export {
   moduleNameOf,
   newMemoryId,
   normalizeFindingSeverity,
+  normalizeFramework,
   normalizeSessionId,
   overallScore,
   parseEslintJson,
   parseFileAst,
   parseFindings,
+  parseLessonFields,
   parseMemory,
   parseNpmAudit,
   parseSarif,
@@ -5888,6 +6025,7 @@ export {
   parseSonar,
   pathsOverlap,
   pickSnippetNeedle,
+  pickTestFramework,
   planConflictResolution,
   planGitWatch,
   prepareBridgeData,
@@ -5928,6 +6066,7 @@ export {
   saveCodeMap,
   saveConfig,
   saveUsageIndex,
+  scaffoldPostIncidentTest,
   scannableSensorTargets,
   scoreRetrievalCase,
   scoreSensorCase,