@decantr/verifier 2.5.1 → 3.0.0-next.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.
- package/README.md +9 -0
- package/dist/index.d.ts +376 -2
- package/dist/index.js +1888 -455
- package/dist/index.js.map +1 -1
- package/package.json +8 -5
- package/schema/evidence-bundle.v1.json +99 -1
- package/schema/project-health-report.v1.json +129 -0
- package/schema/scan-report.v1.json +122 -0
- package/schema/verification-report.common.v1.json +59 -0
package/README.md
CHANGED
|
@@ -16,12 +16,18 @@ npm install @decantr/verifier
|
|
|
16
16
|
- `auditProject()` for project-level Decantr audits
|
|
17
17
|
- `auditBuiltDist()` for built-output runtime verification against emitted HTML, assets, and route hints
|
|
18
18
|
- `scanProject()` for read-only Brownfield reconnaissance of framework, routes, components, styling, static-hosting hints, Decantr presence, and assistant-rule files
|
|
19
|
+
- `auditComponentReuse()` for the first AST-derived component reuse drift slice, focused on AI reimplementing common UI primitives instead of importing project-owned components, plus local import references that the typed graph can turn into source-to-source impact edges
|
|
20
|
+
- `auditStyleBridgeDrift()` for accepted style bridge drift, focused on production `className`, common class-helper values, stylesheet declarations, and hardcoded inline color styles that bypass project-owned token/class authority
|
|
21
|
+
- `collectProjectSourceFiles()` for the shared production-source file selection used by Project Health, component reuse drift, style bridge drift, and typed graph source provenance
|
|
19
22
|
- `resolveGitHubScanInput()` and `probePublishedSite()` for hosted scan inputs and HTML-only published-site metadata probes
|
|
20
23
|
- `critiqueFile()` for file-level review against compiled review-pack contracts
|
|
21
24
|
- `createContractAssertions()` for explicit route, shell, accessibility, context, and design-token assertions derived from Essence/context
|
|
22
25
|
- `createEvidenceBundle()` for privacy-redacted local evidence artifacts used by AI repair loops and CI
|
|
26
|
+
- `resolveGraphAnchorForFinding()` and `anchorFindingsToGraph()` for attaching verifier/Project Health findings to typed Contract graph nodes when a graph snapshot exists
|
|
27
|
+
- `deriveVerificationDiagnostic()` and `KNOWN_VERIFICATION_DIAGNOSTICS` for stable finding codes and typed repair IDs used by Project Health, MCP health, and Evidence Bundles
|
|
23
28
|
- schema-backed report types for project audits, Project Health, Decantr CI reports, Evidence Bundles, Workspace Health, file critiques, and showcase verification
|
|
24
29
|
- `ProjectHealthReport`, `ProjectHealthFinding`, and `ProjectHealthRemediation` types for the CLI's end-user health surface
|
|
30
|
+
- Project Health and Evidence Bundle finding schemas include optional `code`, `repair`, `repairPlan`, and `graph` fields so agents can identify, anchor, and act on findings without parsing prose; Evidence Bundle provenance also records graph snapshot, manifest, diff, and contract-capsule hashes when present
|
|
25
31
|
- interaction findings now include scanned file counts, file line ranges, and expected signal evidence where available, so CLI health/check output can point agents at source-grounded remediation
|
|
26
32
|
- contract-only and style-bridge Brownfield critique avoids requiring Decantr treatments/decorators when the project keeps its own styling authority
|
|
27
33
|
- Decantr CI report schemas include accepted style bridge status, mapping count, styling approach, and theme modes alongside local-law findings
|
|
@@ -29,6 +35,9 @@ npm install @decantr/verifier
|
|
|
29
35
|
- project audits tolerate partial or malformed generated review packs without crashing Project Health, so half-attached Brownfield projects still receive actionable findings
|
|
30
36
|
- Next.js static/document outputs are treated as framework-rendered documents instead of requiring a Vite-style `id="root"` mount element
|
|
31
37
|
- project source audits ignore test, spec, story, fixture, and mock files for production drift warnings such as localhost endpoints and unsafe rendering patterns
|
|
38
|
+
- project audits emit `COMP001` / `import-existing-component` findings when a production source file locally redeclares a primitive such as `Button`, `Card`, or `Dialog` while an exported reusable primitive already exists under common component paths
|
|
39
|
+
- project audits emit `COMP010` / `replace-raw-control-with-local-component` findings when production JSX renders raw controls such as `<button>` or `<input>` while a project-owned primitive already exists
|
|
40
|
+
- project audits emit `TOKEN010` / `replace-arbitrary-style-with-bridge-token` findings when an accepted `.decantr/style-bridge.json` exists and production JSX uses arbitrary Tailwind values such as `bg-[#0f172a]`, values inside `cn()`, `clsx()`, `classnames()`, `cva()`, and `tv()` calls, hardcoded inline color styles such as `style={{ backgroundColor: "#0f172a" }}`, or hardcoded visual values in production CSS/module stylesheets
|
|
32
41
|
- published verifier report schemas are exercised by AJV-backed round-trip tests against real audit, critique, and shortlist-report outputs
|
|
33
42
|
- project audits include runtime evidence when a built `dist/` output is present:
|
|
34
43
|
- root document
|
package/dist/index.d.ts
CHANGED
|
@@ -1,6 +1,197 @@
|
|
|
1
1
|
import { ReviewExecutionPack } from '@decantr/core';
|
|
2
2
|
import { EssenceFile } from '@decantr/essence-spec';
|
|
3
3
|
|
|
4
|
+
interface VerificationRepairAction {
|
|
5
|
+
id: string;
|
|
6
|
+
payload?: Record<string, unknown>;
|
|
7
|
+
}
|
|
8
|
+
interface VerificationDiagnosticInput {
|
|
9
|
+
id: string;
|
|
10
|
+
category: string;
|
|
11
|
+
message: string;
|
|
12
|
+
source?: string;
|
|
13
|
+
rule?: string;
|
|
14
|
+
target?: string;
|
|
15
|
+
file?: string;
|
|
16
|
+
suggestedFix?: string;
|
|
17
|
+
evidence?: string[];
|
|
18
|
+
}
|
|
19
|
+
interface VerificationDiagnosticMetadata {
|
|
20
|
+
code: string;
|
|
21
|
+
repair: VerificationRepairAction;
|
|
22
|
+
}
|
|
23
|
+
interface VerificationDiagnosticCatalogEntry {
|
|
24
|
+
rule: string;
|
|
25
|
+
code: string;
|
|
26
|
+
repairId: string;
|
|
27
|
+
family: string;
|
|
28
|
+
}
|
|
29
|
+
declare const KNOWN_VERIFICATION_DIAGNOSTICS: readonly [{
|
|
30
|
+
readonly rule: "browser-base-url-missing";
|
|
31
|
+
readonly code: "VISUAL002";
|
|
32
|
+
readonly repairId: "provide-browser-base-url";
|
|
33
|
+
readonly family: "VISUAL";
|
|
34
|
+
}, {
|
|
35
|
+
readonly rule: "browser-playwright-missing";
|
|
36
|
+
readonly code: "VISUAL001";
|
|
37
|
+
readonly repairId: "install-browser-verifier";
|
|
38
|
+
readonly family: "VISUAL";
|
|
39
|
+
}, {
|
|
40
|
+
readonly rule: "browser-route-verification-failed";
|
|
41
|
+
readonly code: "VISUAL003";
|
|
42
|
+
readonly repairId: "fix-route-render";
|
|
43
|
+
readonly family: "VISUAL";
|
|
44
|
+
}, {
|
|
45
|
+
readonly rule: "visual-baseline-screenshot-drift";
|
|
46
|
+
readonly code: "VISUAL010";
|
|
47
|
+
readonly repairId: "review-visual-baseline-drift";
|
|
48
|
+
readonly family: "VISUAL";
|
|
49
|
+
}, {
|
|
50
|
+
readonly rule: "brownfield-route-drift";
|
|
51
|
+
readonly code: "ROUTE001";
|
|
52
|
+
readonly repairId: "reconcile-brownfield-routes";
|
|
53
|
+
readonly family: "ROUTE";
|
|
54
|
+
}, {
|
|
55
|
+
readonly rule: "check-failed";
|
|
56
|
+
readonly code: "CHECK001";
|
|
57
|
+
readonly repairId: "repair-contract-check";
|
|
58
|
+
readonly family: "CHECK";
|
|
59
|
+
}, {
|
|
60
|
+
readonly rule: "component-reuse-raw-control";
|
|
61
|
+
readonly code: "COMP010";
|
|
62
|
+
readonly repairId: "replace-raw-control-with-local-component";
|
|
63
|
+
readonly family: "COMP";
|
|
64
|
+
}, {
|
|
65
|
+
readonly rule: "component-reuse-primitive-reimplemented";
|
|
66
|
+
readonly code: "COMP001";
|
|
67
|
+
readonly repairId: "import-existing-component";
|
|
68
|
+
readonly family: "COMP";
|
|
69
|
+
}, {
|
|
70
|
+
readonly rule: "declared-route-resolves";
|
|
71
|
+
readonly code: "STRUCT002";
|
|
72
|
+
readonly repairId: "repair-route-binding";
|
|
73
|
+
readonly family: "STRUCT";
|
|
74
|
+
}, {
|
|
75
|
+
readonly rule: "design-token-coverage";
|
|
76
|
+
readonly code: "TOKEN002";
|
|
77
|
+
readonly repairId: "repair-design-token-coverage";
|
|
78
|
+
readonly family: "TOKEN";
|
|
79
|
+
}, {
|
|
80
|
+
readonly rule: "style-bridge-arbitrary-value";
|
|
81
|
+
readonly code: "TOKEN010";
|
|
82
|
+
readonly repairId: "replace-arbitrary-style-with-bridge-token";
|
|
83
|
+
readonly family: "TOKEN";
|
|
84
|
+
}, {
|
|
85
|
+
readonly rule: "essence-present";
|
|
86
|
+
readonly code: "CONTRACT001";
|
|
87
|
+
readonly repairId: "restore-essence-contract";
|
|
88
|
+
readonly family: "CONTRACT";
|
|
89
|
+
}, {
|
|
90
|
+
readonly rule: "essence-v4";
|
|
91
|
+
readonly code: "CONTRACT002";
|
|
92
|
+
readonly repairId: "migrate-essence-v4";
|
|
93
|
+
readonly family: "CONTRACT";
|
|
94
|
+
}, {
|
|
95
|
+
readonly rule: "focus-visible-enabled";
|
|
96
|
+
readonly code: "A11Y001";
|
|
97
|
+
readonly repairId: "enable-focus-visible";
|
|
98
|
+
readonly family: "A11Y";
|
|
99
|
+
}, {
|
|
100
|
+
readonly rule: "pack-manifest-present";
|
|
101
|
+
readonly code: "CTX002";
|
|
102
|
+
readonly repairId: "hydrate-execution-packs";
|
|
103
|
+
readonly family: "CTX";
|
|
104
|
+
}, {
|
|
105
|
+
readonly rule: "pack-manifest-missing";
|
|
106
|
+
readonly code: "CTX002";
|
|
107
|
+
readonly repairId: "hydrate-execution-packs";
|
|
108
|
+
readonly family: "CTX";
|
|
109
|
+
}, {
|
|
110
|
+
readonly rule: "page-pack-count-mismatch";
|
|
111
|
+
readonly code: "CTX001";
|
|
112
|
+
readonly repairId: "regenerate-context-packs";
|
|
113
|
+
readonly family: "CTX";
|
|
114
|
+
}, {
|
|
115
|
+
readonly rule: "page-route-required";
|
|
116
|
+
readonly code: "STRUCT001";
|
|
117
|
+
readonly repairId: "add-page-route";
|
|
118
|
+
readonly family: "STRUCT";
|
|
119
|
+
}, {
|
|
120
|
+
readonly rule: "project-audit-invalid";
|
|
121
|
+
readonly code: "AUDIT001";
|
|
122
|
+
readonly repairId: "repair-project-audit";
|
|
123
|
+
readonly family: "AUDIT";
|
|
124
|
+
}, {
|
|
125
|
+
readonly rule: "review-pack-present";
|
|
126
|
+
readonly code: "CTX003";
|
|
127
|
+
readonly repairId: "hydrate-review-pack";
|
|
128
|
+
readonly family: "CTX";
|
|
129
|
+
}, {
|
|
130
|
+
readonly rule: "review-pack-file-missing";
|
|
131
|
+
readonly code: "CTX003";
|
|
132
|
+
readonly repairId: "hydrate-review-pack";
|
|
133
|
+
readonly family: "CTX";
|
|
134
|
+
}, {
|
|
135
|
+
readonly rule: "section-shell-concrete";
|
|
136
|
+
readonly code: "STRUCT003";
|
|
137
|
+
readonly repairId: "assign-section-shell";
|
|
138
|
+
readonly family: "STRUCT";
|
|
139
|
+
}, {
|
|
140
|
+
readonly rule: "tokens-file-present";
|
|
141
|
+
readonly code: "TOKEN001";
|
|
142
|
+
readonly repairId: "restore-design-token-file";
|
|
143
|
+
readonly family: "TOKEN";
|
|
144
|
+
}, {
|
|
145
|
+
readonly rule: "typed-graph-current";
|
|
146
|
+
readonly code: "GRAPH001";
|
|
147
|
+
readonly repairId: "regenerate-typed-graph";
|
|
148
|
+
readonly family: "GRAPH";
|
|
149
|
+
}];
|
|
150
|
+
declare function deriveVerificationDiagnostic(input: VerificationDiagnosticInput): VerificationDiagnosticMetadata;
|
|
151
|
+
|
|
152
|
+
type VerificationGraphAnchorConfidence = 'exact' | 'inferred' | 'fallback';
|
|
153
|
+
interface GraphAnchorNode {
|
|
154
|
+
id: string;
|
|
155
|
+
type: string;
|
|
156
|
+
payload?: unknown;
|
|
157
|
+
}
|
|
158
|
+
interface GraphAnchorEdge {
|
|
159
|
+
src: string;
|
|
160
|
+
dst: string;
|
|
161
|
+
relation: string;
|
|
162
|
+
payload?: unknown;
|
|
163
|
+
idx?: number;
|
|
164
|
+
}
|
|
165
|
+
interface GraphAnchorSnapshot {
|
|
166
|
+
id: string;
|
|
167
|
+
project_id: string;
|
|
168
|
+
source_hash: string;
|
|
169
|
+
nodes: GraphAnchorNode[];
|
|
170
|
+
edges: GraphAnchorEdge[];
|
|
171
|
+
}
|
|
172
|
+
interface VerificationGraphAnchor {
|
|
173
|
+
snapshot_id: string;
|
|
174
|
+
source_hash: string;
|
|
175
|
+
node_id: string;
|
|
176
|
+
node_type: string;
|
|
177
|
+
route?: string;
|
|
178
|
+
confidence: VerificationGraphAnchorConfidence;
|
|
179
|
+
reason: string;
|
|
180
|
+
}
|
|
181
|
+
interface GraphAnchorFindingInput {
|
|
182
|
+
id: string;
|
|
183
|
+
category: string;
|
|
184
|
+
message: string;
|
|
185
|
+
evidence?: string[];
|
|
186
|
+
target?: string;
|
|
187
|
+
file?: string;
|
|
188
|
+
rule?: string;
|
|
189
|
+
}
|
|
190
|
+
declare function resolveGraphAnchorForFinding(snapshot: GraphAnchorSnapshot | null | undefined, finding: GraphAnchorFindingInput): VerificationGraphAnchor | undefined;
|
|
191
|
+
declare function anchorFindingsToGraph<TFinding extends GraphAnchorFindingInput>(snapshot: GraphAnchorSnapshot | null | undefined, findings: TFinding[]): Array<TFinding & {
|
|
192
|
+
graph?: VerificationGraphAnchor;
|
|
193
|
+
}>;
|
|
194
|
+
|
|
4
195
|
interface RuntimeAudit {
|
|
5
196
|
distPresent: boolean;
|
|
6
197
|
indexPresent: boolean;
|
|
@@ -53,6 +244,89 @@ interface BuiltDistAuditOptions {
|
|
|
53
244
|
declare function emptyRuntimeAudit(failures?: string[]): RuntimeAudit;
|
|
54
245
|
declare function auditBuiltDist(projectRoot: string, options?: BuiltDistAuditOptions): Promise<RuntimeAudit>;
|
|
55
246
|
|
|
247
|
+
declare const COMPONENT_REUSE_RULE_ID = "component-reuse-primitive-reimplemented";
|
|
248
|
+
declare const RAW_CONTROL_REUSE_RULE_ID = "component-reuse-raw-control";
|
|
249
|
+
declare const RAW_CONTROL_COMPONENT_BY_ELEMENT: {
|
|
250
|
+
readonly button: "Button";
|
|
251
|
+
readonly dialog: "Dialog";
|
|
252
|
+
readonly input: "Input";
|
|
253
|
+
readonly select: "Select";
|
|
254
|
+
readonly table: "Table";
|
|
255
|
+
readonly textarea: "Textarea";
|
|
256
|
+
};
|
|
257
|
+
type RawControlElement = keyof typeof RAW_CONTROL_COMPONENT_BY_ELEMENT;
|
|
258
|
+
interface CodeComponentDeclaration {
|
|
259
|
+
id: string;
|
|
260
|
+
name: string;
|
|
261
|
+
file: string;
|
|
262
|
+
line: number;
|
|
263
|
+
exported: boolean;
|
|
264
|
+
reusable: boolean;
|
|
265
|
+
kind: 'function' | 'variable' | 'class';
|
|
266
|
+
}
|
|
267
|
+
interface ComponentReuseFinding {
|
|
268
|
+
id: string;
|
|
269
|
+
name: string;
|
|
270
|
+
file: string;
|
|
271
|
+
line: number;
|
|
272
|
+
canonicalFile: string;
|
|
273
|
+
canonicalLine: number;
|
|
274
|
+
evidence: string[];
|
|
275
|
+
}
|
|
276
|
+
interface RawControlReuseFinding {
|
|
277
|
+
id: string;
|
|
278
|
+
element: RawControlElement;
|
|
279
|
+
component: string;
|
|
280
|
+
file: string;
|
|
281
|
+
line: number;
|
|
282
|
+
canonicalFile: string;
|
|
283
|
+
canonicalLine: number;
|
|
284
|
+
containingComponent?: string;
|
|
285
|
+
evidence: string[];
|
|
286
|
+
}
|
|
287
|
+
interface CodeImportReference {
|
|
288
|
+
file: string;
|
|
289
|
+
source: string;
|
|
290
|
+
line: number;
|
|
291
|
+
defaultImport?: string;
|
|
292
|
+
namespaceImport?: string;
|
|
293
|
+
imported: string[];
|
|
294
|
+
localNames: string[];
|
|
295
|
+
}
|
|
296
|
+
interface ComponentReuseAudit {
|
|
297
|
+
filesChecked: number;
|
|
298
|
+
declarations: CodeComponentDeclaration[];
|
|
299
|
+
imports: CodeImportReference[];
|
|
300
|
+
reusableComponentCount: number;
|
|
301
|
+
localRedeclarationCount: number;
|
|
302
|
+
rawControlCount: number;
|
|
303
|
+
findings: ComponentReuseFinding[];
|
|
304
|
+
rawControlFindings: RawControlReuseFinding[];
|
|
305
|
+
}
|
|
306
|
+
declare function auditComponentReuse(projectRoot: string, sourceFiles: string[]): ComponentReuseAudit;
|
|
307
|
+
|
|
308
|
+
declare const STYLE_BRIDGE_ARBITRARY_VALUE_RULE_ID = "style-bridge-arbitrary-value";
|
|
309
|
+
interface StyleBridgeDriftFinding {
|
|
310
|
+
id: string;
|
|
311
|
+
file: string;
|
|
312
|
+
line: number;
|
|
313
|
+
className: string;
|
|
314
|
+
value: string;
|
|
315
|
+
source: 'className' | 'inline-style' | 'stylesheet';
|
|
316
|
+
property?: string;
|
|
317
|
+
bridgeMappingIds: string[];
|
|
318
|
+
tokenHints: string[];
|
|
319
|
+
classHints: string[];
|
|
320
|
+
evidence: string[];
|
|
321
|
+
}
|
|
322
|
+
interface StyleBridgeDriftAudit {
|
|
323
|
+
filesChecked: number;
|
|
324
|
+
bridgeMappingCount: number;
|
|
325
|
+
arbitraryValueCount: number;
|
|
326
|
+
findings: StyleBridgeDriftFinding[];
|
|
327
|
+
}
|
|
328
|
+
declare function auditStyleBridgeDrift(projectRoot: string, sourceFiles: string[]): StyleBridgeDriftAudit;
|
|
329
|
+
|
|
56
330
|
/**
|
|
57
331
|
* Experiential interaction verifier.
|
|
58
332
|
*
|
|
@@ -168,6 +442,43 @@ interface ScanFindingV1 {
|
|
|
168
442
|
evidence: string[];
|
|
169
443
|
recommendation?: string;
|
|
170
444
|
}
|
|
445
|
+
type ScanGraphPreviewStatus = 'not_attached' | 'current' | 'stale' | 'needs_migration' | 'unavailable';
|
|
446
|
+
interface ScanGraphPreviewV1 {
|
|
447
|
+
status: ScanGraphPreviewStatus;
|
|
448
|
+
canPreview: boolean;
|
|
449
|
+
readOnly: true;
|
|
450
|
+
message: string;
|
|
451
|
+
nextCommand: string | null;
|
|
452
|
+
staleArtifacts: string[];
|
|
453
|
+
snapshot: {
|
|
454
|
+
id: string;
|
|
455
|
+
schemaVersion: string;
|
|
456
|
+
sourceHash: string;
|
|
457
|
+
nodes: number;
|
|
458
|
+
edges: number;
|
|
459
|
+
findings: number;
|
|
460
|
+
evidence: number;
|
|
461
|
+
sourceArtifacts: number;
|
|
462
|
+
} | null;
|
|
463
|
+
capsule: {
|
|
464
|
+
cacheKey: string;
|
|
465
|
+
routes: number;
|
|
466
|
+
components: number;
|
|
467
|
+
tokens: number;
|
|
468
|
+
localRules: number;
|
|
469
|
+
styleBridge: number;
|
|
470
|
+
sourceArtifacts: number;
|
|
471
|
+
sourceArtifactLimit: number;
|
|
472
|
+
sourceArtifactsTruncated: boolean;
|
|
473
|
+
openFindings: number;
|
|
474
|
+
} | null;
|
|
475
|
+
diff: {
|
|
476
|
+
ops: number;
|
|
477
|
+
findingsAdded: number;
|
|
478
|
+
findingsResolved: number;
|
|
479
|
+
evidenceAdded: number;
|
|
480
|
+
} | null;
|
|
481
|
+
}
|
|
171
482
|
interface ScanReportV1 {
|
|
172
483
|
$schema: typeof SCAN_REPORT_SCHEMA_URL;
|
|
173
484
|
schemaVersion: 'scan-report.v1';
|
|
@@ -225,6 +536,7 @@ interface ScanReportV1 {
|
|
|
225
536
|
assistant: {
|
|
226
537
|
ruleFiles: string[];
|
|
227
538
|
};
|
|
539
|
+
graphPreview?: ScanGraphPreviewV1;
|
|
228
540
|
pagesProbe: PublishedSiteProbeV1 | null;
|
|
229
541
|
findings: ScanFindingV1[];
|
|
230
542
|
recommendedCommands: string[];
|
|
@@ -276,9 +588,10 @@ declare const VERIFICATION_SCHEMA_URLS: {
|
|
|
276
588
|
};
|
|
277
589
|
type VerificationSeverity = 'error' | 'warn' | 'info';
|
|
278
590
|
type ProjectHealthStatus = 'healthy' | 'warning' | 'error';
|
|
279
|
-
type ProjectHealthFindingSource = 'audit' | 'assertion' | 'browser' | 'check' | 'brownfield' | 'design-token' | 'runtime' | 'pack' | 'interaction';
|
|
591
|
+
type ProjectHealthFindingSource = 'audit' | 'assertion' | 'browser' | 'check' | 'brownfield' | 'design-token' | 'style-bridge' | 'graph' | 'runtime' | 'pack' | 'interaction';
|
|
280
592
|
interface VerificationFinding {
|
|
281
593
|
id: string;
|
|
594
|
+
code?: string;
|
|
282
595
|
category: string;
|
|
283
596
|
severity: VerificationSeverity;
|
|
284
597
|
message: string;
|
|
@@ -287,6 +600,8 @@ interface VerificationFinding {
|
|
|
287
600
|
file?: string;
|
|
288
601
|
rule?: string;
|
|
289
602
|
suggestedFix?: string;
|
|
603
|
+
graph?: VerificationGraphAnchor;
|
|
604
|
+
repair?: VerificationRepairAction;
|
|
290
605
|
}
|
|
291
606
|
interface VerificationScore {
|
|
292
607
|
category: string;
|
|
@@ -350,8 +665,35 @@ interface ProjectHealthRemediation {
|
|
|
350
665
|
prompt: string;
|
|
351
666
|
commands: string[];
|
|
352
667
|
}
|
|
668
|
+
interface EvidenceRepairPlanAction {
|
|
669
|
+
id: string;
|
|
670
|
+
kind: string;
|
|
671
|
+
target?: string | null;
|
|
672
|
+
description: string;
|
|
673
|
+
payload?: Record<string, unknown>;
|
|
674
|
+
}
|
|
675
|
+
interface EvidenceRepairPlan {
|
|
676
|
+
id: string;
|
|
677
|
+
findingId: string;
|
|
678
|
+
diagnosticCode?: string | null;
|
|
679
|
+
repairId?: string | null;
|
|
680
|
+
severity: VerificationSeverity;
|
|
681
|
+
source: ProjectHealthFindingSource;
|
|
682
|
+
category: string;
|
|
683
|
+
graphAnchor?: VerificationGraphAnchor | null;
|
|
684
|
+
actions: EvidenceRepairPlanAction[];
|
|
685
|
+
evidence: Array<{
|
|
686
|
+
id: string;
|
|
687
|
+
text: string;
|
|
688
|
+
}>;
|
|
689
|
+
readTargets: string[];
|
|
690
|
+
preserve: string[];
|
|
691
|
+
avoid: string[];
|
|
692
|
+
commands: string[];
|
|
693
|
+
}
|
|
353
694
|
interface ProjectHealthFinding {
|
|
354
695
|
id: string;
|
|
696
|
+
code?: string;
|
|
355
697
|
source: ProjectHealthFindingSource;
|
|
356
698
|
category: string;
|
|
357
699
|
severity: VerificationSeverity;
|
|
@@ -361,6 +703,9 @@ interface ProjectHealthFinding {
|
|
|
361
703
|
file?: string;
|
|
362
704
|
rule?: string;
|
|
363
705
|
suggestedFix?: string;
|
|
706
|
+
graph?: VerificationGraphAnchor;
|
|
707
|
+
repair?: VerificationRepairAction;
|
|
708
|
+
repairPlan?: EvidenceRepairPlan;
|
|
364
709
|
remediation: ProjectHealthRemediation;
|
|
365
710
|
}
|
|
366
711
|
interface ProjectHealthRouteSummary {
|
|
@@ -379,6 +724,24 @@ interface ProjectHealthPackSummary {
|
|
|
379
724
|
mutationPackCount: number;
|
|
380
725
|
generatedAt: string | null;
|
|
381
726
|
}
|
|
727
|
+
interface ProjectHealthGraphSummary {
|
|
728
|
+
present: boolean;
|
|
729
|
+
ready: boolean;
|
|
730
|
+
current: boolean | null;
|
|
731
|
+
snapshotPresent: boolean;
|
|
732
|
+
manifestPresent: boolean;
|
|
733
|
+
diffPresent: boolean;
|
|
734
|
+
capsulePresent: boolean;
|
|
735
|
+
snapshotId: string | null;
|
|
736
|
+
sourceHash: string | null;
|
|
737
|
+
contractHash: string | null;
|
|
738
|
+
contractCacheKey: string | null;
|
|
739
|
+
sourceArtifactCount: number;
|
|
740
|
+
capsuleSourceArtifactLimit: number | null;
|
|
741
|
+
capsuleSourceArtifactsTruncated: boolean | null;
|
|
742
|
+
staleArtifacts: string[];
|
|
743
|
+
error: string | null;
|
|
744
|
+
}
|
|
382
745
|
interface ProjectHealthReport {
|
|
383
746
|
$schema: string;
|
|
384
747
|
generatedAt: string;
|
|
@@ -401,6 +764,7 @@ interface ProjectHealthReport {
|
|
|
401
764
|
};
|
|
402
765
|
routes: ProjectHealthRouteSummary;
|
|
403
766
|
packs: ProjectHealthPackSummary;
|
|
767
|
+
graph: ProjectHealthGraphSummary;
|
|
404
768
|
ci: {
|
|
405
769
|
recommendedCommand: string;
|
|
406
770
|
failOn: 'error' | 'warn' | 'none';
|
|
@@ -452,12 +816,17 @@ interface EvidenceBundle {
|
|
|
452
816
|
essence: EvidenceProvenanceEntry;
|
|
453
817
|
packManifest: EvidenceProvenanceEntry;
|
|
454
818
|
reviewPack: EvidenceProvenanceEntry;
|
|
819
|
+
graphSnapshot: EvidenceProvenanceEntry;
|
|
820
|
+
graphManifest: EvidenceProvenanceEntry;
|
|
821
|
+
graphDiff: EvidenceProvenanceEntry;
|
|
822
|
+
contractCapsule: EvidenceProvenanceEntry;
|
|
455
823
|
workspaceConfig?: EvidenceProvenanceEntry;
|
|
456
824
|
designTokens?: EvidenceProvenanceEntry;
|
|
457
825
|
};
|
|
458
826
|
assertions: ContractAssertion[];
|
|
459
827
|
findings: Array<{
|
|
460
828
|
id: string;
|
|
829
|
+
code?: string;
|
|
461
830
|
source: ProjectHealthFindingSource;
|
|
462
831
|
category: string;
|
|
463
832
|
severity: VerificationSeverity;
|
|
@@ -466,6 +835,9 @@ interface EvidenceBundle {
|
|
|
466
835
|
target?: string;
|
|
467
836
|
rule?: string;
|
|
468
837
|
suggestedFix?: string;
|
|
838
|
+
graph?: VerificationGraphAnchor;
|
|
839
|
+
repair?: VerificationRepairAction;
|
|
840
|
+
repairPlan?: EvidenceRepairPlan;
|
|
469
841
|
remediationSummary: string;
|
|
470
842
|
commands: string[];
|
|
471
843
|
promptCommand: string;
|
|
@@ -497,6 +869,7 @@ interface EvidenceBundleInput {
|
|
|
497
869
|
designTokens?: EvidenceBundle['designTokens'];
|
|
498
870
|
}
|
|
499
871
|
declare const EVIDENCE_BUNDLE_SCHEMA_URL = "https://decantr.ai/schemas/evidence-bundle.v1.json";
|
|
872
|
+
declare function buildProjectHealthRepairPlan(projectRoot: string, finding: ProjectHealthFinding): EvidenceRepairPlan;
|
|
500
873
|
declare function createContractAssertions(projectRoot: string, audit?: ProjectAuditReport | null): ContractAssertion[];
|
|
501
874
|
declare function createEvidenceBundle(input: EvidenceBundleInput): EvidenceBundle;
|
|
502
875
|
interface FileCritiqueReport {
|
|
@@ -610,9 +983,10 @@ interface ShowcaseShortlistVerificationReport {
|
|
|
610
983
|
results: ShowcaseShortlistVerificationEntry[];
|
|
611
984
|
}
|
|
612
985
|
declare function collectMissingPackManifestFiles(projectRoot: string, packManifest?: PackManifest | null): MissingPackManifestFile[];
|
|
986
|
+
declare function collectProjectSourceFiles(projectRoot: string): string[];
|
|
613
987
|
declare function extractRouteHintsFromEssence(essence: EssenceFile | null): string[];
|
|
614
988
|
declare function auditProject(projectRoot: string): Promise<ProjectAuditReport>;
|
|
615
989
|
declare function critiqueSource({ filePath, code, reviewPack, packManifest, treatmentsCss, adoptionMode, }: CritiqueSourceInput): FileCritiqueReport;
|
|
616
990
|
declare function critiqueFile(filePath: string, projectRoot: string): Promise<FileCritiqueReport>;
|
|
617
991
|
|
|
618
|
-
export { type BuiltDistAuditOptions, type ContractAssertion, type ContractAssertionCategory, type CritiqueSourceInput, EVIDENCE_BUNDLE_SCHEMA_URL, type EvidenceBundle, type EvidenceBundleInput, type EvidenceProvenanceEntry, type FileCritiqueReport, type GitHubScanInputResolution, INTERACTION_SIGNALS, type InteractionMissingFinding, type InteractionRequirement, type InteractionSignal, type MissingPackManifestFile, type PackManifest, type ProjectAuditReport, type ProjectHealthFinding, type ProjectHealthFindingSource, type ProjectHealthPackSummary, type ProjectHealthRemediation, type ProjectHealthReport, type ProjectHealthRouteSummary, type ProjectHealthStatus, type PublishedSiteProbeV1, type RuntimeAudit, SCAN_REPORT_SCHEMA_URL, type ScanApplicabilityStatus, type ScanConfidence, type ScanFindingSeverity, type ScanFindingV1, type ScanInputKind, type ScanInputV1, type ScanProjectOptions, type ScanReportV1, type ScanRepositoryV1, type ScanRouteV1, type ShowcaseShortlistVerificationEntry, type ShowcaseShortlistVerificationReport, VERIFICATION_SCHEMA_URLS, type VerificationFinding, type VerificationScore, type VerificationSeverity, auditBuiltDist, auditProject, collectMissingPackManifestFiles, createContractAssertions, createEvidenceBundle, createUnavailableScanReport, critiqueFile, critiqueSource, emptyRuntimeAudit, extractRouteHintsFromEssence, listKnownInteractions, probePublishedSite, resolveGitHubScanInput, scanProject, verifyInteractionsInSource };
|
|
992
|
+
export { type BuiltDistAuditOptions, COMPONENT_REUSE_RULE_ID, type CodeComponentDeclaration, type CodeImportReference, type ComponentReuseAudit, type ComponentReuseFinding, type ContractAssertion, type ContractAssertionCategory, type CritiqueSourceInput, EVIDENCE_BUNDLE_SCHEMA_URL, type EvidenceBundle, type EvidenceBundleInput, type EvidenceProvenanceEntry, type EvidenceRepairPlan, type EvidenceRepairPlanAction, type FileCritiqueReport, type GitHubScanInputResolution, type GraphAnchorEdge, type GraphAnchorFindingInput, type GraphAnchorNode, type GraphAnchorSnapshot, INTERACTION_SIGNALS, type InteractionMissingFinding, type InteractionRequirement, type InteractionSignal, KNOWN_VERIFICATION_DIAGNOSTICS, type MissingPackManifestFile, type PackManifest, type ProjectAuditReport, type ProjectHealthFinding, type ProjectHealthFindingSource, type ProjectHealthGraphSummary, type ProjectHealthPackSummary, type ProjectHealthRemediation, type ProjectHealthReport, type ProjectHealthRouteSummary, type ProjectHealthStatus, type PublishedSiteProbeV1, RAW_CONTROL_REUSE_RULE_ID, type RawControlReuseFinding, type RuntimeAudit, SCAN_REPORT_SCHEMA_URL, STYLE_BRIDGE_ARBITRARY_VALUE_RULE_ID, type ScanApplicabilityStatus, type ScanConfidence, type ScanFindingSeverity, type ScanFindingV1, type ScanInputKind, type ScanInputV1, type ScanProjectOptions, type ScanReportV1, type ScanRepositoryV1, type ScanRouteV1, type ShowcaseShortlistVerificationEntry, type ShowcaseShortlistVerificationReport, type StyleBridgeDriftAudit, type StyleBridgeDriftFinding, VERIFICATION_SCHEMA_URLS, type VerificationDiagnosticCatalogEntry, type VerificationDiagnosticInput, type VerificationDiagnosticMetadata, type VerificationFinding, type VerificationGraphAnchor, type VerificationGraphAnchorConfidence, type VerificationRepairAction, type VerificationScore, type VerificationSeverity, anchorFindingsToGraph, auditBuiltDist, auditComponentReuse, auditProject, auditStyleBridgeDrift, buildProjectHealthRepairPlan, collectMissingPackManifestFiles, collectProjectSourceFiles, createContractAssertions, createEvidenceBundle, createUnavailableScanReport, critiqueFile, critiqueSource, deriveVerificationDiagnostic, emptyRuntimeAudit, extractRouteHintsFromEssence, listKnownInteractions, probePublishedSite, resolveGitHubScanInput, resolveGraphAnchorForFinding, scanProject, verifyInteractionsInSource };
|