@remnic/core 10.0.3 → 10.0.5

package/dist/projection-rebuild-config.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Scheduled projection-rebuild knobs (issue #2119, heap guard).
+ *
+ * Extracted from `config.ts` / `types.ts` so those god-file ceilings do not
+ * grow. `PluginConfig` extends the interface and `parseConfig` spreads
+ * {@link parseProjectionRebuildScheduleConfig}.
+ */
+/** Knobs for the maintenance-scheduled memory-projection rebuild. */
+export interface ProjectionRebuildScheduleConfig {
+    /**
+     * Enable the maintenance-scheduled rebuild of `state/memory-projection.sqlite`.
+     * The projection is otherwise rebuild-only (manual CLI / tests), so it rots as
+     * the lifecycle ledger grows and timeline/browse consumers silently regress to
+     * full-corpus fallback scans. Default true — mirrors lifecycle-ledger
+     * auto-compaction, which is likewise enabled-by-default to keep a state file
+     * healthy. Set false to disable (operators can still cron the CLI rebuild).
+     */
+    projectionRebuildEnabled: boolean;
+    /**
+     * Minimum interval between scheduled projection rebuilds. A rebuild is skipped
+     * when the projection's `rebuiltAt` meta is younger than this, so a burst of
+     * maintenance requests cannot fan into back-to-back rebuilds. Floored at 60s.
+     * Default 6h (matches memoryLifecycleLedgerCompactMinIntervalMs).
+     */
+    projectionRebuildIntervalMs: number;
+    /**
+     * Postpone a scheduled full-corpus projection rebuild when
+     * `v8.getHeapStatistics().used_heap_size / heap_size_limit` exceeds this
+     * ratio. Finite number in `(0, 1]`. Default `0.6`. `1` disables the guard
+     * (usage cannot exceed the limit). A postponed rebuild uses the failure
+     * backoff and does not start the multi-GB allocation.
+     */
+    projectionRebuildHeapUsageLimit: number;
+}
+/** Integer coercion contract shared with `config.ts` (`parseIntegerAtLeast`). */
+type IntegerParser = (value: unknown, fallback: number, min: number, keyName: string) => number;
+/** Default heap-usage ratio above which a scheduled full-corpus rebuild waits. */
+export declare const DEFAULT_PROJECTION_REBUILD_HEAP_USAGE_LIMIT = 0.6;
+/**
+ * Parse `projectionRebuildHeapUsageLimit`. Absent values take the default.
+ * A present value must be a finite number in `(0, 1]` (numeric strings
+ * coerced). `0` is rejected: it would postpone every rebuild.
+ */
+export declare function parseProjectionRebuildHeapUsageLimit(value: unknown): number;
+/**
+ * Parse the scheduled projection-rebuild knobs. Boolean coercion follows
+ * gotcha #36 (`"false"` is false). The interval uses the shared integer
+ * parser (strings coerced, non-integers and sub-60s values rejected).
+ */
+export declare function parseProjectionRebuildScheduleConfig(cfg: Record<string, unknown>, parseIntegerAtLeast: IntegerParser): ProjectionRebuildScheduleConfig;
+export {};
+//# sourceMappingURL=projection-rebuild-config.d.ts.map

package/dist/projection-rebuild-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection-rebuild-config.d.ts","sourceRoot":"","sources":["../src/projection-rebuild-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,qEAAqE;AACrE,MAAM,WAAW,+BAA+B;IAC9C;;;;;;;OAOG;IACH,wBAAwB,EAAE,OAAO,CAAC;IAClC;;;;;OAKG;IACH,2BAA2B,EAAE,MAAM,CAAC;IACpC;;;;;;OAMG;IACH,+BAA+B,EAAE,MAAM,CAAC;CACzC;AAED,iFAAiF;AACjF,KAAK,aAAa,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;AAEhG,kFAAkF;AAClF,eAAO,MAAM,2CAA2C,MAAM,CAAC;AAE/D;;;;GAIG;AACH,wBAAgB,oCAAoC,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAS3E;AAED;;;;GAIG;AACH,wBAAgB,oCAAoC,CAClD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,mBAAmB,EAAE,aAAa,GACjC,+BAA+B,CAajC"}

package/dist/projection-rebuild-config.js

@@ -0,0 +1,14 @@
+import {
+  DEFAULT_PROJECTION_REBUILD_HEAP_USAGE_LIMIT,
+  parseProjectionRebuildHeapUsageLimit,
+  parseProjectionRebuildScheduleConfig
+} from "./chunk-EWMRFW3F.js";
+import "./chunk-PQVCH2AE.js";
+import "./chunk-3WCASNQZ.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  DEFAULT_PROJECTION_REBUILD_HEAP_USAGE_LIMIT,
+  parseProjectionRebuildHeapUsageLimit,
+  parseProjectionRebuildScheduleConfig
+};
+//# sourceMappingURL=projection-rebuild-config.js.map

package/dist/projection-rebuild-config.js.map

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

package/dist/qmd.js

@@ -7,7 +7,10 @@ import {
   retainSharedDaemonSession,
   runCommandWithTimeout,
   sharedDaemonSessionCountForTest
-} from "./chunk-IB63OVUB.js";
+} from "./chunk-AJ6ORARY.js";
+import {
+  parseQmdStatusOutput
+} from "./chunk-IUM3VSHI.js";
 import "./chunk-G26YNEOC.js";
 import "./chunk-IM2GO42H.js";
 import "./chunk-TPSLVZHS.js";
@@ -22,9 +25,6 @@ import {
   shouldAutoUpgradeQmd,
   versionAtLeast
 } from "./chunk-SIGAGKNE.js";
-import {
-  parseQmdStatusOutput
-} from "./chunk-IUM3VSHI.js";
 import "./chunk-C64XATK7.js";
 import "./chunk-42JKGUFJ.js";
 import "./chunk-ZEFVK7XC.js";

package/dist/recall-explain-renderer.js

@@ -5,13 +5,13 @@ import {
   toRecallExplainJson,
   toRecallExplainText,
   toRecallXraySnapshotFromLegacy
-} from "./chunk-32HO62I4.js";
+} from "./chunk-OFEHITAZ.js";
 import "./chunk-SOBJ6NEY.js";
-import "./chunk-QPWUG2S3.js";
+import "./chunk-CYEK6Z3P.js";
 import "./chunk-TOTT6S2V.js";
+import "./chunk-QWWMS4AE.js";
 import "./chunk-I4WBNM3M.js";
 import "./chunk-SOAU2OE2.js";
-import "./chunk-RKDSELA3.js";
 import "./chunk-PZ5AY32C.js";
 export {
   parseRecallExplainFormat,

package/dist/recall-navigate-access.js

@@ -1,8 +1,8 @@
 import {
   expandRecallNode,
   traverseRecallLink
-} from "./chunk-RFIJRZ4K.js";
-import "./chunk-RKDSELA3.js";
+} from "./chunk-B657ZGDH.js";
+import "./chunk-QWWMS4AE.js";
 import "./chunk-PZ5AY32C.js";
 
 // src/recall-navigate-access.ts

package/dist/recall-navigate-disclosure.js

@@ -1,8 +1,8 @@
 import {
   disclosureRank,
   planDisclosureStep
-} from "./chunk-35A7GCHG.js";
-import "./chunk-RKDSELA3.js";
+} from "./chunk-6T42L5FI.js";
+import "./chunk-QWWMS4AE.js";
 import "./chunk-PZ5AY32C.js";
 export {
   disclosureRank,

package/dist/recall-navigate.js

@@ -3,8 +3,8 @@ import {
   expandRecallNode,
   isRecallNavLinkType,
   traverseRecallLink
-} from "./chunk-RFIJRZ4K.js";
-import "./chunk-RKDSELA3.js";
+} from "./chunk-B657ZGDH.js";
+import "./chunk-QWWMS4AE.js";
 import "./chunk-PZ5AY32C.js";
 export {
   RECALL_NAV_LINK_TYPES,

package/dist/recall-navigation-operations.js

@@ -1,47 +1,47 @@
-import "./chunk-5QXMESS7.js";
-import "./chunk-NGOZH7R5.js";
+import "./chunk-AXC7UTLM.js";
+import "./chunk-GVUW5XK5.js";
 import "./chunk-W4F3C7N7.js";
 import "./chunk-MPC7TYTZ.js";
 import "./chunk-UK5EH7AI.js";
 import "./chunk-IFBSZGW3.js";
-import "./chunk-OGXXGHW6.js";
 import "./chunk-EQUD7FP4.js";
 import "./chunk-VQ7B2Q6M.js";
+import "./chunk-OGXXGHW6.js";
+import "./chunk-XQSJXNWC.js";
 import "./chunk-BANSBRNX.js";
-import "./chunk-2NV7MMMM.js";
 import "./chunk-GNVZQ5JN.js";
 import "./chunk-YN2UN7N3.js";
 import "./chunk-ROBHL3GL.js";
-import "./chunk-NQHSXHJP.js";
+import "./chunk-L6GNS5GB.js";
 import "./chunk-RIEGCK2W.js";
 import "./chunk-WWDO7ZWM.js";
 import "./chunk-JYG2334B.js";
 import "./chunk-5Y43VGYB.js";
-import "./chunk-R4NGLTUS.js";
+import "./chunk-TZQOCQXB.js";
+import "./chunk-TDMNADPI.js";
 import "./chunk-5HFVWYHL.js";
-import "./chunk-LI76ESJL.js";
 import "./chunk-KIW3OOZE.js";
 import "./chunk-YE4JBZO5.js";
 import "./chunk-5KVT6G5U.js";
 import "./chunk-VYDGHJIN.js";
-import "./chunk-35A7GCHG.js";
+import "./chunk-6T42L5FI.js";
 import "./chunk-7O5EW7KX.js";
 import "./chunk-H7XKCNR6.js";
-import "./chunk-32HO62I4.js";
+import "./chunk-OFEHITAZ.js";
 import "./chunk-SOBJ6NEY.js";
-import "./chunk-QPWUG2S3.js";
-import "./chunk-CSLK7BN6.js";
-import "./chunk-E6UNM67F.js";
+import "./chunk-CYEK6Z3P.js";
 import "./chunk-BNMI3JBV.js";
+import "./chunk-7LYRFI5A.js";
+import "./chunk-E6UNM67F.js";
+import "./chunk-UD7UNYRD.js";
 import "./chunk-6WHJ2EAB.js";
 import "./chunk-AQEJKOKI.js";
 import "./chunk-HM7RHKS4.js";
 import "./chunk-IISBCCWR.js";
-import "./chunk-UD7UNYRD.js";
-import "./chunk-EJJMDLVB.js";
-import "./chunk-2EZB2DL5.js";
+import "./chunk-IJ4FEGZR.js";
+import "./chunk-GE6HETIF.js";
 import "./chunk-2YA5N2BY.js";
-import "./chunk-RXT6UB25.js";
+import "./chunk-YJAOYEWI.js";
 import "./chunk-7PZHH4KC.js";
 import "./chunk-CHDGJJV6.js";
 import "./chunk-EI6V5UXY.js";
@@ -50,7 +50,7 @@ import "./chunk-WL7N5VGG.js";
 import "./chunk-754XN6LX.js";
 import "./chunk-BLVHDY2U.js";
 import "./chunk-5MA7ZLPD.js";
-import "./chunk-IDSSDL4W.js";
+import "./chunk-JXSYWTFK.js";
 import "./chunk-QM2SPLKQ.js";
 import "./chunk-U4LUIE6Y.js";
 import "./chunk-JUXOTY6J.js";
@@ -58,6 +58,7 @@ import "./chunk-LTHVM4XN.js";
 import "./chunk-UXIZ5XN5.js";
 import "./chunk-C37ZRXX7.js";
 import "./chunk-NVKO5YKP.js";
+import "./chunk-JNLEJE4A.js";
 import "./chunk-RF2SMMPP.js";
 import "./chunk-3X5OPDPF.js";
 import "./chunk-YRULQW5J.js";
@@ -66,13 +67,12 @@ import "./chunk-VZIAVM72.js";
 import "./chunk-HRATODNO.js";
 import "./chunk-UFGFMWAD.js";
 import "./chunk-BMWN7B3Y.js";
-import "./chunk-JNLEJE4A.js";
-import "./chunk-IXYIW3MZ.js";
-import "./chunk-CGOKNQDK.js";
-import "./chunk-O24EWFPQ.js";
-import "./chunk-CFCEJNOE.js";
+import "./chunk-4K2H4KTR.js";
+import "./chunk-ANZXWOYD.js";
+import "./chunk-SNXBXYUE.js";
+import "./chunk-6KHF6PAB.js";
 import "./chunk-ZY2MNJR6.js";
-import "./chunk-L6DJJEFW.js";
+import "./chunk-YJEUHGZZ.js";
 import "./chunk-3UXOZBHV.js";
 import "./chunk-PIWFNPQT.js";
 import "./chunk-2U3R3DDH.js";
@@ -81,18 +81,19 @@ import "./chunk-EUT2WCWS.js";
 import "./chunk-GKCXTSFF.js";
 import "./chunk-2LSZVONP.js";
 import "./chunk-DEUNUKTD.js";
-import "./chunk-6AA7XFMO.js";
+import "./chunk-GF4H3B3R.js";
+import "./chunk-GZFKCLRC.js";
 import "./chunk-6JMQR72P.js";
-import "./chunk-NLYOOGZ7.js";
-import "./chunk-PCO3P7WJ.js";
+import "./chunk-KE5PWLI6.js";
+import "./chunk-OGVJXIHX.js";
 import "./chunk-CSAKJVXW.js";
 import "./chunk-K2XUWZBM.js";
 import "./chunk-OD4FM2U7.js";
 import "./chunk-KF7PQ7G2.js";
 import "./chunk-TBBDFYXW.js";
-import "./chunk-GZFKCLRC.js";
+import "./chunk-SYOIVK7K.js";
 import "./chunk-TOTT6S2V.js";
-import "./chunk-QLK3SL7Q.js";
+import "./chunk-ETSJD5IV.js";
 import "./chunk-FEHIOYML.js";
 import "./chunk-P32IDSHD.js";
 import "./chunk-EH3HNCAM.js";
@@ -107,28 +108,28 @@ import "./chunk-236PXYG7.js";
 import "./chunk-ZCUTSMR2.js";
 import "./chunk-QDW3E4RD.js";
 import "./chunk-VZBW6CDG.js";
-import "./chunk-6JIHC5AS.js";
-import "./chunk-UHVXE24Y.js";
+import "./chunk-37HCPM56.js";
 import "./chunk-46WM6JX2.js";
+import "./chunk-UHVXE24Y.js";
 import "./chunk-V4JZCTMK.js";
-import "./chunk-GUD6FYQG.js";
-import "./chunk-OV7EYM6M.js";
-import "./chunk-S7LWX2PQ.js";
-import "./chunk-T2YX56QI.js";
-import "./chunk-CYEPCZN5.js";
+import "./chunk-RSMIRLKM.js";
+import "./chunk-U6OXJQEH.js";
 import "./chunk-T3FMRLWQ.js";
 import "./chunk-7VO6E5UD.js";
-import "./chunk-4O6WRBGE.js";
 import "./chunk-5BUCKFRE.js";
+import "./chunk-S7LWX2PQ.js";
+import "./chunk-T2YX56QI.js";
+import "./chunk-4O6WRBGE.js";
 import "./chunk-GUMZC2BO.js";
-import "./chunk-QCP75JGO.js";
-import "./chunk-A7Q43EUZ.js";
+import "./chunk-CYEPCZN5.js";
+import "./chunk-TFA6HPOA.js";
 import "./chunk-F4TWWUMP.js";
 import "./chunk-72A4L5JJ.js";
+import "./chunk-A7Q43EUZ.js";
 import "./chunk-S2V7RUCL.js";
 import "./chunk-X3724WL4.js";
-import "./chunk-S2HLHAZ4.js";
 import "./chunk-MRPOZBJC.js";
+import "./chunk-S2HLHAZ4.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
 import "./chunk-FF6N7BXC.js";
@@ -136,13 +137,12 @@ import "./chunk-2DT7PIDZ.js";
 import "./chunk-AAD2ZS6P.js";
 import "./chunk-EIFYYHAF.js";
 import "./chunk-ZIKENA2C.js";
-import "./chunk-345MEMRU.js";
+import "./chunk-3OUGSOJP.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-3ONXXHQO.js";
 import "./chunk-YXZG5TVN.js";
-import "./chunk-5GINB5LC.js";
 import "./chunk-3WU7XOFN.js";
-import "./chunk-G7D6GZ5J.js";
+import "./chunk-6MKLMEBE.js";
 import "./chunk-W5XWHTDO.js";
 import "./chunk-M5GVCJSJ.js";
 import "./chunk-RBOJCG4T.js";
@@ -150,13 +150,14 @@ import "./chunk-R7QY5ZVB.js";
 import "./chunk-5WITETWU.js";
 import "./chunk-6CIAGZ6X.js";
 import "./chunk-7CT3AI52.js";
+import "./chunk-G7D6GZ5J.js";
 import "./chunk-ZJP66Q4I.js";
-import "./chunk-IB63OVUB.js";
+import "./chunk-AJ6ORARY.js";
+import "./chunk-IUM3VSHI.js";
 import "./chunk-G26YNEOC.js";
 import "./chunk-IM2GO42H.js";
 import "./chunk-TPSLVZHS.js";
 import "./chunk-SIGAGKNE.js";
-import "./chunk-IUM3VSHI.js";
 import "./chunk-23G5P7TA.js";
 import "./chunk-C64XATK7.js";
 import "./chunk-42JKGUFJ.js";
@@ -166,17 +167,22 @@ import "./chunk-L2EXJQJP.js";
 import "./chunk-45GF7Y3V.js";
 import "./chunk-EP6BA7VV.js";
 import "./chunk-E2AWJ7KQ.js";
+import "./chunk-Z7L72ZHL.js";
+import "./chunk-4O4TKIXQ.js";
 import "./chunk-C5C7IJ4Q.js";
 import "./chunk-YCVB7X56.js";
 import "./chunk-PQVCH2AE.js";
 import "./chunk-PJKTFXE2.js";
 import "./chunk-W5BIQOAJ.js";
-import "./chunk-Z7L72ZHL.js";
-import "./chunk-4O4TKIXQ.js";
+import "./chunk-EEDI3OXB.js";
+import "./chunk-CDWFWOSZ.js";
+import "./chunk-CTVWELNK.js";
+import "./chunk-QWWMS4AE.js";
+import "./chunk-YBA52OKG.js";
 import "./chunk-RMMA44HE.js";
-import "./chunk-SYOIVK7K.js";
+import "./chunk-T2JSUEH6.js";
 import "./chunk-HRZZJ4XB.js";
-import "./chunk-MY7B3HYC.js";
+import "./chunk-CLCMDKTB.js";
 import "./chunk-353C5UNV.js";
 import "./chunk-5AYUHSAU.js";
 import "./chunk-BT7NVCML.js";
@@ -192,24 +198,28 @@ import "./chunk-SOAU2OE2.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";
 import "./chunk-FP2373TW.js";
-import "./chunk-WI37MWRZ.js";
+import "./chunk-63UNVGZW.js";
 import "./chunk-N7QV3CMX.js";
 import "./chunk-PAAJWQH5.js";
-import "./chunk-2JRB3Z5N.js";
+import "./chunk-EP5WXE2G.js";
 import "./chunk-7XI2UJHL.js";
 import "./chunk-E5H4TM4Y.js";
 import "./chunk-6MINUTGJ.js";
 import "./chunk-L272A5QW.js";
-import "./chunk-22DYJLFN.js";
+import "./chunk-XVC7JU2N.js";
 import "./chunk-ZA53AZND.js";
 import "./chunk-7RJUVTVF.js";
 import "./chunk-AL3UYZ5N.js";
 import "./chunk-RL6NEVXT.js";
+import "./chunk-PWPIERBM.js";
 import "./chunk-IG747LRN.js";
 import "./chunk-C7HJ3NEI.js";
 import "./chunk-N4PYB235.js";
-import "./chunk-AW4QUFQF.js";
+import "./chunk-BTNNL7ZW.js";
 import "./chunk-5FVVY2EB.js";
+import "./chunk-JDSVLVCG.js";
+import "./chunk-5GKPFL3S.js";
+import "./chunk-JAKIDQB2.js";
 import "./chunk-TGF43K66.js";
 import "./chunk-UI3NYK34.js";
 import "./chunk-3E6DGSGZ.js";
@@ -223,24 +233,14 @@ import "./chunk-75PT4N7Q.js";
 import "./chunk-Y57GJDG5.js";
 import "./chunk-LQWOFU6L.js";
 import "./chunk-FFAZ2XFU.js";
-import "./chunk-YVRQ5JRA.js";
-import "./chunk-EEDI3OXB.js";
-import "./chunk-CDWFWOSZ.js";
-import "./chunk-CTVWELNK.js";
-import "./chunk-RKDSELA3.js";
-import "./chunk-YBA52OKG.js";
-import "./chunk-PWPIERBM.js";
-import "./chunk-JDSVLVCG.js";
-import "./chunk-5GKPFL3S.js";
-import "./chunk-JAKIDQB2.js";
 import "./chunk-P7FMDTKL.js";
+import "./chunk-YVRQ5JRA.js";
 import "./chunk-BFIZXFUG.js";
 import "./chunk-OEIA4IHU.js";
 import "./chunk-PCXDUHQH.js";
 import "./chunk-VUFL7X3H.js";
 import "./chunk-2EMROIXS.js";
 import "./chunk-LNEWDF2A.js";
-import "./chunk-T2JSUEH6.js";
 import "./chunk-VFUEZZBS.js";
 import "./chunk-YVGXH72Y.js";
 import "./chunk-3Q3N35W7.js";