@hivelore/core 0.57.3 → 0.57.5

package/dist/index.d.ts

@@ -304,6 +304,16 @@ declare const MemoryFrontmatterSchema: z.ZodEffects<z.ZodObject<{
      * Lets a human distinguish reviewed knowledge from AI/auto-trusted knowledge.
      */
     validated_by: z.ZodDefault<z.ZodNullable<z.ZodEnum<["human", "agent", "auto"]>>>;
+    /**
+     * Does this memory describe code that EXISTS today, or a decision not yet built? Orthogonal to
+     * `confidence`/`status`: a `planned` decision can be fully trusted AS a decision while being false
+     * AS a description of the current code. Surfaced distinctly in briefings so an agent does not write
+     * code against a cookie/route/Node version that was only decided, never implemented (field report §3.3).
+     *   applied   — reflected in the code now (the default when omitted)
+     *   planned   — decided/intended, NOT yet implemented
+     *   abandoned — considered and rejected; kept so it is not re-attempted
+     */
+    lifecycle: z.ZodOptional<z.ZodEnum<["applied", "planned", "abandoned"]>>;
 }, "strip", z.ZodTypeAny, {
     type: "convention" | "decision" | "gotcha" | "architecture" | "glossary" | "skill" | "attempt" | "session_recap";
     status: "draft" | "proposed" | "validated" | "deprecated" | "stale" | "rejected";
@@ -351,6 +361,7 @@ declare const MemoryFrontmatterSchema: z.ZodEffects<z.ZodObject<{
     domain?: string | undefined;
     author?: string | undefined;
     topic?: string | undefined;
+    lifecycle?: "applied" | "planned" | "abandoned" | undefined;
 }, {
     type: "convention" | "decision" | "gotcha" | "architecture" | "glossary" | "skill" | "attempt" | "session_recap";
     id: string;
@@ -398,6 +409,7 @@ declare const MemoryFrontmatterSchema: z.ZodEffects<z.ZodObject<{
     revision_count?: number | undefined;
     requires_human_approval?: boolean | undefined;
     validated_by?: "human" | "agent" | "auto" | null | undefined;
+    lifecycle?: "applied" | "planned" | "abandoned" | undefined;
 }>, {
     type: "convention" | "decision" | "gotcha" | "architecture" | "glossary" | "skill" | "attempt" | "session_recap";
     status: "draft" | "proposed" | "validated" | "deprecated" | "stale" | "rejected";
@@ -445,6 +457,7 @@ declare const MemoryFrontmatterSchema: z.ZodEffects<z.ZodObject<{
     domain?: string | undefined;
     author?: string | undefined;
     topic?: string | undefined;
+    lifecycle?: "applied" | "planned" | "abandoned" | undefined;
 }, {
     type: "convention" | "decision" | "gotcha" | "architecture" | "glossary" | "skill" | "attempt" | "session_recap";
     id: string;
@@ -492,6 +505,7 @@ declare const MemoryFrontmatterSchema: z.ZodEffects<z.ZodObject<{
     revision_count?: number | undefined;
     requires_human_approval?: boolean | undefined;
     validated_by?: "human" | "agent" | "auto" | null | undefined;
+    lifecycle?: "applied" | "planned" | "abandoned" | undefined;
 }>;
 declare const CrossRepoProvenanceSchema: z.ZodOptional<z.ZodObject<{
     source_name: z.ZodString;
@@ -542,6 +556,7 @@ declare function buildFrontmatter(input: {
     relatedIds?: string[];
     sensor?: Sensor;
     activation?: Activation;
+    lifecycle?: MemoryFrontmatter["lifecycle"];
 }): MemoryFrontmatter;
 
 declare const HAIVE_DIR = ".ai";
@@ -1159,6 +1174,19 @@ declare function auditAnchorSpecificity(memories: ReadonlyArray<{
     anchorPaths: readonly string[];
 }>, fileChurn: AnchorChurn, totalCommits: number): AnchorAuditRow[];
 
+/**
+ * One ordering for dotted version strings, shared by everything in the release chain.
+ *
+ * There were three byte-identical copies of this — two in core, one in the CLI — because each new
+ * release check wrote its own rather than look for one. Ordering is the kind of thing that must
+ * not disagree with itself between two gates reading the same tags.
+ *
+ * Deliberately lenient, not a semver parser: it splits on `.` and `-`, reads each part as an
+ * integer and treats anything unparseable as 0. Inputs here are tags and registry versions the
+ * repo produced itself, and a comparator that throws would turn an advisory check into a crash.
+ */
+declare function compareVersions(a: string, b: string): number;
+
 /**
  * Did the tagged releases actually reach the registry?
  *
@@ -1195,6 +1223,52 @@ interface NpmPublicationVerdict {
 }
 declare function classifyNpmPublication(input: NpmPublicationInput): NpmPublicationVerdict;
 
+/**
+ * Did the tags that were meant to be releases become GitHub Releases?
+ *
+ * The npm check ([[npm-publication.ts]]) closed one end of the release chain. This closes the
+ * other. They are not the same signal: npm is where the code is *installed from*, a GitHub Release
+ * is where the version is *announced* — changelog, provenance, and the thing listing directories
+ * and score checkers read to decide whether a project ships. This repo carried 190 version tags
+ * and zero Releases, and the only reason anyone noticed was a third-party listing scoring it down.
+ *
+ * ## The pre-adoption rule is the whole design
+ *
+ * A repo that adopts Releases at version 0.57 has 189 older tags that were never going to be
+ * Releases. Calling those "skipped" would mean a permanent warning that no action can ever clear,
+ * and a warning you cannot clear is one people learn to scroll past. So only tags **newer than the
+ * oldest Release** count: gaps that opened *after* the repo started releasing. Adopting the
+ * practice retroactively cleans nothing, and is not asked to.
+ *
+ * Severities mirror the npm check exactly, and for the same reason — `finish` runs BEFORE you
+ * publish, so "HEAD has no Release yet" is the normal state and can only be info. Never an error:
+ * publishing is the human's call.
+ *
+ * Pure: listing tags and asking GitHub happen in the caller.
+ */
+type GithubReleaseCode = "github-release-published" | "github-release-pending" | "github-releases-skipped" | "github-releases-absent" | "github-release-unverified";
+interface GithubReleaseInput {
+    /** Version in the working tree (the lockstep version). */
+    localVersion: string;
+    /**
+     * Versions that have a published, non-draft GitHub Release. `null` means the lookup could not
+     * run at all — no `gh`, no network, not a GitHub remote — which is "cannot tell", not a defect.
+     */
+    releasedVersions: readonly string[] | null;
+    /** Every version tag in the repo, without the `v` prefix. */
+    taggedVersions: readonly string[];
+    /** How to create one, injected so core stays free of tooling opinions. */
+    releaseHint?: string;
+}
+interface GithubReleaseVerdict {
+    code: GithubReleaseCode;
+    severity: "ok" | "info" | "warn";
+    message: string;
+    fix?: string;
+}
+/** `null` when there is nothing worth saying — an untagged repo has no release chain to check. */
+declare function classifyGithubRelease(input: GithubReleaseInput): GithubReleaseVerdict | null;
+
 type MemoryPriority = "must_read" | "useful" | "background";
 /**
  * Normalized priority evidence. A caller fills only the signals it can compute; unknown ones default
@@ -2028,6 +2102,16 @@ interface HaiveConfig {
          * unpublished release looks exactly like a shipped one.
          */
         npmPublishCheck?: "off" | "warn";
+        /**
+         * Whether `hivelore enforce finish` checks that tagged versions became GitHub Releases.
+         * Default on; set "off" for repos that deliberately tag without releasing.
+         *
+         * It never blocks, and it never asks you to backfill: only tags NEWER than the oldest existing
+         * Release are reported as gaps, so adopting Releases mid-history does not produce a warning
+         * that no action can clear. A repo with tags and no Release at all gets one info line — tags
+         * are not Releases, and listing/scoring tools read Releases.
+         */
+        githubReleaseCheck?: "off" | "warn";
         /**
          * How `hivelore enforce finish` reacts to hard failures observed this session that were never
          * captured as a lesson (`mem_tried`):
@@ -2555,8 +2639,10 @@ declare function isRetiredMemory(fm: MemoryFrontmatter, body?: string, now?: Dat
 /**
  * Is a regex sensor pattern brittle — over-fit to incident-specific literals that rot when code
  * shifts (hardcoded line numbers / ranges like `1131-1186`)? High-precision by design: digits that
- * live inside a character class (`[0-9]`) or quantifier (`{2,}`) generalize and are NOT flagged, so
- * durable patterns like `v[0-9]+\.[0-9]+` or `:\s*any\b` stay clean. Returns a short reason or null.
+ * live inside a character class (`[0-9]`) or quantifier (`{2,}`), regex escapes (`\d`, `\w`, `\s`),
+ * or a dotted-quad IP / version literal (`127\.0\.0\.1`, `1\.2\.3`) all GENERALIZE and are NOT
+ * flagged — so durable patterns like `v[0-9]+\.[0-9]+`, `:\s*any\b`, or `https?://127\.0\.0\.1:\d+`
+ * stay clean. Returns a short reason naming the offending token, or null.
  *
  * Used to keep brittle legacy sensors from being counted as real protection or promoted to `block`.
  */
@@ -4023,4 +4109,4 @@ interface ReviewDraftOptions {
 /** Template review learnings into proposed-memory drafts (reuses the scanner-ingest draft shape). */
 declare function reviewLearningsToDrafts(learnings: ReviewLearning[], options?: ReviewDraftOptions): MemoryDraft[];
 
-export { AUTOPILOT_DEFAULTS, type Activation, type ActivationContext, ActivationSchema, type AgentContext, type Anchor, type AnchorAuditRow, type AnchorChurn, AnchorSchema, type AntiPatternGate, type AppendFrictionInput, type AppendFrictionResult, type AppliedConflictResolution, type AstExport, type AutoPromoteRule, BRIDGE_MARKERS, BRIDGE_TARGETS, BRIDGE_TARGET_PATH, BRIEFING_MARKER_TTL_MS, BRIEFING_PRESET_DEFAULTS, type BaselineHealth, type BehaviourCoverageInput, type BehaviourCoverageMetrics, type BehaviourOracleInfo, type BootstrapAssessment, type BootstrapGap, type BootstrapGate, type BootstrapMetrics, type BootstrapState, type BootstrapStateInput, type BreakingChange, type BridgeFileOutput, type BridgeMemoryEntry, type BridgeSensor, type BridgeTarget, type BriefingBudgetNumbers, type BriefingBudgetPreset, type BriefingMarker, type BriefingProofLineOptions, type BudgetPart, type BudgetSlice, type BuildCodeMapOptions, CHARS_PER_TOKEN, CODE_MAP_DEFAULT_EXCLUDE, CODE_MAP_DEFAULT_INCLUDE, CODE_MAP_FILE, CODE_STOPWORDS, CONFIG_FILE, CONTENT_CATCH_CODES, type CaughtForYouOptions, type CaughtForYouRow, type CaughtForYouSummary, type CodeExport, type CodeExportKind, type CodeFileEntry, type CodeMap, type CodeMapQueryOptions, type CollectTimelineOpts, type CommandSensorSpec, type ConfidenceLevel, type ConfidenceThresholds, type ConflictCandidatePair, type ConflictCandidatesOpts, type ConflictResolution, type ContractCheck, type ContractDiffResult, type ContractFile, type ContractSnapshot, type CoverageGap, type CoverageOptions, CrossRepoProvenanceSchema, type CrossRepoReport, type CrossRepoSource, DECAY_DAYS, DEFAULT_AUTO_PROMOTE_RULE, DEFAULT_BRIEFING_EXCLUDE_TAGS, DEFAULT_CONFIDENCE_THRESHOLDS, DEFAULT_CONFIG, DEFAULT_DORMANT_DAYS, DEFAULT_POSTURE, DEFAULT_PRIORITY_SIGNALS, DEFAULT_SPECIFICITY, type DashboardOptions, type DashboardReport, type DepChange, type DepTrackResult, type DependencySnapshot, type DetectStacksInput, type DetectableStack, type DistilledFailureLesson, type DocFrequency, type DormantRow, type DraftOptions, type DraftsOptions, ENV_WORKAROUND_TAGS, type EvalDelta, type EvalHistoryEntry, type EvalReport, type EvalSpec, type EvalTrend, FRICTION_FIELD_MAX, FRICTION_LOG_FILE, FRICTION_STATE_FILE, type FailureCoverageOptions, type FailureObservation, type FeedbackAdjustment, type FeedbackAdjustmentAction, type FeedbackAdjustmentOptions, type Finding, type FindingFormat, type FindingSeverity, type FrictionGroup, type FrictionKind, type FrictionReport, type FrictionState, type FrictionStateEntry, type FrictionStatus, GATE_REMINDER_WINDOW_MS, GUESSABLE_THRESHOLD, type GateFinding, type GateMissProposal, type GatePolicy, type GatePolicyInput, type GatePosture, type GatePrecision, type GatePrecisionDelta, type GatePrecisionMetricDelta, type GateSeverity, type GateStage, type GateTuningSuggestion, type GateVerdict, type GateVerdictInput, type GenerateBridgesOptions, type GitCommit, type GitWatchPlan, type GitWatchState, HAIVE_DIR, HAIVE_OWNED_FILES, HANDOFF_FILENAME, HIVELORE_ATTRIBUTION, type HaiveConfig, type HaivePaths, type HotFile, type HotFileSource, type ImpactOptions, type ImpactRow, type ImpactScore, type ImpactSummary, type ImpactTier, type IncidentHints, type InvalidMemoryFile, LEGACY_CONFIG_FILE, type LexicalRankResult, type LoadedMemory, MEMORIES_DIR, MIN_WORD_LEN, type Memory, type MemoryDraft, type MemoryFrontmatter, MemoryFrontmatterSchema, type MemoryPriority, type MemoryScope, MemoryScopeSchema, type MemoryStatus, MemoryStatusSchema, type MemoryType, MemoryTypeSchema, type MemoryUsage, type MergeResult, type MetricDelta, type NpmPublicationCode, type NpmPublicationInput, type NpmPublicationVerdict, PREVENTION_DEBOUNCE_MS, PREVENTION_RECEIPT_MARKER, PROCESS_GATE_CODES, PROJECT_CONTEXT_FILE, PROJECT_CONTEXT_THROTTLE_MS, type PostIncidentLesson, type PreventionCommentFinding, type PreventionEvent, type PreventionEventDetail, type PreventionReceipt, type PreventionReceiptRow, type PreventionRow, type PreventionSource, type PreventionTrend, type PrioritySignals, type ProposedEvalSpec, type ProposedSensorVerdict, REVIEW_LEARNING_MARKER, RUNTIME_JOURNAL_FILENAME, type RecurrenceReport, type RecurrenceRow, type ResolveProjectInfo, type RetirementSignal, type RetrievalAggregate, type RetrievalCase, type RetrievalCaseResult, type ReviewDraftOptions, type ReviewLearning, type RuntimeJournalEntry, SCAFFOLD_MARKER_RE, SEED_QUALITY_FLOOR, SENSOR_ABSENT_LOOKBACK, SENSOR_ABSENT_WINDOW, SESSION_RECAP_TTL_MS, SETUP_GATE_CODES, STACK_PACK_TAG, type ScaffoldLoopGap, type ScaffoldOptions, type ScaffoldStyle, type SeedProposal, type SelfEvalOptions, type Sensor, type SensorAggregate, type SensorCase, type SensorCaseResult, type SensorEvaluation, type SensorEvaluationOutcome, type SensorEvaluationStage, type SensorFlap, type SensorHealth, type SensorHit, type SensorRow, SensorSchema, type SensorSeed, type SensorSelfCheck, type SensorSuggestionOptions, type SensorTarget, type SensorWeakening, type SessionHandoffData, type SkillActivation, TEST_FRAMEWORKS, type TestFramework, type TestScaffold, type TierContractCheck, type TimelineEntry, type TopicStatusPair, type TruncateOptions, type TruncateResult, USAGE_FILE, USAGE_LOG_DIR, USAGE_LOG_FILE, type UncapturedFailure, type UncoveredAreaSuggestion, type UsageAggregate, type UsageEvent, type UsageIndex, type VerifyOptions, type VerifyResult, WEAK_ANCHOR_CHURN_RATIO, addedLineNumbersFromDiff, addedLinesFromDiff, aggregateRetrieval, aggregateSensors, aggregateUsage, allocateBudget, anchorMatchesComponent, anchorSpecificity, antiPatternGateParams, appendEvalHistory, appendFrictionReport, appendPreventionEvent, appendProposedRetrievalCases, appendRuntimeJournalEntry, appendSensorEvaluations, appendUsageEvent, applyConflictResolution, applyFeedbackAdjustment, approveProposedCases, assessBehaviourCoverage, assessBootstrapState, assessScaffoldLoop, assessSensorHealth, auditAnchorSpecificity, bridgeMemorySummary, briefingMarkerPath, briefingMarkersDir, briefingProofLine, buildBaselineHealthFinding, buildCodeMap, buildCoverageIndex, buildDashboard, buildDocFrequency, buildFrontmatter, buildHandoffMarkdown, buildPreventionReceipt, buildProposeCommand, buildReport, bumpRead, churnForAnchors, classifyMemoryPriority, classifyNpmPublication, codeMapContentHash, codeMapPath, collectTimelineEntries, compactAutoRecapBody, compareEvalReports, compareGatePrecision, compareImpact, compileRegexSensor, componentOf, computeBaselineHealth, computeEvalTrend, computeGatePrecision, computeImpact, computePreventionTrend, computeRecurrence, computeScopeHash, configPath, contractLockPath, countSourceFilesOnDisk, decideVerdict, dedupeRefusals, deriveConfidence, deriveMainAreas, describePosture, detectAgentContext, detectSensorWeakening, detectStacksFromManifests, diffContract, diffHasDistinctiveOverlap, distillFailureObservations, distinctiveCap, draftsFromFindings, emptyUsage, emptyUsageIndex, enforcementDir, estimateTokens, evalHistoryPath, evaluateSkillActivation, existingGateMissShas, explainSensorRejection, extractActionsBriefBody, extractCorrectApproachExamples, extractReferencedPaths, extractReviewLearnings, extractSensorExamples, extractSnippet, extractTestFilePathsFromCommand, filterNewDrafts, findCoverageGaps, findLexicalConflictPairs, findProjectRoot, findTopicStatusConflictPairs, findUncapturedFailures, findingBody, findingToDraft, firstMemoryOneLine, formatFrictionIssue, frictionFingerprint, frictionLogPath, frictionStatePath, gatePassedShas, generateBridges, getUsage, globToRegExp, groupFriction, handoffAgeMs, handoffFilePath, hasPendingTestMarker, hasRecentBriefingMarker, hashProjectContext, incidentHintsFromDiff, incidentSuffix, inferModulesFromPaths, isAutoPromoteEligible, isAutoRecap, isCovered, isDecaying, isDistinctiveToken, isEnvWorkaroundMemory, isFreshIsoDate, isGlobPath, isHarnessErrorOutput, isLikelyGuessable, isNoiseSubject, isProductionCodeFile, isRetiredMemory, isSensorScannablePath, isSkill, isSkillSuppressed, isStackPackSeed, isStylisticRule, isTemplateProjectContext, isWeakAnchor, judgeProposedSensor, lessonShortName, listMarkdownFilesRecursive, literalMatchesAllTokens, literalMatchesAnyToken, loadCodeMap, loadConfig, loadConfigSync, loadEvalHistory, loadFrictionState, loadMemoriesFromDir, loadMemoriesFromDirDetailed, loadMemory, loadPreventionEvents, loadSensorLedger, loadUsageIndex, looksLikeGenericAdvice, meetsSeedQualityFloor, memoryFilePath, memoryHasExcludedTag, memoryMatchesAnchorPaths, mergeHotFiles, mergeMemoryVersions, mineSensorSeedFromDiff, moduleNameOf, newMemoryId, normalizeChurnPath, normalizeFindingSeverity, normalizeFramework, normalizeFrictionSummary, normalizeKind, normalizeScaffoldStyle, normalizeSessionId, overallScore, parseEslintJson, parseFileAst, parseFindings, parseLessonFields, parseMemory, parseNpmAudit, parseSarif, parseSince, parseSonar, pathsOverlap, pickSnippetNeedle, pickTestFramework, planConflictResolution, planGitWatch, prepareBridgeData, preventionLogPath, priorityRank, prioritySignals, projectContextRecentlyEmitted, proposeGateMissDrafts, proposeSeedsFromCommits, pullCrossRepoSources, quarantineNote, queryCodeMap, rankMemoriesLexical, readFrictionReports, readRecentBriefingMarker, readRuntimeJournalTail, readSessionHandoff, readUsageEvents, recommendFeedbackAdjustment, recordApplied, recordGateReminder, recordPrevention, recordPreventionHits, recordProjectContextEmission, recordRejection, relPathFrom, renderBehaviourCoverageLine, renderBootstrapChecklist, renderCaughtForYou, renderPreventionComment, renderPreventionReceipt, renderPreventionReceiptShare, resolveBriefingBudget, resolveConfigPath, resolveGatePolicy, resolveHaivePaths, resolveManifestFiles, resolveProjectInfo, retirementSignal, revertedShaFromCommit, reviewLearningsToDrafts, runRegexSensor, runSensors, runTierContract, runValidationContract, runtimeJournalPath, saveCodeMap, saveConfig, saveFrictionState, saveUsageIndex, scaffoldPostIncidentTest, scannableSensorTargets, scoreRetrievalCase, scoreSensorCase, scrubbedCommandEnv, selectCommandSensors, sensorAppliesToPath, sensorLedgerPath, sensorPatternBrittleness, sensorPromotedAtMap, sensorSelfCheck, sensorTargetsFromDiff, serializeCodeMap, serializeMemory, setFrictionStatus, shouldExpandGateReminder, snapshotContract, specificityScore, stripPrivate, suggestGate, suggestSensorFromMemory, suggestSensorSeed, suggestTopicKey, summarizeCaughtForYou, summarizeImpact, synthesizeSelfEvalCases, tallyHotFiles, titleFromBody, tokenizeQuery, tokenizeWords, trackDependencies, trackReads, truncateToTokens, usageLogPath, usageLogSize, usagePath, verifyAnchor, watchContracts, withQuarantineNote, withoutQuarantineNote, writeBriefingMarker, writeSessionHandoff };
+export { AUTOPILOT_DEFAULTS, type Activation, type ActivationContext, ActivationSchema, type AgentContext, type Anchor, type AnchorAuditRow, type AnchorChurn, AnchorSchema, type AntiPatternGate, type AppendFrictionInput, type AppendFrictionResult, type AppliedConflictResolution, type AstExport, type AutoPromoteRule, BRIDGE_MARKERS, BRIDGE_TARGETS, BRIDGE_TARGET_PATH, BRIEFING_MARKER_TTL_MS, BRIEFING_PRESET_DEFAULTS, type BaselineHealth, type BehaviourCoverageInput, type BehaviourCoverageMetrics, type BehaviourOracleInfo, type BootstrapAssessment, type BootstrapGap, type BootstrapGate, type BootstrapMetrics, type BootstrapState, type BootstrapStateInput, type BreakingChange, type BridgeFileOutput, type BridgeMemoryEntry, type BridgeSensor, type BridgeTarget, type BriefingBudgetNumbers, type BriefingBudgetPreset, type BriefingMarker, type BriefingProofLineOptions, type BudgetPart, type BudgetSlice, type BuildCodeMapOptions, CHARS_PER_TOKEN, CODE_MAP_DEFAULT_EXCLUDE, CODE_MAP_DEFAULT_INCLUDE, CODE_MAP_FILE, CODE_STOPWORDS, CONFIG_FILE, CONTENT_CATCH_CODES, type CaughtForYouOptions, type CaughtForYouRow, type CaughtForYouSummary, type CodeExport, type CodeExportKind, type CodeFileEntry, type CodeMap, type CodeMapQueryOptions, type CollectTimelineOpts, type CommandSensorSpec, type ConfidenceLevel, type ConfidenceThresholds, type ConflictCandidatePair, type ConflictCandidatesOpts, type ConflictResolution, type ContractCheck, type ContractDiffResult, type ContractFile, type ContractSnapshot, type CoverageGap, type CoverageOptions, CrossRepoProvenanceSchema, type CrossRepoReport, type CrossRepoSource, DECAY_DAYS, DEFAULT_AUTO_PROMOTE_RULE, DEFAULT_BRIEFING_EXCLUDE_TAGS, DEFAULT_CONFIDENCE_THRESHOLDS, DEFAULT_CONFIG, DEFAULT_DORMANT_DAYS, DEFAULT_POSTURE, DEFAULT_PRIORITY_SIGNALS, DEFAULT_SPECIFICITY, type DashboardOptions, type DashboardReport, type DepChange, type DepTrackResult, type DependencySnapshot, type DetectStacksInput, type DetectableStack, type DistilledFailureLesson, type DocFrequency, type DormantRow, type DraftOptions, type DraftsOptions, ENV_WORKAROUND_TAGS, type EvalDelta, type EvalHistoryEntry, type EvalReport, type EvalSpec, type EvalTrend, FRICTION_FIELD_MAX, FRICTION_LOG_FILE, FRICTION_STATE_FILE, type FailureCoverageOptions, type FailureObservation, type FeedbackAdjustment, type FeedbackAdjustmentAction, type FeedbackAdjustmentOptions, type Finding, type FindingFormat, type FindingSeverity, type FrictionGroup, type FrictionKind, type FrictionReport, type FrictionState, type FrictionStateEntry, type FrictionStatus, GATE_REMINDER_WINDOW_MS, GUESSABLE_THRESHOLD, type GateFinding, type GateMissProposal, type GatePolicy, type GatePolicyInput, type GatePosture, type GatePrecision, type GatePrecisionDelta, type GatePrecisionMetricDelta, type GateSeverity, type GateStage, type GateTuningSuggestion, type GateVerdict, type GateVerdictInput, type GenerateBridgesOptions, type GitCommit, type GitWatchPlan, type GitWatchState, type GithubReleaseCode, type GithubReleaseInput, type GithubReleaseVerdict, HAIVE_DIR, HAIVE_OWNED_FILES, HANDOFF_FILENAME, HIVELORE_ATTRIBUTION, type HaiveConfig, type HaivePaths, type HotFile, type HotFileSource, type ImpactOptions, type ImpactRow, type ImpactScore, type ImpactSummary, type ImpactTier, type IncidentHints, type InvalidMemoryFile, LEGACY_CONFIG_FILE, type LexicalRankResult, type LoadedMemory, MEMORIES_DIR, MIN_WORD_LEN, type Memory, type MemoryDraft, type MemoryFrontmatter, MemoryFrontmatterSchema, type MemoryPriority, type MemoryScope, MemoryScopeSchema, type MemoryStatus, MemoryStatusSchema, type MemoryType, MemoryTypeSchema, type MemoryUsage, type MergeResult, type MetricDelta, type NpmPublicationCode, type NpmPublicationInput, type NpmPublicationVerdict, PREVENTION_DEBOUNCE_MS, PREVENTION_RECEIPT_MARKER, PROCESS_GATE_CODES, PROJECT_CONTEXT_FILE, PROJECT_CONTEXT_THROTTLE_MS, type PostIncidentLesson, type PreventionCommentFinding, type PreventionEvent, type PreventionEventDetail, type PreventionReceipt, type PreventionReceiptRow, type PreventionRow, type PreventionSource, type PreventionTrend, type PrioritySignals, type ProposedEvalSpec, type ProposedSensorVerdict, REVIEW_LEARNING_MARKER, RUNTIME_JOURNAL_FILENAME, type RecurrenceReport, type RecurrenceRow, type ResolveProjectInfo, type RetirementSignal, type RetrievalAggregate, type RetrievalCase, type RetrievalCaseResult, type ReviewDraftOptions, type ReviewLearning, type RuntimeJournalEntry, SCAFFOLD_MARKER_RE, SEED_QUALITY_FLOOR, SENSOR_ABSENT_LOOKBACK, SENSOR_ABSENT_WINDOW, SESSION_RECAP_TTL_MS, SETUP_GATE_CODES, STACK_PACK_TAG, type ScaffoldLoopGap, type ScaffoldOptions, type ScaffoldStyle, type SeedProposal, type SelfEvalOptions, type Sensor, type SensorAggregate, type SensorCase, type SensorCaseResult, type SensorEvaluation, type SensorEvaluationOutcome, type SensorEvaluationStage, type SensorFlap, type SensorHealth, type SensorHit, type SensorRow, SensorSchema, type SensorSeed, type SensorSelfCheck, type SensorSuggestionOptions, type SensorTarget, type SensorWeakening, type SessionHandoffData, type SkillActivation, TEST_FRAMEWORKS, type TestFramework, type TestScaffold, type TierContractCheck, type TimelineEntry, type TopicStatusPair, type TruncateOptions, type TruncateResult, USAGE_FILE, USAGE_LOG_DIR, USAGE_LOG_FILE, type UncapturedFailure, type UncoveredAreaSuggestion, type UsageAggregate, type UsageEvent, type UsageIndex, type VerifyOptions, type VerifyResult, WEAK_ANCHOR_CHURN_RATIO, addedLineNumbersFromDiff, addedLinesFromDiff, aggregateRetrieval, aggregateSensors, aggregateUsage, allocateBudget, anchorMatchesComponent, anchorSpecificity, antiPatternGateParams, appendEvalHistory, appendFrictionReport, appendPreventionEvent, appendProposedRetrievalCases, appendRuntimeJournalEntry, appendSensorEvaluations, appendUsageEvent, applyConflictResolution, applyFeedbackAdjustment, approveProposedCases, assessBehaviourCoverage, assessBootstrapState, assessScaffoldLoop, assessSensorHealth, auditAnchorSpecificity, bridgeMemorySummary, briefingMarkerPath, briefingMarkersDir, briefingProofLine, buildBaselineHealthFinding, buildCodeMap, buildCoverageIndex, buildDashboard, buildDocFrequency, buildFrontmatter, buildHandoffMarkdown, buildPreventionReceipt, buildProposeCommand, buildReport, bumpRead, churnForAnchors, classifyGithubRelease, classifyMemoryPriority, classifyNpmPublication, codeMapContentHash, codeMapPath, collectTimelineEntries, compactAutoRecapBody, compareEvalReports, compareGatePrecision, compareImpact, compareVersions, compileRegexSensor, componentOf, computeBaselineHealth, computeEvalTrend, computeGatePrecision, computeImpact, computePreventionTrend, computeRecurrence, computeScopeHash, configPath, contractLockPath, countSourceFilesOnDisk, decideVerdict, dedupeRefusals, deriveConfidence, deriveMainAreas, describePosture, detectAgentContext, detectSensorWeakening, detectStacksFromManifests, diffContract, diffHasDistinctiveOverlap, distillFailureObservations, distinctiveCap, draftsFromFindings, emptyUsage, emptyUsageIndex, enforcementDir, estimateTokens, evalHistoryPath, evaluateSkillActivation, existingGateMissShas, explainSensorRejection, extractActionsBriefBody, extractCorrectApproachExamples, extractReferencedPaths, extractReviewLearnings, extractSensorExamples, extractSnippet, extractTestFilePathsFromCommand, filterNewDrafts, findCoverageGaps, findLexicalConflictPairs, findProjectRoot, findTopicStatusConflictPairs, findUncapturedFailures, findingBody, findingToDraft, firstMemoryOneLine, formatFrictionIssue, frictionFingerprint, frictionLogPath, frictionStatePath, gatePassedShas, generateBridges, getUsage, globToRegExp, groupFriction, handoffAgeMs, handoffFilePath, hasPendingTestMarker, hasRecentBriefingMarker, hashProjectContext, incidentHintsFromDiff, incidentSuffix, inferModulesFromPaths, isAutoPromoteEligible, isAutoRecap, isCovered, isDecaying, isDistinctiveToken, isEnvWorkaroundMemory, isFreshIsoDate, isGlobPath, isHarnessErrorOutput, isLikelyGuessable, isNoiseSubject, isProductionCodeFile, isRetiredMemory, isSensorScannablePath, isSkill, isSkillSuppressed, isStackPackSeed, isStylisticRule, isTemplateProjectContext, isWeakAnchor, judgeProposedSensor, lessonShortName, listMarkdownFilesRecursive, literalMatchesAllTokens, literalMatchesAnyToken, loadCodeMap, loadConfig, loadConfigSync, loadEvalHistory, loadFrictionState, loadMemoriesFromDir, loadMemoriesFromDirDetailed, loadMemory, loadPreventionEvents, loadSensorLedger, loadUsageIndex, looksLikeGenericAdvice, meetsSeedQualityFloor, memoryFilePath, memoryHasExcludedTag, memoryMatchesAnchorPaths, mergeHotFiles, mergeMemoryVersions, mineSensorSeedFromDiff, moduleNameOf, newMemoryId, normalizeChurnPath, normalizeFindingSeverity, normalizeFramework, normalizeFrictionSummary, normalizeKind, normalizeScaffoldStyle, normalizeSessionId, overallScore, parseEslintJson, parseFileAst, parseFindings, parseLessonFields, parseMemory, parseNpmAudit, parseSarif, parseSince, parseSonar, pathsOverlap, pickSnippetNeedle, pickTestFramework, planConflictResolution, planGitWatch, prepareBridgeData, preventionLogPath, priorityRank, prioritySignals, projectContextRecentlyEmitted, proposeGateMissDrafts, proposeSeedsFromCommits, pullCrossRepoSources, quarantineNote, queryCodeMap, rankMemoriesLexical, readFrictionReports, readRecentBriefingMarker, readRuntimeJournalTail, readSessionHandoff, readUsageEvents, recommendFeedbackAdjustment, recordApplied, recordGateReminder, recordPrevention, recordPreventionHits, recordProjectContextEmission, recordRejection, relPathFrom, renderBehaviourCoverageLine, renderBootstrapChecklist, renderCaughtForYou, renderPreventionComment, renderPreventionReceipt, renderPreventionReceiptShare, resolveBriefingBudget, resolveConfigPath, resolveGatePolicy, resolveHaivePaths, resolveManifestFiles, resolveProjectInfo, retirementSignal, revertedShaFromCommit, reviewLearningsToDrafts, runRegexSensor, runSensors, runTierContract, runValidationContract, runtimeJournalPath, saveCodeMap, saveConfig, saveFrictionState, saveUsageIndex, scaffoldPostIncidentTest, scannableSensorTargets, scoreRetrievalCase, scoreSensorCase, scrubbedCommandEnv, selectCommandSensors, sensorAppliesToPath, sensorLedgerPath, sensorPatternBrittleness, sensorPromotedAtMap, sensorSelfCheck, sensorTargetsFromDiff, serializeCodeMap, serializeMemory, setFrictionStatus, shouldExpandGateReminder, snapshotContract, specificityScore, stripPrivate, suggestGate, suggestSensorFromMemory, suggestSensorSeed, suggestTopicKey, summarizeCaughtForYou, summarizeImpact, synthesizeSelfEvalCases, tallyHotFiles, titleFromBody, tokenizeQuery, tokenizeWords, trackDependencies, trackReads, truncateToTokens, usageLogPath, usageLogSize, usagePath, verifyAnchor, watchContracts, withQuarantineNote, withoutQuarantineNote, writeBriefingMarker, writeSessionHandoff };

package/dist/index.js

@@ -135,7 +135,17 @@ var MemoryFrontmatterSchema = z.object({
    * null when the memory is not yet validated, or on legacy memories written before this field.
    * Lets a human distinguish reviewed knowledge from AI/auto-trusted knowledge.
    */
-  validated_by: z.enum(["human", "agent", "auto"]).nullable().default(null)
+  validated_by: z.enum(["human", "agent", "auto"]).nullable().default(null),
+  /**
+   * Does this memory describe code that EXISTS today, or a decision not yet built? Orthogonal to
+   * `confidence`/`status`: a `planned` decision can be fully trusted AS a decision while being false
+   * AS a description of the current code. Surfaced distinctly in briefings so an agent does not write
+   * code against a cookie/route/Node version that was only decided, never implemented (field report §3.3).
+   *   applied   — reflected in the code now (the default when omitted)
+   *   planned   — decided/intended, NOT yet implemented
+   *   abandoned — considered and rejected; kept so it is not re-attempted
+   */
+  lifecycle: z.enum(["applied", "planned", "abandoned"]).optional()
 }).refine(
   (data) => data.scope !== "module" || !!data.module,
   { message: "module name is required when scope is 'module'", path: ["module"] }
@@ -153,15 +163,30 @@ var CrossRepoProvenanceSchema = z.object({
 
 // src/parser.ts
 import matter from "gray-matter";
+import "zod";
 var PRIVATE_BLOCK_RE = /<private>[\s\S]*?<\/private>/g;
 function stripPrivate(body) {
   return body.replace(PRIVATE_BLOCK_RE, "").trimEnd();
 }
+function formatFrontmatterError(err) {
+  const issue = err.issues[0];
+  if (!issue) return "invalid frontmatter";
+  const field = issue.path.length > 0 ? issue.path.join(".") : "frontmatter";
+  if (issue.code === "invalid_enum_value") {
+    const got = JSON.stringify(issue.received);
+    const allowed = issue.options.join(" | ");
+    return `invalid ${field}: ${got} is not a supported value \u2014 expected one of: ${allowed}`;
+  }
+  return `invalid ${field}: ${issue.message}`;
+}
 function parseMemory(raw) {
   const parsed = matter(raw);
-  const frontmatter = MemoryFrontmatterSchema.parse(parsed.data);
+  const result = MemoryFrontmatterSchema.safeParse(parsed.data);
+  if (!result.success) {
+    throw new Error(formatFrontmatterError(result.error));
+  }
   return {
-    frontmatter,
+    frontmatter: result.data,
     body: stripPrivate(parsed.content.trim())
   };
 }
@@ -210,6 +235,7 @@ function buildFrontmatter(input) {
     topic: input.topic,
     sensor: input.sensor,
     activation: input.activation,
+    lifecycle: input.lifecycle,
     revision_count: 0,
     related_ids: input.relatedIds ?? []
   });
@@ -1462,16 +1488,19 @@ function auditAnchorSpecificity(memories, fileChurn, totalCommits) {
   return rows.sort((a, b) => a.specificity - b.specificity);
 }
 
-// src/npm-publication.ts
+// src/version-order.ts
 function compareVersions(a, b) {
-  const pa = a.split(/[.-]/).map((p) => Number.parseInt(p, 10) || 0);
-  const pb = b.split(/[.-]/).map((p) => Number.parseInt(p, 10) || 0);
-  for (let i = 0; i < Math.max(pa.length, pb.length, 3); i++) {
+  const pa = a.split(/[.-]/).map((part) => Number.parseInt(part, 10) || 0);
+  const pb = b.split(/[.-]/).map((part) => Number.parseInt(part, 10) || 0);
+  const len = Math.max(pa.length, pb.length, 3);
+  for (let i = 0; i < len; i++) {
     const diff = (pa[i] ?? 0) - (pb[i] ?? 0);
     if (diff !== 0) return diff;
   }
   return 0;
 }
+
+// src/npm-publication.ts
 function classifyNpmPublication(input) {
   const { packageName, localVersion, publishedVersion } = input;
   const hint = input.publishHint ?? `publish ${packageName} ${localVersion}`;
@@ -1506,6 +1535,62 @@ function classifyNpmPublication(input) {
   };
 }
 
+// src/github-release.ts
+var MAX_LISTED = 5;
+function listGap(versions) {
+  const shown = versions.slice(0, MAX_LISTED).map((v) => `v${v}`).join(", ");
+  const rest = versions.length - MAX_LISTED;
+  return rest > 0 ? `${shown} and ${rest} more` : shown;
+}
+function classifyGithubRelease(input) {
+  const { localVersion, releasedVersions, taggedVersions } = input;
+  const hint = input.releaseHint ?? `create a GitHub Release for v${localVersion}`;
+  if (releasedVersions === null) {
+    return {
+      code: "github-release-unverified",
+      severity: "info",
+      message: `Could not check whether v${localVersion} has a GitHub Release.`
+    };
+  }
+  const tags = [...new Set(taggedVersions)].sort(compareVersions);
+  if (releasedVersions.length === 0) {
+    if (tags.length === 0) return null;
+    return {
+      code: "github-releases-absent",
+      severity: "info",
+      message: `${tags.length} version tag(s) exist but the repository has no GitHub Release. Tags are not Releases: listing and scoring tools read Releases.`,
+      fix: `Start with the current version \u2014 ${hint}. Older tags stay as they are; only gaps after the first Release are reported.`
+    };
+  }
+  const released = new Set(releasedVersions);
+  const oldestReleased = [...releasedVersions].sort(compareVersions)[0];
+  const newestReleased = [...releasedVersions].sort(compareVersions).at(-1);
+  const skipped = tags.filter(
+    (v) => !released.has(v) && compareVersions(v, oldestReleased) > 0 && compareVersions(v, localVersion) < 0
+  );
+  if (skipped.length > 0) {
+    return {
+      code: "github-releases-skipped",
+      severity: "warn",
+      message: `${skipped.length} tagged version(s) after v${oldestReleased} never became a GitHub Release: ${listGap(skipped)}.`,
+      fix: `Releases are not cumulative, so the newest is the one that matters: ${hint}. If the gap is deliberate, turn the check off with \`enforcement.githubReleaseCheck: "off"\`.`
+    };
+  }
+  if (compareVersions(newestReleased, localVersion) >= 0) {
+    return {
+      code: "github-release-published",
+      severity: "ok",
+      message: `v${newestReleased} has a GitHub Release.`
+    };
+  }
+  return {
+    code: "github-release-pending",
+    severity: "info",
+    message: `v${localVersion} has no GitHub Release yet (newest is v${newestReleased}) \u2014 expected at this point; the Release comes after the tag is pushed.`,
+    fix: hint
+  };
+}
+
 // src/priority.ts
 var DEFAULT_PRIORITY_SIGNALS = {
   type: "",
@@ -1693,9 +1778,13 @@ function generateBridges(memories, sensors, opts) {
 
 // src/sensors.ts
 function sensorPatternBrittleness(pattern) {
-  const literal = pattern.replace(/\[[^\]]*\]/g, "").replace(/\{[^}]*\}/g, "");
-  if (/\d{2,}\s*-\s*\d{2,}/.test(literal)) return "hardcoded line/number range \u2014 rots when code shifts";
-  if (/\d{3,}/.test(literal)) return "hardcoded numeric literal (likely a line number) \u2014 rots when code shifts";
+  const literal = pattern.replace(/\\[a-zA-Z]/g, " ").replace(/\[[^\]]*\]/g, " ").replace(/\{[^}]*\}/g, " ").replace(/\b\d{1,3}(?:\s*\\?\.\s*\d{1,3}){2,3}\b/g, " ");
+  const range = literal.match(/\d{2,}\s*-\s*\d{2,}/);
+  if (range) return `hardcoded line/number range "${range[0].replace(/\s+/g, "")}" \u2014 rots when code shifts`;
+  const numeric = literal.match(/\d{3,}/);
+  if (numeric) {
+    return `hardcoded numeric literal "${numeric[0]}" (likely a line number) \u2014 rots when code shifts; if it is a real constant, put it in a character class ([0-9]) or anchor it to a stable token`;
+  }
   return null;
 }
 function normalizeProjectPath(value) {
@@ -7346,6 +7435,7 @@ export {
   buildReport,
   bumpRead,
   churnForAnchors,
+  classifyGithubRelease,
   classifyMemoryPriority,
   classifyNpmPublication,
   codeMapContentHash,
@@ -7355,6 +7445,7 @@ export {
   compareEvalReports,
   compareGatePrecision,
   compareImpact,
+  compareVersions,
   compileRegexSensor,
   componentOf,
   computeBaselineHealth,