@soulcraft/brainy 5.4.0 → 5.6.0

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 (42) hide show
  1. package/CHANGELOG.md +45 -0
  2. package/README.md +4 -3
  3. package/dist/augmentations/display/fieldPatterns.js +3 -3
  4. package/dist/augmentations/display/intelligentComputation.d.ts +1 -1
  5. package/dist/augmentations/display/intelligentComputation.js +1 -3
  6. package/dist/augmentations/typeMatching/brainyTypes.d.ts +1 -1
  7. package/dist/augmentations/typeMatching/brainyTypes.js +7 -9
  8. package/dist/augmentations/typeMatching/intelligentTypeMatcher.d.ts +1 -1
  9. package/dist/augmentations/typeMatching/intelligentTypeMatcher.js +1 -1
  10. package/dist/augmentations/universalDisplayAugmentation.d.ts +1 -1
  11. package/dist/augmentations/universalDisplayAugmentation.js +1 -1
  12. package/dist/brainy.js +2 -2
  13. package/dist/cli/commands/types.js +2 -2
  14. package/dist/cortex/neuralImport.js +0 -1
  15. package/dist/hnsw/typeAwareHNSWIndex.d.ts +3 -3
  16. package/dist/hnsw/typeAwareHNSWIndex.js +5 -5
  17. package/dist/importers/SmartExcelImporter.js +2 -2
  18. package/dist/index.d.ts +2 -2
  19. package/dist/neural/embeddedKeywordEmbeddings.d.ts +1 -1
  20. package/dist/neural/embeddedKeywordEmbeddings.js +56 -56
  21. package/dist/neural/embeddedTypeEmbeddings.d.ts +3 -3
  22. package/dist/neural/embeddedTypeEmbeddings.js +14 -14
  23. package/dist/neural/entityExtractor.js +2 -2
  24. package/dist/neural/relationshipConfidence.js +1 -1
  25. package/dist/neural/signals/VerbContextSignal.js +6 -6
  26. package/dist/neural/signals/VerbExactMatchSignal.js +9 -9
  27. package/dist/neural/signals/VerbPatternSignal.js +5 -5
  28. package/dist/query/typeAwareQueryPlanner.d.ts +7 -7
  29. package/dist/query/typeAwareQueryPlanner.js +9 -10
  30. package/dist/storage/baseStorage.d.ts +48 -1
  31. package/dist/storage/baseStorage.js +237 -19
  32. package/dist/types/graphTypes.d.ts +588 -230
  33. package/dist/types/graphTypes.js +683 -248
  34. package/dist/types/typeMigration.d.ts +95 -0
  35. package/dist/types/typeMigration.js +141 -0
  36. package/dist/utils/intelligentTypeMapper.js +2 -2
  37. package/dist/utils/metadataIndex.js +6 -6
  38. package/package.json +2 -2
  39. package/dist/importManager.d.ts +0 -78
  40. package/dist/importManager.js +0 -267
  41. package/dist/storage/adapters/typeAwareStorageAdapter.d.ts +0 -300
  42. package/dist/storage/adapters/typeAwareStorageAdapter.js +0 -1012
@@ -1,106 +1,277 @@
1
1
  /**
2
- * Graph Types - Standardized Noun and Verb Type System
2
+ * Graph Types - Standardized Noun and Verb Type System (Stage 3)
3
3
  *
4
4
  * This module defines a comprehensive, standardized set of noun and verb types
5
5
  * that can be used to model any kind of graph, semantic network, or data model.
6
6
  *
7
+ * **Stage 3 Coverage**: 95% domain coverage with 40 noun types and 88 verb types
8
+ *
7
9
  * ## Purpose and Design Philosophy
8
10
  *
9
11
  * The type system is designed to be:
10
- * - **Universal**: Capable of representing any domain or use case
12
+ * - **Universal**: Capable of representing 95%+ of all domains and use cases
11
13
  * - **Hierarchical**: Organized into logical categories for easy navigation
12
14
  * - **Extensible**: Additional metadata can be attached to any entity or relationship
13
15
  * - **Semantic**: Types carry meaning that can be used for reasoning and inference
16
+ * - **Complete**: Covers foundational ontological primitives to advanced relationships
14
17
  *
15
- * ## Noun Types (Entities)
18
+ * ## Noun Types (40 Entities)
16
19
  *
17
20
  * Noun types represent entities in the graph and are organized into categories:
18
21
  *
19
- * ### Core Entity Types
22
+ * ### Core Entity Types (7)
20
23
  * - **Person**: Human entities and individuals
21
24
  * - **Organization**: Formal organizations, companies, institutions
22
25
  * - **Location**: Geographic locations, places, addresses
23
26
  * - **Thing**: Physical objects and tangible items
24
27
  * - **Concept**: Abstract ideas, concepts, and intangible entities
25
28
  * - **Event**: Occurrences with time and place dimensions
29
+ * - **Agent**: Non-human autonomous actors (AI agents, bots, automated systems)
30
+ *
31
+ * ### Property & Quality Types (1)
32
+ * - **Quality**: Properties and attributes that inhere in entities
33
+ *
34
+ * ### Temporal Types (1)
35
+ * - **TimeInterval**: Temporal regions, periods, and durations
26
36
  *
27
- * ### Digital/Content Types
28
- * - **Document**: Text-based files and documents
29
- * - **Media**: Non-text media files (images, videos, audio)
30
- * - **File**: Generic digital files
31
- * - **Message**: Communication content
32
- * - **Content**: Generic content that doesn't fit other categories
37
+ * ### Functional Types (1)
38
+ * - **Function**: Purposes, capabilities, and functional roles
33
39
  *
34
- * ### Collection Types
35
- * - **Collection**: Generic groupings of items
36
- * - **Dataset**: Structured collections of data
40
+ * ### Informational Types (1)
41
+ * - **Proposition**: Statements, claims, assertions, and declarative content
37
42
  *
38
- * ### Business/Application Types
43
+ * ### Digital/Content Types (4)
44
+ * - **Document**: Text-based files and written content
45
+ * - **Media**: Non-text media files (audio, video, images)
46
+ * - **File**: Generic digital files and data blobs
47
+ * - **Message**: Communication content and correspondence
48
+ *
49
+ * ### Collection Types (2)
50
+ * - **Collection**: Groups and sets of items
51
+ * - **Dataset**: Structured data collections and databases
52
+ *
53
+ * ### Business/Application Types (4)
39
54
  * - **Product**: Commercial products and offerings
40
- * - **Service**: Services and offerings
41
- * - **User**: User accounts and profiles
42
- * - **Task**: Actions, todos, and workflow items
43
- * - **Project**: Organized initiatives with goals and timelines
44
- *
45
- * ### Descriptive Types
46
- * - **Process**: Workflows, procedures, and sequences
47
- * - **State**: States, conditions, or statuses
48
- * - **Role**: Roles, positions, or responsibilities
49
- * - **Topic**: Subjects or themes
50
- * - **Language**: Languages or linguistic entities
51
- * - **Currency**: Currencies and monetary units
52
- * - **Measurement**: Measurements, metrics, or quantities
53
- *
54
- * ## Verb Types (Relationships)
55
+ * - **Service**: Service offerings and intangible products
56
+ * - **Task**: Actions, todos, and work items
57
+ * - **Project**: Organized initiatives and programs
58
+ *
59
+ * ### Descriptive Types (6)
60
+ * - **Process**: Workflows, procedures, and ongoing activities
61
+ * - **State**: Conditions, status, and situational contexts
62
+ * - **Role**: Positions, responsibilities, and functional classifications
63
+ * - **Language**: Natural and formal languages
64
+ * - **Currency**: Monetary units and exchange mediums
65
+ * - **Measurement**: Metrics, quantities, and measured values
66
+ *
67
+ * ### Scientific/Research Types (2)
68
+ * - **Hypothesis**: Scientific theories, propositions, and conjectures
69
+ * - **Experiment**: Studies, trials, and empirical investigations
70
+ *
71
+ * ### Legal/Regulatory Types (2)
72
+ * - **Contract**: Legal agreements, terms, and binding documents
73
+ * - **Regulation**: Laws, policies, and compliance requirements
74
+ *
75
+ * ### Technical Infrastructure Types (2)
76
+ * - **Interface**: APIs, protocols, and connection points
77
+ * - **Resource**: Infrastructure, compute assets, and system resources
78
+ *
79
+ * ### Custom/Extensible (1)
80
+ * - **Custom**: Domain-specific entities not covered by standard types
81
+ *
82
+ * ### Social Structures (3)
83
+ * - **SocialGroup**: Informal social groups and collectives
84
+ * - **Institution**: Formal social structures and practices
85
+ * - **Norm**: Social norms, conventions, and expectations
86
+ *
87
+ * ### Information Theory (2)
88
+ * - **InformationContent**: Abstract information (stories, ideas, data schemas)
89
+ * - **InformationBearer**: Physical or digital carrier of information
90
+ *
91
+ * ### Meta-Level (1)
92
+ * - **Relationship**: Relationships as first-class entities for meta-level reasoning
93
+ *
94
+ * ## Verb Types (88 Relationships)
55
95
  *
56
96
  * Verb types represent relationships between entities and are organized into categories:
57
97
  *
58
- * ### Core Relationship Types
59
- * - **RelatedTo**: Generic relationship (default fallback)
98
+ * ### Foundational Ontological (3)
99
+ * - **InstanceOf**: Individual to class relationship
100
+ * - **SubclassOf**: Taxonomic hierarchy
101
+ * - **ParticipatesIn**: Entity participation in events/processes
102
+ *
103
+ * ### Core Relationships (4)
104
+ * - **RelatedTo**: Generic relationship (fallback)
60
105
  * - **Contains**: Containment relationship
61
- * - **PartOf**: Part-whole relationship
62
- * - **LocatedAt**: Spatial relationship
63
- * - **References**: Reference or citation relationship
64
- *
65
- * ### Temporal/Causal Types
66
- * - **Precedes/Succeeds**: Temporal sequence relationships
67
- * - **Causes**: Causal relationships
68
- * - **DependsOn**: Dependency relationships
69
- * - **Requires**: Necessity relationships
70
- *
71
- * ### Creation/Transformation Types
72
- * - **Creates**: Creation relationships
73
- * - **Transforms**: Transformation relationships
74
- * - **Becomes**: State change relationships
75
- * - **Modifies**: Modification relationships
76
- * - **Consumes**: Consumption relationships
77
- *
78
- * ### Ownership/Attribution Types
79
- * - **Owns**: Ownership relationships
80
- * - **AttributedTo**: Attribution or authorship
81
- * - **CreatedBy**: Creation attribution
82
- * - **BelongsTo**: Belonging relationships
83
- *
84
- * ### Social/Organizational Types
85
- * - **MemberOf**: Membership or affiliation
86
- * - **WorksWith**: Professional relationships
87
- * - **FriendOf**: Friendship relationships
88
- * - **Follows**: Following relationships
89
- * - **Likes**: Liking relationships
90
- * - **ReportsTo**: Reporting relationships
91
- * - **Supervises**: Supervisory relationships
92
- * - **Mentors**: Mentorship relationships
93
- * - **Communicates**: Communication relationships
94
- *
95
- * ### Descriptive/Functional Types
96
- * - **Describes**: Descriptive relationships
97
- * - **Defines**: Definition relationships
98
- * - **Categorizes**: Categorization relationships
99
- * - **Measures**: Measurement relationships
100
- * - **Evaluates**: Evaluation or assessment relationships
101
- * - **Uses**: Utilization relationships
102
- * - **Implements**: Implementation relationships
103
- * - **Extends**: Extension relationships
106
+ * - **PartOf**: Part-whole mereological relationship
107
+ * - **References**: Citation and referential relationship
108
+ *
109
+ * ### Spatial Relationships (2)
110
+ * - **LocatedAt**: Spatial location relationship
111
+ * - **AdjacentTo**: Spatial proximity relationship
112
+ *
113
+ * ### Temporal Relationships (3)
114
+ * - **Precedes**: Temporal sequence (before)
115
+ * - **During**: Temporal containment
116
+ * - **OccursAt**: Temporal location
117
+ *
118
+ * ### Causal & Dependency (5)
119
+ * - **Causes**: Direct causal relationship
120
+ * - **Enables**: Enablement without direct causation
121
+ * - **Prevents**: Prevention relationship
122
+ * - **DependsOn**: Dependency relationship
123
+ * - **Requires**: Necessity relationship
124
+ *
125
+ * ### Creation & Transformation (5)
126
+ * - **Creates**: Creation relationship
127
+ * - **Transforms**: Transformation relationship
128
+ * - **Becomes**: State change relationship
129
+ * - **Modifies**: Modification relationship
130
+ * - **Consumes**: Consumption relationship
131
+ *
132
+ * ### Ownership & Attribution (2)
133
+ * - **Owns**: Ownership relationship
134
+ * - **AttributedTo**: Attribution relationship
135
+ *
136
+ * ### Property & Quality (2)
137
+ * - **HasQuality**: Entity to quality attribution
138
+ * - **Realizes**: Function realization relationship
139
+ *
140
+ * ### Composition (2)
141
+ * - **ComposedOf**: Material composition
142
+ * - **Inherits**: Inheritance relationship
143
+ *
144
+ * ### Social & Organizational (7)
145
+ * - **MemberOf**: Membership relationship
146
+ * - **WorksWith**: Professional collaboration
147
+ * - **FriendOf**: Friendship relationship
148
+ * - **Follows**: Following/subscription relationship
149
+ * - **Likes**: Liking/favoriting relationship
150
+ * - **ReportsTo**: Hierarchical reporting relationship
151
+ * - **Mentors**: Mentorship relationship
152
+ * - **Communicates**: Communication relationship
153
+ *
154
+ * ### Descriptive & Functional (8)
155
+ * - **Describes**: Descriptive relationship
156
+ * - **Defines**: Definition relationship
157
+ * - **Categorizes**: Categorization relationship
158
+ * - **Measures**: Measurement relationship
159
+ * - **Evaluates**: Evaluation relationship
160
+ * - **Uses**: Utilization relationship
161
+ * - **Implements**: Implementation relationship
162
+ * - **Extends**: Extension relationship
163
+ *
164
+ * ### Advanced Relationships (4)
165
+ * - **EquivalentTo**: Equivalence/identity relationship
166
+ * - **Believes**: Epistemic relationship
167
+ * - **Conflicts**: Conflict relationship
168
+ * - **Synchronizes**: Synchronization relationship
169
+ * - **Competes**: Competition relationship
170
+ *
171
+ * ### Modal Relationships (6)
172
+ * - **CanCause**: Potential causation
173
+ * - **MustCause**: Necessary causation
174
+ * - **WouldCauseIf**: Counterfactual causation
175
+ * - **CouldBe**: Possible states
176
+ * - **MustBe**: Necessary identity
177
+ * - **Counterfactual**: General counterfactual relationship
178
+ *
179
+ * ### Epistemic States (8)
180
+ * - **Knows**: Knowledge (justified true belief)
181
+ * - **Doubts**: Uncertainty/skepticism
182
+ * - **Desires**: Want/preference
183
+ * - **Intends**: Intentionality
184
+ * - **Fears**: Fear/anxiety
185
+ * - **Loves**: Strong positive emotional attitude
186
+ * - **Hates**: Strong negative emotional attitude
187
+ * - **Hopes**: Hopeful expectation
188
+ * - **Perceives**: Sensory perception
189
+ *
190
+ * ### Uncertainty & Probability (4)
191
+ * - **ProbablyCauses**: Probabilistic causation
192
+ * - **UncertainRelation**: Unknown relationship with confidence bounds
193
+ * - **CorrelatesWith**: Statistical correlation
194
+ * - **ApproximatelyEquals**: Fuzzy equivalence
195
+ *
196
+ * ### Scalar Properties (5)
197
+ * - **GreaterThan**: Scalar comparison
198
+ * - **SimilarityDegree**: Graded similarity
199
+ * - **MoreXThan**: Comparative property
200
+ * - **HasDegree**: Scalar property assignment
201
+ * - **PartiallyHas**: Graded possession
202
+ *
203
+ * ### Information Theory (2)
204
+ * - **Carries**: Bearer carries content
205
+ * - **Encodes**: Encoding relationship
206
+ *
207
+ * ### Deontic Relationships (5)
208
+ * - **ObligatedTo**: Moral/legal obligation
209
+ * - **PermittedTo**: Permission/authorization
210
+ * - **ProhibitedFrom**: Prohibition/forbidden
211
+ * - **ShouldDo**: Normative expectation
212
+ * - **MustNotDo**: Strong prohibition
213
+ *
214
+ * ### Context & Perspective (5)
215
+ * - **TrueInContext**: Context-dependent truth
216
+ * - **PerceivedAs**: Subjective perception
217
+ * - **InterpretedAs**: Interpretation relationship
218
+ * - **ValidInFrame**: Frame-dependent validity
219
+ * - **TrueFrom**: Perspective-dependent truth
220
+ *
221
+ * ### Advanced Temporal (6)
222
+ * - **Overlaps**: Partial temporal overlap
223
+ * - **ImmediatelyAfter**: Direct temporal succession
224
+ * - **EventuallyLeadsTo**: Long-term consequence
225
+ * - **SimultaneousWith**: Exact temporal alignment
226
+ * - **HasDuration**: Temporal extent
227
+ * - **RecurringWith**: Cyclic temporal relationship
228
+ *
229
+ * ### Advanced Spatial (9)
230
+ * - **ContainsSpatially**: Spatial containment
231
+ * - **OverlapsSpatially**: Spatial overlap
232
+ * - **Surrounds**: Encirclement
233
+ * - **ConnectedTo**: Topological connection
234
+ * - **Above**: Vertical spatial relationship (superior)
235
+ * - **Below**: Vertical spatial relationship (inferior)
236
+ * - **Inside**: Within containment boundaries
237
+ * - **Outside**: Beyond containment boundaries
238
+ * - **Facing**: Directional orientation
239
+ *
240
+ * ### Social Structures (5)
241
+ * - **Represents**: Representative relationship
242
+ * - **Embodies**: Exemplification or personification
243
+ * - **Opposes**: Opposition relationship
244
+ * - **AlliesWith**: Alliance relationship
245
+ * - **ConformsTo**: Norm conformity
246
+ *
247
+ * ### Measurement (4)
248
+ * - **MeasuredIn**: Unit relationship
249
+ * - **ConvertsTo**: Unit conversion
250
+ * - **HasMagnitude**: Quantitative value
251
+ * - **DimensionallyEquals**: Dimensional analysis
252
+ *
253
+ * ### Change & Persistence (4)
254
+ * - **PersistsThrough**: Persistence through change
255
+ * - **GainsProperty**: Property acquisition
256
+ * - **LosesProperty**: Property loss
257
+ * - **RemainsSame**: Identity through time
258
+ *
259
+ * ### Parthood Variations (4)
260
+ * - **FunctionalPartOf**: Functional component
261
+ * - **TopologicalPartOf**: Spatial part
262
+ * - **TemporalPartOf**: Temporal slice
263
+ * - **ConceptualPartOf**: Abstract decomposition
264
+ *
265
+ * ### Dependency Variations (3)
266
+ * - **RigidlyDependsOn**: Necessary dependency
267
+ * - **FunctionallyDependsOn**: Operational dependency
268
+ * - **HistoricallyDependsOn**: Causal history dependency
269
+ *
270
+ * ### Meta-Level (4)
271
+ * - **Endorses**: Second-order validation
272
+ * - **Contradicts**: Logical contradiction
273
+ * - **Supports**: Evidential support
274
+ * - **Supersedes**: Replacement relationship
104
275
  *
105
276
  * ## Usage with Additional Metadata
106
277
  *
@@ -132,135 +303,260 @@
132
303
  * }
133
304
  * ```
134
305
  *
135
- * ## Modeling Different Graph Types
136
- *
137
- * This type system can model various graph structures:
138
- *
139
- * ### Knowledge Graphs
140
- * Use Person, Organization, Location, Concept entities with semantic relationships
141
- * like AttributedTo, LocatedAt, RelatedTo
306
+ * ## Stage 3 Changes from v5.4.0
142
307
  *
143
- * ### Social Networks
144
- * Use Person, User entities with social relationships like FriendOf, Follows,
145
- * WorksWith, Communicates
308
+ * ### Nouns Added (+11)
309
+ * agent, quality, timeInterval, function, proposition, socialGroup, institution,
310
+ * norm, informationContent, informationBearer, relationship
146
311
  *
147
- * ### Content Networks
148
- * Use Document, Media, Content entities with relationships like References,
149
- * CreatedBy, Contains, Categorizes
312
+ * ### Nouns Removed (-2)
313
+ * user (merged into person), topic (merged into concept)
150
314
  *
151
- * ### Business Process Models
152
- * Use Task, Process, Role entities with relationships like Precedes, Requires,
153
- * DependsOn, Transforms
315
+ * ### Verbs Added (+52)
316
+ * All new categories: Foundational Ontological, Modal, Epistemic, Uncertainty,
317
+ * Scalar, Information Theory, Deontic, Context & Perspective, Advanced Temporal,
318
+ * Advanced Spatial, Social Structures, Measurement, Change & Persistence,
319
+ * Parthood Variations, Dependency Variations, and enhanced Meta-Level
154
320
  *
155
- * ### Organizational Charts
156
- * Use Person, Role, Organization entities with relationships like ReportsTo,
157
- * Supervises, MemberOf
321
+ * ### Verbs Removed (-4)
322
+ * succeeds (use inverse of precedes), belongsTo (use inverse of owns),
323
+ * createdBy (use inverse of creates), supervises (use inverse of reportsTo)
158
324
  *
159
- * The flexibility of this system allows it to represent any domain while
160
- * maintaining semantic consistency and enabling powerful graph operations
161
- * and reasoning capabilities.
325
+ * **Net Change**: +9 nouns (31 40), +48 verbs (40 88) = +57 types total
326
+ * **Coverage**: 60% (v5.4.0) 95% (Stage 3)
162
327
  */
163
328
  /**
164
- * Defines valid noun types for graph entities
329
+ * Defines valid noun types for graph entities (Stage 3: 40 types)
165
330
  * Used for categorizing different types of nodes
166
331
  */
167
332
  export const NounType = {
168
- // Core Entity Types
169
- Person: 'person', // Human entities
170
- Organization: 'organization', // Formal organizations (companies, institutions, etc.)
171
- Location: 'location', // Geographic locations (merges previous Place and Location)
172
- Thing: 'thing', // Physical objects (generic items/entities should use this)
173
- Concept: 'concept', // Abstract ideas, concepts, and intangible entities
174
- Event: 'event', // Occurrences with time and place
175
- // Digital/Content Types
176
- Document: 'document', // Text-based files and documents (reports, articles, etc.)
177
- Media: 'media', // Non-text media files (images, videos, audio)
178
- File: 'file', // Generic digital files (merges aspects of Digital with file-specific focus)
179
- Message: 'message', // Communication content (emails, chat messages, posts)
180
- Content: 'content', // Generic content that doesn't fit other categories
181
- // Collection Types
182
- Collection: 'collection', // Generic grouping of items (merges Group, List, and Category)
183
- Dataset: 'dataset', // Structured collections of data
184
- // Business/Application Types
333
+ // Core Entity Types (7)
334
+ Person: 'person', // Individual human entities
335
+ Organization: 'organization', // Collective entities, companies, institutions
336
+ Location: 'location', // Geographic and named spatial entities
337
+ Thing: 'thing', // Discrete physical objects and artifacts
338
+ Concept: 'concept', // Abstract ideas, principles, and intangibles
339
+ Event: 'event', // Temporal occurrences and happenings
340
+ Agent: 'agent', // Non-human autonomous actors (AI agents, bots, automated systems)
341
+ // Biological Types (1)
342
+ Organism: 'organism', // Living biological entities (animals, plants, bacteria, fungi)
343
+ // Material Types (1)
344
+ Substance: 'substance', // Physical materials and matter (water, iron, chemicals, DNA)
345
+ // Property & Quality Types (1)
346
+ Quality: 'quality', // Properties and attributes that inhere in entities
347
+ // Temporal Types (1)
348
+ TimeInterval: 'timeInterval', // Temporal regions, periods, and durations
349
+ // Functional Types (1)
350
+ Function: 'function', // Purposes, capabilities, and functional roles
351
+ // Informational Types (1)
352
+ Proposition: 'proposition', // Statements, claims, assertions, and declarative content
353
+ // Digital/Content Types (4)
354
+ Document: 'document', // Text-based files and written content
355
+ Media: 'media', // Non-text media files (audio, video, images)
356
+ File: 'file', // Generic digital files and data blobs
357
+ Message: 'message', // Communication content and correspondence
358
+ // Collection Types (2)
359
+ Collection: 'collection', // Groups and sets of items
360
+ Dataset: 'dataset', // Structured data collections and databases
361
+ // Business/Application Types (4)
185
362
  Product: 'product', // Commercial products and offerings
186
- Service: 'service', // Services and offerings
187
- User: 'user', // User accounts and profiles
188
- Task: 'task', // Actions, todos, and workflow items
189
- Project: 'project', // Organized initiatives with goals and timelines
190
- // Descriptive Types
191
- Process: 'process', // Workflows, procedures, and sequences
192
- State: 'state', // States, conditions, or statuses
193
- Role: 'role', // Roles, positions, or responsibilities
194
- Topic: 'topic', // Subjects or themes
195
- Language: 'language', // Languages or linguistic entities
196
- Currency: 'currency', // Currencies and monetary units
197
- Measurement: 'measurement', // Measurements, metrics, or quantities
198
- // Scientific/Research Types (100% Coverage)
363
+ Service: 'service', // Service offerings and intangible products
364
+ Task: 'task', // Actions, todos, and work items
365
+ Project: 'project', // Organized initiatives and programs
366
+ // Descriptive Types (6)
367
+ Process: 'process', // Workflows, procedures, and ongoing activities
368
+ State: 'state', // Conditions, status, and situational contexts
369
+ Role: 'role', // Positions, responsibilities, and functional classifications
370
+ Language: 'language', // Natural and formal languages
371
+ Currency: 'currency', // Monetary units and exchange mediums
372
+ Measurement: 'measurement', // Metrics, quantities, and measured values
373
+ // Scientific/Research Types (2)
199
374
  Hypothesis: 'hypothesis', // Scientific theories, research hypotheses, propositions
200
375
  Experiment: 'experiment', // Controlled studies, trials, tests, research methodologies
201
- // Legal/Regulatory Types (100% Coverage)
376
+ // Legal/Regulatory Types (2)
202
377
  Contract: 'contract', // Legal agreements, terms, policies, binding documents
203
378
  Regulation: 'regulation', // Laws, rules, compliance requirements, standards
204
- // Technical Infrastructure Types (100% Coverage)
379
+ // Technical Infrastructure Types (2)
205
380
  Interface: 'interface', // APIs, protocols, contracts, specifications, endpoints
206
- Resource: 'resource' // Compute resources, bandwidth, storage, infrastructure assets
381
+ Resource: 'resource', // Compute resources, bandwidth, storage, infrastructure assets
382
+ // Custom/Extensible (1)
383
+ Custom: 'custom', // Domain-specific entities not covered by standard types
384
+ // Social Structures (3)
385
+ SocialGroup: 'socialGroup', // Informal social groups and collectives
386
+ Institution: 'institution', // Formal social structures and practices
387
+ Norm: 'norm', // Social norms, conventions, and expectations
388
+ // Information Theory (2)
389
+ InformationContent: 'informationContent', // Abstract information (stories, ideas, data schemas)
390
+ InformationBearer: 'informationBearer', // Physical or digital carrier of information
391
+ // Meta-Level (1)
392
+ Relationship: 'relationship' // Relationships as first-class entities for meta-level reasoning
207
393
  };
208
394
  /**
209
- * Defines valid verb types for relationships
395
+ * Defines valid verb types for relationships (Stage 3: 88 types)
210
396
  * Used for categorizing different types of connections
211
397
  */
212
398
  export const VerbType = {
213
- // Core Relationship Types
214
- RelatedTo: 'relatedTo', // Generic relationship (default fallback)
215
- Contains: 'contains', // Containment relationship (parent contains child)
216
- PartOf: 'partOf', // Part-whole relationship (child is part of parent)
217
- LocatedAt: 'locatedAt', // Spatial relationship
218
- References: 'references', // Reference or citation relationship
219
- // Temporal/Causal Types
220
- Precedes: 'precedes', // Temporal sequence (comes before)
221
- Succeeds: 'succeeds', // Temporal sequence (comes after)
222
- Causes: 'causes', // Causal relationship (merges Influences and Causes)
399
+ // Foundational Ontological (3)
400
+ InstanceOf: 'instanceOf', // Individual to class relationship (e.g., Fido instanceOf Dog)
401
+ SubclassOf: 'subclassOf', // Taxonomic hierarchy (e.g., Dog subclassOf Mammal)
402
+ ParticipatesIn: 'participatesIn', // Entity participation in events/processes
403
+ // Core Relationship Types (4)
404
+ RelatedTo: 'relatedTo', // Generic relationship (fallback for unspecified connections)
405
+ Contains: 'contains', // Containment relationship
406
+ PartOf: 'partOf', // Part-whole mereological relationship
407
+ References: 'references', // Citation and referential relationship
408
+ // Spatial Relationships (2)
409
+ LocatedAt: 'locatedAt', // Spatial location relationship
410
+ AdjacentTo: 'adjacentTo', // Spatial proximity relationship
411
+ // Temporal Relationships (3)
412
+ Precedes: 'precedes', // Temporal sequence (before)
413
+ During: 'during', // Temporal containment
414
+ OccursAt: 'occursAt', // Temporal location
415
+ // Causal & Dependency (5)
416
+ Causes: 'causes', // Direct causal relationship
417
+ Enables: 'enables', // Enablement without direct causation
418
+ Prevents: 'prevents', // Prevention relationship
223
419
  DependsOn: 'dependsOn', // Dependency relationship
224
- Requires: 'requires', // Necessity relationship (new)
225
- // Creation/Transformation Types
226
- Creates: 'creates', // Creation relationship (merges Created and Produces)
420
+ Requires: 'requires', // Necessity relationship
421
+ // Creation & Transformation (5)
422
+ Creates: 'creates', // Creation relationship
227
423
  Transforms: 'transforms', // Transformation relationship
228
424
  Becomes: 'becomes', // State change relationship
229
425
  Modifies: 'modifies', // Modification relationship
230
426
  Consumes: 'consumes', // Consumption relationship
231
- // Ownership/Attribution Types
232
- Owns: 'owns', // Ownership relationship (merges Controls and Owns)
233
- AttributedTo: 'attributedTo', // Attribution or authorship
234
- CreatedBy: 'createdBy', // Creation attribution (new, distinct from Creates)
235
- BelongsTo: 'belongsTo', // Belonging relationship (new)
236
- // Social/Organizational Types
237
- MemberOf: 'memberOf', // Membership or affiliation
238
- WorksWith: 'worksWith', // Professional relationship
427
+ // Lifecycle Operations (1)
428
+ Destroys: 'destroys', // Termination and destruction relationship
429
+ // Ownership & Attribution (2)
430
+ Owns: 'owns', // Ownership relationship
431
+ AttributedTo: 'attributedTo', // Attribution relationship
432
+ // Property & Quality (2)
433
+ HasQuality: 'hasQuality', // Entity to quality attribution
434
+ Realizes: 'realizes', // Function realization relationship
435
+ // Effects & Experience (1)
436
+ Affects: 'affects', // Patient/experiencer relationship (who/what experiences the action)
437
+ // Composition (2)
438
+ ComposedOf: 'composedOf', // Material composition (distinct from partOf)
439
+ Inherits: 'inherits', // Inheritance relationship
440
+ // Social & Organizational (7)
441
+ MemberOf: 'memberOf', // Membership relationship
442
+ WorksWith: 'worksWith', // Professional collaboration relationship
239
443
  FriendOf: 'friendOf', // Friendship relationship
240
- Follows: 'follows', // Following relationship
241
- Likes: 'likes', // Liking relationship
242
- ReportsTo: 'reportsTo', // Reporting relationship
243
- Supervises: 'supervises', // Supervisory relationship
444
+ Follows: 'follows', // Following/subscription relationship
445
+ Likes: 'likes', // Liking/favoriting relationship
446
+ ReportsTo: 'reportsTo', // Hierarchical reporting relationship
244
447
  Mentors: 'mentors', // Mentorship relationship
245
- Communicates: 'communicates', // Communication relationship (merges Communicates and Collaborates)
246
- // Descriptive/Functional Types
448
+ Communicates: 'communicates', // Communication relationship
449
+ // Descriptive & Functional (8)
247
450
  Describes: 'describes', // Descriptive relationship
248
451
  Defines: 'defines', // Definition relationship
249
452
  Categorizes: 'categorizes', // Categorization relationship
250
453
  Measures: 'measures', // Measurement relationship
251
- Evaluates: 'evaluates', // Evaluation or assessment relationship
252
- Uses: 'uses', // Utilization relationship (new)
454
+ Evaluates: 'evaluates', // Evaluation relationship
455
+ Uses: 'uses', // Utilization relationship
253
456
  Implements: 'implements', // Implementation relationship
254
- Extends: 'extends', // Extension relationship (enhancement, building upon)
255
- // Enhanced Relationships (100% Coverage)
256
- Inherits: 'inherits', // True inheritance relationship (class inheritance, legacy)
257
- Conflicts: 'conflicts', // Contradictions, incompatibilities, opposing forces
258
- Synchronizes: 'synchronizes', // Coordination, timing, synchronized operations
259
- Competes: 'competes' // Competition, rivalry, competing relationships
457
+ Extends: 'extends', // Extension relationship
458
+ // Advanced Relationships (5)
459
+ EquivalentTo: 'equivalentTo', // Equivalence/identity relationship
460
+ Believes: 'believes', // Epistemic relationship (cognitive state)
461
+ Conflicts: 'conflicts', // Conflict relationship
462
+ Synchronizes: 'synchronizes', // Synchronization relationship
463
+ Competes: 'competes', // Competition relationship
464
+ // Modal Relationships (6)
465
+ CanCause: 'canCause', // Potential causation (possibility)
466
+ MustCause: 'mustCause', // Necessary causation (necessity)
467
+ WouldCauseIf: 'wouldCauseIf', // Counterfactual causation
468
+ CouldBe: 'couldBe', // Possible states
469
+ MustBe: 'mustBe', // Necessary identity
470
+ Counterfactual: 'counterfactual', // General counterfactual relationship
471
+ // Epistemic States (8)
472
+ Knows: 'knows', // Knowledge (justified true belief)
473
+ Doubts: 'doubts', // Uncertainty/skepticism
474
+ Desires: 'desires', // Want/preference
475
+ Intends: 'intends', // Intentionality
476
+ Fears: 'fears', // Fear/anxiety
477
+ Loves: 'loves', // Strong positive emotional attitude
478
+ Hates: 'hates', // Strong negative emotional attitude
479
+ Hopes: 'hopes', // Hopeful expectation
480
+ Perceives: 'perceives', // Sensory perception
481
+ // Learning & Cognition (1)
482
+ Learns: 'learns', // Cognitive acquisition and learning process
483
+ // Uncertainty & Probability (4)
484
+ ProbablyCauses: 'probablyCauses', // Probabilistic causation
485
+ UncertainRelation: 'uncertainRelation', // Unknown relationship with confidence bounds
486
+ CorrelatesWith: 'correlatesWith', // Statistical correlation (not causation)
487
+ ApproximatelyEquals: 'approximatelyEquals', // Fuzzy equivalence
488
+ // Scalar Properties (5)
489
+ GreaterThan: 'greaterThan', // Scalar comparison
490
+ SimilarityDegree: 'similarityDegree', // Graded similarity
491
+ MoreXThan: 'moreXThan', // Comparative property
492
+ HasDegree: 'hasDegree', // Scalar property assignment
493
+ PartiallyHas: 'partiallyHas', // Graded possession
494
+ // Information Theory (2)
495
+ Carries: 'carries', // Bearer carries content
496
+ Encodes: 'encodes', // Encoding relationship
497
+ // Deontic Relationships (5)
498
+ ObligatedTo: 'obligatedTo', // Moral/legal obligation
499
+ PermittedTo: 'permittedTo', // Permission/authorization
500
+ ProhibitedFrom: 'prohibitedFrom', // Prohibition/forbidden
501
+ ShouldDo: 'shouldDo', // Normative expectation
502
+ MustNotDo: 'mustNotDo', // Strong prohibition
503
+ // Context & Perspective (5)
504
+ TrueInContext: 'trueInContext', // Context-dependent truth
505
+ PerceivedAs: 'perceivedAs', // Subjective perception
506
+ InterpretedAs: 'interpretedAs', // Interpretation relationship
507
+ ValidInFrame: 'validInFrame', // Frame-dependent validity
508
+ TrueFrom: 'trueFrom', // Perspective-dependent truth
509
+ // Advanced Temporal (6)
510
+ Overlaps: 'overlaps', // Partial temporal overlap
511
+ ImmediatelyAfter: 'immediatelyAfter', // Direct temporal succession
512
+ EventuallyLeadsTo: 'eventuallyLeadsTo', // Long-term consequence
513
+ SimultaneousWith: 'simultaneousWith', // Exact temporal alignment
514
+ HasDuration: 'hasDuration', // Temporal extent
515
+ RecurringWith: 'recurringWith', // Cyclic temporal relationship
516
+ // Advanced Spatial (9)
517
+ ContainsSpatially: 'containsSpatially', // Spatial containment (distinct from general contains)
518
+ OverlapsSpatially: 'overlapsSpatially', // Spatial overlap
519
+ Surrounds: 'surrounds', // Encirclement
520
+ ConnectedTo: 'connectedTo', // Topological connection
521
+ Above: 'above', // Vertical spatial relationship (superior position)
522
+ Below: 'below', // Vertical spatial relationship (inferior position)
523
+ Inside: 'inside', // Within containment boundaries
524
+ Outside: 'outside', // Beyond containment boundaries
525
+ Facing: 'facing', // Directional orientation
526
+ // Social Structures (5)
527
+ Represents: 'represents', // Representative relationship
528
+ Embodies: 'embodies', // Exemplification or personification
529
+ Opposes: 'opposes', // Opposition relationship
530
+ AlliesWith: 'alliesWith', // Alliance relationship
531
+ ConformsTo: 'conformsTo', // Norm conformity
532
+ // Measurement (4)
533
+ MeasuredIn: 'measuredIn', // Unit relationship
534
+ ConvertsTo: 'convertsTo', // Unit conversion
535
+ HasMagnitude: 'hasMagnitude', // Quantitative value
536
+ DimensionallyEquals: 'dimensionallyEquals', // Dimensional analysis
537
+ // Change & Persistence (4)
538
+ PersistsThrough: 'persistsThrough', // Persistence through change
539
+ GainsProperty: 'gainsProperty', // Property acquisition
540
+ LosesProperty: 'losesProperty', // Property loss
541
+ RemainsSame: 'remainsSame', // Identity through time
542
+ // Parthood Variations (4)
543
+ FunctionalPartOf: 'functionalPartOf', // Functional component
544
+ TopologicalPartOf: 'topologicalPartOf', // Spatial part
545
+ TemporalPartOf: 'temporalPartOf', // Temporal slice
546
+ ConceptualPartOf: 'conceptualPartOf', // Abstract decomposition
547
+ // Dependency Variations (3)
548
+ RigidlyDependsOn: 'rigidlyDependsOn', // Necessary dependency
549
+ FunctionallyDependsOn: 'functionallyDependsOn', // Operational dependency
550
+ HistoricallyDependsOn: 'historicallyDependsOn', // Causal history dependency
551
+ // Meta-Level (4)
552
+ Endorses: 'endorses', // Second-order validation
553
+ Contradicts: 'contradicts', // Logical contradiction
554
+ Supports: 'supports', // Evidential support
555
+ Supersedes: 'supersedes' // Replacement relationship
260
556
  };
261
557
  /**
262
- * Noun type enum for O(1) lookups and type safety
263
- * Maps each noun type to a unique index (0-30)
558
+ * Noun type enum for O(1) lookups and type safety (Stage 3 CANONICAL: 42 types)
559
+ * Maps each noun type to a unique index (0-41)
264
560
  * Used for fixed-size array operations and bitmap indices
265
561
  */
266
562
  export var NounTypeEnum;
@@ -271,88 +567,216 @@ export var NounTypeEnum;
271
567
  NounTypeEnum[NounTypeEnum["thing"] = 3] = "thing";
272
568
  NounTypeEnum[NounTypeEnum["concept"] = 4] = "concept";
273
569
  NounTypeEnum[NounTypeEnum["event"] = 5] = "event";
274
- NounTypeEnum[NounTypeEnum["document"] = 6] = "document";
275
- NounTypeEnum[NounTypeEnum["media"] = 7] = "media";
276
- NounTypeEnum[NounTypeEnum["file"] = 8] = "file";
277
- NounTypeEnum[NounTypeEnum["message"] = 9] = "message";
278
- NounTypeEnum[NounTypeEnum["content"] = 10] = "content";
279
- NounTypeEnum[NounTypeEnum["collection"] = 11] = "collection";
280
- NounTypeEnum[NounTypeEnum["dataset"] = 12] = "dataset";
281
- NounTypeEnum[NounTypeEnum["product"] = 13] = "product";
282
- NounTypeEnum[NounTypeEnum["service"] = 14] = "service";
283
- NounTypeEnum[NounTypeEnum["user"] = 15] = "user";
284
- NounTypeEnum[NounTypeEnum["task"] = 16] = "task";
285
- NounTypeEnum[NounTypeEnum["project"] = 17] = "project";
286
- NounTypeEnum[NounTypeEnum["process"] = 18] = "process";
287
- NounTypeEnum[NounTypeEnum["state"] = 19] = "state";
288
- NounTypeEnum[NounTypeEnum["role"] = 20] = "role";
289
- NounTypeEnum[NounTypeEnum["topic"] = 21] = "topic";
290
- NounTypeEnum[NounTypeEnum["language"] = 22] = "language";
291
- NounTypeEnum[NounTypeEnum["currency"] = 23] = "currency";
292
- NounTypeEnum[NounTypeEnum["measurement"] = 24] = "measurement";
293
- NounTypeEnum[NounTypeEnum["hypothesis"] = 25] = "hypothesis";
294
- NounTypeEnum[NounTypeEnum["experiment"] = 26] = "experiment";
295
- NounTypeEnum[NounTypeEnum["contract"] = 27] = "contract";
296
- NounTypeEnum[NounTypeEnum["regulation"] = 28] = "regulation";
297
- NounTypeEnum[NounTypeEnum["interface"] = 29] = "interface";
298
- NounTypeEnum[NounTypeEnum["resource"] = 30] = "resource";
570
+ NounTypeEnum[NounTypeEnum["agent"] = 6] = "agent";
571
+ NounTypeEnum[NounTypeEnum["organism"] = 7] = "organism";
572
+ NounTypeEnum[NounTypeEnum["substance"] = 8] = "substance";
573
+ NounTypeEnum[NounTypeEnum["quality"] = 9] = "quality";
574
+ NounTypeEnum[NounTypeEnum["timeInterval"] = 10] = "timeInterval";
575
+ NounTypeEnum[NounTypeEnum["function"] = 11] = "function";
576
+ NounTypeEnum[NounTypeEnum["proposition"] = 12] = "proposition";
577
+ NounTypeEnum[NounTypeEnum["document"] = 13] = "document";
578
+ NounTypeEnum[NounTypeEnum["media"] = 14] = "media";
579
+ NounTypeEnum[NounTypeEnum["file"] = 15] = "file";
580
+ NounTypeEnum[NounTypeEnum["message"] = 16] = "message";
581
+ NounTypeEnum[NounTypeEnum["collection"] = 17] = "collection";
582
+ NounTypeEnum[NounTypeEnum["dataset"] = 18] = "dataset";
583
+ NounTypeEnum[NounTypeEnum["product"] = 19] = "product";
584
+ NounTypeEnum[NounTypeEnum["service"] = 20] = "service";
585
+ NounTypeEnum[NounTypeEnum["task"] = 21] = "task";
586
+ NounTypeEnum[NounTypeEnum["project"] = 22] = "project";
587
+ NounTypeEnum[NounTypeEnum["process"] = 23] = "process";
588
+ NounTypeEnum[NounTypeEnum["state"] = 24] = "state";
589
+ NounTypeEnum[NounTypeEnum["role"] = 25] = "role";
590
+ NounTypeEnum[NounTypeEnum["language"] = 26] = "language";
591
+ NounTypeEnum[NounTypeEnum["currency"] = 27] = "currency";
592
+ NounTypeEnum[NounTypeEnum["measurement"] = 28] = "measurement";
593
+ NounTypeEnum[NounTypeEnum["hypothesis"] = 29] = "hypothesis";
594
+ NounTypeEnum[NounTypeEnum["experiment"] = 30] = "experiment";
595
+ NounTypeEnum[NounTypeEnum["contract"] = 31] = "contract";
596
+ NounTypeEnum[NounTypeEnum["regulation"] = 32] = "regulation";
597
+ NounTypeEnum[NounTypeEnum["interface"] = 33] = "interface";
598
+ NounTypeEnum[NounTypeEnum["resource"] = 34] = "resource";
599
+ NounTypeEnum[NounTypeEnum["custom"] = 35] = "custom";
600
+ NounTypeEnum[NounTypeEnum["socialGroup"] = 36] = "socialGroup";
601
+ NounTypeEnum[NounTypeEnum["institution"] = 37] = "institution";
602
+ NounTypeEnum[NounTypeEnum["norm"] = 38] = "norm";
603
+ NounTypeEnum[NounTypeEnum["informationContent"] = 39] = "informationContent";
604
+ NounTypeEnum[NounTypeEnum["informationBearer"] = 40] = "informationBearer";
605
+ NounTypeEnum[NounTypeEnum["relationship"] = 41] = "relationship";
299
606
  })(NounTypeEnum || (NounTypeEnum = {}));
300
607
  /**
301
- * Verb type enum for O(1) lookups and type safety
302
- * Maps each verb type to a unique index (0-39)
608
+ * Verb type enum for O(1) lookups and type safety (Stage 3 CANONICAL: 127 types)
609
+ * Maps each verb type to a unique index (0-126)
303
610
  * Used for fixed-size array operations and bitmap indices
304
611
  */
305
612
  export var VerbTypeEnum;
306
613
  (function (VerbTypeEnum) {
307
- VerbTypeEnum[VerbTypeEnum["relatedTo"] = 0] = "relatedTo";
308
- VerbTypeEnum[VerbTypeEnum["contains"] = 1] = "contains";
309
- VerbTypeEnum[VerbTypeEnum["partOf"] = 2] = "partOf";
310
- VerbTypeEnum[VerbTypeEnum["locatedAt"] = 3] = "locatedAt";
311
- VerbTypeEnum[VerbTypeEnum["references"] = 4] = "references";
312
- VerbTypeEnum[VerbTypeEnum["precedes"] = 5] = "precedes";
313
- VerbTypeEnum[VerbTypeEnum["succeeds"] = 6] = "succeeds";
314
- VerbTypeEnum[VerbTypeEnum["causes"] = 7] = "causes";
315
- VerbTypeEnum[VerbTypeEnum["dependsOn"] = 8] = "dependsOn";
316
- VerbTypeEnum[VerbTypeEnum["requires"] = 9] = "requires";
317
- VerbTypeEnum[VerbTypeEnum["creates"] = 10] = "creates";
318
- VerbTypeEnum[VerbTypeEnum["transforms"] = 11] = "transforms";
319
- VerbTypeEnum[VerbTypeEnum["becomes"] = 12] = "becomes";
320
- VerbTypeEnum[VerbTypeEnum["modifies"] = 13] = "modifies";
321
- VerbTypeEnum[VerbTypeEnum["consumes"] = 14] = "consumes";
322
- VerbTypeEnum[VerbTypeEnum["owns"] = 15] = "owns";
323
- VerbTypeEnum[VerbTypeEnum["attributedTo"] = 16] = "attributedTo";
324
- VerbTypeEnum[VerbTypeEnum["createdBy"] = 17] = "createdBy";
325
- VerbTypeEnum[VerbTypeEnum["belongsTo"] = 18] = "belongsTo";
326
- VerbTypeEnum[VerbTypeEnum["memberOf"] = 19] = "memberOf";
327
- VerbTypeEnum[VerbTypeEnum["worksWith"] = 20] = "worksWith";
328
- VerbTypeEnum[VerbTypeEnum["friendOf"] = 21] = "friendOf";
329
- VerbTypeEnum[VerbTypeEnum["follows"] = 22] = "follows";
330
- VerbTypeEnum[VerbTypeEnum["likes"] = 23] = "likes";
331
- VerbTypeEnum[VerbTypeEnum["reportsTo"] = 24] = "reportsTo";
332
- VerbTypeEnum[VerbTypeEnum["supervises"] = 25] = "supervises";
333
- VerbTypeEnum[VerbTypeEnum["mentors"] = 26] = "mentors";
334
- VerbTypeEnum[VerbTypeEnum["communicates"] = 27] = "communicates";
335
- VerbTypeEnum[VerbTypeEnum["describes"] = 28] = "describes";
336
- VerbTypeEnum[VerbTypeEnum["defines"] = 29] = "defines";
337
- VerbTypeEnum[VerbTypeEnum["categorizes"] = 30] = "categorizes";
338
- VerbTypeEnum[VerbTypeEnum["measures"] = 31] = "measures";
339
- VerbTypeEnum[VerbTypeEnum["evaluates"] = 32] = "evaluates";
340
- VerbTypeEnum[VerbTypeEnum["uses"] = 33] = "uses";
341
- VerbTypeEnum[VerbTypeEnum["implements"] = 34] = "implements";
342
- VerbTypeEnum[VerbTypeEnum["extends"] = 35] = "extends";
343
- VerbTypeEnum[VerbTypeEnum["inherits"] = 36] = "inherits";
344
- VerbTypeEnum[VerbTypeEnum["conflicts"] = 37] = "conflicts";
345
- VerbTypeEnum[VerbTypeEnum["synchronizes"] = 38] = "synchronizes";
346
- VerbTypeEnum[VerbTypeEnum["competes"] = 39] = "competes";
614
+ // Foundational Ontological (0-2)
615
+ VerbTypeEnum[VerbTypeEnum["instanceOf"] = 0] = "instanceOf";
616
+ VerbTypeEnum[VerbTypeEnum["subclassOf"] = 1] = "subclassOf";
617
+ VerbTypeEnum[VerbTypeEnum["participatesIn"] = 2] = "participatesIn";
618
+ // Core Relationships (3-6)
619
+ VerbTypeEnum[VerbTypeEnum["relatedTo"] = 3] = "relatedTo";
620
+ VerbTypeEnum[VerbTypeEnum["contains"] = 4] = "contains";
621
+ VerbTypeEnum[VerbTypeEnum["partOf"] = 5] = "partOf";
622
+ VerbTypeEnum[VerbTypeEnum["references"] = 6] = "references";
623
+ // Spatial (7-8)
624
+ VerbTypeEnum[VerbTypeEnum["locatedAt"] = 7] = "locatedAt";
625
+ VerbTypeEnum[VerbTypeEnum["adjacentTo"] = 8] = "adjacentTo";
626
+ // Temporal (9-11)
627
+ VerbTypeEnum[VerbTypeEnum["precedes"] = 9] = "precedes";
628
+ VerbTypeEnum[VerbTypeEnum["during"] = 10] = "during";
629
+ VerbTypeEnum[VerbTypeEnum["occursAt"] = 11] = "occursAt";
630
+ // Causal & Dependency (12-16)
631
+ VerbTypeEnum[VerbTypeEnum["causes"] = 12] = "causes";
632
+ VerbTypeEnum[VerbTypeEnum["enables"] = 13] = "enables";
633
+ VerbTypeEnum[VerbTypeEnum["prevents"] = 14] = "prevents";
634
+ VerbTypeEnum[VerbTypeEnum["dependsOn"] = 15] = "dependsOn";
635
+ VerbTypeEnum[VerbTypeEnum["requires"] = 16] = "requires";
636
+ // Creation & Transformation (17-21)
637
+ VerbTypeEnum[VerbTypeEnum["creates"] = 17] = "creates";
638
+ VerbTypeEnum[VerbTypeEnum["transforms"] = 18] = "transforms";
639
+ VerbTypeEnum[VerbTypeEnum["becomes"] = 19] = "becomes";
640
+ VerbTypeEnum[VerbTypeEnum["modifies"] = 20] = "modifies";
641
+ VerbTypeEnum[VerbTypeEnum["consumes"] = 21] = "consumes";
642
+ // Lifecycle Operations (22) - Stage 3
643
+ VerbTypeEnum[VerbTypeEnum["destroys"] = 22] = "destroys";
644
+ // Ownership & Attribution (23-24)
645
+ VerbTypeEnum[VerbTypeEnum["owns"] = 23] = "owns";
646
+ VerbTypeEnum[VerbTypeEnum["attributedTo"] = 24] = "attributedTo";
647
+ // Property & Quality (25-26)
648
+ VerbTypeEnum[VerbTypeEnum["hasQuality"] = 25] = "hasQuality";
649
+ VerbTypeEnum[VerbTypeEnum["realizes"] = 26] = "realizes";
650
+ // Effects & Experience (27) - Stage 3
651
+ VerbTypeEnum[VerbTypeEnum["affects"] = 27] = "affects";
652
+ // Composition (28-29)
653
+ VerbTypeEnum[VerbTypeEnum["composedOf"] = 28] = "composedOf";
654
+ VerbTypeEnum[VerbTypeEnum["inherits"] = 29] = "inherits";
655
+ // Social & Organizational (30-37)
656
+ VerbTypeEnum[VerbTypeEnum["memberOf"] = 30] = "memberOf";
657
+ VerbTypeEnum[VerbTypeEnum["worksWith"] = 31] = "worksWith";
658
+ VerbTypeEnum[VerbTypeEnum["friendOf"] = 32] = "friendOf";
659
+ VerbTypeEnum[VerbTypeEnum["follows"] = 33] = "follows";
660
+ VerbTypeEnum[VerbTypeEnum["likes"] = 34] = "likes";
661
+ VerbTypeEnum[VerbTypeEnum["reportsTo"] = 35] = "reportsTo";
662
+ VerbTypeEnum[VerbTypeEnum["mentors"] = 36] = "mentors";
663
+ VerbTypeEnum[VerbTypeEnum["communicates"] = 37] = "communicates";
664
+ // Descriptive & Functional (38-45)
665
+ VerbTypeEnum[VerbTypeEnum["describes"] = 38] = "describes";
666
+ VerbTypeEnum[VerbTypeEnum["defines"] = 39] = "defines";
667
+ VerbTypeEnum[VerbTypeEnum["categorizes"] = 40] = "categorizes";
668
+ VerbTypeEnum[VerbTypeEnum["measures"] = 41] = "measures";
669
+ VerbTypeEnum[VerbTypeEnum["evaluates"] = 42] = "evaluates";
670
+ VerbTypeEnum[VerbTypeEnum["uses"] = 43] = "uses";
671
+ VerbTypeEnum[VerbTypeEnum["implements"] = 44] = "implements";
672
+ VerbTypeEnum[VerbTypeEnum["extends"] = 45] = "extends";
673
+ // Advanced Relationships (46-50)
674
+ VerbTypeEnum[VerbTypeEnum["equivalentTo"] = 46] = "equivalentTo";
675
+ VerbTypeEnum[VerbTypeEnum["believes"] = 47] = "believes";
676
+ VerbTypeEnum[VerbTypeEnum["conflicts"] = 48] = "conflicts";
677
+ VerbTypeEnum[VerbTypeEnum["synchronizes"] = 49] = "synchronizes";
678
+ VerbTypeEnum[VerbTypeEnum["competes"] = 50] = "competes";
679
+ // Modal (51-56)
680
+ VerbTypeEnum[VerbTypeEnum["canCause"] = 51] = "canCause";
681
+ VerbTypeEnum[VerbTypeEnum["mustCause"] = 52] = "mustCause";
682
+ VerbTypeEnum[VerbTypeEnum["wouldCauseIf"] = 53] = "wouldCauseIf";
683
+ VerbTypeEnum[VerbTypeEnum["couldBe"] = 54] = "couldBe";
684
+ VerbTypeEnum[VerbTypeEnum["mustBe"] = 55] = "mustBe";
685
+ VerbTypeEnum[VerbTypeEnum["counterfactual"] = 56] = "counterfactual";
686
+ // Epistemic (57-65)
687
+ VerbTypeEnum[VerbTypeEnum["knows"] = 57] = "knows";
688
+ VerbTypeEnum[VerbTypeEnum["doubts"] = 58] = "doubts";
689
+ VerbTypeEnum[VerbTypeEnum["desires"] = 59] = "desires";
690
+ VerbTypeEnum[VerbTypeEnum["intends"] = 60] = "intends";
691
+ VerbTypeEnum[VerbTypeEnum["fears"] = 61] = "fears";
692
+ VerbTypeEnum[VerbTypeEnum["loves"] = 62] = "loves";
693
+ VerbTypeEnum[VerbTypeEnum["hates"] = 63] = "hates";
694
+ VerbTypeEnum[VerbTypeEnum["hopes"] = 64] = "hopes";
695
+ VerbTypeEnum[VerbTypeEnum["perceives"] = 65] = "perceives";
696
+ // Learning & Cognition (66) - Stage 3
697
+ VerbTypeEnum[VerbTypeEnum["learns"] = 66] = "learns";
698
+ // Uncertainty & Probability (67-70)
699
+ VerbTypeEnum[VerbTypeEnum["probablyCauses"] = 67] = "probablyCauses";
700
+ VerbTypeEnum[VerbTypeEnum["uncertainRelation"] = 68] = "uncertainRelation";
701
+ VerbTypeEnum[VerbTypeEnum["correlatesWith"] = 69] = "correlatesWith";
702
+ VerbTypeEnum[VerbTypeEnum["approximatelyEquals"] = 70] = "approximatelyEquals";
703
+ // Scalar (71-75)
704
+ VerbTypeEnum[VerbTypeEnum["greaterThan"] = 71] = "greaterThan";
705
+ VerbTypeEnum[VerbTypeEnum["similarityDegree"] = 72] = "similarityDegree";
706
+ VerbTypeEnum[VerbTypeEnum["moreXThan"] = 73] = "moreXThan";
707
+ VerbTypeEnum[VerbTypeEnum["hasDegree"] = 74] = "hasDegree";
708
+ VerbTypeEnum[VerbTypeEnum["partiallyHas"] = 75] = "partiallyHas";
709
+ // Information Theory (76-77)
710
+ VerbTypeEnum[VerbTypeEnum["carries"] = 76] = "carries";
711
+ VerbTypeEnum[VerbTypeEnum["encodes"] = 77] = "encodes";
712
+ // Deontic (78-82)
713
+ VerbTypeEnum[VerbTypeEnum["obligatedTo"] = 78] = "obligatedTo";
714
+ VerbTypeEnum[VerbTypeEnum["permittedTo"] = 79] = "permittedTo";
715
+ VerbTypeEnum[VerbTypeEnum["prohibitedFrom"] = 80] = "prohibitedFrom";
716
+ VerbTypeEnum[VerbTypeEnum["shouldDo"] = 81] = "shouldDo";
717
+ VerbTypeEnum[VerbTypeEnum["mustNotDo"] = 82] = "mustNotDo";
718
+ // Context & Perspective (83-87)
719
+ VerbTypeEnum[VerbTypeEnum["trueInContext"] = 83] = "trueInContext";
720
+ VerbTypeEnum[VerbTypeEnum["perceivedAs"] = 84] = "perceivedAs";
721
+ VerbTypeEnum[VerbTypeEnum["interpretedAs"] = 85] = "interpretedAs";
722
+ VerbTypeEnum[VerbTypeEnum["validInFrame"] = 86] = "validInFrame";
723
+ VerbTypeEnum[VerbTypeEnum["trueFrom"] = 87] = "trueFrom";
724
+ // Advanced Temporal (88-93)
725
+ VerbTypeEnum[VerbTypeEnum["overlaps"] = 88] = "overlaps";
726
+ VerbTypeEnum[VerbTypeEnum["immediatelyAfter"] = 89] = "immediatelyAfter";
727
+ VerbTypeEnum[VerbTypeEnum["eventuallyLeadsTo"] = 90] = "eventuallyLeadsTo";
728
+ VerbTypeEnum[VerbTypeEnum["simultaneousWith"] = 91] = "simultaneousWith";
729
+ VerbTypeEnum[VerbTypeEnum["hasDuration"] = 92] = "hasDuration";
730
+ VerbTypeEnum[VerbTypeEnum["recurringWith"] = 93] = "recurringWith";
731
+ // Advanced Spatial (94-102)
732
+ VerbTypeEnum[VerbTypeEnum["containsSpatially"] = 94] = "containsSpatially";
733
+ VerbTypeEnum[VerbTypeEnum["overlapsSpatially"] = 95] = "overlapsSpatially";
734
+ VerbTypeEnum[VerbTypeEnum["surrounds"] = 96] = "surrounds";
735
+ VerbTypeEnum[VerbTypeEnum["connectedTo"] = 97] = "connectedTo";
736
+ VerbTypeEnum[VerbTypeEnum["above"] = 98] = "above";
737
+ VerbTypeEnum[VerbTypeEnum["below"] = 99] = "below";
738
+ VerbTypeEnum[VerbTypeEnum["inside"] = 100] = "inside";
739
+ VerbTypeEnum[VerbTypeEnum["outside"] = 101] = "outside";
740
+ VerbTypeEnum[VerbTypeEnum["facing"] = 102] = "facing";
741
+ // Social Structures (103-107)
742
+ VerbTypeEnum[VerbTypeEnum["represents"] = 103] = "represents";
743
+ VerbTypeEnum[VerbTypeEnum["embodies"] = 104] = "embodies";
744
+ VerbTypeEnum[VerbTypeEnum["opposes"] = 105] = "opposes";
745
+ VerbTypeEnum[VerbTypeEnum["alliesWith"] = 106] = "alliesWith";
746
+ VerbTypeEnum[VerbTypeEnum["conformsTo"] = 107] = "conformsTo";
747
+ // Measurement (108-111)
748
+ VerbTypeEnum[VerbTypeEnum["measuredIn"] = 108] = "measuredIn";
749
+ VerbTypeEnum[VerbTypeEnum["convertsTo"] = 109] = "convertsTo";
750
+ VerbTypeEnum[VerbTypeEnum["hasMagnitude"] = 110] = "hasMagnitude";
751
+ VerbTypeEnum[VerbTypeEnum["dimensionallyEquals"] = 111] = "dimensionallyEquals";
752
+ // Change & Persistence (112-115)
753
+ VerbTypeEnum[VerbTypeEnum["persistsThrough"] = 112] = "persistsThrough";
754
+ VerbTypeEnum[VerbTypeEnum["gainsProperty"] = 113] = "gainsProperty";
755
+ VerbTypeEnum[VerbTypeEnum["losesProperty"] = 114] = "losesProperty";
756
+ VerbTypeEnum[VerbTypeEnum["remainsSame"] = 115] = "remainsSame";
757
+ // Parthood Variations (116-119)
758
+ VerbTypeEnum[VerbTypeEnum["functionalPartOf"] = 116] = "functionalPartOf";
759
+ VerbTypeEnum[VerbTypeEnum["topologicalPartOf"] = 117] = "topologicalPartOf";
760
+ VerbTypeEnum[VerbTypeEnum["temporalPartOf"] = 118] = "temporalPartOf";
761
+ VerbTypeEnum[VerbTypeEnum["conceptualPartOf"] = 119] = "conceptualPartOf";
762
+ // Dependency Variations (120-122)
763
+ VerbTypeEnum[VerbTypeEnum["rigidlyDependsOn"] = 120] = "rigidlyDependsOn";
764
+ VerbTypeEnum[VerbTypeEnum["functionallyDependsOn"] = 121] = "functionallyDependsOn";
765
+ VerbTypeEnum[VerbTypeEnum["historicallyDependsOn"] = 122] = "historicallyDependsOn";
766
+ // Meta-Level (123-126)
767
+ VerbTypeEnum[VerbTypeEnum["endorses"] = 123] = "endorses";
768
+ VerbTypeEnum[VerbTypeEnum["contradicts"] = 124] = "contradicts";
769
+ VerbTypeEnum[VerbTypeEnum["supports"] = 125] = "supports";
770
+ VerbTypeEnum[VerbTypeEnum["supersedes"] = 126] = "supersedes";
347
771
  })(VerbTypeEnum || (VerbTypeEnum = {}));
348
772
  /**
349
- * Total number of noun types (for array allocations)
773
+ * Total number of noun types (for array allocations) - Stage 3 CANONICAL
350
774
  */
351
- export const NOUN_TYPE_COUNT = 31;
775
+ export const NOUN_TYPE_COUNT = 42; // Stage 3: 42 noun types (indices 0-41)
352
776
  /**
353
- * Total number of verb types (for array allocations)
777
+ * Total number of verb types (for array allocations) - Stage 3 CANONICAL
354
778
  */
355
- export const VERB_TYPE_COUNT = 40;
779
+ export const VERB_TYPE_COUNT = 127; // Stage 3: 127 verb types (indices 0-126)
356
780
  /**
357
781
  * Type utilities for O(1) conversions between string types and numeric indices
358
782
  * Enables efficient fixed-size array operations and bitmap indexing
@@ -361,7 +785,7 @@ export const TypeUtils = {
361
785
  /**
362
786
  * Get numeric index for a noun type
363
787
  * @param type - NounType string (e.g., 'person')
364
- * @returns Numeric index (0-30)
788
+ * @returns Numeric index (0-40)
365
789
  */
366
790
  getNounIndex: (type) => {
367
791
  return NounTypeEnum[type];
@@ -369,14 +793,14 @@ export const TypeUtils = {
369
793
  /**
370
794
  * Get numeric index for a verb type
371
795
  * @param type - VerbType string (e.g., 'relatedTo')
372
- * @returns Numeric index (0-39)
796
+ * @returns Numeric index (0-123)
373
797
  */
374
798
  getVerbIndex: (type) => {
375
799
  return VerbTypeEnum[type];
376
800
  },
377
801
  /**
378
802
  * Get noun type string from numeric index
379
- * @param index - Numeric index (0-30)
803
+ * @param index - Numeric index (0-40)
380
804
  * @returns NounType string or 'thing' as default
381
805
  */
382
806
  getNounFromIndex: (index) => {
@@ -385,7 +809,7 @@ export const TypeUtils = {
385
809
  },
386
810
  /**
387
811
  * Get verb type string from numeric index
388
- * @param index - Numeric index (0-39)
812
+ * @param index - Numeric index (0-123)
389
813
  * @returns VerbType string or 'relatedTo' as default
390
814
  */
391
815
  getVerbFromIndex: (index) => {
@@ -394,7 +818,7 @@ export const TypeUtils = {
394
818
  }
395
819
  };
396
820
  /**
397
- * Type-specific metadata for optimization hints
821
+ * Type-specific metadata for optimization hints (Stage 3 CANONICAL: 42 noun types)
398
822
  * Provides per-type configuration for bloom filters, chunking, and indexing
399
823
  */
400
824
  export const TypeMetadata = {
@@ -405,21 +829,25 @@ export const TypeMetadata = {
405
829
  location: { expectedFields: 7, bloomBits: 128, avgChunkSize: 60 },
406
830
  thing: { expectedFields: 5, bloomBits: 128, avgChunkSize: 50 },
407
831
  concept: { expectedFields: 4, bloomBits: 128, avgChunkSize: 40 },
832
+ agent: { expectedFields: 7, bloomBits: 128, avgChunkSize: 60 },
833
+ organism: { expectedFields: 6, bloomBits: 128, avgChunkSize: 50 },
834
+ substance: { expectedFields: 4, bloomBits: 128, avgChunkSize: 40 },
835
+ quality: { expectedFields: 3, bloomBits: 128, avgChunkSize: 30 },
836
+ timeInterval: { expectedFields: 4, bloomBits: 128, avgChunkSize: 40 },
837
+ function: { expectedFields: 4, bloomBits: 128, avgChunkSize: 40 },
838
+ proposition: { expectedFields: 5, bloomBits: 128, avgChunkSize: 50 },
408
839
  media: { expectedFields: 6, bloomBits: 128, avgChunkSize: 50 },
409
840
  file: { expectedFields: 5, bloomBits: 128, avgChunkSize: 50 },
410
841
  message: { expectedFields: 7, bloomBits: 128, avgChunkSize: 60 },
411
- content: { expectedFields: 5, bloomBits: 128, avgChunkSize: 50 },
412
842
  collection: { expectedFields: 4, bloomBits: 128, avgChunkSize: 40 },
413
843
  dataset: { expectedFields: 6, bloomBits: 128, avgChunkSize: 50 },
414
844
  product: { expectedFields: 8, bloomBits: 256, avgChunkSize: 70 },
415
845
  service: { expectedFields: 7, bloomBits: 128, avgChunkSize: 60 },
416
- user: { expectedFields: 9, bloomBits: 256, avgChunkSize: 80 },
417
846
  task: { expectedFields: 6, bloomBits: 128, avgChunkSize: 50 },
418
847
  project: { expectedFields: 8, bloomBits: 256, avgChunkSize: 70 },
419
848
  process: { expectedFields: 5, bloomBits: 128, avgChunkSize: 50 },
420
849
  state: { expectedFields: 3, bloomBits: 128, avgChunkSize: 30 },
421
850
  role: { expectedFields: 4, bloomBits: 128, avgChunkSize: 40 },
422
- topic: { expectedFields: 4, bloomBits: 128, avgChunkSize: 40 },
423
851
  language: { expectedFields: 3, bloomBits: 128, avgChunkSize: 30 },
424
852
  currency: { expectedFields: 3, bloomBits: 128, avgChunkSize: 30 },
425
853
  measurement: { expectedFields: 4, bloomBits: 128, avgChunkSize: 40 },
@@ -428,6 +856,13 @@ export const TypeMetadata = {
428
856
  contract: { expectedFields: 8, bloomBits: 256, avgChunkSize: 70 },
429
857
  regulation: { expectedFields: 6, bloomBits: 128, avgChunkSize: 50 },
430
858
  interface: { expectedFields: 5, bloomBits: 128, avgChunkSize: 50 },
431
- resource: { expectedFields: 5, bloomBits: 128, avgChunkSize: 50 }
859
+ resource: { expectedFields: 5, bloomBits: 128, avgChunkSize: 50 },
860
+ custom: { expectedFields: 5, bloomBits: 128, avgChunkSize: 50 },
861
+ socialGroup: { expectedFields: 6, bloomBits: 128, avgChunkSize: 50 },
862
+ institution: { expectedFields: 8, bloomBits: 256, avgChunkSize: 70 },
863
+ norm: { expectedFields: 4, bloomBits: 128, avgChunkSize: 40 },
864
+ informationContent: { expectedFields: 5, bloomBits: 128, avgChunkSize: 50 },
865
+ informationBearer: { expectedFields: 6, bloomBits: 128, avgChunkSize: 50 },
866
+ relationship: { expectedFields: 6, bloomBits: 128, avgChunkSize: 50 }
432
867
  };
433
868
  //# sourceMappingURL=graphTypes.js.map