@remnic/core 10.0.12 → 10.0.14

package/dist/extraction-quote-grounding.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Quote-anchored source grounding.
+ *
+ * An extracted fact carries the exact words that support it in `quote`. A quote
+ * that is a verbatim substring of the source (whitespace-normalized) is real
+ * evidence: the claim only has to be supported by the text around that span,
+ * not by word overlap against the whole conversation. Items without such a
+ * quote never get an anchor here and stay on the whole-source rules.
+ */
+import type { ExtractionResult } from "./types.js";
+/** Shortest normalized quote that counts as evidence; "the" or "I" prove nothing. */
+export declare const QUOTE_ANCHOR_MIN_CHARS = 12;
+/** Characters of context kept on each side of the quote inside its turn. */
+export declare const QUOTE_ANCHOR_CONTEXT_CHARS = 400;
+/** Share of a claim's content words that must occur in the quote's window. */
+export declare const QUOTE_ANCHOR_MIN_WINDOW_COVERAGE = 0.35;
+/** Share of a claim's content words that must occur anywhere in the source; the rest is invented. */
+export declare const QUOTE_ANCHOR_MIN_SOURCE_COVERAGE = 0.75;
+/** A verbatim quote and the text around it inside its turn. */
+export interface QuoteAnchor {
+    /** Whitespace-normalized quote, exactly as it appears in the source. */
+    quote: string;
+    /** `quote` with its turn-local context; `;` inside the quote is rewritten to `,`. */
+    window: string;
+}
+export type TokenPool = (token: string) => boolean;
+type Entity = ExtractionResult["entities"][number];
+type Relationship = NonNullable<ExtractionResult["relationships"]>[number];
+/**
+ * Returns one anchor per place `quote` occurs verbatim in `source`, or [] when
+ * the quote is absent, too short, or not an exact substring. A quote that
+ * spans a turn separator is not one turn's words and yields no anchor; windows
+ * never extend past their turn.
+ *
+ * The quote is one evidence unit: a `;` inside it is rewritten to `,` in the
+ * window so sentence splitting cannot cut it, or a claim that merges two of
+ * its clauses could never be grounded in a single sentence.
+ *
+ * `source` may have been rewritten before grounding (temporal anchoring,
+ * pronoun resolution) while the model quoted the original words. When the raw
+ * quote is not found, `transformQuote` applies the same rewrite to the quote.
+ */
+export declare function quoteAnchors(quote: string | undefined, source: string, transformQuote?: (quote: string) => string): QuoteAnchor[];
+export declare function tokenPool(tokens: ReadonlySet<string>): TokenPool;
+/**
+ * A claim is supported by a verbatim quote when it shares at least
+ * GROUNDING_MIN_SHARED_TOKENS content words with the quote, a good part of its
+ * words sit in the text around the quote, nearly all of them occur in the
+ * source at all, and it does not invert a negated clause of the quote. Reworded
+ * and lightly elaborated claims pass; claims that bring words the conversation
+ * never used, or that have nothing to do with the quote, do not.
+ */
+export declare function isQuoteAnchoredClaim(content: string, anchor: QuoteAnchor, sourceHas: TokenPool): boolean;
+/** Keeps the entity facts (flat and sectioned) `isSupported` accepts; undefined when none remain. */
+export declare function filterEntityFacts(entity: Entity, isSupported: (fact: string) => boolean): Entity | undefined;
+/**
+ * Entities carry no quote of their own; the anchors of facts that kept support
+ * them. Returns a fact predicate, or undefined when no anchor window names the entity.
+ */
+export declare function quoteAnchoredEntitySupport(entity: Entity, anchors: readonly QuoteAnchor[], sourceHas: TokenPool): ((fact: string) => boolean) | undefined;
+/**
+ * The label words and both names must sit in one anchor-window sentence, source
+ * before target, so an invented label or a reversed edge never passes.
+ */
+export declare function isQuoteAnchoredRelationship(relationship: Relationship, anchors: readonly QuoteAnchor[], sourceHas: TokenPool): boolean;
+export {};
+//# sourceMappingURL=extraction-quote-grounding.d.ts.map

package/dist/extraction-quote-grounding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraction-quote-grounding.d.ts","sourceRoot":"","sources":["../src/extraction-quote-grounding.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAanD,qFAAqF;AACrF,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,4EAA4E;AAC5E,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAC9C,8EAA8E;AAC9E,eAAO,MAAM,gCAAgC,OAAO,CAAC;AACrD,qGAAqG;AACrG,eAAO,MAAM,gCAAgC,OAAO,CAAC;AAOrD,+DAA+D;AAC/D,MAAM,WAAW,WAAW;IAC1B,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,qFAAqF;IACrF,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;AAEnD,KAAK,MAAM,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AACnD,KAAK,YAAY,GAAG,WAAW,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAkD3E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,MAAM,EAAE,MAAM,EACd,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GACzC,WAAW,EAAE,CAKf;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAGhE;AA2BD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAWxG;AAED,qGAAqG;AACrG,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GAAG,MAAM,GAAG,SAAS,CAe5G;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,SAAS,EAAE,SAAS,GACnB,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,SAAS,CAIzC;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,SAAS,EAAE,SAAS,GACnB,OAAO,CAiBT"}

package/dist/extraction-quote-grounding.js

@@ -0,0 +1,27 @@
+import {
+  QUOTE_ANCHOR_CONTEXT_CHARS,
+  QUOTE_ANCHOR_MIN_CHARS,
+  QUOTE_ANCHOR_MIN_SOURCE_COVERAGE,
+  QUOTE_ANCHOR_MIN_WINDOW_COVERAGE,
+  filterEntityFacts,
+  isQuoteAnchoredClaim,
+  isQuoteAnchoredRelationship,
+  quoteAnchoredEntitySupport,
+  quoteAnchors,
+  tokenPool
+} from "./chunk-77R7BQZ2.js";
+import "./chunk-AIYXVWUH.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  QUOTE_ANCHOR_CONTEXT_CHARS,
+  QUOTE_ANCHOR_MIN_CHARS,
+  QUOTE_ANCHOR_MIN_SOURCE_COVERAGE,
+  QUOTE_ANCHOR_MIN_WINDOW_COVERAGE,
+  filterEntityFacts,
+  isQuoteAnchoredClaim,
+  isQuoteAnchoredRelationship,
+  quoteAnchoredEntitySupport,
+  quoteAnchors,
+  tokenPool
+};
+//# sourceMappingURL=extraction-quote-grounding.js.map

package/dist/extraction-quote-grounding.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/extraction-source-grounding-helpers.d.ts

@@ -41,4 +41,12 @@ export declare function normalizedGroundingAlignmentTokenSequence(text: string):
 export declare function normalizedGroundingTokenSequence(text: string): string[];
 export declare function areGroundingTokensCompatible(left: string, right: string): boolean;
 export declare function hasContradictoryPolarity(candidate: string, source: string): boolean;
+export declare function normalizedEntityIdentifierTokens(name: string): string[];
+/** Index of the entity name's tokens inside the sentence's token sequence, or -1. */
+export declare function entityNameStart(name: string, sentence: string): number;
+export declare function isGroundedEntityName(name: string, source: string): boolean;
+/** True when the text reports a claim without asserting it ("suspects", "alleged", "said"). */
+export declare function hasNonAssertiveReporting(text: string): boolean;
+/** True when the text reports a denial ("denied", "refuses"). */
+export declare function hasDenialReporting(text: string): boolean;
 //# sourceMappingURL=extraction-source-grounding-helpers.d.ts.map

package/dist/extraction-source-grounding-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extraction-source-grounding-helpers.d.ts","sourceRoot":"","sources":["../src/extraction-source-grounding-helpers.ts"],"names":[],"mappings":"AAAA,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAgBvE;AAED,wBAAgB,iCAAiC,CAC/C,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,EACtC,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,GAClC,OAAO,CAKT;AAED,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,sBAAsB,EAAE,aAAa,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,GAC3D,OAAO,CAIT;AAED,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,EAChC,0BAA0B,UAAQ,GACjC,MAAM,EAAE,CAwDV;AAED,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAiFpD,CAAC;AAEF,eAAO,MAAM,yBAAyB,aA6BpC,CAAC;AAEH,eAAO,MAAM,0BAA0B,aAoBrC,CAAC;AAEH,eAAO,MAAM,uBAAuB,aASlC,CAAC;AAEH,eAAO,MAAM,0BAA0B,aAQrC,CAAC;AACH,eAAO,MAAM,8BAA8B,aAOzC,CAAC;AAEH,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CA8D5D,CAAC;AAGF,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE,CA0EhE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEpD;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAQrF;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAKjE;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAiBjF;AAED,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAC7C,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAK1C,wBAAgB,SAAS,CACvB,KAAK,EAAE,MAAM,EACb,iBAAiB,UAAQ,EACzB,SAAS,UAAQ,GAChB,MAAM,CA0BR;AAGD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAMlD;AA4ED;;;;;;;GAOG;AACH,wBAAgB,iCAAiC,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA0BlG;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CA0BxD;AAGD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAQ7D;AACD,wBAAgB,yCAAyC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAOhF;AAGD,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEvE;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAuBjF;AAyID,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CA0EnF"}
+{"version":3,"file":"extraction-source-grounding-helpers.d.ts","sourceRoot":"","sources":["../src/extraction-source-grounding-helpers.ts"],"names":[],"mappings":"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"}

package/dist/extraction-source-grounding-helpers.js

@@ -11,15 +11,20 @@ import {
   areGroundingTokensCompatible,
   containsContiguousGroundingTokens,
   containsExactTokenSequence,
+  entityNameStart,
   groundingLexemes,
   groundingTokenSequence,
   hasContradictoryPolarity,
+  hasDenialReporting,
   hasExplicitRoleSubjectToken,
+  hasNonAssertiveReporting,
   isAttachedNegatedAuxiliary,
+  isGroundedEntityName,
   isInterrogativeSourceSentence,
   isNegatedAt,
   isNegationCue,
   normalizeForExactMatch,
+  normalizedEntityIdentifierTokens,
   normalizedGroundingAlignmentTokenSequence,
   normalizedGroundingTokenSequence,
   sourceSentences,
@@ -28,7 +33,7 @@ import {
   stemToken,
   tokenSequence,
   tokenize
-} from "./chunk-LNH76ZJX.js";
+} from "./chunk-AIYXVWUH.js";
 import "./chunk-PZ5AY32C.js";
 export {
   GROUNDING_AUXILIARY_TOKENS,
@@ -43,15 +48,20 @@ export {
   areGroundingTokensCompatible,
   containsContiguousGroundingTokens,
   containsExactTokenSequence,
+  entityNameStart,
   groundingLexemes,
   groundingTokenSequence,
   hasContradictoryPolarity,
+  hasDenialReporting,
   hasExplicitRoleSubjectToken,
+  hasNonAssertiveReporting,
   isAttachedNegatedAuxiliary,
+  isGroundedEntityName,
   isInterrogativeSourceSentence,
   isNegatedAt,
   isNegationCue,
   normalizeForExactMatch,
+  normalizedEntityIdentifierTokens,
   normalizedGroundingAlignmentTokenSequence,
   normalizedGroundingTokenSequence,
   sourceSentences,

package/dist/extraction-source-grounding-rules.d.ts

@@ -3,11 +3,13 @@ export interface ExtractionSourceGroundingOptions {
     sourceGrounding: boolean;
     anchorTemporalExpressions: boolean;
     spanMode?: "off" | "shadow" | "on";
+    /** Rewrite applied to the source before this stage, so a verbatim quote can still be located in it. */
+    quoteTransform?: (quote: string) => string;
 }
 export declare function applyExtractionSourceGrounding(result: ExtractionResult, sourceText: string, assertionSourceText: string | undefined, roleAssertionSources: ExtractionGroundingRoleSources | undefined, messageTimestamp: Date | undefined, options: ExtractionSourceGroundingOptions): ExtractionResult;
 export interface ExtractionGroundingRoleSources {
     profile?: string;
     identity?: string;
 }
-export declare function filterExtractionResultBySource(result: ExtractionResult, source: string, assertionSource?: string, roleAssertionSources?: ExtractionGroundingRoleSources, eventTimeNormalizer?: (eventTime: string) => string, spanMode?: "off" | "shadow" | "on"): ExtractionResult;
+export declare function filterExtractionResultBySource(result: ExtractionResult, source: string, assertionSource?: string, roleAssertionSources?: ExtractionGroundingRoleSources, eventTimeNormalizer?: (eventTime: string) => string, spanMode?: "off" | "shadow" | "on", quoteTransform?: (quote: string) => string): ExtractionResult;
 //# sourceMappingURL=extraction-source-grounding-rules.d.ts.map

package/dist/extraction-source-grounding-rules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extraction-source-grounding-rules.d.ts","sourceRoot":"","sources":["../src/extraction-source-grounding-rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA4BnD,MAAM,WAAW,gCAAgC;IAC/C,eAAe,EAAE,OAAO,CAAC;IACzB,yBAAyB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,IAAI,CAAC;CACpC;AAED,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,MAAM,EAClB,mBAAmB,EAAE,MAAM,YAAa,EACxC,oBAAoB,EAAE,8BAA8B,GAAG,SAAS,EAChE,gBAAgB,EAAE,IAAI,GAAG,SAAS,EAClC,OAAO,EAAE,gCAAgC,GACxC,gBAAgB,CAwBlB;AAED,MAAM,WAAW,8BAA8B;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAqgCD,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,EACd,eAAe,CAAC,EAAE,MAAM,EACxB,oBAAoB,CAAC,EAAE,8BAA8B,EACrD,mBAAmB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,EACnD,QAAQ,GAAE,KAAK,GAAG,QAAQ,GAAG,IAAY,GACxC,gBAAgB,CAyDlB"}
+{"version":3,"file":"extraction-source-grounding-rules.d.ts","sourceRoot":"","sources":["../src/extraction-source-grounding-rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAuCnD,MAAM,WAAW,gCAAgC;IAC/C,eAAe,EAAE,OAAO,CAAC;IACzB,yBAAyB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,IAAI,CAAC;IACnC,uGAAuG;IACvG,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CAC5C;AAED,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,MAAM,EAClB,mBAAmB,EAAE,MAAM,YAAa,EACxC,oBAAoB,EAAE,8BAA8B,GAAG,SAAS,EAChE,gBAAgB,EAAE,IAAI,GAAG,SAAS,EAClC,OAAO,EAAE,gCAAgC,GACxC,gBAAgB,CA2BlB;AAED,MAAM,WAAW,8BAA8B;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAigCD,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,EACd,eAAe,CAAC,EAAE,MAAM,EACxB,oBAAoB,CAAC,EAAE,8BAA8B,EACrD,mBAAmB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,EACnD,QAAQ,GAAE,KAAK,GAAG,QAAQ,GAAG,IAAY,EACzC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GACzC,gBAAgB,CAqElB"}

package/dist/extraction-source-grounding-rules.js

@@ -1,8 +1,9 @@
 import {
   applyExtractionSourceGrounding,
   filterExtractionResultBySource
-} from "./chunk-375ARKRS.js";
-import "./chunk-LNH76ZJX.js";
+} from "./chunk-D5SSBCYY.js";
+import "./chunk-77R7BQZ2.js";
+import "./chunk-AIYXVWUH.js";
 import "./chunk-VEWZZM3H.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/dist/extraction-source-grounding.d.ts

@@ -15,5 +15,5 @@ export declare function attachExtractionProvenance(result: ExtractionResult, tur
     timestamp: string;
     turnFingerprint?: string;
 }>, provenanceConfig: ProvenanceConfig): ExtractionResult;
-export declare function filterExtractionResultBySource(result: ExtractionResult, source: string, assertionSource?: string, roleAssertionSources?: ExtractionGroundingRoleSources, eventTimeNormalizer?: (eventTime: string) => string, spanMode?: "off" | "shadow" | "on"): ExtractionResult;
+export declare function filterExtractionResultBySource(result: ExtractionResult, source: string, assertionSource?: string, roleAssertionSources?: ExtractionGroundingRoleSources, eventTimeNormalizer?: (eventTime: string) => string, spanMode?: "off" | "shadow" | "on", quoteTransform?: (quote: string) => string): ExtractionResult;
 //# sourceMappingURL=extraction-source-grounding.d.ts.map

package/dist/extraction-source-grounding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extraction-source-grounding.d.ts","sourceRoot":"","sources":["../src/extraction-source-grounding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAOrE,OAAO,KAAK,EACV,8BAA8B,EAC9B,gCAAgC,EACjC,MAAM,wCAAwC,CAAC;AAEhD,YAAY,EAAE,8BAA8B,EAAE,gCAAgC,EAAE,MAAM,wCAAwC,CAAC;AAE/H,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,MAAM,EAClB,mBAAmB,EAAE,MAAM,YAAa,EACxC,oBAAoB,EAAE,8BAA8B,GAAG,SAAS,EAChE,gBAAgB,EAAE,IAAI,GAAG,SAAS,EAClC,OAAO,EAAE,gCAAgC,GACxC,gBAAgB,CAmBlB;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,aAAa,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC,EACF,gBAAgB,EAAE,gBAAgB,GACjC,gBAAgB,CAmClB;AAED,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,EACd,eAAe,CAAC,EAAE,MAAM,EACxB,oBAAoB,CAAC,EAAE,8BAA8B,EACrD,mBAAmB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,EACnD,QAAQ,GAAE,KAAK,GAAG,QAAQ,GAAG,IAAY,GACxC,gBAAgB,CAElB"}
+{"version":3,"file":"extraction-source-grounding.d.ts","sourceRoot":"","sources":["../src/extraction-source-grounding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAOrE,OAAO,KAAK,EACV,8BAA8B,EAC9B,gCAAgC,EACjC,MAAM,wCAAwC,CAAC;AAEhD,YAAY,EAAE,8BAA8B,EAAE,gCAAgC,EAAE,MAAM,wCAAwC,CAAC;AAE/H,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,MAAM,EAClB,mBAAmB,EAAE,MAAM,YAAa,EACxC,oBAAoB,EAAE,8BAA8B,GAAG,SAAS,EAChE,gBAAgB,EAAE,IAAI,GAAG,SAAS,EAClC,OAAO,EAAE,gCAAgC,GACxC,gBAAgB,CAmBlB;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,aAAa,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC,EACF,gBAAgB,EAAE,gBAAgB,GACjC,gBAAgB,CAmClB;AAED,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,EACd,eAAe,CAAC,EAAE,MAAM,EACxB,oBAAoB,CAAC,EAAE,8BAA8B,EACrD,mBAAmB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,EACnD,QAAQ,GAAE,KAAK,GAAG,QAAQ,GAAG,IAAY,EACzC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GACzC,gBAAgB,CAUlB"}

package/dist/extraction-source-grounding.js

@@ -2,9 +2,10 @@ import {
   applyExtractionSourceGrounding,
   attachExtractionProvenance,
   filterExtractionResultBySource
-} from "./chunk-YRH3C2OJ.js";
-import "./chunk-375ARKRS.js";
-import "./chunk-LNH76ZJX.js";
+} from "./chunk-CIIHIAJ2.js";
+import "./chunk-D5SSBCYY.js";
+import "./chunk-77R7BQZ2.js";
+import "./chunk-AIYXVWUH.js";
 import "./chunk-VEWZZM3H.js";
 import "./chunk-FF6N7BXC.js";
 import "./chunk-PQVCH2AE.js";

package/dist/extraction-span-materialize.js

@@ -9,10 +9,10 @@ import {
   spanAgreesWithContent,
   stripUntrustedFactSpans,
   truncateLocalExtractionConversation
-} from "./chunk-FZVROZKC.js";
+} from "./chunk-XVZA6VXC.js";
+import "./chunk-JE26AUX6.js";
 import "./chunk-A6CXG5WI.js";
 import "./chunk-QJ2AX6DU.js";
-import "./chunk-JE26AUX6.js";
 import "./chunk-3WCASNQZ.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/dist/extraction.js

@@ -1,48 +1,49 @@
 import {
   ExtractionEngine,
   shouldEnableLocalExtractionThinking
-} from "./chunk-SQ2O52SU.js";
-import "./chunk-RNPJ4GQA.js";
+} from "./chunk-WSGPFRBH.js";
+import "./chunk-22W2XWGH.js";
 import "./chunk-54V4BZWP.js";
 import "./chunk-2CGLBUW3.js";
 import "./chunk-AAQA6ZUP.js";
 import "./chunk-JHU4EYDV.js";
 import "./chunk-E4X2YX2F.js";
-import "./chunk-FZVROZKC.js";
+import "./chunk-XVZA6VXC.js";
+import "./chunk-JE26AUX6.js";
 import "./chunk-A6CXG5WI.js";
 import "./chunk-QJ2AX6DU.js";
-import "./chunk-JE26AUX6.js";
-import "./chunk-YRH3C2OJ.js";
-import "./chunk-375ARKRS.js";
-import "./chunk-AEGNDL24.js";
-import "./chunk-LNH76ZJX.js";
+import "./chunk-CIIHIAJ2.js";
+import "./chunk-D5SSBCYY.js";
+import "./chunk-77R7BQZ2.js";
+import "./chunk-AIYXVWUH.js";
+import "./chunk-BVRZSI7Q.js";
 import {
   classifyExtractionThrownError,
   classifyFallbackParseFailure,
   formatExtractionParseFailureLog
 } from "./chunk-PJRKLB4Z.js";
 import "./chunk-VEWZZM3H.js";
-import "./chunk-4G2YCKLT.js";
+import "./chunk-7G5NTS7F.js";
 import "./chunk-C7SRUWBW.js";
 import "./chunk-5JMAGU26.js";
-import "./chunk-JLIGUFPF.js";
+import "./chunk-YN2DQ2D6.js";
 import "./chunk-4RA3C3EV.js";
 import "./chunk-QW27DOHG.js";
 import "./chunk-EI6V5UXY.js";
-import "./chunk-QAIKLICT.js";
-import "./chunk-WL7N5VGG.js";
+import "./chunk-M7KGIW5F.js";
+import "./chunk-5TJEOU6Y.js";
 import "./chunk-754XN6LX.js";
 import "./chunk-BLVHDY2U.js";
 import "./chunk-5MA7ZLPD.js";
-import "./chunk-2U4BM3TW.js";
+import "./chunk-TITG2NBS.js";
 import "./chunk-3UXOZBHV.js";
 import "./chunk-PIWFNPQT.js";
-import "./chunk-LOFVW6JA.js";
-import "./chunk-PBVNVKYN.js";
+import "./chunk-CLWBFR7Q.js";
+import "./chunk-PIN5OPBA.js";
 import "./chunk-CSAKJVXW.js";
 import "./chunk-K2XUWZBM.js";
 import "./chunk-OD4FM2U7.js";
-import "./chunk-JXSYWTFK.js";
+import "./chunk-DYJHGJZ4.js";
 import "./chunk-QM2SPLKQ.js";
 import "./chunk-U4LUIE6Y.js";
 import "./chunk-JUXOTY6J.js";
@@ -52,19 +53,19 @@ import "./chunk-ADXCCZL2.js";
 import "./chunk-236PXYG7.js";
 import "./chunk-ZCUTSMR2.js";
 import "./chunk-QDW3E4RD.js";
-import "./chunk-BD5QEP3T.js";
+import "./chunk-PAZ35RJ4.js";
 import "./chunk-UHVXE24Y.js";
-import "./chunk-LZKOVXMX.js";
+import "./chunk-TRMJ6BYC.js";
 import "./chunk-V4JZCTMK.js";
-import "./chunk-7UX44C4N.js";
-import "./chunk-MB5EJ2CT.js";
+import "./chunk-N4C7QKOG.js";
+import "./chunk-O2IPAX26.js";
+import "./chunk-S7LWX2PQ.js";
+import "./chunk-T2YX56QI.js";
 import "./chunk-CYEPCZN5.js";
 import "./chunk-T3FMRLWQ.js";
 import "./chunk-7VO6E5UD.js";
-import "./chunk-5BUCKFRE.js";
-import "./chunk-S7LWX2PQ.js";
-import "./chunk-T2YX56QI.js";
 import "./chunk-4O6WRBGE.js";
+import "./chunk-VOKHZRHW.js";
 import "./chunk-GUMZC2BO.js";
 import "./chunk-TFA6HPOA.js";
 import "./chunk-F4TWWUMP.js";
@@ -74,37 +75,38 @@ import "./chunk-S2V7RUCL.js";
 import "./chunk-X3724WL4.js";
 import "./chunk-MRPOZBJC.js";
 import "./chunk-S2HLHAZ4.js";
-import "./chunk-LDXUBPMO.js";
 import "./chunk-DM2T26WE.js";
-import "./chunk-FF6N7BXC.js";
+import "./chunk-LDXUBPMO.js";
 import "./chunk-2DT7PIDZ.js";
 import "./chunk-AAD2ZS6P.js";
-import "./chunk-YYO447A7.js";
+import "./chunk-FF6N7BXC.js";
+import "./chunk-JNIVZNIB.js";
+import "./chunk-YXZG5TVN.js";
 import "./chunk-ZIKENA2C.js";
 import "./chunk-3OUGSOJP.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-3ONXXHQO.js";
-import "./chunk-YXZG5TVN.js";
-import "./chunk-3WU7XOFN.js";
 import "./chunk-6MKLMEBE.js";
-import "./chunk-QZZPUREO.js";
+import "./chunk-3WU7XOFN.js";
+import "./chunk-G7D6GZ5J.js";
+import "./chunk-3GYSZHMT.js";
 import "./chunk-M5GVCJSJ.js";
 import "./chunk-RBOJCG4T.js";
-import "./chunk-4NDWE44P.js";
+import "./chunk-NZFFGO5O.js";
 import "./chunk-5WITETWU.js";
 import "./chunk-6CIAGZ6X.js";
 import "./chunk-7CT3AI52.js";
-import "./chunk-G7D6GZ5J.js";
+import "./chunk-6EDW54SQ.js";
 import "./chunk-ZJP66Q4I.js";
-import "./chunk-DGRMWDQY.js";
+import "./chunk-66BCOVW2.js";
 import "./chunk-G26YNEOC.js";
+import "./chunk-SWWHIJUJ.js";
+import "./chunk-TPSLVZHS.js";
 import "./chunk-SIGAGKNE.js";
 import "./chunk-IUM3VSHI.js";
-import "./chunk-WVHRNAXL.js";
-import "./chunk-TPSLVZHS.js";
-import "./chunk-23G5P7TA.js";
 import "./chunk-C64XATK7.js";
 import "./chunk-42JKGUFJ.js";
+import "./chunk-23G5P7TA.js";
 import "./chunk-TKC5LZ43.js";
 import "./chunk-I55KAVET.js";
 import "./chunk-L2EXJQJP.js";
@@ -118,39 +120,40 @@ import "./chunk-YCVB7X56.js";
 import "./chunk-PQVCH2AE.js";
 import "./chunk-PJKTFXE2.js";
 import "./chunk-W5BIQOAJ.js";
-import "./chunk-QWWMS4AE.js";
+import "./chunk-3MO4LWYU.js";
 import "./chunk-YBA52OKG.js";
-import "./chunk-3I3U6FFT.js";
+import "./chunk-K7BN34IA.js";
 import "./chunk-353C5UNV.js";
-import "./chunk-OFCHT2TN.js";
+import "./chunk-5LRV557D.js";
 import "./chunk-BT7NVCML.js";
-import "./chunk-VFTK5WKI.js";
+import "./chunk-STBX5X6B.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";
 import "./chunk-FP2373TW.js";
-import "./chunk-E5H4TM4Y.js";
+import "./chunk-WC3V7HHP.js";
 import "./chunk-L272A5QW.js";
-import "./chunk-FQD2KPQH.js";
+import "./chunk-P55FACBG.js";
 import "./chunk-ZA53AZND.js";
 import "./chunk-7RJUVTVF.js";
 import "./chunk-AL3UYZ5N.js";
 import "./chunk-RL6NEVXT.js";
+import "./chunk-YET735EZ.js";
 import "./chunk-PWPIERBM.js";
 import "./chunk-IG747LRN.js";
 import "./chunk-C7HJ3NEI.js";
-import "./chunk-KI6UOSNR.js";
-import "./chunk-BTNNL7ZW.js";
+import "./chunk-DEY7B77Y.js";
 import "./chunk-5FVVY2EB.js";
+import "./chunk-BTNNL7ZW.js";
 import "./chunk-JDSVLVCG.js";
 import "./chunk-5GKPFL3S.js";
 import "./chunk-JAKIDQB2.js";
-import "./chunk-EHRE7ZG3.js";
+import "./chunk-5B5WYAHQ.js";
 import "./chunk-P7FMDTKL.js";
-import "./chunk-OEIA4IHU.js";
+import "./chunk-ESG6ITGP.js";
 import "./chunk-PCXDUHQH.js";
 import "./chunk-VUFL7X3H.js";
-import "./chunk-2EMROIXS.js";
-import "./chunk-7LEQREP2.js";
+import "./chunk-C5LWPYS3.js";
+import "./chunk-PGRZ3FYC.js";
 import "./chunk-3Q3N35W7.js";
 import "./chunk-ZEFVK7XC.js";
 import "./chunk-6KH5NLQS.js";

package/dist/{first-start-migration-OM3PHMZO.js → first-start-migration-6A5BJPDW.js}

@@ -2,12 +2,12 @@ import {
   applyUtilityPromotionRuntimePolicy,
   loadUtilityRuntimeValues
 } from "./chunk-SWIKABKI.js";
-import {
-  TierMigrationExecutor
-} from "./chunk-YRFAYOFQ.js";
 import {
   decideTierTransition
 } from "./chunk-GCBIXUPT.js";
+import {
+  TierMigrationExecutor
+} from "./chunk-YRFAYOFQ.js";
 import "./chunk-W3K3HITK.js";
 import "./chunk-EBA5DA77.js";
 import "./chunk-TBBDFYXW.js";
@@ -23,7 +23,7 @@ import {
   resolveMemoryLifecycleCapabilities,
   resolveQmdCapabilities,
   resolveUtilityLearningCapabilities
-} from "./chunk-2EMROIXS.js";
+} from "./chunk-C5LWPYS3.js";
 import "./chunk-A2IYSXDQ.js";
 import "./chunk-B6O2YLUR.js";
 import "./chunk-KNA3BXXL.js";
@@ -273,4 +273,4 @@ export {
   LIFECYCLE_INIT_DONE_MARKER,
   runFirstStartMigration
 };
-//# sourceMappingURL=first-start-migration-OM3PHMZO.js.map
+//# sourceMappingURL=first-start-migration-6A5BJPDW.js.map

package/dist/{forget-OHAJ6PSU.js → forget-GXBWFKRC.js}

@@ -1,13 +1,14 @@
 import {
   buildRetiredFactTombstoneInputs
-} from "./chunk-LZKOVXMX.js";
+} from "./chunk-TRMJ6BYC.js";
 import {
   supersessionKeysForFact
 } from "./chunk-5WITETWU.js";
 import "./chunk-6CIAGZ6X.js";
 import "./chunk-5FVVY2EB.js";
-import "./chunk-EHRE7ZG3.js";
-import "./chunk-7LEQREP2.js";
+import "./chunk-5B5WYAHQ.js";
+import "./chunk-PGRZ3FYC.js";
+import "./chunk-BTTPKDIL.js";
 import "./chunk-3WCASNQZ.js";
 import "./chunk-PZ5AY32C.js";
 
@@ -99,4 +100,4 @@ export {
   ForgetMemoryNotFoundError,
   forgetMemory
 };
-//# sourceMappingURL=forget-OHAJ6PSU.js.map
+//# sourceMappingURL=forget-GXBWFKRC.js.map

package/dist/{forget-OHAJ6PSU.js.map → forget-GXBWFKRC.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/maintenance/forget.ts"],"sourcesContent":["/**\n * Operator-facing memory forgetting (issue #686 PR 4/6).\n *\n * `remnic forget <id>` marks a memory as forgotten — a soft-delete that:\n *\n *   1. Sets `status: \"forgotten\"`, `forgottenAt`, optional\n *      `forgottenReason` in YAML frontmatter via the existing\n *      `storage.writeMemoryFrontmatter` path (which logs the change\n *      to the lifecycle ledger and invalidates caches).\n *   2. Returns a structured result describing what changed so the\n *      CLI and downstream telemetry can render it.\n *\n * Memories with `status === \"forgotten\"` are excluded from recall,\n * browse, and entity attribution by the status filters that serve\n * active user context.  A future maintenance cron will hard-delete\n * forgotten memories after a configurable retention window (default\n * 90 days) — for this PR the file stays on disk and the act is\n * reversible by editing the YAML directly.\n *\n * This module ships the pure helper; the CLI wires it in `cli.ts` as\n * a new `remnic forget` subcommand.\n */\n\nimport type { StorageManager } from \"../storage.js\";\nimport { buildRetiredFactTombstoneInputs } from \"../lifecycle/tombstones.js\";\nimport { supersessionKeysForFact } from \"../temporal-supersession.js\";\nimport type { MemoryFile } from \"../types.js\";\n\nexport interface ForgetMemoryRequest {\n  /** Memory id (frontmatter `id`) to forget. */\n  id: string;\n  /** Optional human-readable reason. */\n  reason?: string;\n  /** Override the timestamp written to `forgottenAt`. Defaults to `new Date().toISOString()`. */\n  now?: () => Date;\n}\n\nexport interface ForgetMemoryResult {\n  /** Memory id that was forgotten. */\n  id: string;\n  /** Filesystem path of the forgotten memory. */\n  path: string;\n  /** Prior status before the forget call, for audit. */\n  priorStatus: string;\n  /** Timestamp written to `forgottenAt`. */\n  forgottenAt: string;\n  /** Reason captured (or empty string if none). */\n  reason: string;\n}\n\nexport class ForgetMemoryNotFoundError extends Error {\n  readonly code = \"memory_not_found\" as const;\n  constructor(id: string) {\n    super(`memory not found: ${id}`);\n    this.name = \"ForgetMemoryNotFoundError\";\n  }\n}\n\nexport class ForgetMemoryAlreadyForgottenError extends Error {\n  readonly code = \"already_forgotten\" as const;\n  constructor(id: string, forgottenAt: string) {\n    super(`memory ${id} was already forgotten at ${forgottenAt}`);\n    this.name = \"ForgetMemoryAlreadyForgottenError\";\n  }\n}\n\n/**\n * Mark a memory as forgotten.  Pure orchestration over storage —\n * caller supplies the storage instance and the request.  Status\n * filters elsewhere in the codebase exclude `status: \"forgotten\"`\n * from recall/browse surfaces before they serve active user context.\n */\nexport async function forgetMemory(\n  storage: StorageManager,\n  request: ForgetMemoryRequest,\n): Promise<ForgetMemoryResult> {\n  const id = typeof request.id === \"string\" ? request.id.trim() : \"\";\n  if (id.length === 0) {\n    throw new Error(\"forget: memory id is required and must be non-empty\");\n  }\n  const memory = await findMemoryById(storage, id);\n  if (!memory) {\n    throw new ForgetMemoryNotFoundError(id);\n  }\n  if (memory.frontmatter.status === \"forgotten\") {\n    throw new ForgetMemoryAlreadyForgottenError(\n      id,\n      memory.frontmatter.forgottenAt ?? \"(unknown)\",\n    );\n  }\n  const priorStatus =\n    typeof memory.frontmatter.status === \"string\" ? memory.frontmatter.status : \"active\";\n  const now = (request.now ?? (() => new Date()))();\n  const forgottenAt = now.toISOString();\n  const reason = typeof request.reason === \"string\" ? request.reason.trim() : \"\";\n  await storage.writeMemoryFrontmatter(memory, {\n    status: \"forgotten\",\n    forgottenAt,\n    forgottenReason: reason.length > 0 ? reason : undefined,\n    updated: forgottenAt,\n  }, {\n    actor: \"remnic-forget\",\n    reasonCode: \"operator_forget\",\n  });\n  // Issue #1579 thread OchiF: emit a LIVE tombstone at forget time so a\n  // forgotten FACT cannot resurrect via re-extraction/import before an\n  // operator runs `remnic doctor --rebuild-tombstones`. Without this, the\n  // non-resurrection chokepoint in writeMemory has nothing to match — the\n  // forgotten fact's content hash is gone from the active index but no\n  // tombstone exists until a manual rebuild derives one — so the same fact\n  // written again through writeMemory becomes active. Mirrors supersedeMemory\n  // (contradiction) and applyTemporalSupersession via the shared\n  // buildRetiredFactTombstoneInputs helper. Best-effort (rule 34): a tombstone\n  // append failure must not fail the forget, which already succeeded on disk.\n  if (memory.frontmatter.category === \"fact\") {\n    for (const input of buildRetiredFactTombstoneInputs(\n      {\n        id,\n        content: memory.content,\n        ...(memory.frontmatter.contentHash\n          ? { contentHash: memory.frontmatter.contentHash }\n          : {}),\n        ...(memory.frontmatter.entityRef\n          ? { entityRef: memory.frontmatter.entityRef }\n          : {}),\n        ...(memory.frontmatter.structuredAttributes\n          ? { structuredAttributes: memory.frontmatter.structuredAttributes }\n          : {}),\n      },\n      {\n        reason: \"retraction\",\n        createdBy: \"user_correction\",\n        createdAt: forgottenAt,\n        supersessionKeysForFact,\n      },\n    )) {\n      try {\n        await storage.appendTombstone(input);\n      } catch {\n        // Best-effort — the forget already succeeded on disk.\n      }\n    }\n  }\n  return {\n    id,\n    path: memory.path,\n    priorStatus,\n    forgottenAt,\n    reason,\n  };\n}\n\nasync function findMemoryById(\n  storage: StorageManager,\n  id: string,\n): Promise<MemoryFile | null> {\n  const hot = await storage.readAllMemories();\n  const hotMatch = hot.find((m) => m.frontmatter.id === id);\n  if (hotMatch) return hotMatch;\n\n  const archived = await storage.readArchivedMemories();\n  const archivedMatch = archived.find((m) => m.frontmatter.id === id);\n  if (archivedMatch) return archivedMatch;\n\n  const cold = await storage.readAllColdMemories();\n  return cold.find((m) => m.frontmatter.id === id) ?? null;\n}\n"],"mappings":";;;;;;;;;;;;;;AAkDO,IAAM,4BAAN,cAAwC,MAAM;AAAA,EAC1C,OAAO;AAAA,EAChB,YAAY,IAAY;AACtB,UAAM,qBAAqB,EAAE,EAAE;AAC/B,SAAK,OAAO;AAAA,EACd;AACF;AAEO,IAAM,oCAAN,cAAgD,MAAM;AAAA,EAClD,OAAO;AAAA,EAChB,YAAY,IAAY,aAAqB;AAC3C,UAAM,UAAU,EAAE,6BAA6B,WAAW,EAAE;AAC5D,SAAK,OAAO;AAAA,EACd;AACF;AAQA,eAAsB,aACpB,SACA,SAC6B;AAC7B,QAAM,KAAK,OAAO,QAAQ,OAAO,WAAW,QAAQ,GAAG,KAAK,IAAI;AAChE,MAAI,GAAG,WAAW,GAAG;AACnB,UAAM,IAAI,MAAM,qDAAqD;AAAA,EACvE;AACA,QAAM,SAAS,MAAM,eAAe,SAAS,EAAE;AAC/C,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI,0BAA0B,EAAE;AAAA,EACxC;AACA,MAAI,OAAO,YAAY,WAAW,aAAa;AAC7C,UAAM,IAAI;AAAA,MACR;AAAA,MACA,OAAO,YAAY,eAAe;AAAA,IACpC;AAAA,EACF;AACA,QAAM,cACJ,OAAO,OAAO,YAAY,WAAW,WAAW,OAAO,YAAY,SAAS;AAC9E,QAAM,OAAO,QAAQ,QAAQ,MAAM,oBAAI,KAAK,IAAI;AAChD,QAAM,cAAc,IAAI,YAAY;AACpC,QAAM,SAAS,OAAO,QAAQ,WAAW,WAAW,QAAQ,OAAO,KAAK,IAAI;AAC5E,QAAM,QAAQ,uBAAuB,QAAQ;AAAA,IAC3C,QAAQ;AAAA,IACR;AAAA,IACA,iBAAiB,OAAO,SAAS,IAAI,SAAS;AAAA,IAC9C,SAAS;AAAA,EACX,GAAG;AAAA,IACD,OAAO;AAAA,IACP,YAAY;AAAA,EACd,CAAC;AAWD,MAAI,OAAO,YAAY,aAAa,QAAQ;AAC1C,eAAW,SAAS;AAAA,MAClB;AAAA,QACE;AAAA,QACA,SAAS,OAAO;AAAA,QAChB,GAAI,OAAO,YAAY,cACnB,EAAE,aAAa,OAAO,YAAY,YAAY,IAC9C,CAAC;AAAA,QACL,GAAI,OAAO,YAAY,YACnB,EAAE,WAAW,OAAO,YAAY,UAAU,IAC1C,CAAC;AAAA,QACL,GAAI,OAAO,YAAY,uBACnB,EAAE,sBAAsB,OAAO,YAAY,qBAAqB,IAChE,CAAC;AAAA,MACP;AAAA,MACA;AAAA,QACE,QAAQ;AAAA,QACR,WAAW;AAAA,QACX,WAAW;AAAA,QACX;AAAA,MACF;AAAA,IACF,GAAG;AACD,UAAI;AACF,cAAM,QAAQ,gBAAgB,KAAK;AAAA,MACrC,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,EACF;AACA,SAAO;AAAA,IACL;AAAA,IACA,MAAM,OAAO;AAAA,IACb;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAEA,eAAe,eACb,SACA,IAC4B;AAC5B,QAAM,MAAM,MAAM,QAAQ,gBAAgB;AAC1C,QAAM,WAAW,IAAI,KAAK,CAAC,MAAM,EAAE,YAAY,OAAO,EAAE;AACxD,MAAI,SAAU,QAAO;AAErB,QAAM,WAAW,MAAM,QAAQ,qBAAqB;AACpD,QAAM,gBAAgB,SAAS,KAAK,CAAC,MAAM,EAAE,YAAY,OAAO,EAAE;AAClE,MAAI,cAAe,QAAO;AAE1B,QAAM,OAAO,MAAM,QAAQ,oBAAoB;AAC/C,SAAO,KAAK,KAAK,CAAC,MAAM,EAAE,YAAY,OAAO,EAAE,KAAK;AACtD;","names":[]}
+{"version":3,"sources":["../src/maintenance/forget.ts"],"sourcesContent":["/**\n * Operator-facing memory forgetting (issue #686 PR 4/6).\n *\n * `remnic forget <id>` marks a memory as forgotten — a soft-delete that:\n *\n *   1. Sets `status: \"forgotten\"`, `forgottenAt`, optional\n *      `forgottenReason` in YAML frontmatter via the existing\n *      `storage.writeMemoryFrontmatter` path (which logs the change\n *      to the lifecycle ledger and invalidates caches).\n *   2. Returns a structured result describing what changed so the\n *      CLI and downstream telemetry can render it.\n *\n * Memories with `status === \"forgotten\"` are excluded from recall,\n * browse, and entity attribution by the status filters that serve\n * active user context.  A future maintenance cron will hard-delete\n * forgotten memories after a configurable retention window (default\n * 90 days) — for this PR the file stays on disk and the act is\n * reversible by editing the YAML directly.\n *\n * This module ships the pure helper; the CLI wires it in `cli.ts` as\n * a new `remnic forget` subcommand.\n */\n\nimport type { StorageManager } from \"../storage.js\";\nimport { buildRetiredFactTombstoneInputs } from \"../lifecycle/tombstones.js\";\nimport { supersessionKeysForFact } from \"../temporal-supersession.js\";\nimport type { MemoryFile } from \"../types.js\";\n\nexport interface ForgetMemoryRequest {\n  /** Memory id (frontmatter `id`) to forget. */\n  id: string;\n  /** Optional human-readable reason. */\n  reason?: string;\n  /** Override the timestamp written to `forgottenAt`. Defaults to `new Date().toISOString()`. */\n  now?: () => Date;\n}\n\nexport interface ForgetMemoryResult {\n  /** Memory id that was forgotten. */\n  id: string;\n  /** Filesystem path of the forgotten memory. */\n  path: string;\n  /** Prior status before the forget call, for audit. */\n  priorStatus: string;\n  /** Timestamp written to `forgottenAt`. */\n  forgottenAt: string;\n  /** Reason captured (or empty string if none). */\n  reason: string;\n}\n\nexport class ForgetMemoryNotFoundError extends Error {\n  readonly code = \"memory_not_found\" as const;\n  constructor(id: string) {\n    super(`memory not found: ${id}`);\n    this.name = \"ForgetMemoryNotFoundError\";\n  }\n}\n\nexport class ForgetMemoryAlreadyForgottenError extends Error {\n  readonly code = \"already_forgotten\" as const;\n  constructor(id: string, forgottenAt: string) {\n    super(`memory ${id} was already forgotten at ${forgottenAt}`);\n    this.name = \"ForgetMemoryAlreadyForgottenError\";\n  }\n}\n\n/**\n * Mark a memory as forgotten.  Pure orchestration over storage —\n * caller supplies the storage instance and the request.  Status\n * filters elsewhere in the codebase exclude `status: \"forgotten\"`\n * from recall/browse surfaces before they serve active user context.\n */\nexport async function forgetMemory(\n  storage: StorageManager,\n  request: ForgetMemoryRequest,\n): Promise<ForgetMemoryResult> {\n  const id = typeof request.id === \"string\" ? request.id.trim() : \"\";\n  if (id.length === 0) {\n    throw new Error(\"forget: memory id is required and must be non-empty\");\n  }\n  const memory = await findMemoryById(storage, id);\n  if (!memory) {\n    throw new ForgetMemoryNotFoundError(id);\n  }\n  if (memory.frontmatter.status === \"forgotten\") {\n    throw new ForgetMemoryAlreadyForgottenError(\n      id,\n      memory.frontmatter.forgottenAt ?? \"(unknown)\",\n    );\n  }\n  const priorStatus =\n    typeof memory.frontmatter.status === \"string\" ? memory.frontmatter.status : \"active\";\n  const now = (request.now ?? (() => new Date()))();\n  const forgottenAt = now.toISOString();\n  const reason = typeof request.reason === \"string\" ? request.reason.trim() : \"\";\n  await storage.writeMemoryFrontmatter(memory, {\n    status: \"forgotten\",\n    forgottenAt,\n    forgottenReason: reason.length > 0 ? reason : undefined,\n    updated: forgottenAt,\n  }, {\n    actor: \"remnic-forget\",\n    reasonCode: \"operator_forget\",\n  });\n  // Issue #1579 thread OchiF: emit a LIVE tombstone at forget time so a\n  // forgotten FACT cannot resurrect via re-extraction/import before an\n  // operator runs `remnic doctor --rebuild-tombstones`. Without this, the\n  // non-resurrection chokepoint in writeMemory has nothing to match — the\n  // forgotten fact's content hash is gone from the active index but no\n  // tombstone exists until a manual rebuild derives one — so the same fact\n  // written again through writeMemory becomes active. Mirrors supersedeMemory\n  // (contradiction) and applyTemporalSupersession via the shared\n  // buildRetiredFactTombstoneInputs helper. Best-effort (rule 34): a tombstone\n  // append failure must not fail the forget, which already succeeded on disk.\n  if (memory.frontmatter.category === \"fact\") {\n    for (const input of buildRetiredFactTombstoneInputs(\n      {\n        id,\n        content: memory.content,\n        ...(memory.frontmatter.contentHash\n          ? { contentHash: memory.frontmatter.contentHash }\n          : {}),\n        ...(memory.frontmatter.entityRef\n          ? { entityRef: memory.frontmatter.entityRef }\n          : {}),\n        ...(memory.frontmatter.structuredAttributes\n          ? { structuredAttributes: memory.frontmatter.structuredAttributes }\n          : {}),\n      },\n      {\n        reason: \"retraction\",\n        createdBy: \"user_correction\",\n        createdAt: forgottenAt,\n        supersessionKeysForFact,\n      },\n    )) {\n      try {\n        await storage.appendTombstone(input);\n      } catch {\n        // Best-effort — the forget already succeeded on disk.\n      }\n    }\n  }\n  return {\n    id,\n    path: memory.path,\n    priorStatus,\n    forgottenAt,\n    reason,\n  };\n}\n\nasync function findMemoryById(\n  storage: StorageManager,\n  id: string,\n): Promise<MemoryFile | null> {\n  const hot = await storage.readAllMemories();\n  const hotMatch = hot.find((m) => m.frontmatter.id === id);\n  if (hotMatch) return hotMatch;\n\n  const archived = await storage.readArchivedMemories();\n  const archivedMatch = archived.find((m) => m.frontmatter.id === id);\n  if (archivedMatch) return archivedMatch;\n\n  const cold = await storage.readAllColdMemories();\n  return cold.find((m) => m.frontmatter.id === id) ?? null;\n}\n"],"mappings":";;;;;;;;;;;;;;;AAkDO,IAAM,4BAAN,cAAwC,MAAM;AAAA,EAC1C,OAAO;AAAA,EAChB,YAAY,IAAY;AACtB,UAAM,qBAAqB,EAAE,EAAE;AAC/B,SAAK,OAAO;AAAA,EACd;AACF;AAEO,IAAM,oCAAN,cAAgD,MAAM;AAAA,EAClD,OAAO;AAAA,EAChB,YAAY,IAAY,aAAqB;AAC3C,UAAM,UAAU,EAAE,6BAA6B,WAAW,EAAE;AAC5D,SAAK,OAAO;AAAA,EACd;AACF;AAQA,eAAsB,aACpB,SACA,SAC6B;AAC7B,QAAM,KAAK,OAAO,QAAQ,OAAO,WAAW,QAAQ,GAAG,KAAK,IAAI;AAChE,MAAI,GAAG,WAAW,GAAG;AACnB,UAAM,IAAI,MAAM,qDAAqD;AAAA,EACvE;AACA,QAAM,SAAS,MAAM,eAAe,SAAS,EAAE;AAC/C,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI,0BAA0B,EAAE;AAAA,EACxC;AACA,MAAI,OAAO,YAAY,WAAW,aAAa;AAC7C,UAAM,IAAI;AAAA,MACR;AAAA,MACA,OAAO,YAAY,eAAe;AAAA,IACpC;AAAA,EACF;AACA,QAAM,cACJ,OAAO,OAAO,YAAY,WAAW,WAAW,OAAO,YAAY,SAAS;AAC9E,QAAM,OAAO,QAAQ,QAAQ,MAAM,oBAAI,KAAK,IAAI;AAChD,QAAM,cAAc,IAAI,YAAY;AACpC,QAAM,SAAS,OAAO,QAAQ,WAAW,WAAW,QAAQ,OAAO,KAAK,IAAI;AAC5E,QAAM,QAAQ,uBAAuB,QAAQ;AAAA,IAC3C,QAAQ;AAAA,IACR;AAAA,IACA,iBAAiB,OAAO,SAAS,IAAI,SAAS;AAAA,IAC9C,SAAS;AAAA,EACX,GAAG;AAAA,IACD,OAAO;AAAA,IACP,YAAY;AAAA,EACd,CAAC;AAWD,MAAI,OAAO,YAAY,aAAa,QAAQ;AAC1C,eAAW,SAAS;AAAA,MAClB;AAAA,QACE;AAAA,QACA,SAAS,OAAO;AAAA,QAChB,GAAI,OAAO,YAAY,cACnB,EAAE,aAAa,OAAO,YAAY,YAAY,IAC9C,CAAC;AAAA,QACL,GAAI,OAAO,YAAY,YACnB,EAAE,WAAW,OAAO,YAAY,UAAU,IAC1C,CAAC;AAAA,QACL,GAAI,OAAO,YAAY,uBACnB,EAAE,sBAAsB,OAAO,YAAY,qBAAqB,IAChE,CAAC;AAAA,MACP;AAAA,MACA;AAAA,QACE,QAAQ;AAAA,QACR,WAAW;AAAA,QACX,WAAW;AAAA,QACX;AAAA,MACF;AAAA,IACF,GAAG;AACD,UAAI;AACF,cAAM,QAAQ,gBAAgB,KAAK;AAAA,MACrC,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,EACF;AACA,SAAO;AAAA,IACL;AAAA,IACA,MAAM,OAAO;AAAA,IACb;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAEA,eAAe,eACb,SACA,IAC4B;AAC5B,QAAM,MAAM,MAAM,QAAQ,gBAAgB;AAC1C,QAAM,WAAW,IAAI,KAAK,CAAC,MAAM,EAAE,YAAY,OAAO,EAAE;AACxD,MAAI,SAAU,QAAO;AAErB,QAAM,WAAW,MAAM,QAAQ,qBAAqB;AACpD,QAAM,gBAAgB,SAAS,KAAK,CAAC,MAAM,EAAE,YAAY,OAAO,EAAE;AAClE,MAAI,cAAe,QAAO;AAE1B,QAAM,OAAO,MAAM,QAAQ,oBAAoB;AAC/C,SAAO,KAAK,KAAK,CAAC,MAAM,EAAE,YAAY,OAAO,EAAE,KAAK;AACtD;","names":[]}

package/dist/{graph-edge-decay-CZ3SYLM4.js → graph-edge-decay-BYPZVJT4.js}

@@ -5,18 +5,19 @@ import {
   readGraphEdgeDecayStatus,
   runGraphEdgeDecayMaintenance,
   runGraphEdgeDecayMaintenanceAcrossNamespaces
-} from "./chunk-Y6DZ33PA.js";
-import "./chunk-QUNDYIYZ.js";
-import "./chunk-BTJ6CAIA.js";
-import "./chunk-LXY5VVGM.js";
-import "./chunk-ZQ3WU6JO.js";
-import "./chunk-GKCXTSFF.js";
+} from "./chunk-5GX5457J.js";
+import "./chunk-YYEOR4XN.js";
+import "./chunk-4IYIGN53.js";
+import "./chunk-RXFCU3CY.js";
 import "./chunk-2LSZVONP.js";
 import "./chunk-DEUNUKTD.js";
-import "./chunk-EHRE7ZG3.js";
+import "./chunk-LXY5VVGM.js";
+import "./chunk-GKCXTSFF.js";
+import "./chunk-5B5WYAHQ.js";
 import "./chunk-PCXDUHQH.js";
 import "./chunk-VUFL7X3H.js";
-import "./chunk-7LEQREP2.js";
+import "./chunk-PGRZ3FYC.js";
+import "./chunk-BTTPKDIL.js";
 import "./chunk-KNA3BXXL.js";
 import "./chunk-3WCASNQZ.js";
 import "./chunk-PZ5AY32C.js";
@@ -28,4 +29,4 @@ export {
   runGraphEdgeDecayMaintenance,
   runGraphEdgeDecayMaintenanceAcrossNamespaces
 };
-//# sourceMappingURL=graph-edge-decay-CZ3SYLM4.js.map
+//# sourceMappingURL=graph-edge-decay-BYPZVJT4.js.map

package/dist/graph-edge-decay-BYPZVJT4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/graph-jsonl.js

@@ -3,15 +3,16 @@ import {
   restoreRemovedNodeEdges,
   rollbackNodeEdgeRewrite,
   writeGraphJsonlAtomic
-} from "./chunk-QUNDYIYZ.js";
-import "./chunk-BTJ6CAIA.js";
-import "./chunk-LXY5VVGM.js";
-import "./chunk-ZQ3WU6JO.js";
-import "./chunk-GKCXTSFF.js";
+} from "./chunk-YYEOR4XN.js";
+import "./chunk-4IYIGN53.js";
+import "./chunk-RXFCU3CY.js";
 import "./chunk-2LSZVONP.js";
 import "./chunk-DEUNUKTD.js";
-import "./chunk-EHRE7ZG3.js";
-import "./chunk-7LEQREP2.js";
+import "./chunk-LXY5VVGM.js";
+import "./chunk-GKCXTSFF.js";
+import "./chunk-5B5WYAHQ.js";
+import "./chunk-PGRZ3FYC.js";
+import "./chunk-BTTPKDIL.js";
 import "./chunk-KNA3BXXL.js";
 import "./chunk-3WCASNQZ.js";
 import "./chunk-PZ5AY32C.js";