@hviana/sema 0.1.5 → 0.1.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (160) hide show
  1. package/AGENTS.md +6 -5
  2. package/CITATION.cff +49 -0
  3. package/HOW_IT_WORKS.md +11 -12
  4. package/README.md +7 -5
  5. package/dist/example/demo.js +25 -25
  6. package/dist/example/train_base.d.ts +19 -21
  7. package/dist/example/train_base.js +1687 -1952
  8. package/dist/src/alphabet.d.ts +3 -3
  9. package/dist/src/alphabet.js +24 -27
  10. package/dist/src/alu/src/alu.d.ts +169 -194
  11. package/dist/src/alu/src/alu.js +374 -414
  12. package/dist/src/alu/src/expr.d.ts +36 -43
  13. package/dist/src/alu/src/expr.js +252 -278
  14. package/dist/src/alu/src/index.d.ts +9 -98
  15. package/dist/src/alu/src/index.js +10 -64
  16. package/dist/src/alu/src/kernel-arith.d.ts +1 -5
  17. package/dist/src/alu/src/kernel-arith.js +195 -285
  18. package/dist/src/alu/src/kernel-bits.d.ts +1 -5
  19. package/dist/src/alu/src/kernel-bits.js +81 -115
  20. package/dist/src/alu/src/kernel-logic.js +33 -63
  21. package/dist/src/alu/src/kernel-nd.js +155 -195
  22. package/dist/src/alu/src/kernel-numeric.d.ts +16 -80
  23. package/dist/src/alu/src/kernel-numeric.js +259 -331
  24. package/dist/src/alu/src/operation.d.ts +112 -132
  25. package/dist/src/alu/src/operation.js +149 -163
  26. package/dist/src/alu/src/parser.d.ts +168 -175
  27. package/dist/src/alu/src/parser.js +382 -421
  28. package/dist/src/alu/src/resonance.d.ts +16 -25
  29. package/dist/src/alu/src/resonance.js +49 -56
  30. package/dist/src/alu/src/text.d.ts +3 -7
  31. package/dist/src/alu/src/text.js +31 -37
  32. package/dist/src/alu/src/value.d.ts +14 -14
  33. package/dist/src/alu/src/value.js +150 -160
  34. package/dist/src/alu/test/alu.test.js +543 -656
  35. package/dist/src/bytes.d.ts +1 -5
  36. package/dist/src/bytes.js +33 -40
  37. package/dist/src/config.d.ts +99 -102
  38. package/dist/src/config.js +78 -83
  39. package/dist/src/derive/src/deduction.d.ts +60 -62
  40. package/dist/src/derive/src/deduction.js +103 -109
  41. package/dist/src/derive/src/index.d.ts +1 -7
  42. package/dist/src/derive/src/priority-queue.d.ts +8 -8
  43. package/dist/src/derive/src/priority-queue.js +57 -61
  44. package/dist/src/derive/src/rewrite.d.ts +15 -18
  45. package/dist/src/derive/src/rewrite.js +59 -67
  46. package/dist/src/derive/src/trie.d.ts +56 -56
  47. package/dist/src/derive/src/trie.js +175 -179
  48. package/dist/src/derive/test/derive.test.js +96 -100
  49. package/dist/src/extension.d.ts +13 -16
  50. package/dist/src/geometry.d.ts +17 -42
  51. package/dist/src/geometry.js +235 -266
  52. package/dist/src/index.d.ts +2 -17
  53. package/dist/src/index.js +2 -12
  54. package/dist/src/ingest-cache.d.ts +25 -30
  55. package/dist/src/ingest-cache.js +108 -127
  56. package/dist/src/mind/articulation.d.ts +1 -5
  57. package/dist/src/mind/articulation.js +77 -112
  58. package/dist/src/mind/attention.d.ts +40 -108
  59. package/dist/src/mind/attention.js +749 -871
  60. package/dist/src/mind/canonical.d.ts +4 -19
  61. package/dist/src/mind/canonical.js +27 -31
  62. package/dist/src/mind/graph-search.d.ts +201 -225
  63. package/dist/src/mind/graph-search.js +742 -821
  64. package/dist/src/mind/index.d.ts +2 -10
  65. package/dist/src/mind/junction.d.ts +31 -58
  66. package/dist/src/mind/junction.js +172 -237
  67. package/dist/src/mind/learning.d.ts +16 -52
  68. package/dist/src/mind/learning.js +143 -165
  69. package/dist/src/mind/match.d.ts +20 -69
  70. package/dist/src/mind/match.js +259 -318
  71. package/dist/src/mind/mechanisms/alu.js +16 -16
  72. package/dist/src/mind/mechanisms/cast.d.ts +9 -13
  73. package/dist/src/mind/mechanisms/cast.js +363 -456
  74. package/dist/src/mind/mechanisms/confluence.d.ts +8 -12
  75. package/dist/src/mind/mechanisms/confluence.js +152 -183
  76. package/dist/src/mind/mechanisms/cover.d.ts +2 -8
  77. package/dist/src/mind/mechanisms/cover.js +148 -210
  78. package/dist/src/mind/mechanisms/extraction.d.ts +8 -34
  79. package/dist/src/mind/mechanisms/extraction.js +234 -288
  80. package/dist/src/mind/mechanisms/recall.d.ts +6 -10
  81. package/dist/src/mind/mechanisms/recall.js +126 -185
  82. package/dist/src/mind/mind.d.ts +129 -154
  83. package/dist/src/mind/mind.js +258 -288
  84. package/dist/src/mind/pipeline-mechanism.d.ts +112 -124
  85. package/dist/src/mind/pipeline-mechanism.js +161 -172
  86. package/dist/src/mind/pipeline.d.ts +4 -14
  87. package/dist/src/mind/pipeline.js +125 -189
  88. package/dist/src/mind/primitives.d.ts +8 -32
  89. package/dist/src/mind/primitives.js +99 -117
  90. package/dist/src/mind/rationale.d.ts +86 -98
  91. package/dist/src/mind/rationale.js +113 -121
  92. package/dist/src/mind/reasoning.d.ts +2 -13
  93. package/dist/src/mind/reasoning.js +129 -166
  94. package/dist/src/mind/recognition.d.ts +1 -4
  95. package/dist/src/mind/recognition.js +183 -208
  96. package/dist/src/mind/resonance.d.ts +5 -22
  97. package/dist/src/mind/resonance.js +0 -0
  98. package/dist/src/mind/trace.d.ts +6 -25
  99. package/dist/src/mind/trace.js +50 -58
  100. package/dist/src/mind/traverse.d.ts +16 -58
  101. package/dist/src/mind/traverse.js +304 -357
  102. package/dist/src/mind/types.d.ts +120 -127
  103. package/dist/src/mind/types.js +60 -69
  104. package/dist/src/rabitq-ivf/src/database.d.ts +113 -0
  105. package/dist/src/rabitq-ivf/src/database.js +201 -0
  106. package/dist/src/rabitq-ivf/src/index.d.ts +7 -0
  107. package/dist/src/{rabitq-hnsw → rabitq-ivf}/src/index.js +1 -3
  108. package/dist/src/rabitq-ivf/src/ivf.d.ts +200 -0
  109. package/dist/src/rabitq-ivf/src/ivf.js +1165 -0
  110. package/dist/src/rabitq-ivf/src/prng.d.ts +19 -0
  111. package/dist/src/rabitq-ivf/src/prng.js +36 -0
  112. package/dist/src/rabitq-ivf/src/rabitq.d.ts +95 -0
  113. package/dist/src/rabitq-ivf/src/rabitq.js +283 -0
  114. package/dist/src/sema.d.ts +9 -13
  115. package/dist/src/sema.js +26 -40
  116. package/dist/src/store-sqlite.d.ts +169 -166
  117. package/dist/src/store-sqlite.js +762 -662
  118. package/dist/src/store.d.ts +586 -630
  119. package/dist/src/store.js +1423 -1581
  120. package/dist/src/vec.d.ts +5 -9
  121. package/dist/src/vec.js +61 -73
  122. package/example/train_base.ts +13 -10
  123. package/package.json +1 -1
  124. package/src/alu/README.md +1 -1
  125. package/src/alu/src/index.ts +1 -1
  126. package/src/config.ts +19 -27
  127. package/src/index.ts +6 -11
  128. package/src/rabitq-ivf/README.md +56 -0
  129. package/src/rabitq-ivf/src/database.ts +276 -0
  130. package/src/{rabitq-hnsw → rabitq-ivf}/src/index.ts +2 -5
  131. package/src/rabitq-ivf/src/ivf.ts +1330 -0
  132. package/src/{rabitq-hnsw → rabitq-ivf}/src/prng.ts +1 -1
  133. package/src/store-sqlite.ts +196 -9
  134. package/src/store.ts +8 -32
  135. package/test/08-storage.test.mjs +3 -3
  136. package/test/14-scaling.test.mjs +2 -2
  137. package/test/35-ivf.test.mjs +263 -0
  138. package/test/36-bloom.test.mjs +123 -0
  139. package/dist/src/rabitq-hnsw/src/database.d.ts +0 -202
  140. package/dist/src/rabitq-hnsw/src/database.js +0 -405
  141. package/dist/src/rabitq-hnsw/src/heap.d.ts +0 -22
  142. package/dist/src/rabitq-hnsw/src/heap.js +0 -94
  143. package/dist/src/rabitq-hnsw/src/hnsw.d.ts +0 -125
  144. package/dist/src/rabitq-hnsw/src/hnsw.js +0 -500
  145. package/dist/src/rabitq-hnsw/src/index.d.ts +0 -15
  146. package/dist/src/rabitq-hnsw/src/prng.d.ts +0 -19
  147. package/dist/src/rabitq-hnsw/src/prng.js +0 -38
  148. package/dist/src/rabitq-hnsw/src/rabitq.d.ts +0 -95
  149. package/dist/src/rabitq-hnsw/src/rabitq.js +0 -299
  150. package/dist/src/rabitq-hnsw/src/store.d.ts +0 -162
  151. package/dist/src/rabitq-hnsw/src/store.js +0 -916
  152. package/dist/src/rabitq-hnsw/test/hnsw.test.d.ts +0 -1
  153. package/dist/src/rabitq-hnsw/test/hnsw.test.js +0 -1197
  154. package/src/rabitq-hnsw/README.md +0 -303
  155. package/src/rabitq-hnsw/src/database.ts +0 -492
  156. package/src/rabitq-hnsw/src/heap.ts +0 -90
  157. package/src/rabitq-hnsw/src/hnsw.ts +0 -514
  158. package/src/rabitq-hnsw/src/store.ts +0 -994
  159. package/src/rabitq-hnsw/test/hnsw.test.ts +0 -1213
  160. /package/src/{rabitq-hnsw → rabitq-ivf}/src/rabitq.ts +0 -0
@@ -11,12 +11,7 @@ import type { AncestorReach, MindContext } from "./types.js";
11
11
  * repeatedly — regions sharing a chunk, and canonicalChunkId probing each
12
12
  * chunk's prefixes — so without the memo every repeat re-pays the full
13
13
  * fan-out reads. */
14
- export declare function edgeAncestors(
15
- ctx: MindContext,
16
- id: number,
17
- contextCount: number,
18
- memo?: Map<number, AncestorReach>,
19
- ): AncestorReach;
14
+ export declare function edgeAncestors(ctx: MindContext, id: number, contextCount: number, memo?: Map<number, AncestorReach>): AncestorReach;
20
15
  /** Convenience: forward edges of a node. */
21
16
  export declare function nextOf(ctx: MindContext, id: number): number[];
22
17
  /** Convenience: reverse edges of a node. */
@@ -37,12 +32,7 @@ export declare function leadsSomewhere(ctx: MindContext, id: number): boolean;
37
32
  * half-dominance convention (geometry.dominates(reach, N)): content
38
33
  * reaching a corpus MINORITY of contexts discriminates (an entity, a
39
34
  * filler); content reaching a majority is frame scaffolding. */
40
- export declare function reachOf(
41
- ctx: MindContext,
42
- id: number,
43
- contextCount: number,
44
- memo?: Map<number, AncestorReach>,
45
- ): number;
35
+ export declare function reachOf(ctx: MindContext, id: number, contextCount: number, memo?: Map<number, AncestorReach>): number;
46
36
  /** The corpus scale N — the count of DISTINCT learnt contexts, floored at 2
47
37
  * so its derived readings (ln N in the consensus floor, √N in the hub bound)
48
38
  * stay meaningful on a near-empty store. The one definition every consumer
@@ -58,55 +48,31 @@ export declare function hubBound(ctx: MindContext): number;
58
48
  * §8.6). A node connected to more than √N others is a hub whose individual
59
49
  * connections carry ~no discriminative information; materialising or scoring
60
50
  * them all would make single decisions scale with the corpus. */
61
- export declare function hubCap<T>(
62
- ctx: MindContext,
63
- ids: readonly T[],
64
- ): readonly T[];
51
+ export declare function hubCap<T>(ctx: MindContext, ids: readonly T[]): readonly T[];
65
52
  /** Whether `descendant` lies within `ancestor`'s subtree — a structural DAG
66
53
  * relation read off the hash-consed `kids` lists, by a bounded explicit-stack
67
54
  * descent. Used by articulation to keep a voice from revoicing a fragment
68
55
  * OF that voice. */
69
- export declare function contains(
70
- ctx: MindContext,
71
- ancestor: number,
72
- descendant: number,
73
- ): boolean;
56
+ export declare function contains(ctx: MindContext, ancestor: number, descendant: number): boolean;
74
57
  /** The best-scoring item by cosine against `query`, among items scoring at
75
58
  * or above `threshold` — the shared arg-max every Pattern-A "which of these
76
59
  * resonates best" decision reduces to. `strict` picks the tie-break a
77
60
  * caller needs: `true` keeps the first-seen leader on a tie (`>`), the
78
61
  * default lets a later equal score take it (`>=`). */
79
- export declare function argmaxBy<T>(
80
- items: Iterable<T>,
81
- scoreOf: (item: T) => number,
82
- threshold: number,
83
- strict?: boolean,
84
- ): {
85
- item: T;
86
- score: number;
62
+ export declare function argmaxBy<T>(items: Iterable<T>, scoreOf: (item: T) => number, threshold: number, strict?: boolean): {
63
+ item: T;
64
+ score: number;
87
65
  } | null;
88
- export declare function argmaxCosine<T>(
89
- query: Vec,
90
- items: Iterable<T>,
91
- vecOf: (item: T) => Vec | null | undefined,
92
- threshold: number,
93
- strict?: boolean,
94
- ): {
95
- item: T;
96
- score: number;
66
+ export declare function argmaxCosine<T>(query: Vec, items: Iterable<T>, vecOf: (item: T) => Vec | null | undefined, threshold: number, strict?: boolean): {
67
+ item: T;
68
+ score: number;
97
69
  } | null;
98
70
  /** The guided-or-first continuation of a node, as answer-shaped bytes source:
99
71
  * chooseNext under the response guide, falling back to the FIRST-inserted
100
72
  * edge — the one no-guide convention chooseNext, project() and the search's
101
73
  * formRules all share. undefined when the node has no continuation. */
102
- export declare function guidedFirst(
103
- ctx: MindContext,
104
- id: number,
105
- ): number | undefined;
106
- export declare function guidedNext(
107
- ctx: MindContext,
108
- node: number,
109
- ): number | undefined;
74
+ export declare function guidedFirst(ctx: MindContext, id: number): number | undefined;
75
+ export declare function guidedNext(ctx: MindContext, node: number): number | undefined;
110
76
  /** Disambiguate among a node's learnt continuations by distributional
111
77
  * support. NOTE the `guide` contract: its VALUE is deliberately unused —
112
78
  * only its PRESENCE gates disambiguation (a null guide means no query is in
@@ -119,11 +85,7 @@ export declare function guidedNext(
119
85
  * that their perceived gists ARE semantically meaningful — and which
120
86
  * therefore scores by guide cosine. The two directions consult different
121
87
  * halves of the evidence on purpose. */
122
- export declare function chooseNext(
123
- ctx: MindContext,
124
- id: number,
125
- guide?: Vec | null,
126
- ): number | undefined;
88
+ export declare function chooseNext(ctx: MindContext, id: number, guide?: Vec | null): number | undefined;
127
89
  /** The perceived gist of a candidate node, through the session gist cache.
128
90
  * Re-gisting a candidate is a full river fold of its bytes — the measured
129
91
  * recall bottleneck (a hub context offers up to √N continuations, EACH
@@ -132,11 +94,7 @@ export declare function chooseNext(
132
94
  * every "score node ids against a guide" decision (chooseAmong here, the
133
95
  * bridge's junction pick) so they share ONE cache and one convention. */
134
96
  export declare function candidateGist(ctx: MindContext, c: number): Vec | null;
135
- export declare function chooseAmong(
136
- ctx: MindContext,
137
- candidates: readonly number[],
138
- guide: Vec,
139
- ): {
140
- id: number;
141
- score: number;
97
+ export declare function chooseAmong(ctx: MindContext, candidates: readonly number[], guide: Vec): {
98
+ id: number;
99
+ score: number;
142
100
  };