-
Notifications
You must be signed in to change notification settings - Fork 118
/
code-nasa-schema.json
executable file
·267 lines (265 loc) · 11.4 KB
/
code-nasa-schema.json
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
{
"$schema": "http://json-schema.org/draft-04/schema",
"title": "Code.nasa.gov Inventory",
"description": "Code.nasa.gov code catolog, adapted frrom code.gov's federal source code catalog",
"type": "object",
"properties": {
"measurementType": {
"type": "object",
"description": "An object containing description of the open source measurement method.",
"properties": {
"method": {
"type": "string",
"enum": [
"linesOfCode",
"modules",
"cost",
"projects",
"systems",
"other"
],
"description": "An enumerated list of methods for measuring the open source requirement: (1) cost: Cost of software development, (2) systems: system certification and accreditation boundaries, (3) projects: A complete software solution / project, (4) modules: A self-contained module from a software solution, (5) linesOfCode: Source lines of code, (6) other: Another measurement method not referenced above"
}
},
"additionalProperties": false
},
"version": {
"type": "string",
"description": "The version of the metadata schema in use. Implements semantic versioning 2.0.0 rules as defined at http://semver.org"
},
"agency": {
"type": "string",
"description": "The agency acronym for Clinger Cohen Act agency, as defined by the United States Government Manual."
},
"releases": {
"type": "array",
"items": {
"type": "object",
"description": "An object containing each versioned source code release made available.",
"properties": {
"repositoryURL": {
"type": "string",
"format": "uri",
"description": "The URL of the public release repository for open source repositories. This field is not required for repositories that are only available as government-wide reuse or are closed (pursuant to one of the exemptions)."
},
"name": {
"type": "string",
"description": "The name of the release."
},
"tags": {
"type": "array",
"description": "An array of keywords that will be helpful in discovering and searching for the release.",
"items": {
"type": "string"
}
},
"contact": {
"type": "object",
"description": "Point of contact information for the release.",
"properties": {
"email": {
"type": "string",
"description": "The email address for the point of contact for the release."
},
"name": {
"type": "string",
"description": "The name of the point of contact for the release."
},
"URL": {
"type": "string",
"format": "uri",
"description": "The URL to a website that can be used to reach the point of contact. For example, 'http://twitter.com/codeDotGov'."
},
"phone": {
"type": "string",
"description": "A phone number for the point of contact for the release."
}
},
"additionalProperties": false,
"required": ["email"]
},
"laborHours": {
"type": "number",
"description": "An estimate of total labor hours spent by your organization/component across all versions of this release. This includes labor performed by federal employees and contractors."
},
"date": {
"type": "object",
"description": "A date object describing the release.",
"properties": {
"created": {
"type": "string",
"format": "date",
"description": "The date the release was created, in YYYY-MM-DD or ISO 8601 format."
},
"lastModified": {
"type": "string",
"format": "date",
"description": "The date the release was modified, in YYYY-MM-DD or ISO 8601 format."
},
"metadataLastUpdated": {
"type": "string",
"format": "date",
"description": "The date the metadata of the release was last updated, in YYYY-MM-DD or ISO 8601 format."
}
},
"additionalProperties": false
},
"organization": {
"type": "string",
"description": "The organization or component within the agency to which the releases listed belong. For example, '18F' or 'Navy'."
},
"permissions": {
"type": "object",
"description": "An object containing description of the usage/restrictions regarding the release.",
"properties": {
"licenses": {
"type": ["array", "null"],
"description" : "Info container for the code's license.",
"items": {
"type": "object",
"properties": {
"URL": {
"type": "string",
"format": "uri",
"description": "The URL of the release license, if available. If not, null should be used."
},
"name": {
"type": "string",
"description": "An abbreviation for the name of the license. For example, 'CC0' or 'MIT'."
}
},
"additionalProperties": false
}
},
"usageType": {
"type": "string",
"description": "A list of enumerated values which describes the usage permissions for the release: (1) openSource: Open source; (2) governmentWideReuse: Government-wide reuse; (3) exemptByLaw: The sharing of the source code is restricted by law or regulation, including—but not limited to—patent or intellectual property law, the Export Asset Regulations, the International Traffic in Arms Regulation, and the Federal laws and regulations governing classified information; (4) exemptByNationalSecurity: The sharing of the source code would create an identifiable risk to the detriment of national security, confidentiality of Government information, or individual privacy; (5) exemptByAgencySystem: The sharing of the source code would create an identifiable risk to the stability, security, or integrity of the agency’s systems or personnel, (6) exemptByAgencyMission: The sharing of the source code would create an identifiable risk to agency mission, programs, or operations; (7) exemptByCIO: The CIO believes it is in the national interest to exempt sharing the source code; (8) exemptByPolicyDate: The release was created prior to the M-16-21 policy (August 8, 2016)",
"enum": [
"openSource",
"governmentWideReuse",
"exemptByLaw",
"exemptByNationalSecurity",
"exemptByAgencySystem",
"exemptByAgencyMission",
"exemptByCIO",
"exemptByPolicyDate"
],
"additionalProperties": false
},
"exemptionText": {
"type": ["string", "null"],
"description": "If an exemption is listed in the 'usageType' field, this field should include a one- or two- sentence justification for the exemption used."
}
},
"additionalProperties": false,
"required": ["licenses", "usageType"]
},
"local-id": {
"type": "string",
"description": "ID of project used by WebForm to edit and remove projects"
},
"description": {
"type": "string",
"description": "A one or two sentence description of the release."
},
"supplementaryURLs": {
"type": "array",
"description": "URL's where the code can be downloaded from.",
"items": {
"type": "string"
}
},
"contributors": {
"type": "array",
"description": "An array of objects including an acronym for each agency partnering on the release and the contact email at such agency.",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The acronym describing the contributer."
},
"email": {
"type": "string",
"description": "The email address for the point of contact at the contributor."
},
"github": {
"type": "string",
"description": "The github account link of the contributor."
}
},
"additionalProperties": false
}
},
"languages": {
"type": "array",
"description": " An array of strings with the names of the programming languages in use on the release.",
"items": {
"type": "string"
}
},
"homepageURL": {
"type": "string",
"format": "uri",
"description": "The URL of the public release homepage."
},
"disclaimerURL": {
"type": "string",
"format": "uri",
"description": "The URL where disclaimer language regarding the release can be found."
},
"downloadURL": {
"type": "string",
"format": "uri",
"description": "The URL where a distribution of the release can be found."
},
"sti_keywords_passed_thresholds": {
"type": "array",
"description": "An array of AI GENERATED keywords that will be helpful in discovering and searching for the release. Keywords come from this list: https://www.sti.nasa.gov/nasa-thesaurus/
Description of autogeneration methods: https://strategy.data.gov/proof-points/2019/05/28/improving-data-access-and-data-management-artificial-intelligence-generated-metadata-tags-at-nasa/
",
"items": {
"type": "string"
}
},
"service_version": {
"type": "string",
"description": "The version for this release. For example, '1.0.0'."
},
"status": {
"type": "string",
"description": "The development status of the release.",
"enum": [
"Ideation",
"Development",
"Alpha",
"Beta",
"Release Candidate",
"Production",
"Archival"
]
},
"date_AI_tags": {
"type": "string",
"description": "Date when code was added to the catolog"
}
},
"required": [
"name",
"permissions",
"repositoryURL",
"description",
"laborHours",
"tags",
"contact"
]
},
"additionalProperties": false
}
},
"required": [
"version",
"measurementType",
"agency",
"releases"
],
"additionalProperties": false
}