@pg-atlas/data-sdk 0.7.0 → 0.8.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.
@@ -1,164 +1,166 @@
1
- export declare const VisibilitySchema: {
1
+ export declare const ActivityStatusSchema: {
2
2
  readonly type: "string";
3
- readonly enum: readonly ["public", "private"];
4
- readonly title: "Visibility";
5
- readonly description: "Whether a Repo is publicly accessible (affects data collection scope).";
3
+ readonly enum: readonly ["live", "in-dev", "discontinued", "non-responsive"];
4
+ readonly title: "ActivityStatus";
5
+ readonly description: "Lifecycle status of a Project.\n\nUpdated by the SCF Impact Survey (yearly) and higher-frequency signals;\nsee the Activity Status Update Logic in the architecture docs.";
6
6
  };
7
- export declare const ValidationErrorSchema: {
7
+ export declare const ContributionEntrySchema: {
8
8
  readonly properties: {
9
- readonly loc: {
10
- readonly items: {
11
- readonly anyOf: readonly [{
12
- readonly type: "string";
13
- }, {
14
- readonly type: "integer";
15
- }];
16
- };
17
- readonly type: "array";
18
- readonly title: "Location";
19
- };
20
- readonly msg: {
9
+ readonly repo_canonical_id: {
21
10
  readonly type: "string";
22
- readonly title: "Message";
11
+ readonly title: "Repo Canonical Id";
23
12
  };
24
- readonly type: {
13
+ readonly repo_display_name: {
25
14
  readonly type: "string";
26
- readonly title: "Error Type";
15
+ readonly title: "Repo Display Name";
27
16
  };
28
- readonly input: {
29
- readonly title: "Input";
17
+ readonly project_canonical_id: {
18
+ readonly anyOf: readonly [{
19
+ readonly type: "string";
20
+ }, {
21
+ readonly type: "null";
22
+ }];
23
+ readonly title: "Project Canonical Id";
30
24
  };
31
- readonly ctx: {
32
- readonly type: "object";
33
- readonly title: "Context";
25
+ readonly number_of_commits: {
26
+ readonly type: "integer";
27
+ readonly title: "Number Of Commits";
34
28
  };
35
- };
36
- readonly type: "object";
37
- readonly required: readonly ["loc", "msg", "type"];
38
- readonly title: "ValidationError";
39
- };
40
- export declare const SubmissionStatusSchema: {
41
- readonly type: "string";
42
- readonly enum: readonly ["pending", "processed", "failed"];
43
- readonly title: "SubmissionStatus";
44
- readonly description: "Processing state of an artifact-linked audit record.";
45
- };
46
- export declare const ScfSubmissionSchema: {
47
- readonly properties: {
48
- readonly round: {
29
+ readonly first_commit_date: {
49
30
  readonly type: "string";
50
- readonly title: "Round";
31
+ readonly format: "date-time";
32
+ readonly title: "First Commit Date";
51
33
  };
52
- readonly title: {
34
+ readonly last_commit_date: {
53
35
  readonly type: "string";
54
- readonly title: "Title";
36
+ readonly format: "date-time";
37
+ readonly title: "Last Commit Date";
55
38
  };
56
39
  };
57
40
  readonly type: "object";
58
- readonly required: readonly ["round", "title"];
59
- readonly title: "ScfSubmission";
60
- readonly description: "A single SCF funding round submission.";
41
+ readonly required: readonly ["repo_canonical_id", "repo_display_name", "project_canonical_id", "number_of_commits", "first_commit_date", "last_commit_date"];
42
+ readonly title: "ContributionEntry";
43
+ readonly description: "A single repo that a contributor has committed to.";
61
44
  };
62
- export declare const SbomSubmissionResponseSchema: {
45
+ export declare const ContributorDetailResponseSchema: {
63
46
  readonly properties: {
64
47
  readonly id: {
65
48
  readonly type: "integer";
66
49
  readonly title: "Id";
67
50
  };
68
- readonly repository_claim: {
69
- readonly type: "string";
70
- readonly title: "Repository Claim";
71
- };
72
- readonly actor_claim: {
51
+ readonly name: {
73
52
  readonly type: "string";
74
- readonly title: "Actor Claim";
53
+ readonly title: "Name";
75
54
  };
76
- readonly sbom_content_hash: {
55
+ readonly email_hash: {
77
56
  readonly type: "string";
78
- readonly title: "Sbom Content Hash";
57
+ readonly title: "Email Hash";
79
58
  };
80
- readonly artifact_path: {
81
- readonly type: "string";
82
- readonly title: "Artifact Path";
59
+ readonly total_repos: {
60
+ readonly type: "integer";
61
+ readonly title: "Total Repos";
83
62
  };
84
- readonly status: {
85
- readonly $ref: "#/components/schemas/SubmissionStatus";
63
+ readonly total_commits: {
64
+ readonly type: "integer";
65
+ readonly title: "Total Commits";
86
66
  };
87
- readonly error_detail: {
67
+ readonly first_contribution: {
88
68
  readonly anyOf: readonly [{
89
69
  readonly type: "string";
70
+ readonly format: "date-time";
90
71
  }, {
91
72
  readonly type: "null";
92
73
  }];
93
- readonly title: "Error Detail";
94
- };
95
- readonly submitted_at: {
96
- readonly type: "string";
97
- readonly format: "date-time";
98
- readonly title: "Submitted At";
74
+ readonly title: "First Contribution";
99
75
  };
100
- readonly processed_at: {
76
+ readonly last_contribution: {
101
77
  readonly anyOf: readonly [{
102
78
  readonly type: "string";
103
79
  readonly format: "date-time";
104
80
  }, {
105
81
  readonly type: "null";
106
82
  }];
107
- readonly title: "Processed At";
83
+ readonly title: "Last Contribution";
108
84
  };
109
- };
110
- readonly type: "object";
111
- readonly required: readonly ["id", "repository_claim", "actor_claim", "sbom_content_hash", "artifact_path", "status", "error_detail", "submitted_at", "processed_at"];
112
- readonly title: "SbomSubmissionResponse";
113
- readonly description: "Full SBOM submission record.\n\nSerialised from the ``SbomSubmission`` ORM model. The ``sbom_content_hash``\nfield is the SHA-256 hex digest of the raw submitted payload.";
114
- };
115
- export declare const SbomSubmissionListResponseSchema: {
116
- readonly properties: {
117
- readonly items: {
85
+ readonly repos: {
118
86
  readonly items: {
119
- readonly $ref: "#/components/schemas/SbomSubmissionResponse";
87
+ readonly $ref: "#/components/schemas/ContributionEntry";
120
88
  };
121
89
  readonly type: "array";
122
- readonly title: "Items";
90
+ readonly title: "Repos";
123
91
  };
124
- readonly total: {
92
+ };
93
+ readonly type: "object";
94
+ readonly required: readonly ["id", "name", "email_hash", "total_repos", "total_commits", "first_contribution", "last_contribution", "repos"];
95
+ readonly title: "ContributorDetailResponse";
96
+ readonly description: "Full contributor detail with aggregated statistics and per-repo activity.";
97
+ };
98
+ export declare const ContributorSummarySchema: {
99
+ readonly properties: {
100
+ readonly id: {
125
101
  readonly type: "integer";
126
- readonly title: "Total";
102
+ readonly title: "Id";
127
103
  };
128
- readonly limit: {
104
+ readonly name: {
105
+ readonly type: "string";
106
+ readonly title: "Name";
107
+ };
108
+ readonly email_hash: {
109
+ readonly type: "string";
110
+ readonly title: "Email Hash";
111
+ };
112
+ };
113
+ readonly type: "object";
114
+ readonly required: readonly ["id", "name", "email_hash"];
115
+ readonly title: "ContributorSummary";
116
+ readonly description: "Compact contributor reference embedded in repo detail responses.";
117
+ };
118
+ export declare const DepCountsSchema: {
119
+ readonly properties: {
120
+ readonly repos: {
129
121
  readonly type: "integer";
130
- readonly title: "Limit";
122
+ readonly title: "Repos";
131
123
  };
132
- readonly offset: {
124
+ readonly external_repos: {
133
125
  readonly type: "integer";
134
- readonly title: "Offset";
126
+ readonly title: "External Repos";
135
127
  };
136
128
  };
137
129
  readonly type: "object";
138
- readonly required: readonly ["items", "total", "limit", "offset"];
139
- readonly title: "SbomSubmissionListResponse";
140
- readonly description: "Paginated list of SBOM submission records.\n\nReturned by the list endpoint with ``total`` reflecting the count after\nany ``repository`` filter has been applied.";
130
+ readonly required: readonly ["repos", "external_repos"];
131
+ readonly title: "DepCounts";
132
+ readonly description: "Counts of dependency edges grouped by target vertex type.\n\nProvided as part of the repo detail response so the frontend can show\n\"depends on N repos + M external\" without fetching the full edge list.";
141
133
  };
142
- export declare const SbomSubmissionDetailResponseSchema: {
134
+ export declare const EdgeConfidenceSchema: {
135
+ readonly type: "string";
136
+ readonly enum: readonly ["verified-sbom", "inferred-shadow"];
137
+ readonly title: "EdgeConfidence";
138
+ readonly description: "How firmly an edge was established.";
139
+ };
140
+ export declare const GitLogArtifactDetailResponseSchema: {
143
141
  readonly properties: {
144
142
  readonly id: {
145
143
  readonly type: "integer";
146
144
  readonly title: "Id";
147
145
  };
148
- readonly repository_claim: {
149
- readonly type: "string";
150
- readonly title: "Repository Claim";
146
+ readonly repo_id: {
147
+ readonly type: "integer";
148
+ readonly title: "Repo Id";
151
149
  };
152
- readonly actor_claim: {
150
+ readonly repo_canonical_id: {
153
151
  readonly type: "string";
154
- readonly title: "Actor Claim";
152
+ readonly title: "Repo Canonical Id";
155
153
  };
156
- readonly sbom_content_hash: {
154
+ readonly repo_display_name: {
157
155
  readonly type: "string";
158
- readonly title: "Sbom Content Hash";
156
+ readonly title: "Repo Display Name";
159
157
  };
160
158
  readonly artifact_path: {
161
- readonly type: "string";
159
+ readonly anyOf: readonly [{
160
+ readonly type: "string";
161
+ }, {
162
+ readonly type: "null";
163
+ }];
162
164
  readonly title: "Artifact Path";
163
165
  };
164
166
  readonly status: {
@@ -172,6 +174,10 @@ export declare const SbomSubmissionDetailResponseSchema: {
172
174
  }];
173
175
  readonly title: "Error Detail";
174
176
  };
177
+ readonly since_months: {
178
+ readonly type: "integer";
179
+ readonly title: "Since Months";
180
+ };
175
181
  readonly submitted_at: {
176
182
  readonly type: "string";
177
183
  readonly format: "date-time";
@@ -196,710 +202,437 @@ export declare const SbomSubmissionDetailResponseSchema: {
196
202
  };
197
203
  };
198
204
  readonly type: "object";
199
- readonly required: readonly ["id", "repository_claim", "actor_claim", "sbom_content_hash", "artifact_path", "status", "error_detail", "submitted_at", "processed_at"];
200
- readonly title: "SbomSubmissionDetailResponse";
201
- readonly description: "Extended SBOM submission record with the raw artifact content.\n\nReturned by the detail endpoint. ``raw_artifact`` contains the full JSON\ntext of the stored SBOM, or ``None`` if the artifact file is missing from\nthe store.";
205
+ readonly required: readonly ["id", "repo_id", "repo_canonical_id", "repo_display_name", "artifact_path", "status", "error_detail", "since_months", "submitted_at", "processed_at"];
206
+ readonly title: "GitLogArtifactDetailResponse";
207
+ readonly description: "Full gitlog artifact audit record including raw artifact content.";
202
208
  };
203
- export declare const SbomAcceptedResponseSchema: {
209
+ export declare const GitLogArtifactSummarySchema: {
204
210
  readonly properties: {
205
- readonly message: {
206
- readonly type: "string";
207
- readonly title: "Message";
208
- };
209
- readonly repository: {
210
- readonly type: "string";
211
- readonly title: "Repository";
212
- };
213
- readonly package_count: {
211
+ readonly id: {
214
212
  readonly type: "integer";
215
- readonly title: "Package Count";
213
+ readonly title: "Id";
216
214
  };
217
- };
218
- readonly type: "object";
219
- readonly required: readonly ["message", "repository", "package_count"];
220
- readonly title: "SbomAcceptedResponse";
221
- readonly description: "Response body returned on successful SBOM submission (202 Accepted).";
222
- };
223
- export declare const RepoVertexTypeSchema: {
224
- readonly type: "string";
225
- readonly enum: readonly ["repo", "external-repo"];
226
- readonly title: "RepoVertexType";
227
- readonly description: "Discriminator values for the RepoVertex joined-table-inheritance hierarchy.";
228
- };
229
- export declare const RepoSummarySchema: {
230
- readonly properties: {
231
- readonly canonical_id: {
232
- readonly type: "string";
233
- readonly title: "Canonical Id";
215
+ readonly repo_id: {
216
+ readonly type: "integer";
217
+ readonly title: "Repo Id";
234
218
  };
235
- readonly display_name: {
219
+ readonly repo_canonical_id: {
236
220
  readonly type: "string";
237
- readonly title: "Display Name";
238
- };
239
- readonly visibility: {
240
- readonly $ref: "#/components/schemas/Visibility";
221
+ readonly title: "Repo Canonical Id";
241
222
  };
242
- readonly latest_version: {
223
+ readonly repo_display_name: {
243
224
  readonly type: "string";
244
- readonly title: "Latest Version";
225
+ readonly title: "Repo Display Name";
245
226
  };
246
- readonly latest_commit_date: {
227
+ readonly artifact_path: {
247
228
  readonly anyOf: readonly [{
248
229
  readonly type: "string";
249
- readonly format: "date-time";
250
230
  }, {
251
231
  readonly type: "null";
252
232
  }];
253
- readonly title: "Latest Commit Date";
233
+ readonly title: "Artifact Path";
254
234
  };
255
- readonly repo_url: {
235
+ readonly status: {
236
+ readonly $ref: "#/components/schemas/SubmissionStatus";
237
+ };
238
+ readonly error_detail: {
256
239
  readonly anyOf: readonly [{
257
240
  readonly type: "string";
258
241
  }, {
259
242
  readonly type: "null";
260
243
  }];
261
- readonly title: "Repo Url";
244
+ readonly title: "Error Detail";
262
245
  };
263
- readonly project_id: {
264
- readonly anyOf: readonly [{
265
- readonly type: "integer";
266
- }, {
267
- readonly type: "null";
268
- }];
269
- readonly title: "Project Id";
246
+ readonly since_months: {
247
+ readonly type: "integer";
248
+ readonly title: "Since Months";
270
249
  };
271
- readonly pony_factor: {
272
- readonly anyOf: readonly [{
273
- readonly type: "integer";
274
- }, {
275
- readonly type: "null";
276
- }];
277
- readonly title: "Pony Factor";
250
+ readonly submitted_at: {
251
+ readonly type: "string";
252
+ readonly format: "date-time";
253
+ readonly title: "Submitted At";
278
254
  };
279
- readonly criticality_score: {
255
+ readonly processed_at: {
280
256
  readonly anyOf: readonly [{
281
- readonly type: "integer";
257
+ readonly type: "string";
258
+ readonly format: "date-time";
282
259
  }, {
283
260
  readonly type: "null";
284
261
  }];
285
- readonly title: "Criticality Score";
262
+ readonly title: "Processed At";
286
263
  };
287
- readonly adoption_downloads: {
288
- readonly anyOf: readonly [{
289
- readonly type: "integer";
290
- }, {
291
- readonly type: "null";
292
- }];
293
- readonly title: "Adoption Downloads";
264
+ };
265
+ readonly type: "object";
266
+ readonly required: readonly ["id", "repo_id", "repo_canonical_id", "repo_display_name", "artifact_path", "status", "error_detail", "since_months", "submitted_at", "processed_at"];
267
+ readonly title: "GitLogArtifactSummary";
268
+ readonly description: "Compact gitlog artifact audit record for list endpoints.";
269
+ };
270
+ export declare const GithubDependentObservationItemSchema: {
271
+ readonly properties: {
272
+ readonly dependent_canonical_id: {
273
+ readonly type: "string";
274
+ readonly title: "Dependent Canonical Id";
294
275
  };
295
- readonly adoption_stars: {
276
+ readonly dependent_repo_url: {
277
+ readonly type: "string";
278
+ readonly title: "Dependent Repo Url";
279
+ };
280
+ readonly observed_owner: {
281
+ readonly type: "string";
282
+ readonly title: "Observed Owner";
283
+ };
284
+ readonly observed_repo_name: {
285
+ readonly type: "string";
286
+ readonly title: "Observed Repo Name";
287
+ };
288
+ readonly resolved_repo_canonical_id: {
296
289
  readonly anyOf: readonly [{
297
- readonly type: "integer";
290
+ readonly type: "string";
298
291
  }, {
299
292
  readonly type: "null";
300
293
  }];
301
- readonly title: "Adoption Stars";
294
+ readonly title: "Resolved Repo Canonical Id";
302
295
  };
303
- readonly adoption_forks: {
296
+ readonly package_ids: {
304
297
  readonly anyOf: readonly [{
305
- readonly type: "integer";
298
+ readonly items: {
299
+ readonly type: "string";
300
+ };
301
+ readonly type: "array";
306
302
  }, {
307
303
  readonly type: "null";
308
304
  }];
309
- readonly title: "Adoption Forks";
305
+ readonly title: "Package Ids";
310
306
  };
311
- readonly updated_at: {
307
+ readonly first_seen_at: {
312
308
  readonly type: "string";
313
309
  readonly format: "date-time";
314
- readonly title: "Updated At";
310
+ readonly title: "First Seen At";
311
+ };
312
+ readonly last_seen_at: {
313
+ readonly type: "string";
314
+ readonly format: "date-time";
315
+ readonly title: "Last Seen At";
315
316
  };
316
317
  };
317
318
  readonly type: "object";
318
- readonly required: readonly ["canonical_id", "display_name", "visibility", "latest_version", "latest_commit_date", "repo_url", "project_id", "pony_factor", "criticality_score", "adoption_downloads", "adoption_stars", "adoption_forks", "updated_at"];
319
- readonly title: "RepoSummary";
320
- readonly description: "Compact repo representation used in list endpoints and as an embedded\nreference in project detail responses.";
319
+ readonly required: readonly ["dependent_canonical_id", "dependent_repo_url", "observed_owner", "observed_repo_name", "first_seen_at", "last_seen_at"];
320
+ readonly title: "GithubDependentObservationItem";
321
+ readonly description: "One active GitHub dependent observation for a source repo.";
321
322
  };
322
- export declare const RepoDetailResponseSchema: {
323
+ export declare const GithubDependentsResponseSchema: {
323
324
  readonly properties: {
324
- readonly canonical_id: {
325
- readonly type: "string";
326
- readonly title: "Canonical Id";
327
- };
328
- readonly display_name: {
329
- readonly type: "string";
330
- readonly title: "Display Name";
331
- };
332
- readonly visibility: {
333
- readonly $ref: "#/components/schemas/Visibility";
325
+ readonly summary: {
326
+ readonly $ref: "#/components/schemas/GithubDependentsSummary";
334
327
  };
335
- readonly latest_version: {
336
- readonly type: "string";
337
- readonly title: "Latest Version";
328
+ readonly observations: {
329
+ readonly $ref: "#/components/schemas/PaginatedResponse_GithubDependentObservationItem_";
338
330
  };
339
- readonly latest_commit_date: {
331
+ };
332
+ readonly type: "object";
333
+ readonly required: readonly ["summary", "observations"];
334
+ readonly title: "GithubDependentsResponse";
335
+ readonly description: "Summary plus paginated active observations for one source repo.";
336
+ };
337
+ export declare const GithubDependentsSummarySchema: {
338
+ readonly properties: {
339
+ readonly latest_attempt_at: {
340
340
  readonly anyOf: readonly [{
341
341
  readonly type: "string";
342
342
  readonly format: "date-time";
343
343
  }, {
344
344
  readonly type: "null";
345
345
  }];
346
- readonly title: "Latest Commit Date";
346
+ readonly title: "Latest Attempt At";
347
347
  };
348
- readonly repo_url: {
348
+ readonly latest_attempt_status: {
349
349
  readonly anyOf: readonly [{
350
350
  readonly type: "string";
351
351
  }, {
352
352
  readonly type: "null";
353
353
  }];
354
- readonly title: "Repo Url";
354
+ readonly title: "Latest Attempt Status";
355
355
  };
356
- readonly project_id: {
356
+ readonly latest_attempt_listing_incomplete_reason: {
357
357
  readonly anyOf: readonly [{
358
- readonly type: "integer";
358
+ readonly type: "string";
359
359
  }, {
360
360
  readonly type: "null";
361
361
  }];
362
- readonly title: "Project Id";
362
+ readonly title: "Latest Attempt Listing Incomplete Reason";
363
363
  };
364
- readonly pony_factor: {
364
+ readonly latest_attempt_counts_incomplete_reason: {
365
365
  readonly anyOf: readonly [{
366
- readonly type: "integer";
366
+ readonly type: "string";
367
367
  }, {
368
368
  readonly type: "null";
369
369
  }];
370
- readonly title: "Pony Factor";
370
+ readonly title: "Latest Attempt Counts Incomplete Reason";
371
371
  };
372
- readonly criticality_score: {
372
+ readonly observations_as_of: {
373
373
  readonly anyOf: readonly [{
374
- readonly type: "integer";
374
+ readonly type: "string";
375
+ readonly format: "date-time";
375
376
  }, {
376
377
  readonly type: "null";
377
378
  }];
378
- readonly title: "Criticality Score";
379
+ readonly title: "Observations As Of";
379
380
  };
380
- readonly adoption_downloads: {
381
+ readonly reported_counts_as_of: {
381
382
  readonly anyOf: readonly [{
382
- readonly type: "integer";
383
+ readonly type: "string";
384
+ readonly format: "date-time";
383
385
  }, {
384
386
  readonly type: "null";
385
387
  }];
386
- readonly title: "Adoption Downloads";
388
+ readonly title: "Reported Counts As Of";
387
389
  };
388
- readonly adoption_stars: {
390
+ readonly repos_total_reported: {
389
391
  readonly anyOf: readonly [{
390
392
  readonly type: "integer";
391
393
  }, {
392
394
  readonly type: "null";
393
395
  }];
394
- readonly title: "Adoption Stars";
396
+ readonly title: "Repos Total Reported";
395
397
  };
396
- readonly adoption_forks: {
398
+ readonly packages_total_reported: {
397
399
  readonly anyOf: readonly [{
398
400
  readonly type: "integer";
399
401
  }, {
400
402
  readonly type: "null";
401
403
  }];
402
- readonly title: "Adoption Forks";
403
- };
404
- readonly updated_at: {
405
- readonly type: "string";
406
- readonly format: "date-time";
407
- readonly title: "Updated At";
408
- };
409
- readonly releases: {
410
- readonly anyOf: readonly [{
411
- readonly items: {
412
- readonly properties: {
413
- readonly purl: {
414
- readonly type: "string";
415
- };
416
- readonly version: {
417
- readonly type: "string";
418
- };
419
- readonly release_date: {
420
- readonly type: "string";
421
- readonly default: "";
422
- };
423
- };
424
- readonly type: "object";
425
- readonly required: readonly ["purl", "version"];
426
- readonly title: "Release";
427
- readonly description: "One normalized release record keyed by package PURL + version.";
428
- };
429
- readonly type: "array";
430
- }, {
431
- readonly type: "null";
432
- }];
433
- readonly title: "Releases";
404
+ readonly title: "Packages Total Reported";
434
405
  };
435
- readonly parent_project: {
406
+ readonly packages_scanned: {
436
407
  readonly anyOf: readonly [{
437
- readonly $ref: "#/components/schemas/ProjectSummary";
408
+ readonly type: "integer";
438
409
  }, {
439
410
  readonly type: "null";
440
411
  }];
412
+ readonly title: "Packages Scanned";
441
413
  };
442
- readonly contributors: {
443
- readonly items: {
444
- readonly $ref: "#/components/schemas/ContributorSummary";
445
- };
446
- readonly type: "array";
447
- readonly title: "Contributors";
448
- };
449
- readonly outgoing_dep_counts: {
450
- readonly $ref: "#/components/schemas/DepCounts";
451
- };
452
- readonly incoming_dep_counts: {
453
- readonly $ref: "#/components/schemas/DepCounts";
454
- };
455
- readonly active_contributors_30d: {
456
- readonly type: "integer";
457
- readonly title: "Active Contributors 30D";
458
- };
459
- readonly active_contributors_90d: {
414
+ readonly active_observations: {
460
415
  readonly type: "integer";
461
- readonly title: "Active Contributors 90D";
416
+ readonly title: "Active Observations";
417
+ readonly default: 0;
462
418
  };
463
419
  };
464
420
  readonly type: "object";
465
- readonly required: readonly ["canonical_id", "display_name", "visibility", "latest_version", "latest_commit_date", "repo_url", "project_id", "pony_factor", "criticality_score", "adoption_downloads", "adoption_stars", "adoption_forks", "updated_at", "releases", "parent_project", "contributors", "outgoing_dep_counts", "incoming_dep_counts", "active_contributors_30d", "active_contributors_90d"];
466
- readonly title: "RepoDetailResponse";
467
- readonly description: "Full repo detail with parent project, contributors, releases, dependency counts,\nand active contributor stats.";
421
+ readonly title: "GithubDependentsSummary";
422
+ readonly description: "Freshness and completeness summary for a source repo's observations.\n\n``observations_as_of`` is the finish time of the latest applied\nlisting-complete run; ``reported_counts_as_of`` is the finish time of the\nlatest applied counts-complete run. The two can point to different runs,\nso the reported totals always carry their own timestamp. Reported header\ntotals may exceed the enumerable public entries and, for multi-package\nrepositories, are per-package sums that can double count a dependent\nusing several packages.";
468
423
  };
469
- export declare const DepCountsSchema: {
424
+ export declare const HTTPValidationErrorSchema: {
470
425
  readonly properties: {
471
- readonly repos: {
472
- readonly type: "integer";
473
- readonly title: "Repos";
474
- };
475
- readonly external_repos: {
476
- readonly type: "integer";
477
- readonly title: "External Repos";
426
+ readonly detail: {
427
+ readonly items: {
428
+ readonly $ref: "#/components/schemas/ValidationError";
429
+ };
430
+ readonly type: "array";
431
+ readonly title: "Detail";
478
432
  };
479
433
  };
480
434
  readonly type: "object";
481
- readonly required: readonly ["repos", "external_repos"];
482
- readonly title: "DepCounts";
483
- readonly description: "Counts of dependency edges grouped by target vertex type.\n\nProvided as part of the repo detail response so the frontend can show\n\"depends on N repos + M external\" without fetching the full edge list.";
435
+ readonly title: "HTTPValidationError";
484
436
  };
485
- export declare const ContributorSummarySchema: {
437
+ export declare const HealthComponentsSchema: {
486
438
  readonly properties: {
487
- readonly id: {
488
- readonly type: "integer";
489
- readonly title: "Id";
490
- };
491
- readonly name: {
439
+ readonly artifact_store: {
492
440
  readonly type: "string";
493
- readonly title: "Name";
441
+ readonly enum: readonly ["local", "IPFS"];
442
+ readonly title: "Artifact Store";
494
443
  };
495
- readonly email_hash: {
444
+ readonly database: {
496
445
  readonly type: "string";
497
- readonly title: "Email Hash";
446
+ readonly enum: readonly ["ready", "not-configured"];
447
+ readonly title: "Database";
448
+ };
449
+ readonly schema_version: {
450
+ readonly anyOf: readonly [{
451
+ readonly type: "string";
452
+ }, {
453
+ readonly type: "null";
454
+ }];
455
+ readonly title: "Schema Version";
498
456
  };
499
457
  };
500
458
  readonly type: "object";
501
- readonly required: readonly ["id", "name", "email_hash"];
502
- readonly title: "ContributorSummary";
503
- readonly description: "Compact contributor reference embedded in repo detail responses.";
504
- };
505
- export declare const ActivityStatusSchema: {
506
- readonly type: "string";
507
- readonly enum: readonly ["live", "in-dev", "discontinued", "non-responsive"];
508
- readonly title: "ActivityStatus";
509
- readonly description: "Lifecycle status of a Project.\n\nUpdated by the SCF Impact Survey (yearly) and higher-frequency signals;\nsee the Activity Status Update Logic in the architecture docs.";
510
- };
511
- export declare const ProjectTypeSchema: {
512
- readonly type: "string";
513
- readonly enum: readonly ["public-good", "scf-project"];
514
- readonly title: "ProjectType";
515
- readonly description: "Classification of a Project within the PG Atlas universe.";
459
+ readonly required: readonly ["artifact_store", "database", "schema_version"];
460
+ readonly title: "HealthComponents";
461
+ readonly description: "Component-level readiness details for GET /health.";
516
462
  };
517
- export declare const ProjectSummarySchema: {
463
+ export declare const HealthResponseSchema: {
518
464
  readonly properties: {
519
- readonly canonical_id: {
465
+ readonly status: {
520
466
  readonly type: "string";
521
- readonly title: "Canonical Id";
467
+ readonly enum: readonly ["live", "ready"];
468
+ readonly title: "Status";
522
469
  };
523
- readonly display_name: {
470
+ readonly version: {
524
471
  readonly type: "string";
525
- readonly title: "Display Name";
526
- };
527
- readonly project_type: {
528
- readonly $ref: "#/components/schemas/ProjectType";
472
+ readonly title: "Version";
529
473
  };
530
- readonly activity_status: {
531
- readonly $ref: "#/components/schemas/ActivityStatus";
474
+ readonly components: {
475
+ readonly $ref: "#/components/schemas/HealthComponents";
532
476
  };
533
- readonly category: {
534
- readonly anyOf: readonly [{
535
- readonly type: "string";
536
- }, {
537
- readonly type: "null";
538
- }];
539
- readonly title: "Category";
477
+ };
478
+ readonly type: "object";
479
+ readonly required: readonly ["status", "version", "components"];
480
+ readonly title: "HealthResponse";
481
+ readonly description: "Response body for GET /health.";
482
+ };
483
+ export declare const MaintenanceProfileResponseSchema: {
484
+ readonly properties: {
485
+ readonly schema_version: {
486
+ readonly type: "integer";
487
+ readonly title: "Schema Version";
540
488
  };
541
- readonly git_owner_url: {
542
- readonly anyOf: readonly [{
543
- readonly type: "string";
544
- }, {
545
- readonly type: "null";
546
- }];
547
- readonly title: "Git Owner Url";
489
+ readonly as_of: {
490
+ readonly type: "string";
491
+ readonly title: "As Of";
548
492
  };
549
- readonly pony_factor: {
550
- readonly anyOf: readonly [{
551
- readonly type: "integer";
552
- }, {
553
- readonly type: "null";
554
- }];
555
- readonly title: "Pony Factor";
493
+ readonly window_days: {
494
+ readonly type: "integer";
495
+ readonly title: "Window Days";
556
496
  };
557
- readonly criticality_score: {
558
- readonly anyOf: readonly [{
559
- readonly type: "integer";
560
- }, {
561
- readonly type: "null";
562
- }];
563
- readonly title: "Criticality Score";
497
+ readonly response_interval_days: {
498
+ readonly type: "integer";
499
+ readonly title: "Response Interval Days";
564
500
  };
565
- readonly adoption_score: {
566
- readonly anyOf: readonly [{
567
- readonly type: "number";
568
- }, {
569
- readonly type: "null";
570
- }];
571
- readonly title: "Adoption Score";
501
+ readonly eligible_population: {
502
+ readonly type: "integer";
503
+ readonly title: "Eligible Population";
572
504
  };
573
- readonly updated_at: {
574
- readonly type: "string";
575
- readonly format: "date-time";
576
- readonly title: "Updated At";
505
+ readonly signals: {
506
+ readonly additionalProperties: {
507
+ readonly additionalProperties: true;
508
+ readonly type: "object";
509
+ };
510
+ readonly type: "object";
511
+ readonly title: "Signals";
577
512
  };
578
513
  };
579
514
  readonly type: "object";
580
- readonly required: readonly ["canonical_id", "display_name", "project_type", "activity_status", "category", "git_owner_url", "pony_factor", "criticality_score", "adoption_score", "updated_at"];
581
- readonly title: "ProjectSummary";
582
- readonly description: "Compact project representation used in list endpoints and as an embedded\nreference in repo detail responses.";
515
+ readonly required: readonly ["schema_version", "as_of", "window_days", "response_interval_days", "eligible_population", "signals"];
516
+ readonly title: "MaintenanceProfileResponse";
517
+ readonly description: "Stored maintenance profile for one repo, as materialized.";
583
518
  };
584
- export declare const RepoDependencySchema: {
519
+ export declare const MetadataResponseSchema: {
585
520
  readonly properties: {
586
- readonly canonical_id: {
587
- readonly type: "string";
588
- readonly title: "Canonical Id";
521
+ readonly total_projects: {
522
+ readonly type: "integer";
523
+ readonly title: "Total Projects";
589
524
  };
590
- readonly display_name: {
591
- readonly type: "string";
592
- readonly title: "Display Name";
525
+ readonly active_projects: {
526
+ readonly type: "integer";
527
+ readonly title: "Active Projects";
593
528
  };
594
- readonly vertex_type: {
595
- readonly $ref: "#/components/schemas/RepoVertexType";
529
+ readonly total_repos: {
530
+ readonly type: "integer";
531
+ readonly title: "Total Repos";
596
532
  };
597
- readonly version_range: {
533
+ readonly active_repos_90d: {
534
+ readonly type: "integer";
535
+ readonly title: "Active Repos 90D";
536
+ };
537
+ readonly total_external_repos: {
538
+ readonly type: "integer";
539
+ readonly title: "Total External Repos";
540
+ };
541
+ readonly total_dependency_edges: {
542
+ readonly type: "integer";
543
+ readonly title: "Total Dependency Edges";
544
+ };
545
+ readonly total_contributor_edges: {
546
+ readonly type: "integer";
547
+ readonly title: "Total Contributor Edges";
548
+ };
549
+ readonly active_contributors_30d: {
550
+ readonly type: "integer";
551
+ readonly title: "Active Contributors 30D";
552
+ };
553
+ readonly active_contributors_90d: {
554
+ readonly type: "integer";
555
+ readonly title: "Active Contributors 90D";
556
+ };
557
+ readonly last_updated: {
598
558
  readonly anyOf: readonly [{
599
559
  readonly type: "string";
560
+ readonly format: "date-time";
600
561
  }, {
601
562
  readonly type: "null";
602
563
  }];
603
- readonly title: "Version Range";
604
- };
605
- readonly confidence: {
606
- readonly $ref: "#/components/schemas/EdgeConfidence";
564
+ readonly title: "Last Updated";
607
565
  };
608
566
  };
609
567
  readonly type: "object";
610
- readonly required: readonly ["canonical_id", "display_name", "vertex_type", "version_range", "confidence"];
611
- readonly title: "RepoDependency";
612
- readonly description: "A single dependency or reverse-dependency edge from a repo.\n\n``vertex_type`` tells the frontend whether the target is an in-ecosystem\n``Repo`` or an ``ExternalRepo``.";
613
- };
614
- export declare const EdgeConfidenceSchema: {
615
- readonly type: "string";
616
- readonly enum: readonly ["verified-sbom", "inferred-shadow"];
617
- readonly title: "EdgeConfidence";
618
- readonly description: "How firmly an edge was established.";
568
+ readonly required: readonly ["total_projects", "active_projects", "total_repos", "active_repos_90d", "total_external_repos", "total_dependency_edges", "total_contributor_edges", "active_contributors_30d", "active_contributors_90d", "last_updated"];
569
+ readonly title: "MetadataResponse";
570
+ readonly description: "Ecosystem-wide summary statistics returned by ``GET /metadata``.";
619
571
  };
620
- export declare const RepoContributorSummarySchema: {
572
+ export declare const PaginatedResponse_ContributorSummary_Schema: {
621
573
  readonly properties: {
622
- readonly id: {
574
+ readonly items: {
575
+ readonly items: {
576
+ readonly $ref: "#/components/schemas/ContributorSummary";
577
+ };
578
+ readonly type: "array";
579
+ readonly title: "Items";
580
+ };
581
+ readonly total: {
623
582
  readonly type: "integer";
624
- readonly title: "Id";
583
+ readonly title: "Total";
625
584
  };
626
- readonly name: {
627
- readonly type: "string";
628
- readonly title: "Name";
585
+ readonly limit: {
586
+ readonly type: "integer";
587
+ readonly title: "Limit";
629
588
  };
630
- readonly email_hash: {
631
- readonly type: "string";
632
- readonly title: "Email Hash";
589
+ readonly offset: {
590
+ readonly type: "integer";
591
+ readonly title: "Offset";
633
592
  };
634
- readonly number_of_commits: {
593
+ };
594
+ readonly type: "object";
595
+ readonly required: readonly ["items", "total", "limit", "offset"];
596
+ readonly title: "PaginatedResponse[ContributorSummary]";
597
+ };
598
+ export declare const PaginatedResponse_GitLogArtifactSummary_Schema: {
599
+ readonly properties: {
600
+ readonly items: {
601
+ readonly items: {
602
+ readonly $ref: "#/components/schemas/GitLogArtifactSummary";
603
+ };
604
+ readonly type: "array";
605
+ readonly title: "Items";
606
+ };
607
+ readonly total: {
635
608
  readonly type: "integer";
636
- readonly title: "Number Of Commits";
609
+ readonly title: "Total";
637
610
  };
638
- readonly first_commit_date: {
639
- readonly type: "string";
640
- readonly format: "date-time";
641
- readonly title: "First Commit Date";
611
+ readonly limit: {
612
+ readonly type: "integer";
613
+ readonly title: "Limit";
642
614
  };
643
- readonly last_commit_date: {
644
- readonly type: "string";
645
- readonly format: "date-time";
646
- readonly title: "Last Commit Date";
615
+ readonly offset: {
616
+ readonly type: "integer";
617
+ readonly title: "Offset";
647
618
  };
648
619
  };
649
620
  readonly type: "object";
650
- readonly required: readonly ["id", "name", "email_hash", "number_of_commits", "first_commit_date", "last_commit_date"];
651
- readonly title: "RepoContributorSummary";
652
- readonly description: "Contributor summary with commit counts for one repo.";
621
+ readonly required: readonly ["items", "total", "limit", "offset"];
622
+ readonly title: "PaginatedResponse[GitLogArtifactSummary]";
653
623
  };
654
- export declare const ProjectMetadataSchema: {
624
+ export declare const PaginatedResponse_GithubDependentObservationItem_Schema: {
655
625
  readonly properties: {
656
- readonly scf_submissions: {
626
+ readonly items: {
657
627
  readonly items: {
658
- readonly $ref: "#/components/schemas/ScfSubmission";
628
+ readonly $ref: "#/components/schemas/GithubDependentObservationItem";
659
629
  };
660
630
  readonly type: "array";
661
- readonly title: "Scf Submissions";
662
- readonly default: readonly [];
631
+ readonly title: "Items";
663
632
  };
664
- readonly description: {
665
- readonly anyOf: readonly [{
666
- readonly type: "string";
667
- }, {
668
- readonly type: "null";
669
- }];
670
- readonly title: "Description";
671
- };
672
- readonly technical_architecture: {
673
- readonly anyOf: readonly [{
674
- readonly type: "string";
675
- }, {
676
- readonly type: "null";
677
- }];
678
- readonly title: "Technical Architecture";
679
- };
680
- readonly scf_tranche_completion: {
681
- readonly anyOf: readonly [{
682
- readonly type: "string";
683
- }, {
684
- readonly type: "null";
685
- }];
686
- readonly title: "Scf Tranche Completion";
687
- };
688
- readonly website: {
689
- readonly anyOf: readonly [{
690
- readonly type: "string";
691
- }, {
692
- readonly type: "null";
693
- }];
694
- readonly title: "Website";
695
- };
696
- readonly x_profile: {
697
- readonly anyOf: readonly [{
698
- readonly type: "string";
699
- }, {
700
- readonly type: "null";
701
- }];
702
- readonly title: "X Profile";
703
- };
704
- readonly total_awarded_usd: {
705
- readonly anyOf: readonly [{
706
- readonly type: "integer";
707
- }, {
708
- readonly type: "number";
709
- }, {
710
- readonly type: "null";
711
- }];
712
- readonly title: "Total Awarded Usd";
713
- };
714
- readonly total_paid_usd: {
715
- readonly anyOf: readonly [{
716
- readonly type: "integer";
717
- }, {
718
- readonly type: "number";
719
- }, {
720
- readonly type: "null";
721
- }];
722
- readonly title: "Total Paid Usd";
723
- };
724
- readonly awarded_submissions_count: {
725
- readonly anyOf: readonly [{
726
- readonly type: "integer";
727
- }, {
728
- readonly type: "null";
729
- }];
730
- readonly title: "Awarded Submissions Count";
731
- };
732
- readonly open_source: {
733
- readonly anyOf: readonly [{
734
- readonly type: "boolean";
735
- }, {
736
- readonly type: "null";
737
- }];
738
- readonly title: "Open Source";
739
- };
740
- readonly socials: {
741
- readonly anyOf: readonly [{
742
- readonly items: {
743
- readonly additionalProperties: true;
744
- readonly type: "object";
745
- };
746
- readonly type: "array";
747
- }, {
748
- readonly type: "null";
749
- }];
750
- readonly title: "Socials";
751
- };
752
- readonly analytics: {
753
- readonly anyOf: readonly [{}, {
754
- readonly type: "null";
755
- }];
756
- readonly title: "Analytics";
757
- };
758
- readonly regions_of_operation: {
759
- readonly anyOf: readonly [{}, {
760
- readonly type: "null";
761
- }];
762
- readonly title: "Regions Of Operation";
763
- };
764
- };
765
- readonly additionalProperties: true;
766
- readonly type: "object";
767
- readonly title: "ProjectMetadata";
768
- readonly description: "Validates and normalises the ``project_metadata`` JSONB column on ``Project``.\n\nThe single write path (``_build_project_metadata`` in the OpenGrants crawler)\nguarantees consistent key names and types. ``extra = \"allow\"`` ensures that\nany future keys added by the crawler pass through without breaking the API.\nFuture keys must still be added in this model for clarity.";
769
- };
770
- export declare const ProjectDetailResponseSchema: {
771
- readonly properties: {
772
- readonly canonical_id: {
773
- readonly type: "string";
774
- readonly title: "Canonical Id";
775
- };
776
- readonly display_name: {
777
- readonly type: "string";
778
- readonly title: "Display Name";
779
- };
780
- readonly project_type: {
781
- readonly $ref: "#/components/schemas/ProjectType";
782
- };
783
- readonly activity_status: {
784
- readonly $ref: "#/components/schemas/ActivityStatus";
785
- };
786
- readonly category: {
787
- readonly anyOf: readonly [{
788
- readonly type: "string";
789
- }, {
790
- readonly type: "null";
791
- }];
792
- readonly title: "Category";
793
- };
794
- readonly git_owner_url: {
795
- readonly anyOf: readonly [{
796
- readonly type: "string";
797
- }, {
798
- readonly type: "null";
799
- }];
800
- readonly title: "Git Owner Url";
801
- };
802
- readonly pony_factor: {
803
- readonly anyOf: readonly [{
804
- readonly type: "integer";
805
- }, {
806
- readonly type: "null";
807
- }];
808
- readonly title: "Pony Factor";
809
- };
810
- readonly criticality_score: {
811
- readonly anyOf: readonly [{
812
- readonly type: "integer";
813
- }, {
814
- readonly type: "null";
815
- }];
816
- readonly title: "Criticality Score";
817
- };
818
- readonly adoption_score: {
819
- readonly anyOf: readonly [{
820
- readonly type: "number";
821
- }, {
822
- readonly type: "null";
823
- }];
824
- readonly title: "Adoption Score";
825
- };
826
- readonly updated_at: {
827
- readonly type: "string";
828
- readonly format: "date-time";
829
- readonly title: "Updated At";
830
- };
831
- readonly project_id: {
832
- readonly type: "integer";
833
- readonly title: "Project Id";
834
- };
835
- readonly active_contributors_30d: {
836
- readonly type: "integer";
837
- readonly title: "Active Contributors 30D";
838
- };
839
- readonly active_contributors_90d: {
840
- readonly type: "integer";
841
- readonly title: "Active Contributors 90D";
842
- };
843
- readonly metadata: {
844
- readonly $ref: "#/components/schemas/ProjectMetadata";
845
- };
846
- };
847
- readonly type: "object";
848
- readonly required: readonly ["canonical_id", "display_name", "project_type", "activity_status", "category", "git_owner_url", "pony_factor", "criticality_score", "adoption_score", "updated_at", "project_id", "active_contributors_30d", "active_contributors_90d", "metadata"];
849
- readonly title: "ProjectDetailResponse";
850
- readonly description: "Full project detail including contributor stats and metadata.\n\n``metadata`` is the normalised form of the ``project_metadata`` JSONB column.";
851
- };
852
- export declare const ProjectDependencySchema: {
853
- readonly properties: {
854
- readonly project: {
855
- readonly $ref: "#/components/schemas/ProjectSummary";
856
- };
857
- readonly edge_count: {
858
- readonly type: "integer";
859
- readonly title: "Edge Count";
860
- };
861
- };
862
- readonly type: "object";
863
- readonly required: readonly ["project", "edge_count"];
864
- readonly title: "ProjectDependency";
865
- readonly description: "A collapsed project-level dependency: aggregates repo-level edges\nbetween two projects into a single summary.";
866
- };
867
- export declare const ProjectContributorSummarySchema: {
868
- readonly properties: {
869
- readonly id: {
870
- readonly type: "integer";
871
- readonly title: "Id";
872
- };
873
- readonly name: {
874
- readonly type: "string";
875
- readonly title: "Name";
876
- };
877
- readonly email_hash: {
878
- readonly type: "string";
879
- readonly title: "Email Hash";
880
- };
881
- readonly total_commits_in_project: {
882
- readonly type: "integer";
883
- readonly title: "Total Commits In Project";
884
- };
885
- };
886
- readonly type: "object";
887
- readonly required: readonly ["id", "name", "email_hash", "total_commits_in_project"];
888
- readonly title: "ProjectContributorSummary";
889
- readonly description: "Contributor summary aggregated across all repos in a project.";
890
- };
891
- export declare const PaginatedResponse_RepoSummary_Schema: {
892
- readonly properties: {
893
- readonly items: {
894
- readonly items: {
895
- readonly $ref: "#/components/schemas/RepoSummary";
896
- };
897
- readonly type: "array";
898
- readonly title: "Items";
899
- };
900
- readonly total: {
901
- readonly type: "integer";
902
- readonly title: "Total";
633
+ readonly total: {
634
+ readonly type: "integer";
635
+ readonly title: "Total";
903
636
  };
904
637
  readonly limit: {
905
638
  readonly type: "integer";
@@ -912,13 +645,13 @@ export declare const PaginatedResponse_RepoSummary_Schema: {
912
645
  };
913
646
  readonly type: "object";
914
647
  readonly required: readonly ["items", "total", "limit", "offset"];
915
- readonly title: "PaginatedResponse[RepoSummary]";
648
+ readonly title: "PaginatedResponse[GithubDependentObservationItem]";
916
649
  };
917
- export declare const PaginatedResponse_RepoContributorSummary_Schema: {
650
+ export declare const PaginatedResponse_ProjectContributorSummary_Schema: {
918
651
  readonly properties: {
919
652
  readonly items: {
920
653
  readonly items: {
921
- readonly $ref: "#/components/schemas/RepoContributorSummary";
654
+ readonly $ref: "#/components/schemas/ProjectContributorSummary";
922
655
  };
923
656
  readonly type: "array";
924
657
  readonly title: "Items";
@@ -938,7 +671,7 @@ export declare const PaginatedResponse_RepoContributorSummary_Schema: {
938
671
  };
939
672
  readonly type: "object";
940
673
  readonly required: readonly ["items", "total", "limit", "offset"];
941
- readonly title: "PaginatedResponse[RepoContributorSummary]";
674
+ readonly title: "PaginatedResponse[ProjectContributorSummary]";
942
675
  };
943
676
  export declare const PaginatedResponse_ProjectSummary_Schema: {
944
677
  readonly properties: {
@@ -966,11 +699,11 @@ export declare const PaginatedResponse_ProjectSummary_Schema: {
966
699
  readonly required: readonly ["items", "total", "limit", "offset"];
967
700
  readonly title: "PaginatedResponse[ProjectSummary]";
968
701
  };
969
- export declare const PaginatedResponse_ProjectContributorSummary_Schema: {
702
+ export declare const PaginatedResponse_RepoContributorSummary_Schema: {
970
703
  readonly properties: {
971
704
  readonly items: {
972
705
  readonly items: {
973
- readonly $ref: "#/components/schemas/ProjectContributorSummary";
706
+ readonly $ref: "#/components/schemas/RepoContributorSummary";
974
707
  };
975
708
  readonly type: "array";
976
709
  readonly title: "Items";
@@ -990,13 +723,13 @@ export declare const PaginatedResponse_ProjectContributorSummary_Schema: {
990
723
  };
991
724
  readonly type: "object";
992
725
  readonly required: readonly ["items", "total", "limit", "offset"];
993
- readonly title: "PaginatedResponse[ProjectContributorSummary]";
726
+ readonly title: "PaginatedResponse[RepoContributorSummary]";
994
727
  };
995
- export declare const PaginatedResponse_GithubDependentObservationItem_Schema: {
728
+ export declare const PaginatedResponse_RepoSummary_Schema: {
996
729
  readonly properties: {
997
730
  readonly items: {
998
731
  readonly items: {
999
- readonly $ref: "#/components/schemas/GithubDependentObservationItem";
732
+ readonly $ref: "#/components/schemas/RepoSummary";
1000
733
  };
1001
734
  readonly type: "array";
1002
735
  readonly title: "Items";
@@ -1016,203 +749,514 @@ export declare const PaginatedResponse_GithubDependentObservationItem_Schema: {
1016
749
  };
1017
750
  readonly type: "object";
1018
751
  readonly required: readonly ["items", "total", "limit", "offset"];
1019
- readonly title: "PaginatedResponse[GithubDependentObservationItem]";
752
+ readonly title: "PaginatedResponse[RepoSummary]";
1020
753
  };
1021
- export declare const GithubDependentObservationItemSchema: {
754
+ export declare const ProjectContributorSummarySchema: {
1022
755
  readonly properties: {
1023
- readonly dependent_canonical_id: {
1024
- readonly type: "string";
1025
- readonly title: "Dependent Canonical Id";
756
+ readonly id: {
757
+ readonly type: "integer";
758
+ readonly title: "Id";
1026
759
  };
1027
- readonly dependent_repo_url: {
760
+ readonly name: {
1028
761
  readonly type: "string";
1029
- readonly title: "Dependent Repo Url";
762
+ readonly title: "Name";
1030
763
  };
1031
- readonly observed_owner: {
764
+ readonly email_hash: {
1032
765
  readonly type: "string";
1033
- readonly title: "Observed Owner";
766
+ readonly title: "Email Hash";
1034
767
  };
1035
- readonly observed_repo_name: {
768
+ readonly total_commits_in_project: {
769
+ readonly type: "integer";
770
+ readonly title: "Total Commits In Project";
771
+ };
772
+ };
773
+ readonly type: "object";
774
+ readonly required: readonly ["id", "name", "email_hash", "total_commits_in_project"];
775
+ readonly title: "ProjectContributorSummary";
776
+ readonly description: "Contributor summary aggregated across all repos in a project.";
777
+ };
778
+ export declare const ProjectDependencySchema: {
779
+ readonly properties: {
780
+ readonly project: {
781
+ readonly $ref: "#/components/schemas/ProjectSummary";
782
+ };
783
+ readonly edge_count: {
784
+ readonly type: "integer";
785
+ readonly title: "Edge Count";
786
+ };
787
+ };
788
+ readonly type: "object";
789
+ readonly required: readonly ["project", "edge_count"];
790
+ readonly title: "ProjectDependency";
791
+ readonly description: "A collapsed project-level dependency: aggregates repo-level edges\nbetween two projects into a single summary.";
792
+ };
793
+ export declare const ProjectDetailResponseSchema: {
794
+ readonly properties: {
795
+ readonly canonical_id: {
1036
796
  readonly type: "string";
1037
- readonly title: "Observed Repo Name";
797
+ readonly title: "Canonical Id";
1038
798
  };
1039
- readonly resolved_repo_canonical_id: {
799
+ readonly display_name: {
800
+ readonly type: "string";
801
+ readonly title: "Display Name";
802
+ };
803
+ readonly project_type: {
804
+ readonly $ref: "#/components/schemas/ProjectType";
805
+ };
806
+ readonly activity_status: {
807
+ readonly $ref: "#/components/schemas/ActivityStatus";
808
+ };
809
+ readonly category: {
1040
810
  readonly anyOf: readonly [{
1041
811
  readonly type: "string";
1042
812
  }, {
1043
813
  readonly type: "null";
1044
814
  }];
1045
- readonly title: "Resolved Repo Canonical Id";
815
+ readonly title: "Category";
1046
816
  };
1047
- readonly package_ids: {
817
+ readonly git_owner_url: {
1048
818
  readonly anyOf: readonly [{
1049
- readonly items: {
1050
- readonly type: "string";
1051
- };
1052
- readonly type: "array";
819
+ readonly type: "string";
1053
820
  }, {
1054
821
  readonly type: "null";
1055
822
  }];
1056
- readonly title: "Package Ids";
823
+ readonly title: "Git Owner Url";
1057
824
  };
1058
- readonly first_seen_at: {
1059
- readonly type: "string";
1060
- readonly format: "date-time";
1061
- readonly title: "First Seen At";
825
+ readonly pony_factor: {
826
+ readonly anyOf: readonly [{
827
+ readonly type: "integer";
828
+ }, {
829
+ readonly type: "null";
830
+ }];
831
+ readonly title: "Pony Factor";
1062
832
  };
1063
- readonly last_seen_at: {
833
+ readonly criticality_score: {
834
+ readonly anyOf: readonly [{
835
+ readonly type: "integer";
836
+ }, {
837
+ readonly type: "null";
838
+ }];
839
+ readonly title: "Criticality Score";
840
+ };
841
+ readonly adoption_score: {
842
+ readonly anyOf: readonly [{
843
+ readonly type: "number";
844
+ }, {
845
+ readonly type: "null";
846
+ }];
847
+ readonly title: "Adoption Score";
848
+ };
849
+ readonly updated_at: {
1064
850
  readonly type: "string";
1065
851
  readonly format: "date-time";
1066
- readonly title: "Last Seen At";
852
+ readonly title: "Updated At";
853
+ };
854
+ readonly project_id: {
855
+ readonly type: "integer";
856
+ readonly title: "Project Id";
857
+ };
858
+ readonly active_contributors_30d: {
859
+ readonly type: "integer";
860
+ readonly title: "Active Contributors 30D";
861
+ };
862
+ readonly active_contributors_90d: {
863
+ readonly type: "integer";
864
+ readonly title: "Active Contributors 90D";
865
+ };
866
+ readonly metadata: {
867
+ readonly $ref: "#/components/schemas/ProjectMetadata";
1067
868
  };
1068
869
  };
1069
870
  readonly type: "object";
1070
- readonly required: readonly ["dependent_canonical_id", "dependent_repo_url", "observed_owner", "observed_repo_name", "first_seen_at", "last_seen_at"];
1071
- readonly title: "GithubDependentObservationItem";
1072
- readonly description: "One active GitHub dependent observation for a source repo.";
871
+ readonly required: readonly ["canonical_id", "display_name", "project_type", "activity_status", "category", "git_owner_url", "pony_factor", "criticality_score", "adoption_score", "updated_at", "project_id", "active_contributors_30d", "active_contributors_90d", "metadata"];
872
+ readonly title: "ProjectDetailResponse";
873
+ readonly description: "Full project detail including contributor stats and metadata.\n\n``metadata`` is the normalised form of the ``project_metadata`` JSONB column.";
1073
874
  };
1074
- export declare const PaginatedResponse_GitLogArtifactSummary_Schema: {
875
+ export declare const ProjectMetadataSchema: {
1075
876
  readonly properties: {
1076
- readonly items: {
877
+ readonly scf_submissions: {
1077
878
  readonly items: {
1078
- readonly $ref: "#/components/schemas/GitLogArtifactSummary";
879
+ readonly $ref: "#/components/schemas/ScfSubmission";
1079
880
  };
1080
881
  readonly type: "array";
1081
- readonly title: "Items";
882
+ readonly title: "Scf Submissions";
883
+ readonly default: readonly [];
1082
884
  };
1083
- readonly total: {
1084
- readonly type: "integer";
1085
- readonly title: "Total";
885
+ readonly description: {
886
+ readonly anyOf: readonly [{
887
+ readonly type: "string";
888
+ }, {
889
+ readonly type: "null";
890
+ }];
891
+ readonly title: "Description";
1086
892
  };
1087
- readonly limit: {
1088
- readonly type: "integer";
1089
- readonly title: "Limit";
893
+ readonly technical_architecture: {
894
+ readonly anyOf: readonly [{
895
+ readonly type: "string";
896
+ }, {
897
+ readonly type: "null";
898
+ }];
899
+ readonly title: "Technical Architecture";
1090
900
  };
1091
- readonly offset: {
1092
- readonly type: "integer";
1093
- readonly title: "Offset";
901
+ readonly scf_tranche_completion: {
902
+ readonly anyOf: readonly [{
903
+ readonly type: "string";
904
+ }, {
905
+ readonly type: "null";
906
+ }];
907
+ readonly title: "Scf Tranche Completion";
908
+ };
909
+ readonly website: {
910
+ readonly anyOf: readonly [{
911
+ readonly type: "string";
912
+ }, {
913
+ readonly type: "null";
914
+ }];
915
+ readonly title: "Website";
916
+ };
917
+ readonly x_profile: {
918
+ readonly anyOf: readonly [{
919
+ readonly type: "string";
920
+ }, {
921
+ readonly type: "null";
922
+ }];
923
+ readonly title: "X Profile";
924
+ };
925
+ readonly total_awarded_usd: {
926
+ readonly anyOf: readonly [{
927
+ readonly type: "integer";
928
+ }, {
929
+ readonly type: "number";
930
+ }, {
931
+ readonly type: "null";
932
+ }];
933
+ readonly title: "Total Awarded Usd";
934
+ };
935
+ readonly total_paid_usd: {
936
+ readonly anyOf: readonly [{
937
+ readonly type: "integer";
938
+ }, {
939
+ readonly type: "number";
940
+ }, {
941
+ readonly type: "null";
942
+ }];
943
+ readonly title: "Total Paid Usd";
944
+ };
945
+ readonly awarded_submissions_count: {
946
+ readonly anyOf: readonly [{
947
+ readonly type: "integer";
948
+ }, {
949
+ readonly type: "null";
950
+ }];
951
+ readonly title: "Awarded Submissions Count";
952
+ };
953
+ readonly open_source: {
954
+ readonly anyOf: readonly [{
955
+ readonly type: "boolean";
956
+ }, {
957
+ readonly type: "null";
958
+ }];
959
+ readonly title: "Open Source";
960
+ };
961
+ readonly socials: {
962
+ readonly anyOf: readonly [{
963
+ readonly items: {
964
+ readonly additionalProperties: true;
965
+ readonly type: "object";
966
+ };
967
+ readonly type: "array";
968
+ }, {
969
+ readonly type: "null";
970
+ }];
971
+ readonly title: "Socials";
972
+ };
973
+ readonly analytics: {
974
+ readonly anyOf: readonly [{}, {
975
+ readonly type: "null";
976
+ }];
977
+ readonly title: "Analytics";
978
+ };
979
+ readonly regions_of_operation: {
980
+ readonly anyOf: readonly [{}, {
981
+ readonly type: "null";
982
+ }];
983
+ readonly title: "Regions Of Operation";
1094
984
  };
1095
985
  };
986
+ readonly additionalProperties: true;
1096
987
  readonly type: "object";
1097
- readonly required: readonly ["items", "total", "limit", "offset"];
1098
- readonly title: "PaginatedResponse[GitLogArtifactSummary]";
988
+ readonly title: "ProjectMetadata";
989
+ readonly description: "Validates and normalises the ``project_metadata`` JSONB column on ``Project``.\n\nThe single write path (``_build_project_metadata`` in the OpenGrants crawler)\nguarantees consistent key names and types. ``extra = \"allow\"`` ensures that\nany future keys added by the crawler pass through without breaking the API.\nFuture keys must still be added in this model for clarity.";
1099
990
  };
1100
- export declare const GitLogArtifactSummarySchema: {
991
+ export declare const ProjectSummarySchema: {
992
+ readonly properties: {
993
+ readonly canonical_id: {
994
+ readonly type: "string";
995
+ readonly title: "Canonical Id";
996
+ };
997
+ readonly display_name: {
998
+ readonly type: "string";
999
+ readonly title: "Display Name";
1000
+ };
1001
+ readonly project_type: {
1002
+ readonly $ref: "#/components/schemas/ProjectType";
1003
+ };
1004
+ readonly activity_status: {
1005
+ readonly $ref: "#/components/schemas/ActivityStatus";
1006
+ };
1007
+ readonly category: {
1008
+ readonly anyOf: readonly [{
1009
+ readonly type: "string";
1010
+ }, {
1011
+ readonly type: "null";
1012
+ }];
1013
+ readonly title: "Category";
1014
+ };
1015
+ readonly git_owner_url: {
1016
+ readonly anyOf: readonly [{
1017
+ readonly type: "string";
1018
+ }, {
1019
+ readonly type: "null";
1020
+ }];
1021
+ readonly title: "Git Owner Url";
1022
+ };
1023
+ readonly pony_factor: {
1024
+ readonly anyOf: readonly [{
1025
+ readonly type: "integer";
1026
+ }, {
1027
+ readonly type: "null";
1028
+ }];
1029
+ readonly title: "Pony Factor";
1030
+ };
1031
+ readonly criticality_score: {
1032
+ readonly anyOf: readonly [{
1033
+ readonly type: "integer";
1034
+ }, {
1035
+ readonly type: "null";
1036
+ }];
1037
+ readonly title: "Criticality Score";
1038
+ };
1039
+ readonly adoption_score: {
1040
+ readonly anyOf: readonly [{
1041
+ readonly type: "number";
1042
+ }, {
1043
+ readonly type: "null";
1044
+ }];
1045
+ readonly title: "Adoption Score";
1046
+ };
1047
+ readonly updated_at: {
1048
+ readonly type: "string";
1049
+ readonly format: "date-time";
1050
+ readonly title: "Updated At";
1051
+ };
1052
+ };
1053
+ readonly type: "object";
1054
+ readonly required: readonly ["canonical_id", "display_name", "project_type", "activity_status", "category", "git_owner_url", "pony_factor", "criticality_score", "adoption_score", "updated_at"];
1055
+ readonly title: "ProjectSummary";
1056
+ readonly description: "Compact project representation used in list endpoints and as an embedded\nreference in repo detail responses.";
1057
+ };
1058
+ export declare const ProjectTypeSchema: {
1059
+ readonly type: "string";
1060
+ readonly enum: readonly ["public-good", "scf-project"];
1061
+ readonly title: "ProjectType";
1062
+ readonly description: "Classification of a Project within the PG Atlas universe.";
1063
+ };
1064
+ export declare const RepoContributorSummarySchema: {
1101
1065
  readonly properties: {
1102
1066
  readonly id: {
1103
1067
  readonly type: "integer";
1104
1068
  readonly title: "Id";
1105
1069
  };
1106
- readonly repo_id: {
1070
+ readonly name: {
1071
+ readonly type: "string";
1072
+ readonly title: "Name";
1073
+ };
1074
+ readonly email_hash: {
1075
+ readonly type: "string";
1076
+ readonly title: "Email Hash";
1077
+ };
1078
+ readonly number_of_commits: {
1107
1079
  readonly type: "integer";
1108
- readonly title: "Repo Id";
1080
+ readonly title: "Number Of Commits";
1109
1081
  };
1110
- readonly repo_canonical_id: {
1082
+ readonly first_commit_date: {
1111
1083
  readonly type: "string";
1112
- readonly title: "Repo Canonical Id";
1084
+ readonly format: "date-time";
1085
+ readonly title: "First Commit Date";
1086
+ };
1087
+ readonly last_commit_date: {
1088
+ readonly type: "string";
1089
+ readonly format: "date-time";
1090
+ readonly title: "Last Commit Date";
1091
+ };
1092
+ };
1093
+ readonly type: "object";
1094
+ readonly required: readonly ["id", "name", "email_hash", "number_of_commits", "first_commit_date", "last_commit_date"];
1095
+ readonly title: "RepoContributorSummary";
1096
+ readonly description: "Contributor summary with commit counts for one repo.";
1097
+ };
1098
+ export declare const RepoDependencySchema: {
1099
+ readonly properties: {
1100
+ readonly canonical_id: {
1101
+ readonly type: "string";
1102
+ readonly title: "Canonical Id";
1103
+ };
1104
+ readonly display_name: {
1105
+ readonly type: "string";
1106
+ readonly title: "Display Name";
1107
+ };
1108
+ readonly vertex_type: {
1109
+ readonly $ref: "#/components/schemas/RepoVertexType";
1110
+ };
1111
+ readonly version_range: {
1112
+ readonly anyOf: readonly [{
1113
+ readonly type: "string";
1114
+ }, {
1115
+ readonly type: "null";
1116
+ }];
1117
+ readonly title: "Version Range";
1118
+ };
1119
+ readonly confidence: {
1120
+ readonly $ref: "#/components/schemas/EdgeConfidence";
1121
+ };
1122
+ };
1123
+ readonly type: "object";
1124
+ readonly required: readonly ["canonical_id", "display_name", "vertex_type", "version_range", "confidence"];
1125
+ readonly title: "RepoDependency";
1126
+ readonly description: "A single dependency or reverse-dependency edge from a repo.\n\n``vertex_type`` tells the frontend whether the target is an in-ecosystem\n``Repo`` or an ``ExternalRepo``.";
1127
+ };
1128
+ export declare const RepoDetailResponseSchema: {
1129
+ readonly properties: {
1130
+ readonly canonical_id: {
1131
+ readonly type: "string";
1132
+ readonly title: "Canonical Id";
1133
+ };
1134
+ readonly display_name: {
1135
+ readonly type: "string";
1136
+ readonly title: "Display Name";
1137
+ };
1138
+ readonly visibility: {
1139
+ readonly $ref: "#/components/schemas/Visibility";
1113
1140
  };
1114
- readonly repo_display_name: {
1141
+ readonly latest_version: {
1115
1142
  readonly type: "string";
1116
- readonly title: "Repo Display Name";
1143
+ readonly title: "Latest Version";
1117
1144
  };
1118
- readonly artifact_path: {
1145
+ readonly latest_commit_date: {
1119
1146
  readonly anyOf: readonly [{
1120
1147
  readonly type: "string";
1148
+ readonly format: "date-time";
1121
1149
  }, {
1122
1150
  readonly type: "null";
1123
1151
  }];
1124
- readonly title: "Artifact Path";
1125
- };
1126
- readonly status: {
1127
- readonly $ref: "#/components/schemas/SubmissionStatus";
1152
+ readonly title: "Latest Commit Date";
1128
1153
  };
1129
- readonly error_detail: {
1154
+ readonly repo_url: {
1130
1155
  readonly anyOf: readonly [{
1131
1156
  readonly type: "string";
1132
1157
  }, {
1133
1158
  readonly type: "null";
1134
1159
  }];
1135
- readonly title: "Error Detail";
1136
- };
1137
- readonly since_months: {
1138
- readonly type: "integer";
1139
- readonly title: "Since Months";
1140
- };
1141
- readonly submitted_at: {
1142
- readonly type: "string";
1143
- readonly format: "date-time";
1144
- readonly title: "Submitted At";
1160
+ readonly title: "Repo Url";
1145
1161
  };
1146
- readonly processed_at: {
1162
+ readonly project_id: {
1147
1163
  readonly anyOf: readonly [{
1148
- readonly type: "string";
1149
- readonly format: "date-time";
1164
+ readonly type: "integer";
1150
1165
  }, {
1151
1166
  readonly type: "null";
1152
1167
  }];
1153
- readonly title: "Processed At";
1168
+ readonly title: "Project Id";
1154
1169
  };
1155
- };
1156
- readonly type: "object";
1157
- readonly required: readonly ["id", "repo_id", "repo_canonical_id", "repo_display_name", "artifact_path", "status", "error_detail", "since_months", "submitted_at", "processed_at"];
1158
- readonly title: "GitLogArtifactSummary";
1159
- readonly description: "Compact gitlog artifact audit record for list endpoints.";
1160
- };
1161
- export declare const PaginatedResponse_ContributorSummary_Schema: {
1162
- readonly properties: {
1163
- readonly items: {
1164
- readonly items: {
1165
- readonly $ref: "#/components/schemas/ContributorSummary";
1166
- };
1167
- readonly type: "array";
1168
- readonly title: "Items";
1170
+ readonly pony_factor: {
1171
+ readonly anyOf: readonly [{
1172
+ readonly type: "integer";
1173
+ }, {
1174
+ readonly type: "null";
1175
+ }];
1176
+ readonly title: "Pony Factor";
1169
1177
  };
1170
- readonly total: {
1171
- readonly type: "integer";
1172
- readonly title: "Total";
1178
+ readonly criticality_score: {
1179
+ readonly anyOf: readonly [{
1180
+ readonly type: "integer";
1181
+ }, {
1182
+ readonly type: "null";
1183
+ }];
1184
+ readonly title: "Criticality Score";
1173
1185
  };
1174
- readonly limit: {
1175
- readonly type: "integer";
1176
- readonly title: "Limit";
1186
+ readonly adoption_downloads: {
1187
+ readonly anyOf: readonly [{
1188
+ readonly type: "integer";
1189
+ }, {
1190
+ readonly type: "null";
1191
+ }];
1192
+ readonly title: "Adoption Downloads";
1177
1193
  };
1178
- readonly offset: {
1179
- readonly type: "integer";
1180
- readonly title: "Offset";
1194
+ readonly adoption_stars: {
1195
+ readonly anyOf: readonly [{
1196
+ readonly type: "integer";
1197
+ }, {
1198
+ readonly type: "null";
1199
+ }];
1200
+ readonly title: "Adoption Stars";
1181
1201
  };
1182
- };
1183
- readonly type: "object";
1184
- readonly required: readonly ["items", "total", "limit", "offset"];
1185
- readonly title: "PaginatedResponse[ContributorSummary]";
1186
- };
1187
- export declare const MetadataResponseSchema: {
1188
- readonly properties: {
1189
- readonly total_projects: {
1190
- readonly type: "integer";
1191
- readonly title: "Total Projects";
1202
+ readonly adoption_forks: {
1203
+ readonly anyOf: readonly [{
1204
+ readonly type: "integer";
1205
+ }, {
1206
+ readonly type: "null";
1207
+ }];
1208
+ readonly title: "Adoption Forks";
1192
1209
  };
1193
- readonly active_projects: {
1194
- readonly type: "integer";
1195
- readonly title: "Active Projects";
1210
+ readonly updated_at: {
1211
+ readonly type: "string";
1212
+ readonly format: "date-time";
1213
+ readonly title: "Updated At";
1196
1214
  };
1197
- readonly total_repos: {
1198
- readonly type: "integer";
1199
- readonly title: "Total Repos";
1215
+ readonly releases: {
1216
+ readonly anyOf: readonly [{
1217
+ readonly items: {
1218
+ readonly properties: {
1219
+ readonly purl: {
1220
+ readonly type: "string";
1221
+ };
1222
+ readonly version: {
1223
+ readonly type: "string";
1224
+ };
1225
+ readonly release_date: {
1226
+ readonly type: "string";
1227
+ readonly default: "";
1228
+ };
1229
+ };
1230
+ readonly type: "object";
1231
+ readonly required: readonly ["purl", "version"];
1232
+ readonly title: "Release";
1233
+ readonly description: "One normalized release record keyed by package PURL + version.";
1234
+ };
1235
+ readonly type: "array";
1236
+ }, {
1237
+ readonly type: "null";
1238
+ }];
1239
+ readonly title: "Releases";
1200
1240
  };
1201
- readonly active_repos_90d: {
1202
- readonly type: "integer";
1203
- readonly title: "Active Repos 90D";
1241
+ readonly parent_project: {
1242
+ readonly anyOf: readonly [{
1243
+ readonly $ref: "#/components/schemas/ProjectSummary";
1244
+ }, {
1245
+ readonly type: "null";
1246
+ }];
1204
1247
  };
1205
- readonly total_external_repos: {
1206
- readonly type: "integer";
1207
- readonly title: "Total External Repos";
1248
+ readonly contributors: {
1249
+ readonly items: {
1250
+ readonly $ref: "#/components/schemas/ContributorSummary";
1251
+ };
1252
+ readonly type: "array";
1253
+ readonly title: "Contributors";
1208
1254
  };
1209
- readonly total_dependency_edges: {
1210
- readonly type: "integer";
1211
- readonly title: "Total Dependency Edges";
1255
+ readonly outgoing_dep_counts: {
1256
+ readonly $ref: "#/components/schemas/DepCounts";
1212
1257
  };
1213
- readonly total_contributor_edges: {
1214
- readonly type: "integer";
1215
- readonly title: "Total Contributor Edges";
1258
+ readonly incoming_dep_counts: {
1259
+ readonly $ref: "#/components/schemas/DepCounts";
1216
1260
  };
1217
1261
  readonly active_contributors_30d: {
1218
1262
  readonly type: "integer";
@@ -1222,205 +1266,151 @@ export declare const MetadataResponseSchema: {
1222
1266
  readonly type: "integer";
1223
1267
  readonly title: "Active Contributors 90D";
1224
1268
  };
1225
- readonly last_updated: {
1226
- readonly anyOf: readonly [{
1227
- readonly type: "string";
1228
- readonly format: "date-time";
1229
- }, {
1230
- readonly type: "null";
1231
- }];
1232
- readonly title: "Last Updated";
1233
- };
1234
1269
  };
1235
1270
  readonly type: "object";
1236
- readonly required: readonly ["total_projects", "active_projects", "total_repos", "active_repos_90d", "total_external_repos", "total_dependency_edges", "total_contributor_edges", "active_contributors_30d", "active_contributors_90d", "last_updated"];
1237
- readonly title: "MetadataResponse";
1238
- readonly description: "Ecosystem-wide summary statistics returned by ``GET /metadata``.";
1271
+ readonly required: readonly ["canonical_id", "display_name", "visibility", "latest_version", "latest_commit_date", "repo_url", "project_id", "pony_factor", "criticality_score", "adoption_downloads", "adoption_stars", "adoption_forks", "updated_at", "releases", "parent_project", "contributors", "outgoing_dep_counts", "incoming_dep_counts", "active_contributors_30d", "active_contributors_90d"];
1272
+ readonly title: "RepoDetailResponse";
1273
+ readonly description: "Full repo detail with parent project, contributors, releases, dependency counts,\nand active contributor stats.";
1239
1274
  };
1240
- export declare const HealthResponseSchema: {
1275
+ export declare const RepoSummarySchema: {
1241
1276
  readonly properties: {
1242
- readonly status: {
1277
+ readonly canonical_id: {
1243
1278
  readonly type: "string";
1244
- readonly enum: readonly ["live", "ready"];
1245
- readonly title: "Status";
1279
+ readonly title: "Canonical Id";
1246
1280
  };
1247
- readonly version: {
1281
+ readonly display_name: {
1248
1282
  readonly type: "string";
1249
- readonly title: "Version";
1250
- };
1251
- readonly components: {
1252
- readonly $ref: "#/components/schemas/HealthComponents";
1283
+ readonly title: "Display Name";
1253
1284
  };
1254
- };
1255
- readonly type: "object";
1256
- readonly required: readonly ["status", "version", "components"];
1257
- readonly title: "HealthResponse";
1258
- readonly description: "Response body for GET /health.";
1259
- };
1260
- export declare const HealthComponentsSchema: {
1261
- readonly properties: {
1262
- readonly artifact_store: {
1263
- readonly type: "string";
1264
- readonly enum: readonly ["local", "IPFS"];
1265
- readonly title: "Artifact Store";
1285
+ readonly visibility: {
1286
+ readonly $ref: "#/components/schemas/Visibility";
1266
1287
  };
1267
- readonly database: {
1288
+ readonly latest_version: {
1268
1289
  readonly type: "string";
1269
- readonly enum: readonly ["ready", "not-configured"];
1270
- readonly title: "Database";
1271
- };
1272
- readonly schema_version: {
1273
- readonly anyOf: readonly [{
1274
- readonly type: "string";
1275
- }, {
1276
- readonly type: "null";
1277
- }];
1278
- readonly title: "Schema Version";
1279
- };
1280
- };
1281
- readonly type: "object";
1282
- readonly required: readonly ["artifact_store", "database", "schema_version"];
1283
- readonly title: "HealthComponents";
1284
- readonly description: "Component-level readiness details for GET /health.";
1285
- };
1286
- export declare const HTTPValidationErrorSchema: {
1287
- readonly properties: {
1288
- readonly detail: {
1289
- readonly items: {
1290
- readonly $ref: "#/components/schemas/ValidationError";
1291
- };
1292
- readonly type: "array";
1293
- readonly title: "Detail";
1290
+ readonly title: "Latest Version";
1294
1291
  };
1295
- };
1296
- readonly type: "object";
1297
- readonly title: "HTTPValidationError";
1298
- };
1299
- export declare const GithubDependentsSummarySchema: {
1300
- readonly properties: {
1301
- readonly latest_attempt_at: {
1292
+ readonly latest_commit_date: {
1302
1293
  readonly anyOf: readonly [{
1303
1294
  readonly type: "string";
1304
1295
  readonly format: "date-time";
1305
1296
  }, {
1306
1297
  readonly type: "null";
1307
1298
  }];
1308
- readonly title: "Latest Attempt At";
1309
- };
1310
- readonly latest_attempt_status: {
1311
- readonly anyOf: readonly [{
1312
- readonly type: "string";
1313
- }, {
1314
- readonly type: "null";
1315
- }];
1316
- readonly title: "Latest Attempt Status";
1299
+ readonly title: "Latest Commit Date";
1317
1300
  };
1318
- readonly latest_attempt_listing_incomplete_reason: {
1301
+ readonly repo_url: {
1319
1302
  readonly anyOf: readonly [{
1320
1303
  readonly type: "string";
1321
1304
  }, {
1322
1305
  readonly type: "null";
1323
1306
  }];
1324
- readonly title: "Latest Attempt Listing Incomplete Reason";
1307
+ readonly title: "Repo Url";
1325
1308
  };
1326
- readonly latest_attempt_counts_incomplete_reason: {
1309
+ readonly project_id: {
1327
1310
  readonly anyOf: readonly [{
1328
- readonly type: "string";
1311
+ readonly type: "integer";
1329
1312
  }, {
1330
1313
  readonly type: "null";
1331
1314
  }];
1332
- readonly title: "Latest Attempt Counts Incomplete Reason";
1315
+ readonly title: "Project Id";
1333
1316
  };
1334
- readonly observations_as_of: {
1317
+ readonly pony_factor: {
1335
1318
  readonly anyOf: readonly [{
1336
- readonly type: "string";
1337
- readonly format: "date-time";
1319
+ readonly type: "integer";
1338
1320
  }, {
1339
1321
  readonly type: "null";
1340
1322
  }];
1341
- readonly title: "Observations As Of";
1323
+ readonly title: "Pony Factor";
1342
1324
  };
1343
- readonly reported_counts_as_of: {
1325
+ readonly criticality_score: {
1344
1326
  readonly anyOf: readonly [{
1345
- readonly type: "string";
1346
- readonly format: "date-time";
1327
+ readonly type: "integer";
1347
1328
  }, {
1348
1329
  readonly type: "null";
1349
1330
  }];
1350
- readonly title: "Reported Counts As Of";
1331
+ readonly title: "Criticality Score";
1351
1332
  };
1352
- readonly repos_total_reported: {
1333
+ readonly adoption_downloads: {
1353
1334
  readonly anyOf: readonly [{
1354
1335
  readonly type: "integer";
1355
1336
  }, {
1356
1337
  readonly type: "null";
1357
1338
  }];
1358
- readonly title: "Repos Total Reported";
1339
+ readonly title: "Adoption Downloads";
1359
1340
  };
1360
- readonly packages_total_reported: {
1341
+ readonly adoption_stars: {
1361
1342
  readonly anyOf: readonly [{
1362
1343
  readonly type: "integer";
1363
1344
  }, {
1364
1345
  readonly type: "null";
1365
1346
  }];
1366
- readonly title: "Packages Total Reported";
1347
+ readonly title: "Adoption Stars";
1367
1348
  };
1368
- readonly packages_scanned: {
1349
+ readonly adoption_forks: {
1369
1350
  readonly anyOf: readonly [{
1370
1351
  readonly type: "integer";
1371
1352
  }, {
1372
1353
  readonly type: "null";
1373
1354
  }];
1374
- readonly title: "Packages Scanned";
1355
+ readonly title: "Adoption Forks";
1375
1356
  };
1376
- readonly active_observations: {
1377
- readonly type: "integer";
1378
- readonly title: "Active Observations";
1379
- readonly default: 0;
1357
+ readonly updated_at: {
1358
+ readonly type: "string";
1359
+ readonly format: "date-time";
1360
+ readonly title: "Updated At";
1380
1361
  };
1381
1362
  };
1382
1363
  readonly type: "object";
1383
- readonly title: "GithubDependentsSummary";
1384
- readonly description: "Freshness and completeness summary for a source repo's observations.\n\n``observations_as_of`` is the finish time of the latest applied\nlisting-complete run; ``reported_counts_as_of`` is the finish time of the\nlatest applied counts-complete run. The two can point to different runs,\nso the reported totals always carry their own timestamp. Reported header\ntotals may exceed the enumerable public entries and, for multi-package\nrepositories, are per-package sums that can double count a dependent\nusing several packages.";
1364
+ readonly required: readonly ["canonical_id", "display_name", "visibility", "latest_version", "latest_commit_date", "repo_url", "project_id", "pony_factor", "criticality_score", "adoption_downloads", "adoption_stars", "adoption_forks", "updated_at"];
1365
+ readonly title: "RepoSummary";
1366
+ readonly description: "Compact repo representation used in list endpoints and as an embedded\nreference in project detail responses.";
1385
1367
  };
1386
- export declare const GithubDependentsResponseSchema: {
1368
+ export declare const RepoVertexTypeSchema: {
1369
+ readonly type: "string";
1370
+ readonly enum: readonly ["repo", "external-repo", "redirect"];
1371
+ readonly title: "RepoVertexType";
1372
+ readonly description: "Discriminator values for the RepoVertex joined-table-inheritance hierarchy.";
1373
+ };
1374
+ export declare const SbomAcceptedResponseSchema: {
1387
1375
  readonly properties: {
1388
- readonly summary: {
1389
- readonly $ref: "#/components/schemas/GithubDependentsSummary";
1376
+ readonly message: {
1377
+ readonly type: "string";
1378
+ readonly title: "Message";
1390
1379
  };
1391
- readonly observations: {
1392
- readonly $ref: "#/components/schemas/PaginatedResponse_GithubDependentObservationItem_";
1380
+ readonly repository: {
1381
+ readonly type: "string";
1382
+ readonly title: "Repository";
1383
+ };
1384
+ readonly package_count: {
1385
+ readonly type: "integer";
1386
+ readonly title: "Package Count";
1393
1387
  };
1394
1388
  };
1395
1389
  readonly type: "object";
1396
- readonly required: readonly ["summary", "observations"];
1397
- readonly title: "GithubDependentsResponse";
1398
- readonly description: "Summary plus paginated active observations for one source repo.";
1390
+ readonly required: readonly ["message", "repository", "package_count"];
1391
+ readonly title: "SbomAcceptedResponse";
1392
+ readonly description: "Response body returned on successful SBOM submission (202 Accepted).";
1399
1393
  };
1400
- export declare const GitLogArtifactDetailResponseSchema: {
1394
+ export declare const SbomSubmissionDetailResponseSchema: {
1401
1395
  readonly properties: {
1402
1396
  readonly id: {
1403
1397
  readonly type: "integer";
1404
1398
  readonly title: "Id";
1405
1399
  };
1406
- readonly repo_id: {
1407
- readonly type: "integer";
1408
- readonly title: "Repo Id";
1400
+ readonly repository_claim: {
1401
+ readonly type: "string";
1402
+ readonly title: "Repository Claim";
1409
1403
  };
1410
- readonly repo_canonical_id: {
1404
+ readonly actor_claim: {
1411
1405
  readonly type: "string";
1412
- readonly title: "Repo Canonical Id";
1406
+ readonly title: "Actor Claim";
1413
1407
  };
1414
- readonly repo_display_name: {
1408
+ readonly sbom_content_hash: {
1415
1409
  readonly type: "string";
1416
- readonly title: "Repo Display Name";
1410
+ readonly title: "Sbom Content Hash";
1417
1411
  };
1418
1412
  readonly artifact_path: {
1419
- readonly anyOf: readonly [{
1420
- readonly type: "string";
1421
- }, {
1422
- readonly type: "null";
1423
- }];
1413
+ readonly type: "string";
1424
1414
  readonly title: "Artifact Path";
1425
1415
  };
1426
1416
  readonly status: {
@@ -1434,10 +1424,6 @@ export declare const GitLogArtifactDetailResponseSchema: {
1434
1424
  }];
1435
1425
  readonly title: "Error Detail";
1436
1426
  };
1437
- readonly since_months: {
1438
- readonly type: "integer";
1439
- readonly title: "Since Months";
1440
- };
1441
1427
  readonly submitted_at: {
1442
1428
  readonly type: "string";
1443
1429
  readonly format: "date-time";
@@ -1462,98 +1448,148 @@ export declare const GitLogArtifactDetailResponseSchema: {
1462
1448
  };
1463
1449
  };
1464
1450
  readonly type: "object";
1465
- readonly required: readonly ["id", "repo_id", "repo_canonical_id", "repo_display_name", "artifact_path", "status", "error_detail", "since_months", "submitted_at", "processed_at"];
1466
- readonly title: "GitLogArtifactDetailResponse";
1467
- readonly description: "Full gitlog artifact audit record including raw artifact content.";
1451
+ readonly required: readonly ["id", "repository_claim", "actor_claim", "sbom_content_hash", "artifact_path", "status", "error_detail", "submitted_at", "processed_at"];
1452
+ readonly title: "SbomSubmissionDetailResponse";
1453
+ readonly description: "Extended SBOM submission record with the raw artifact content.\n\nReturned by the detail endpoint. ``raw_artifact`` contains the full JSON\ntext of the stored SBOM, or ``None`` if the artifact file is missing from\nthe store.";
1468
1454
  };
1469
- export declare const ContributorDetailResponseSchema: {
1455
+ export declare const SbomSubmissionListResponseSchema: {
1456
+ readonly properties: {
1457
+ readonly items: {
1458
+ readonly items: {
1459
+ readonly $ref: "#/components/schemas/SbomSubmissionResponse";
1460
+ };
1461
+ readonly type: "array";
1462
+ readonly title: "Items";
1463
+ };
1464
+ readonly total: {
1465
+ readonly type: "integer";
1466
+ readonly title: "Total";
1467
+ };
1468
+ readonly limit: {
1469
+ readonly type: "integer";
1470
+ readonly title: "Limit";
1471
+ };
1472
+ readonly offset: {
1473
+ readonly type: "integer";
1474
+ readonly title: "Offset";
1475
+ };
1476
+ };
1477
+ readonly type: "object";
1478
+ readonly required: readonly ["items", "total", "limit", "offset"];
1479
+ readonly title: "SbomSubmissionListResponse";
1480
+ readonly description: "Paginated list of SBOM submission records.\n\nReturned by the list endpoint with ``total`` reflecting the count after\nany ``repository`` filter has been applied.";
1481
+ };
1482
+ export declare const SbomSubmissionResponseSchema: {
1470
1483
  readonly properties: {
1471
1484
  readonly id: {
1472
1485
  readonly type: "integer";
1473
1486
  readonly title: "Id";
1474
1487
  };
1475
- readonly name: {
1488
+ readonly repository_claim: {
1476
1489
  readonly type: "string";
1477
- readonly title: "Name";
1490
+ readonly title: "Repository Claim";
1478
1491
  };
1479
- readonly email_hash: {
1492
+ readonly actor_claim: {
1480
1493
  readonly type: "string";
1481
- readonly title: "Email Hash";
1494
+ readonly title: "Actor Claim";
1482
1495
  };
1483
- readonly total_repos: {
1484
- readonly type: "integer";
1485
- readonly title: "Total Repos";
1496
+ readonly sbom_content_hash: {
1497
+ readonly type: "string";
1498
+ readonly title: "Sbom Content Hash";
1486
1499
  };
1487
- readonly total_commits: {
1488
- readonly type: "integer";
1489
- readonly title: "Total Commits";
1500
+ readonly artifact_path: {
1501
+ readonly type: "string";
1502
+ readonly title: "Artifact Path";
1490
1503
  };
1491
- readonly first_contribution: {
1504
+ readonly status: {
1505
+ readonly $ref: "#/components/schemas/SubmissionStatus";
1506
+ };
1507
+ readonly error_detail: {
1492
1508
  readonly anyOf: readonly [{
1493
1509
  readonly type: "string";
1494
- readonly format: "date-time";
1495
1510
  }, {
1496
1511
  readonly type: "null";
1497
1512
  }];
1498
- readonly title: "First Contribution";
1513
+ readonly title: "Error Detail";
1499
1514
  };
1500
- readonly last_contribution: {
1515
+ readonly submitted_at: {
1516
+ readonly type: "string";
1517
+ readonly format: "date-time";
1518
+ readonly title: "Submitted At";
1519
+ };
1520
+ readonly processed_at: {
1501
1521
  readonly anyOf: readonly [{
1502
1522
  readonly type: "string";
1503
1523
  readonly format: "date-time";
1504
1524
  }, {
1505
1525
  readonly type: "null";
1506
1526
  }];
1507
- readonly title: "Last Contribution";
1508
- };
1509
- readonly repos: {
1510
- readonly items: {
1511
- readonly $ref: "#/components/schemas/ContributionEntry";
1512
- };
1513
- readonly type: "array";
1514
- readonly title: "Repos";
1527
+ readonly title: "Processed At";
1515
1528
  };
1516
1529
  };
1517
1530
  readonly type: "object";
1518
- readonly required: readonly ["id", "name", "email_hash", "total_repos", "total_commits", "first_contribution", "last_contribution", "repos"];
1519
- readonly title: "ContributorDetailResponse";
1520
- readonly description: "Full contributor detail with aggregated statistics and per-repo activity.";
1531
+ readonly required: readonly ["id", "repository_claim", "actor_claim", "sbom_content_hash", "artifact_path", "status", "error_detail", "submitted_at", "processed_at"];
1532
+ readonly title: "SbomSubmissionResponse";
1533
+ readonly description: "Full SBOM submission record.\n\nSerialised from the ``SbomSubmission`` ORM model. The ``sbom_content_hash``\nfield is the SHA-256 hex digest of the raw submitted payload.";
1521
1534
  };
1522
- export declare const ContributionEntrySchema: {
1535
+ export declare const ScfSubmissionSchema: {
1523
1536
  readonly properties: {
1524
- readonly repo_canonical_id: {
1537
+ readonly round: {
1525
1538
  readonly type: "string";
1526
- readonly title: "Repo Canonical Id";
1539
+ readonly title: "Round";
1527
1540
  };
1528
- readonly repo_display_name: {
1541
+ readonly title: {
1529
1542
  readonly type: "string";
1530
- readonly title: "Repo Display Name";
1531
- };
1532
- readonly project_canonical_id: {
1533
- readonly anyOf: readonly [{
1534
- readonly type: "string";
1535
- }, {
1536
- readonly type: "null";
1537
- }];
1538
- readonly title: "Project Canonical Id";
1543
+ readonly title: "Title";
1539
1544
  };
1540
- readonly number_of_commits: {
1541
- readonly type: "integer";
1542
- readonly title: "Number Of Commits";
1545
+ };
1546
+ readonly type: "object";
1547
+ readonly required: readonly ["round", "title"];
1548
+ readonly title: "ScfSubmission";
1549
+ readonly description: "A single SCF funding round submission.";
1550
+ };
1551
+ export declare const SubmissionStatusSchema: {
1552
+ readonly type: "string";
1553
+ readonly enum: readonly ["pending", "processed", "failed"];
1554
+ readonly title: "SubmissionStatus";
1555
+ readonly description: "Processing state of an artifact-linked audit record.";
1556
+ };
1557
+ export declare const ValidationErrorSchema: {
1558
+ readonly properties: {
1559
+ readonly loc: {
1560
+ readonly items: {
1561
+ readonly anyOf: readonly [{
1562
+ readonly type: "string";
1563
+ }, {
1564
+ readonly type: "integer";
1565
+ }];
1566
+ };
1567
+ readonly type: "array";
1568
+ readonly title: "Location";
1543
1569
  };
1544
- readonly first_commit_date: {
1570
+ readonly msg: {
1545
1571
  readonly type: "string";
1546
- readonly format: "date-time";
1547
- readonly title: "First Commit Date";
1572
+ readonly title: "Message";
1548
1573
  };
1549
- readonly last_commit_date: {
1574
+ readonly type: {
1550
1575
  readonly type: "string";
1551
- readonly format: "date-time";
1552
- readonly title: "Last Commit Date";
1576
+ readonly title: "Error Type";
1577
+ };
1578
+ readonly input: {
1579
+ readonly title: "Input";
1580
+ };
1581
+ readonly ctx: {
1582
+ readonly type: "object";
1583
+ readonly title: "Context";
1553
1584
  };
1554
1585
  };
1555
1586
  readonly type: "object";
1556
- readonly required: readonly ["repo_canonical_id", "repo_display_name", "project_canonical_id", "number_of_commits", "first_commit_date", "last_commit_date"];
1557
- readonly title: "ContributionEntry";
1558
- readonly description: "A single repo that a contributor has committed to.";
1587
+ readonly required: readonly ["loc", "msg", "type"];
1588
+ readonly title: "ValidationError";
1589
+ };
1590
+ export declare const VisibilitySchema: {
1591
+ readonly type: "string";
1592
+ readonly enum: readonly ["public", "private"];
1593
+ readonly title: "Visibility";
1594
+ readonly description: "Whether a Repo is publicly accessible (affects data collection scope).";
1559
1595
  };