@decantr/verifier 1.0.6 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (6) hide show
  1. package/README.md +8 -2
  2. package/dist/index.d.ts +66 -1
  3. package/dist/index.js +229 -31
  4. package/dist/index.js.map +1 -1
  5. package/package.json +4 -3
  6. package/schema/project-health-report.v1.json +257 -0
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@decantr/verifier",
3
- "version": "1.0.6",
4
- "description": "Shared verification, critique, and report-schema engine for Decantr",
3
+ "version": "1.1.0",
4
+ "description": "Shared verification, critique, Project Health, and report-schema engine for Decantr",
5
5
  "author": "Decantr AI",
6
6
  "license": "MIT",
7
7
  "bugs": {
@@ -23,6 +23,7 @@
23
23
  },
24
24
  "./schema/verification-report.common.v1.json": "./schema/verification-report.common.v1.json",
25
25
  "./schema/project-audit-report.v1.json": "./schema/project-audit-report.v1.json",
26
+ "./schema/project-health-report.v1.json": "./schema/project-health-report.v1.json",
26
27
  "./schema/file-critique-report.v1.json": "./schema/file-critique-report.v1.json",
27
28
  "./schema/showcase-shortlist-report.v1.json": "./schema/showcase-shortlist-report.v1.json"
28
29
  },
@@ -39,7 +40,7 @@
39
40
  "dependencies": {
40
41
  "typescript": "^5.7.0",
41
42
  "@decantr/core": "1.0.6",
42
- "@decantr/essence-spec": "1.0.6"
43
+ "@decantr/essence-spec": "1.0.7"
43
44
  },
44
45
  "devDependencies": {
45
46
  "ajv": "^8.18.0",
package/schema/project-health-report.v1.json ADDED
@@ -0,0 +1,257 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://decantr.ai/schemas/project-health-report.v1.json",
4
+ "title": "Decantr Project Health Report",
5
+ "type": "object",
6
+ "required": [
7
+ "$schema",
8
+ "generatedAt",
9
+ "projectRoot",
10
+ "status",
11
+ "score",
12
+ "summary",
13
+ "routes",
14
+ "packs",
15
+ "ci",
16
+ "findings"
17
+ ],
18
+ "properties": {
19
+ "$schema": {
20
+ "const": "https://decantr.ai/schemas/project-health-report.v1.json"
21
+ },
22
+ "generatedAt": {
23
+ "type": "string",
24
+ "format": "date-time"
25
+ },
26
+ "projectRoot": {
27
+ "$ref": "https://decantr.ai/schemas/verification-report.common.v1.json#/$defs/nonEmptyString"
28
+ },
29
+ "status": {
30
+ "type": "string",
31
+ "enum": ["healthy", "warning", "error"]
32
+ },
33
+ "score": {
34
+ "type": "integer",
35
+ "minimum": 0,
36
+ "maximum": 100
37
+ },
38
+ "summary": {
39
+ "type": "object",
40
+ "required": [
41
+ "errorCount",
42
+ "warnCount",
43
+ "infoCount",
44
+ "findingCount",
45
+ "workflowMode",
46
+ "adoptionMode",
47
+ "essenceVersion",
48
+ "pageCount",
49
+ "runtimeAuditChecked",
50
+ "runtimePassed",
51
+ "packManifestPresent",
52
+ "reviewPackPresent"
53
+ ],
54
+ "properties": {
55
+ "errorCount": {
56
+ "type": "integer",
57
+ "minimum": 0
58
+ },
59
+ "warnCount": {
60
+ "type": "integer",
61
+ "minimum": 0
62
+ },
63
+ "infoCount": {
64
+ "type": "integer",
65
+ "minimum": 0
66
+ },
67
+ "findingCount": {
68
+ "type": "integer",
69
+ "minimum": 0
70
+ },
71
+ "workflowMode": {
72
+ "type": ["string", "null"]
73
+ },
74
+ "adoptionMode": {
75
+ "type": ["string", "null"]
76
+ },
77
+ "essenceVersion": {
78
+ "type": ["string", "null"]
79
+ },
80
+ "pageCount": {
81
+ "type": "integer",
82
+ "minimum": 0
83
+ },
84
+ "runtimeAuditChecked": {
85
+ "type": "boolean"
86
+ },
87
+ "runtimePassed": {
88
+ "type": ["boolean", "null"]
89
+ },
90
+ "packManifestPresent": {
91
+ "type": "boolean"
92
+ },
93
+ "reviewPackPresent": {
94
+ "type": "boolean"
95
+ }
96
+ },
97
+ "additionalProperties": false
98
+ },
99
+ "routes": {
100
+ "type": "object",
101
+ "required": ["declared", "runtimeChecked", "runtimeMatched", "runtimeCoverageOk", "issues"],
102
+ "properties": {
103
+ "declared": {
104
+ "type": "array",
105
+ "items": {
106
+ "type": "string"
107
+ }
108
+ },
109
+ "runtimeChecked": {
110
+ "type": "array",
111
+ "items": {
112
+ "type": "string"
113
+ }
114
+ },
115
+ "runtimeMatched": {
116
+ "type": "integer",
117
+ "minimum": 0
118
+ },
119
+ "runtimeCoverageOk": {
120
+ "type": ["boolean", "null"]
121
+ },
122
+ "issues": {
123
+ "type": "array",
124
+ "items": {
125
+ "type": "string"
126
+ }
127
+ }
128
+ },
129
+ "additionalProperties": false
130
+ },
131
+ "packs": {
132
+ "type": "object",
133
+ "required": [
134
+ "manifestPresent",
135
+ "reviewPackPresent",
136
+ "scaffoldPackPresent",
137
+ "sectionPackCount",
138
+ "pagePackCount",
139
+ "mutationPackCount",
140
+ "generatedAt"
141
+ ],
142
+ "properties": {
143
+ "manifestPresent": {
144
+ "type": "boolean"
145
+ },
146
+ "reviewPackPresent": {
147
+ "type": "boolean"
148
+ },
149
+ "scaffoldPackPresent": {
150
+ "type": "boolean"
151
+ },
152
+ "sectionPackCount": {
153
+ "type": "integer",
154
+ "minimum": 0
155
+ },
156
+ "pagePackCount": {
157
+ "type": "integer",
158
+ "minimum": 0
159
+ },
160
+ "mutationPackCount": {
161
+ "type": "integer",
162
+ "minimum": 0
163
+ },
164
+ "generatedAt": {
165
+ "type": ["string", "null"]
166
+ }
167
+ },
168
+ "additionalProperties": false
169
+ },
170
+ "ci": {
171
+ "type": "object",
172
+ "required": ["recommendedCommand", "failOn"],
173
+ "properties": {
174
+ "recommendedCommand": {
175
+ "$ref": "https://decantr.ai/schemas/verification-report.common.v1.json#/$defs/nonEmptyString"
176
+ },
177
+ "failOn": {
178
+ "type": "string",
179
+ "enum": ["error", "warn", "none"]
180
+ }
181
+ },
182
+ "additionalProperties": false
183
+ },
184
+ "findings": {
185
+ "type": "array",
186
+ "items": {
187
+ "$ref": "#/$defs/projectHealthFinding"
188
+ }
189
+ }
190
+ },
191
+ "additionalProperties": false,
192
+ "$defs": {
193
+ "projectHealthFinding": {
194
+ "type": "object",
195
+ "required": [
196
+ "id",
197
+ "source",
198
+ "category",
199
+ "severity",
200
+ "message",
201
+ "evidence",
202
+ "remediation"
203
+ ],
204
+ "properties": {
205
+ "id": {
206
+ "$ref": "https://decantr.ai/schemas/verification-report.common.v1.json#/$defs/nonEmptyString"
207
+ },
208
+ "source": {
209
+ "type": "string",
210
+ "enum": ["audit", "check", "brownfield", "runtime", "pack", "interaction"]
211
+ },
212
+ "category": {
213
+ "$ref": "https://decantr.ai/schemas/verification-report.common.v1.json#/$defs/nonEmptyString"
214
+ },
215
+ "severity": {
216
+ "type": "string",
217
+ "enum": ["error", "warn", "info"]
218
+ },
219
+ "message": {
220
+ "$ref": "https://decantr.ai/schemas/verification-report.common.v1.json#/$defs/nonEmptyString"
221
+ },
222
+ "evidence": {
223
+ "$ref": "https://decantr.ai/schemas/verification-report.common.v1.json#/$defs/stringArray"
224
+ },
225
+ "target": {
226
+ "type": "string"
227
+ },
228
+ "file": {
229
+ "type": "string"
230
+ },
231
+ "rule": {
232
+ "type": "string"
233
+ },
234
+ "suggestedFix": {
235
+ "type": "string"
236
+ },
237
+ "remediation": {
238
+ "type": "object",
239
+ "required": ["summary", "prompt", "commands"],
240
+ "properties": {
241
+ "summary": {
242
+ "$ref": "https://decantr.ai/schemas/verification-report.common.v1.json#/$defs/nonEmptyString"
243
+ },
244
+ "prompt": {
245
+ "$ref": "https://decantr.ai/schemas/verification-report.common.v1.json#/$defs/nonEmptyString"
246
+ },
247
+ "commands": {
248
+ "$ref": "https://decantr.ai/schemas/verification-report.common.v1.json#/$defs/stringArray"
249
+ }
250
+ },
251
+ "additionalProperties": false
252
+ }
253
+ },
254
+ "additionalProperties": false
255
+ }
256
+ }
257
+ }