@know-graph/core 0.4.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 (163) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +47 -0
  3. package/dist/connectors/cache.d.ts +25 -0
  4. package/dist/connectors/cache.d.ts.map +1 -0
  5. package/dist/connectors/cache.js +73 -0
  6. package/dist/connectors/cache.js.map +1 -0
  7. package/dist/connectors/index.d.ts +12 -0
  8. package/dist/connectors/index.d.ts.map +1 -0
  9. package/dist/connectors/index.js +7 -0
  10. package/dist/connectors/index.js.map +1 -0
  11. package/dist/connectors/jira-connector.d.ts +26 -0
  12. package/dist/connectors/jira-connector.d.ts.map +1 -0
  13. package/dist/connectors/jira-connector.js +234 -0
  14. package/dist/connectors/jira-connector.js.map +1 -0
  15. package/dist/connectors/notion-connector.d.ts +24 -0
  16. package/dist/connectors/notion-connector.d.ts.map +1 -0
  17. package/dist/connectors/notion-connector.js +246 -0
  18. package/dist/connectors/notion-connector.js.map +1 -0
  19. package/dist/connectors/rate-limiter.d.ts +23 -0
  20. package/dist/connectors/rate-limiter.d.ts.map +1 -0
  21. package/dist/connectors/rate-limiter.js +54 -0
  22. package/dist/connectors/rate-limiter.js.map +1 -0
  23. package/dist/connectors/registry.d.ts +15 -0
  24. package/dist/connectors/registry.d.ts.map +1 -0
  25. package/dist/connectors/registry.js +72 -0
  26. package/dist/connectors/registry.js.map +1 -0
  27. package/dist/connectors/types.d.ts +142 -0
  28. package/dist/connectors/types.d.ts.map +1 -0
  29. package/dist/connectors/types.js +35 -0
  30. package/dist/connectors/types.js.map +1 -0
  31. package/dist/coverage/__tests__/fixtures/mixed-project/annotated.d.ts +9 -0
  32. package/dist/coverage/__tests__/fixtures/mixed-project/annotated.d.ts.map +1 -0
  33. package/dist/coverage/__tests__/fixtures/mixed-project/annotated.js +11 -0
  34. package/dist/coverage/__tests__/fixtures/mixed-project/annotated.js.map +1 -0
  35. package/dist/coverage/__tests__/fixtures/mixed-project/unannotated.d.ts +2 -0
  36. package/dist/coverage/__tests__/fixtures/mixed-project/unannotated.d.ts.map +1 -0
  37. package/dist/coverage/__tests__/fixtures/mixed-project/unannotated.js +4 -0
  38. package/dist/coverage/__tests__/fixtures/mixed-project/unannotated.js.map +1 -0
  39. package/dist/coverage/coverage-calculator.d.ts +3 -0
  40. package/dist/coverage/coverage-calculator.d.ts.map +1 -0
  41. package/dist/coverage/coverage-calculator.js +204 -0
  42. package/dist/coverage/coverage-calculator.js.map +1 -0
  43. package/dist/coverage/index.d.ts +3 -0
  44. package/dist/coverage/index.d.ts.map +1 -0
  45. package/dist/coverage/index.js +2 -0
  46. package/dist/coverage/index.js.map +1 -0
  47. package/dist/coverage/types.d.ts +38 -0
  48. package/dist/coverage/types.d.ts.map +1 -0
  49. package/dist/coverage/types.js +13 -0
  50. package/dist/coverage/types.js.map +1 -0
  51. package/dist/index.d.ts +17 -0
  52. package/dist/index.d.ts.map +1 -0
  53. package/dist/index.js +16 -0
  54. package/dist/index.js.map +1 -0
  55. package/dist/indexer/database.d.ts +32 -0
  56. package/dist/indexer/database.d.ts.map +1 -0
  57. package/dist/indexer/database.js +242 -0
  58. package/dist/indexer/database.js.map +1 -0
  59. package/dist/indexer/index.d.ts +7 -0
  60. package/dist/indexer/index.d.ts.map +1 -0
  61. package/dist/indexer/index.js +4 -0
  62. package/dist/indexer/index.js.map +1 -0
  63. package/dist/indexer/indexer.d.ts +12 -0
  64. package/dist/indexer/indexer.d.ts.map +1 -0
  65. package/dist/indexer/indexer.js +145 -0
  66. package/dist/indexer/indexer.js.map +1 -0
  67. package/dist/indexer/schema.d.ts +21 -0
  68. package/dist/indexer/schema.d.ts.map +1 -0
  69. package/dist/indexer/schema.js +122 -0
  70. package/dist/indexer/schema.js.map +1 -0
  71. package/dist/indexer/types.d.ts +85 -0
  72. package/dist/indexer/types.d.ts.map +1 -0
  73. package/dist/indexer/types.js +2 -0
  74. package/dist/indexer/types.js.map +1 -0
  75. package/dist/parsers/generic-parser.d.ts +3 -0
  76. package/dist/parsers/generic-parser.d.ts.map +1 -0
  77. package/dist/parsers/generic-parser.js +150 -0
  78. package/dist/parsers/generic-parser.js.map +1 -0
  79. package/dist/parsers/go-parser.d.ts +3 -0
  80. package/dist/parsers/go-parser.d.ts.map +1 -0
  81. package/dist/parsers/go-parser.js +437 -0
  82. package/dist/parsers/go-parser.js.map +1 -0
  83. package/dist/parsers/index.d.ts +10 -0
  84. package/dist/parsers/index.d.ts.map +1 -0
  85. package/dist/parsers/index.js +8 -0
  86. package/dist/parsers/index.js.map +1 -0
  87. package/dist/parsers/java-parser.d.ts +3 -0
  88. package/dist/parsers/java-parser.d.ts.map +1 -0
  89. package/dist/parsers/java-parser.js +321 -0
  90. package/dist/parsers/java-parser.js.map +1 -0
  91. package/dist/parsers/metadata-extractor.d.ts +25 -0
  92. package/dist/parsers/metadata-extractor.d.ts.map +1 -0
  93. package/dist/parsers/metadata-extractor.js +137 -0
  94. package/dist/parsers/metadata-extractor.js.map +1 -0
  95. package/dist/parsers/python-parser.d.ts +3 -0
  96. package/dist/parsers/python-parser.d.ts.map +1 -0
  97. package/dist/parsers/python-parser.js +226 -0
  98. package/dist/parsers/python-parser.js.map +1 -0
  99. package/dist/parsers/registry.d.ts +3 -0
  100. package/dist/parsers/registry.d.ts.map +1 -0
  101. package/dist/parsers/registry.js +41 -0
  102. package/dist/parsers/registry.js.map +1 -0
  103. package/dist/parsers/types.d.ts +23 -0
  104. package/dist/parsers/types.d.ts.map +1 -0
  105. package/dist/parsers/types.js +2 -0
  106. package/dist/parsers/types.js.map +1 -0
  107. package/dist/parsers/typescript-parser.d.ts +3 -0
  108. package/dist/parsers/typescript-parser.d.ts.map +1 -0
  109. package/dist/parsers/typescript-parser.js +321 -0
  110. package/dist/parsers/typescript-parser.js.map +1 -0
  111. package/dist/query/index.d.ts +3 -0
  112. package/dist/query/index.d.ts.map +1 -0
  113. package/dist/query/index.js +2 -0
  114. package/dist/query/index.js.map +1 -0
  115. package/dist/query/query-engine.d.ts +40 -0
  116. package/dist/query/query-engine.d.ts.map +1 -0
  117. package/dist/query/query-engine.js +126 -0
  118. package/dist/query/query-engine.js.map +1 -0
  119. package/dist/suggest/index.d.ts +3 -0
  120. package/dist/suggest/index.d.ts.map +1 -0
  121. package/dist/suggest/index.js +2 -0
  122. package/dist/suggest/index.js.map +1 -0
  123. package/dist/suggest/suggestion-engine.d.ts +7 -0
  124. package/dist/suggest/suggestion-engine.d.ts.map +1 -0
  125. package/dist/suggest/suggestion-engine.js +239 -0
  126. package/dist/suggest/suggestion-engine.js.map +1 -0
  127. package/dist/suggest/types.d.ts +29 -0
  128. package/dist/suggest/types.d.ts.map +1 -0
  129. package/dist/suggest/types.js +13 -0
  130. package/dist/suggest/types.js.map +1 -0
  131. package/dist/types/entity.d.ts +336 -0
  132. package/dist/types/entity.d.ts.map +1 -0
  133. package/dist/types/entity.js +99 -0
  134. package/dist/types/entity.js.map +1 -0
  135. package/dist/types/index.d.ts +6 -0
  136. package/dist/types/index.d.ts.map +1 -0
  137. package/dist/types/index.js +3 -0
  138. package/dist/types/index.js.map +1 -0
  139. package/dist/types/manifest.d.ts +488 -0
  140. package/dist/types/manifest.d.ts.map +1 -0
  141. package/dist/types/manifest.js +66 -0
  142. package/dist/types/manifest.js.map +1 -0
  143. package/dist/types/parse-result.d.ts +25 -0
  144. package/dist/types/parse-result.d.ts.map +1 -0
  145. package/dist/types/parse-result.js +2 -0
  146. package/dist/types/parse-result.js.map +1 -0
  147. package/dist/validation/index.d.ts +5 -0
  148. package/dist/validation/index.d.ts.map +1 -0
  149. package/dist/validation/index.js +3 -0
  150. package/dist/validation/index.js.map +1 -0
  151. package/dist/validation/rules.d.ts +9 -0
  152. package/dist/validation/rules.d.ts.map +1 -0
  153. package/dist/validation/rules.js +119 -0
  154. package/dist/validation/rules.js.map +1 -0
  155. package/dist/validation/types.d.ts +34 -0
  156. package/dist/validation/types.d.ts.map +1 -0
  157. package/dist/validation/types.js +2 -0
  158. package/dist/validation/types.js.map +1 -0
  159. package/dist/validation/validator.d.ts +10 -0
  160. package/dist/validation/validator.d.ts.map +1 -0
  161. package/dist/validation/validator.js +111 -0
  162. package/dist/validation/validator.js.map +1 -0
  163. package/package.json +58 -0
@@ -0,0 +1,336 @@
1
+ /**
2
+ * @knowgraph
3
+ * type: module
4
+ * description: Zod schemas and TypeScript types for code entities, metadata, and validation
5
+ * owner: knowgraph-core
6
+ * status: stable
7
+ * tags: [schema, validation, zod, types]
8
+ * context:
9
+ * business_goal: Provide type-safe entity definitions for the entire KnowGraph system
10
+ * domain: core-types
11
+ */
12
+ import { z } from 'zod';
13
+ export declare const EntityTypeSchema: z.ZodEnum<["module", "class", "function", "method", "service", "api_endpoint", "variable", "constant", "interface", "enum"]>;
14
+ export declare const StatusSchema: z.ZodEnum<["experimental", "stable", "deprecated"]>;
15
+ export declare const LinkTypeSchema: z.ZodEnum<["notion", "jira", "linear", "confluence", "github", "custom"]>;
16
+ export declare const LinkSchema: z.ZodObject<{
17
+ type: z.ZodOptional<z.ZodEnum<["notion", "jira", "linear", "confluence", "github", "custom"]>>;
18
+ url: z.ZodString;
19
+ title: z.ZodOptional<z.ZodString>;
20
+ }, "strip", z.ZodTypeAny, {
21
+ url: string;
22
+ type?: "notion" | "jira" | "linear" | "confluence" | "github" | "custom" | undefined;
23
+ title?: string | undefined;
24
+ }, {
25
+ url: string;
26
+ type?: "notion" | "jira" | "linear" | "confluence" | "github" | "custom" | undefined;
27
+ title?: string | undefined;
28
+ }>;
29
+ export declare const CoreMetadataSchema: z.ZodObject<{
30
+ type: z.ZodEnum<["module", "class", "function", "method", "service", "api_endpoint", "variable", "constant", "interface", "enum"]>;
31
+ description: z.ZodString;
32
+ owner: z.ZodOptional<z.ZodString>;
33
+ status: z.ZodOptional<z.ZodEnum<["experimental", "stable", "deprecated"]>>;
34
+ tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
35
+ links: z.ZodOptional<z.ZodArray<z.ZodObject<{
36
+ type: z.ZodOptional<z.ZodEnum<["notion", "jira", "linear", "confluence", "github", "custom"]>>;
37
+ url: z.ZodString;
38
+ title: z.ZodOptional<z.ZodString>;
39
+ }, "strip", z.ZodTypeAny, {
40
+ url: string;
41
+ type?: "notion" | "jira" | "linear" | "confluence" | "github" | "custom" | undefined;
42
+ title?: string | undefined;
43
+ }, {
44
+ url: string;
45
+ type?: "notion" | "jira" | "linear" | "confluence" | "github" | "custom" | undefined;
46
+ title?: string | undefined;
47
+ }>, "many">>;
48
+ }, "strip", z.ZodTypeAny, {
49
+ type: "function" | "module" | "class" | "method" | "service" | "api_endpoint" | "variable" | "constant" | "interface" | "enum";
50
+ description: string;
51
+ status?: "experimental" | "stable" | "deprecated" | undefined;
52
+ owner?: string | undefined;
53
+ tags?: string[] | undefined;
54
+ links?: {
55
+ url: string;
56
+ type?: "notion" | "jira" | "linear" | "confluence" | "github" | "custom" | undefined;
57
+ title?: string | undefined;
58
+ }[] | undefined;
59
+ }, {
60
+ type: "function" | "module" | "class" | "method" | "service" | "api_endpoint" | "variable" | "constant" | "interface" | "enum";
61
+ description: string;
62
+ status?: "experimental" | "stable" | "deprecated" | undefined;
63
+ owner?: string | undefined;
64
+ tags?: string[] | undefined;
65
+ links?: {
66
+ url: string;
67
+ type?: "notion" | "jira" | "linear" | "confluence" | "github" | "custom" | undefined;
68
+ title?: string | undefined;
69
+ }[] | undefined;
70
+ }>;
71
+ export declare const FunnelStageSchema: z.ZodEnum<["awareness", "acquisition", "activation", "retention", "revenue", "referral"]>;
72
+ export declare const RevenueImpactSchema: z.ZodEnum<["critical", "high", "medium", "low", "none"]>;
73
+ export declare const ContextSchema: z.ZodObject<{
74
+ business_goal: z.ZodOptional<z.ZodString>;
75
+ funnel_stage: z.ZodOptional<z.ZodEnum<["awareness", "acquisition", "activation", "retention", "revenue", "referral"]>>;
76
+ revenue_impact: z.ZodOptional<z.ZodEnum<["critical", "high", "medium", "low", "none"]>>;
77
+ }, "strip", z.ZodTypeAny, {
78
+ business_goal?: string | undefined;
79
+ funnel_stage?: "awareness" | "acquisition" | "activation" | "retention" | "revenue" | "referral" | undefined;
80
+ revenue_impact?: "critical" | "high" | "medium" | "low" | "none" | undefined;
81
+ }, {
82
+ business_goal?: string | undefined;
83
+ funnel_stage?: "awareness" | "acquisition" | "activation" | "retention" | "revenue" | "referral" | undefined;
84
+ revenue_impact?: "critical" | "high" | "medium" | "low" | "none" | undefined;
85
+ }>;
86
+ export declare const DependenciesSchema: z.ZodObject<{
87
+ services: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
88
+ external_apis: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
89
+ databases: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
90
+ }, "strip", z.ZodTypeAny, {
91
+ services?: string[] | undefined;
92
+ external_apis?: string[] | undefined;
93
+ databases?: string[] | undefined;
94
+ }, {
95
+ services?: string[] | undefined;
96
+ external_apis?: string[] | undefined;
97
+ databases?: string[] | undefined;
98
+ }>;
99
+ export declare const DataSensitivitySchema: z.ZodEnum<["public", "internal", "confidential", "restricted"]>;
100
+ export declare const ComplianceSchema: z.ZodObject<{
101
+ regulations: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
102
+ data_sensitivity: z.ZodOptional<z.ZodEnum<["public", "internal", "confidential", "restricted"]>>;
103
+ audit_requirements: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
104
+ }, "strip", z.ZodTypeAny, {
105
+ regulations?: string[] | undefined;
106
+ data_sensitivity?: "public" | "internal" | "confidential" | "restricted" | undefined;
107
+ audit_requirements?: string[] | undefined;
108
+ }, {
109
+ regulations?: string[] | undefined;
110
+ data_sensitivity?: "public" | "internal" | "confidential" | "restricted" | undefined;
111
+ audit_requirements?: string[] | undefined;
112
+ }>;
113
+ export declare const MonitoringDashboardSchema: z.ZodObject<{
114
+ type: z.ZodOptional<z.ZodString>;
115
+ url: z.ZodString;
116
+ title: z.ZodOptional<z.ZodString>;
117
+ }, "strip", z.ZodTypeAny, {
118
+ url: string;
119
+ type?: string | undefined;
120
+ title?: string | undefined;
121
+ }, {
122
+ url: string;
123
+ type?: string | undefined;
124
+ title?: string | undefined;
125
+ }>;
126
+ export declare const OperationalSchema: z.ZodObject<{
127
+ sla: z.ZodOptional<z.ZodString>;
128
+ on_call_team: z.ZodOptional<z.ZodString>;
129
+ monitoring_dashboards: z.ZodOptional<z.ZodArray<z.ZodObject<{
130
+ type: z.ZodOptional<z.ZodString>;
131
+ url: z.ZodString;
132
+ title: z.ZodOptional<z.ZodString>;
133
+ }, "strip", z.ZodTypeAny, {
134
+ url: string;
135
+ type?: string | undefined;
136
+ title?: string | undefined;
137
+ }, {
138
+ url: string;
139
+ type?: string | undefined;
140
+ title?: string | undefined;
141
+ }>, "many">>;
142
+ }, "strip", z.ZodTypeAny, {
143
+ sla?: string | undefined;
144
+ on_call_team?: string | undefined;
145
+ monitoring_dashboards?: {
146
+ url: string;
147
+ type?: string | undefined;
148
+ title?: string | undefined;
149
+ }[] | undefined;
150
+ }, {
151
+ sla?: string | undefined;
152
+ on_call_team?: string | undefined;
153
+ monitoring_dashboards?: {
154
+ url: string;
155
+ type?: string | undefined;
156
+ title?: string | undefined;
157
+ }[] | undefined;
158
+ }>;
159
+ export declare const ExtendedMetadataSchema: z.ZodObject<{
160
+ type: z.ZodEnum<["module", "class", "function", "method", "service", "api_endpoint", "variable", "constant", "interface", "enum"]>;
161
+ description: z.ZodString;
162
+ owner: z.ZodOptional<z.ZodString>;
163
+ status: z.ZodOptional<z.ZodEnum<["experimental", "stable", "deprecated"]>>;
164
+ tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
165
+ links: z.ZodOptional<z.ZodArray<z.ZodObject<{
166
+ type: z.ZodOptional<z.ZodEnum<["notion", "jira", "linear", "confluence", "github", "custom"]>>;
167
+ url: z.ZodString;
168
+ title: z.ZodOptional<z.ZodString>;
169
+ }, "strip", z.ZodTypeAny, {
170
+ url: string;
171
+ type?: "notion" | "jira" | "linear" | "confluence" | "github" | "custom" | undefined;
172
+ title?: string | undefined;
173
+ }, {
174
+ url: string;
175
+ type?: "notion" | "jira" | "linear" | "confluence" | "github" | "custom" | undefined;
176
+ title?: string | undefined;
177
+ }>, "many">>;
178
+ } & {
179
+ context: z.ZodOptional<z.ZodObject<{
180
+ business_goal: z.ZodOptional<z.ZodString>;
181
+ funnel_stage: z.ZodOptional<z.ZodEnum<["awareness", "acquisition", "activation", "retention", "revenue", "referral"]>>;
182
+ revenue_impact: z.ZodOptional<z.ZodEnum<["critical", "high", "medium", "low", "none"]>>;
183
+ }, "strip", z.ZodTypeAny, {
184
+ business_goal?: string | undefined;
185
+ funnel_stage?: "awareness" | "acquisition" | "activation" | "retention" | "revenue" | "referral" | undefined;
186
+ revenue_impact?: "critical" | "high" | "medium" | "low" | "none" | undefined;
187
+ }, {
188
+ business_goal?: string | undefined;
189
+ funnel_stage?: "awareness" | "acquisition" | "activation" | "retention" | "revenue" | "referral" | undefined;
190
+ revenue_impact?: "critical" | "high" | "medium" | "low" | "none" | undefined;
191
+ }>>;
192
+ dependencies: z.ZodOptional<z.ZodObject<{
193
+ services: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
194
+ external_apis: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
195
+ databases: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
196
+ }, "strip", z.ZodTypeAny, {
197
+ services?: string[] | undefined;
198
+ external_apis?: string[] | undefined;
199
+ databases?: string[] | undefined;
200
+ }, {
201
+ services?: string[] | undefined;
202
+ external_apis?: string[] | undefined;
203
+ databases?: string[] | undefined;
204
+ }>>;
205
+ compliance: z.ZodOptional<z.ZodObject<{
206
+ regulations: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
207
+ data_sensitivity: z.ZodOptional<z.ZodEnum<["public", "internal", "confidential", "restricted"]>>;
208
+ audit_requirements: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
209
+ }, "strip", z.ZodTypeAny, {
210
+ regulations?: string[] | undefined;
211
+ data_sensitivity?: "public" | "internal" | "confidential" | "restricted" | undefined;
212
+ audit_requirements?: string[] | undefined;
213
+ }, {
214
+ regulations?: string[] | undefined;
215
+ data_sensitivity?: "public" | "internal" | "confidential" | "restricted" | undefined;
216
+ audit_requirements?: string[] | undefined;
217
+ }>>;
218
+ operational: z.ZodOptional<z.ZodObject<{
219
+ sla: z.ZodOptional<z.ZodString>;
220
+ on_call_team: z.ZodOptional<z.ZodString>;
221
+ monitoring_dashboards: z.ZodOptional<z.ZodArray<z.ZodObject<{
222
+ type: z.ZodOptional<z.ZodString>;
223
+ url: z.ZodString;
224
+ title: z.ZodOptional<z.ZodString>;
225
+ }, "strip", z.ZodTypeAny, {
226
+ url: string;
227
+ type?: string | undefined;
228
+ title?: string | undefined;
229
+ }, {
230
+ url: string;
231
+ type?: string | undefined;
232
+ title?: string | undefined;
233
+ }>, "many">>;
234
+ }, "strip", z.ZodTypeAny, {
235
+ sla?: string | undefined;
236
+ on_call_team?: string | undefined;
237
+ monitoring_dashboards?: {
238
+ url: string;
239
+ type?: string | undefined;
240
+ title?: string | undefined;
241
+ }[] | undefined;
242
+ }, {
243
+ sla?: string | undefined;
244
+ on_call_team?: string | undefined;
245
+ monitoring_dashboards?: {
246
+ url: string;
247
+ type?: string | undefined;
248
+ title?: string | undefined;
249
+ }[] | undefined;
250
+ }>>;
251
+ }, "strip", z.ZodTypeAny, {
252
+ type: "function" | "module" | "class" | "method" | "service" | "api_endpoint" | "variable" | "constant" | "interface" | "enum";
253
+ description: string;
254
+ status?: "experimental" | "stable" | "deprecated" | undefined;
255
+ owner?: string | undefined;
256
+ tags?: string[] | undefined;
257
+ links?: {
258
+ url: string;
259
+ type?: "notion" | "jira" | "linear" | "confluence" | "github" | "custom" | undefined;
260
+ title?: string | undefined;
261
+ }[] | undefined;
262
+ context?: {
263
+ business_goal?: string | undefined;
264
+ funnel_stage?: "awareness" | "acquisition" | "activation" | "retention" | "revenue" | "referral" | undefined;
265
+ revenue_impact?: "critical" | "high" | "medium" | "low" | "none" | undefined;
266
+ } | undefined;
267
+ dependencies?: {
268
+ services?: string[] | undefined;
269
+ external_apis?: string[] | undefined;
270
+ databases?: string[] | undefined;
271
+ } | undefined;
272
+ compliance?: {
273
+ regulations?: string[] | undefined;
274
+ data_sensitivity?: "public" | "internal" | "confidential" | "restricted" | undefined;
275
+ audit_requirements?: string[] | undefined;
276
+ } | undefined;
277
+ operational?: {
278
+ sla?: string | undefined;
279
+ on_call_team?: string | undefined;
280
+ monitoring_dashboards?: {
281
+ url: string;
282
+ type?: string | undefined;
283
+ title?: string | undefined;
284
+ }[] | undefined;
285
+ } | undefined;
286
+ }, {
287
+ type: "function" | "module" | "class" | "method" | "service" | "api_endpoint" | "variable" | "constant" | "interface" | "enum";
288
+ description: string;
289
+ status?: "experimental" | "stable" | "deprecated" | undefined;
290
+ owner?: string | undefined;
291
+ tags?: string[] | undefined;
292
+ links?: {
293
+ url: string;
294
+ type?: "notion" | "jira" | "linear" | "confluence" | "github" | "custom" | undefined;
295
+ title?: string | undefined;
296
+ }[] | undefined;
297
+ context?: {
298
+ business_goal?: string | undefined;
299
+ funnel_stage?: "awareness" | "acquisition" | "activation" | "retention" | "revenue" | "referral" | undefined;
300
+ revenue_impact?: "critical" | "high" | "medium" | "low" | "none" | undefined;
301
+ } | undefined;
302
+ dependencies?: {
303
+ services?: string[] | undefined;
304
+ external_apis?: string[] | undefined;
305
+ databases?: string[] | undefined;
306
+ } | undefined;
307
+ compliance?: {
308
+ regulations?: string[] | undefined;
309
+ data_sensitivity?: "public" | "internal" | "confidential" | "restricted" | undefined;
310
+ audit_requirements?: string[] | undefined;
311
+ } | undefined;
312
+ operational?: {
313
+ sla?: string | undefined;
314
+ on_call_team?: string | undefined;
315
+ monitoring_dashboards?: {
316
+ url: string;
317
+ type?: string | undefined;
318
+ title?: string | undefined;
319
+ }[] | undefined;
320
+ } | undefined;
321
+ }>;
322
+ export type EntityType = z.infer<typeof EntityTypeSchema>;
323
+ export type Status = z.infer<typeof StatusSchema>;
324
+ export type LinkType = z.infer<typeof LinkTypeSchema>;
325
+ export type Link = z.infer<typeof LinkSchema>;
326
+ export type CoreMetadata = z.infer<typeof CoreMetadataSchema>;
327
+ export type FunnelStage = z.infer<typeof FunnelStageSchema>;
328
+ export type RevenueImpact = z.infer<typeof RevenueImpactSchema>;
329
+ export type Context = z.infer<typeof ContextSchema>;
330
+ export type Dependencies = z.infer<typeof DependenciesSchema>;
331
+ export type DataSensitivity = z.infer<typeof DataSensitivitySchema>;
332
+ export type Compliance = z.infer<typeof ComplianceSchema>;
333
+ export type MonitoringDashboard = z.infer<typeof MonitoringDashboardSchema>;
334
+ export type Operational = z.infer<typeof OperationalSchema>;
335
+ export type ExtendedMetadata = z.infer<typeof ExtendedMetadataSchema>;
336
+ //# sourceMappingURL=entity.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../../src/types/entity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,gBAAgB,8HAW3B,CAAC;AAEH,eAAO,MAAM,YAAY,qDAAmD,CAAC;AAE7E,eAAO,MAAM,cAAc,2EAOzB,CAAC;AAEH,eAAO,MAAM,UAAU;;;;;;;;;;;;EAIrB,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAO7B,CAAC;AAEH,eAAO,MAAM,iBAAiB,2FAO5B,CAAC;AAEH,eAAO,MAAM,mBAAmB,0DAM9B,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;EAIxB,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAI7B,CAAC;AAEH,eAAO,MAAM,qBAAqB,iEAKhC,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;EAI3B,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;EAIpC,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAI5B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKjC,CAAC;AAGH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAClD,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAC9C,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}
@@ -0,0 +1,99 @@
1
+ /**
2
+ * @knowgraph
3
+ * type: module
4
+ * description: Zod schemas and TypeScript types for code entities, metadata, and validation
5
+ * owner: knowgraph-core
6
+ * status: stable
7
+ * tags: [schema, validation, zod, types]
8
+ * context:
9
+ * business_goal: Provide type-safe entity definitions for the entire KnowGraph system
10
+ * domain: core-types
11
+ */
12
+ import { z } from 'zod';
13
+ export const EntityTypeSchema = z.enum([
14
+ 'module',
15
+ 'class',
16
+ 'function',
17
+ 'method',
18
+ 'service',
19
+ 'api_endpoint',
20
+ 'variable',
21
+ 'constant',
22
+ 'interface',
23
+ 'enum',
24
+ ]);
25
+ export const StatusSchema = z.enum(['experimental', 'stable', 'deprecated']);
26
+ export const LinkTypeSchema = z.enum([
27
+ 'notion',
28
+ 'jira',
29
+ 'linear',
30
+ 'confluence',
31
+ 'github',
32
+ 'custom',
33
+ ]);
34
+ export const LinkSchema = z.object({
35
+ type: LinkTypeSchema.optional(),
36
+ url: z.string().url(),
37
+ title: z.string().optional(),
38
+ });
39
+ export const CoreMetadataSchema = z.object({
40
+ type: EntityTypeSchema,
41
+ description: z.string().min(1),
42
+ owner: z.string().optional(),
43
+ status: StatusSchema.optional(),
44
+ tags: z.array(z.string()).optional(),
45
+ links: z.array(LinkSchema).optional(),
46
+ });
47
+ export const FunnelStageSchema = z.enum([
48
+ 'awareness',
49
+ 'acquisition',
50
+ 'activation',
51
+ 'retention',
52
+ 'revenue',
53
+ 'referral',
54
+ ]);
55
+ export const RevenueImpactSchema = z.enum([
56
+ 'critical',
57
+ 'high',
58
+ 'medium',
59
+ 'low',
60
+ 'none',
61
+ ]);
62
+ export const ContextSchema = z.object({
63
+ business_goal: z.string().optional(),
64
+ funnel_stage: FunnelStageSchema.optional(),
65
+ revenue_impact: RevenueImpactSchema.optional(),
66
+ });
67
+ export const DependenciesSchema = z.object({
68
+ services: z.array(z.string()).optional(),
69
+ external_apis: z.array(z.string()).optional(),
70
+ databases: z.array(z.string()).optional(),
71
+ });
72
+ export const DataSensitivitySchema = z.enum([
73
+ 'public',
74
+ 'internal',
75
+ 'confidential',
76
+ 'restricted',
77
+ ]);
78
+ export const ComplianceSchema = z.object({
79
+ regulations: z.array(z.string()).optional(),
80
+ data_sensitivity: DataSensitivitySchema.optional(),
81
+ audit_requirements: z.array(z.string()).optional(),
82
+ });
83
+ export const MonitoringDashboardSchema = z.object({
84
+ type: z.string().optional(),
85
+ url: z.string().url(),
86
+ title: z.string().optional(),
87
+ });
88
+ export const OperationalSchema = z.object({
89
+ sla: z.string().optional(),
90
+ on_call_team: z.string().optional(),
91
+ monitoring_dashboards: z.array(MonitoringDashboardSchema).optional(),
92
+ });
93
+ export const ExtendedMetadataSchema = CoreMetadataSchema.extend({
94
+ context: ContextSchema.optional(),
95
+ dependencies: DependenciesSchema.optional(),
96
+ compliance: ComplianceSchema.optional(),
97
+ operational: OperationalSchema.optional(),
98
+ });
99
+ //# sourceMappingURL=entity.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"entity.js","sourceRoot":"","sources":["../../src/types/entity.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ export { EntityTypeSchema, StatusSchema, LinkTypeSchema, LinkSchema, CoreMetadataSchema, FunnelStageSchema, RevenueImpactSchema, ContextSchema, DependenciesSchema, DataSensitivitySchema, ComplianceSchema, MonitoringDashboardSchema, OperationalSchema, ExtendedMetadataSchema, } from './entity.js';
2
+ export type { EntityType, Status, LinkType, Link, CoreMetadata, FunnelStage, RevenueImpact, Context, Dependencies, DataSensitivity, Compliance, MonitoringDashboard, Operational, ExtendedMetadata, } from './entity.js';
3
+ export type { ParseResult } from './parse-result.js';
4
+ export { AnnotationStyleSchema, ParserConfigSchema, ConnectorConfigSchema, WebhookEventSchema, WebhookConfigSchema, ConnectorsSchema, IndexConfigSchema, ManifestSchema, } from './manifest.js';
5
+ export type { AnnotationStyle, ParserConfig, ConnectorConfig, WebhookEvent, WebhookConfig, Connectors, IndexConfig, Manifest, } from './manifest.js';
6
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,yBAAyB,EACzB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,UAAU,EACV,MAAM,EACN,QAAQ,EACR,IAAI,EACJ,YAAY,EACZ,WAAW,EACX,aAAa,EACb,OAAO,EACP,YAAY,EACZ,eAAe,EACf,UAAU,EACV,mBAAmB,EACnB,WAAW,EACX,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,eAAe,EACf,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,aAAa,EACb,UAAU,EACV,WAAW,EACX,QAAQ,GACT,MAAM,eAAe,CAAC"}
@@ -0,0 +1,3 @@
1
+ export { EntityTypeSchema, StatusSchema, LinkTypeSchema, LinkSchema, CoreMetadataSchema, FunnelStageSchema, RevenueImpactSchema, ContextSchema, DependenciesSchema, DataSensitivitySchema, ComplianceSchema, MonitoringDashboardSchema, OperationalSchema, ExtendedMetadataSchema, } from './entity.js';
2
+ export { AnnotationStyleSchema, ParserConfigSchema, ConnectorConfigSchema, WebhookEventSchema, WebhookConfigSchema, ConnectorsSchema, IndexConfigSchema, ManifestSchema, } from './manifest.js';
3
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,yBAAyB,EACzB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAqBrB,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,GACf,MAAM,eAAe,CAAC"}