@supermodeltools/openapi-spec 0.6.4 → 0.7.1

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 (2) hide show
  1. package/openapi.yaml +241 -5
  2. package/package.json +1 -1
package/openapi.yaml CHANGED
@@ -2,7 +2,7 @@ openapi: 3.0.0
2
2
  info:
3
3
  title: Supermodel
4
4
  description: Code Graphing & Analysis API
5
- version: 0.6.4
5
+ version: 0.7.1
6
6
  license:
7
7
  name: Supermodel API Terms of Service
8
8
  url: https://supermodeltools.com/legal/api-terms
@@ -734,6 +734,32 @@ paths:
734
734
  jobId: abc-123-def
735
735
  result:
736
736
  runId: smart-sampling-a1b2c3d4
737
+ graph:
738
+ nodes:
739
+ - id: domain:BillingAccount
740
+ labels:
741
+ - Domain
742
+ properties:
743
+ name: BillingAccount
744
+ description: Handles billing and account management
745
+ - id: subdomain:BillingAccount:PaymentProcessing
746
+ labels:
747
+ - Subdomain
748
+ properties:
749
+ name: PaymentProcessing
750
+ description: Processes payment transactions
751
+ relationships:
752
+ - id: domain:BillingAccount->contains->subdomain:BillingAccount:PaymentProcessing
753
+ type: CONTAINS
754
+ startNode: domain:BillingAccount
755
+ endNode: subdomain:BillingAccount:PaymentProcessing
756
+ properties: {}
757
+ metadata:
758
+ analysisStartTime: '2025-02-05T15:42:10Z'
759
+ analysisEndTime: '2025-02-05T15:42:25Z'
760
+ fileCount: 2
761
+ languages:
762
+ - typescript
737
763
  domains:
738
764
  - name: BillingAccount
739
765
  descriptionSummary: Handles billing and account management
@@ -746,6 +772,11 @@ paths:
746
772
  subdomains:
747
773
  - name: PaymentProcessing
748
774
  descriptionSummary: Processes payment transactions
775
+ files:
776
+ - src/services/billing.service.ts
777
+ functions:
778
+ - func-123
779
+ classes: []
749
780
  - name: UsageSummary
750
781
  descriptionSummary: Tracks and summarizes usage metrics
751
782
  keyFiles:
@@ -782,8 +813,18 @@ paths:
782
813
  - functionId: func-456
783
814
  descriptionSummary: Aggregates usage metrics for billing period
784
815
  stats:
785
- domainCount: 2
816
+ nodeCount: 2
786
817
  relationshipCount: 1
818
+ nodeTypes:
819
+ Domain: 2
820
+ Subdomain: 1
821
+ relationshipTypes:
822
+ CONTAINS: 1
823
+ domainCount: 2
824
+ subdomainCount: 1
825
+ assignedFileCount: 1
826
+ assignedFunctionCount: 1
827
+ assignedClassCount: 0
787
828
  fileAssignments: 2
788
829
  functionAssignments: 1
789
830
  unassignedFunctions: 1
@@ -1347,6 +1388,40 @@ paths:
1347
1388
  type: belongsTo
1348
1389
  startNode: fn:src/index.ts:main
1349
1390
  endNode: subdomain:Core:Initialization
1391
+ stats:
1392
+ nodeCount: 5
1393
+ relationshipCount: 4
1394
+ nodeTypes:
1395
+ File: 1
1396
+ Function: 2
1397
+ Domain: 1
1398
+ Subdomain: 1
1399
+ relationshipTypes:
1400
+ contains: 1
1401
+ imports: 1
1402
+ calls: 1
1403
+ belongsTo: 1
1404
+ metadata:
1405
+ analysisStartTime: '2025-02-05T15:42:05Z'
1406
+ analysisEndTime: '2025-02-05T15:42:10Z'
1407
+ fileCount: 2
1408
+ languages:
1409
+ - typescript
1410
+ domains:
1411
+ - name: Core
1412
+ descriptionSummary: Core application logic
1413
+ keyFiles:
1414
+ - src/index.ts
1415
+ responsibilities:
1416
+ - Application initialization
1417
+ subdomains:
1418
+ - name: Initialization
1419
+ descriptionSummary: Application startup logic
1420
+ files:
1421
+ - src/index.ts
1422
+ functions:
1423
+ - fn:src/index.ts:main
1424
+ classes: []
1350
1425
  artifacts:
1351
1426
  - id: artifact-usage-summary
1352
1427
  kind: summary
@@ -1656,6 +1731,24 @@ components:
1656
1731
  CodeGraphStats:
1657
1732
  type: object
1658
1733
  properties:
1734
+ nodeCount:
1735
+ type: integer
1736
+ format: int64
1737
+ description: Total number of nodes in the graph
1738
+ relationshipCount:
1739
+ type: integer
1740
+ format: int64
1741
+ description: Total number of relationships in the graph
1742
+ nodeTypes:
1743
+ type: object
1744
+ additionalProperties:
1745
+ type: integer
1746
+ description: Count of nodes by type
1747
+ relationshipTypes:
1748
+ type: object
1749
+ additionalProperties:
1750
+ type: integer
1751
+ description: Count of relationships by type
1659
1752
  filesProcessed:
1660
1753
  type: integer
1661
1754
  format: int64
@@ -1680,6 +1773,22 @@ components:
1680
1773
  type: string
1681
1774
  stats:
1682
1775
  $ref: '#/components/schemas/CodeGraphStats'
1776
+ metadata:
1777
+ type: object
1778
+ properties:
1779
+ analysisStartTime:
1780
+ type: string
1781
+ format: date-time
1782
+ analysisEndTime:
1783
+ type: string
1784
+ format: date-time
1785
+ fileCount:
1786
+ type: integer
1787
+ languages:
1788
+ type: array
1789
+ items:
1790
+ type: string
1791
+ description: Analysis metadata including timing and file information
1683
1792
  graph:
1684
1793
  type: object
1685
1794
  properties:
@@ -1822,6 +1931,9 @@ components:
1822
1931
  - schemaVersion
1823
1932
  - generatedAt
1824
1933
  - graph
1934
+ - stats
1935
+ - metadata
1936
+ - domains
1825
1937
  properties:
1826
1938
  repo:
1827
1939
  type: string
@@ -1840,6 +1952,45 @@ components:
1840
1952
  type: object
1841
1953
  description: High-level metadata and summary insights including filesProcessed, classes, functions, types, primaryLanguage, and domains count.
1842
1954
  additionalProperties: true
1955
+ stats:
1956
+ type: object
1957
+ properties:
1958
+ nodeCount:
1959
+ type: integer
1960
+ format: int64
1961
+ relationshipCount:
1962
+ type: integer
1963
+ format: int64
1964
+ nodeTypes:
1965
+ type: object
1966
+ additionalProperties:
1967
+ type: integer
1968
+ relationshipTypes:
1969
+ type: object
1970
+ additionalProperties:
1971
+ type: integer
1972
+ description: Graph statistics including node and relationship counts by type
1973
+ metadata:
1974
+ type: object
1975
+ properties:
1976
+ analysisStartTime:
1977
+ type: string
1978
+ format: date-time
1979
+ analysisEndTime:
1980
+ type: string
1981
+ format: date-time
1982
+ fileCount:
1983
+ type: integer
1984
+ languages:
1985
+ type: array
1986
+ items:
1987
+ type: string
1988
+ description: Analysis metadata including timing and file information
1989
+ domains:
1990
+ type: array
1991
+ items:
1992
+ $ref: '#/components/schemas/DomainSummary'
1993
+ description: Array of discovered domain entities
1843
1994
  graph:
1844
1995
  type: object
1845
1996
  description: Unified code graph containing all nodes and relationships.
@@ -1868,6 +2019,37 @@ components:
1868
2019
  runId:
1869
2020
  type: string
1870
2021
  description: Unique identifier for this classification run
2022
+ graph:
2023
+ type: object
2024
+ properties:
2025
+ nodes:
2026
+ type: array
2027
+ items:
2028
+ $ref: '#/components/schemas/CodeGraphNode'
2029
+ relationships:
2030
+ type: array
2031
+ items:
2032
+ $ref: '#/components/schemas/CodeGraphRelationship'
2033
+ required:
2034
+ - nodes
2035
+ - relationships
2036
+ description: Graph representation with Domain and Subdomain nodes
2037
+ metadata:
2038
+ type: object
2039
+ properties:
2040
+ analysisStartTime:
2041
+ type: string
2042
+ format: date-time
2043
+ analysisEndTime:
2044
+ type: string
2045
+ format: date-time
2046
+ fileCount:
2047
+ type: integer
2048
+ languages:
2049
+ type: array
2050
+ items:
2051
+ type: string
2052
+ description: Analysis metadata including timing and file information
1871
2053
  domains:
1872
2054
  type: array
1873
2055
  items:
@@ -1907,6 +2089,8 @@ components:
1907
2089
  $ref: '#/components/schemas/ClassificationStats'
1908
2090
  required:
1909
2091
  - runId
2092
+ - graph
2093
+ - metadata
1910
2094
  - domains
1911
2095
  - relationships
1912
2096
  - fileAssignments
@@ -1953,9 +2137,27 @@ components:
1953
2137
  descriptionSummary:
1954
2138
  type: string
1955
2139
  description: Concise description of the subdomain
2140
+ files:
2141
+ type: array
2142
+ items:
2143
+ type: string
2144
+ description: List of file paths assigned to this subdomain
2145
+ functions:
2146
+ type: array
2147
+ items:
2148
+ type: string
2149
+ description: List of function IDs assigned to this subdomain
2150
+ classes:
2151
+ type: array
2152
+ items:
2153
+ type: string
2154
+ description: List of class IDs assigned to this subdomain
1956
2155
  required:
1957
2156
  - name
1958
2157
  - descriptionSummary
2158
+ - files
2159
+ - functions
2160
+ - classes
1959
2161
  DomainRelationship:
1960
2162
  type: object
1961
2163
  properties:
@@ -2048,12 +2250,39 @@ components:
2048
2250
  ClassificationStats:
2049
2251
  type: object
2050
2252
  properties:
2253
+ nodeCount:
2254
+ type: integer
2255
+ format: int64
2256
+ description: Total number of nodes in the graph
2257
+ relationshipCount:
2258
+ type: integer
2259
+ format: int64
2260
+ description: Total number of relationships in the graph
2261
+ nodeTypes:
2262
+ type: object
2263
+ additionalProperties:
2264
+ type: integer
2265
+ description: Count of nodes by type
2266
+ relationshipTypes:
2267
+ type: object
2268
+ additionalProperties:
2269
+ type: integer
2270
+ description: Count of relationships by type
2051
2271
  domainCount:
2052
2272
  type: integer
2053
2273
  description: Number of domains discovered
2054
- relationshipCount:
2274
+ subdomainCount:
2055
2275
  type: integer
2056
- description: Number of relationships
2276
+ description: Number of subdomains discovered
2277
+ assignedFileCount:
2278
+ type: integer
2279
+ description: Number of files assigned to domains/subdomains
2280
+ assignedFunctionCount:
2281
+ type: integer
2282
+ description: Number of functions assigned to domains/subdomains
2283
+ assignedClassCount:
2284
+ type: integer
2285
+ description: Number of classes assigned to domains/subdomains
2057
2286
  fileAssignments:
2058
2287
  type: integer
2059
2288
  description: Count of file assignments
@@ -2067,8 +2296,15 @@ components:
2067
2296
  type: integer
2068
2297
  description: Count of class assignments
2069
2298
  required:
2070
- - domainCount
2299
+ - nodeCount
2071
2300
  - relationshipCount
2301
+ - nodeTypes
2302
+ - relationshipTypes
2303
+ - domainCount
2304
+ - subdomainCount
2305
+ - assignedFileCount
2306
+ - assignedFunctionCount
2307
+ - assignedClassCount
2072
2308
  - fileAssignments
2073
2309
  - functionAssignments
2074
2310
  - unassignedFunctions
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@supermodeltools/openapi-spec",
3
- "version": "0.6.4",
3
+ "version": "0.7.1",
4
4
  "description": "Supermodel Public OpenAPI Specification",
5
5
  "main": "openapi.yaml",
6
6
  "files": [