@contextrail/assess 0.0.0-stage → 1.0.0-alpha.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.
- package/LICENSE +202 -0
- package/README.md +82 -2
- package/assets/brand/icon-dark.png +0 -0
- package/assets/brand/icon-light.png +0 -0
- package/dist/assess.d.ts +109 -0
- package/dist/assess.js +1548 -0
- package/dist/assessment.d.ts +566 -0
- package/dist/assessment.js +404 -0
- package/dist/budget.d.ts +24 -0
- package/dist/budget.js +52 -0
- package/dist/candidate.d.ts +147 -0
- package/dist/candidate.js +321 -0
- package/dist/change-summary.d.ts +33 -0
- package/dist/change-summary.js +26 -0
- package/dist/cli.d.ts +2 -0
- package/dist/cli.js +406 -0
- package/dist/contracts.d.ts +99 -0
- package/dist/contracts.js +62 -0
- package/dist/diagnostics.d.ts +44 -0
- package/dist/diagnostics.js +412 -0
- package/dist/evidence.d.ts +73 -0
- package/dist/evidence.js +297 -0
- package/dist/feedback.d.ts +21 -0
- package/dist/feedback.js +140 -0
- package/dist/git.d.ts +40 -0
- package/dist/git.js +207 -0
- package/dist/github.d.ts +90 -0
- package/dist/github.js +1342 -0
- package/dist/index.d.ts +14 -0
- package/dist/index.js +14 -0
- package/dist/mcp.d.ts +28 -0
- package/dist/mcp.js +173 -0
- package/dist/pack.d.ts +160 -0
- package/dist/pack.js +377 -0
- package/dist/phases.d.ts +65 -0
- package/dist/phases.js +63 -0
- package/dist/planning.d.ts +64 -0
- package/dist/planning.js +135 -0
- package/dist/pr-context.d.ts +316 -0
- package/dist/pr-context.js +198 -0
- package/dist/prepare.d.ts +71 -0
- package/dist/prepare.js +335 -0
- package/dist/presentation.d.ts +309 -0
- package/dist/presentation.js +1026 -0
- package/dist/provider-diagnostics.d.ts +93 -0
- package/dist/provider-diagnostics.js +233 -0
- package/dist/providers.d.ts +45 -0
- package/dist/providers.js +291 -0
- package/dist/report-contract.d.ts +132 -0
- package/dist/report-contract.js +240 -0
- package/dist/results.d.ts +90 -0
- package/dist/results.js +128 -0
- package/dist/resume.d.ts +25 -0
- package/dist/resume.js +116 -0
- package/dist/source.d.ts +167 -0
- package/dist/source.js +675 -0
- package/dist/verification.d.ts +386 -0
- package/dist/verification.js +168 -0
- package/dist/version.d.ts +2 -0
- package/dist/version.js +9 -0
- package/docs/README.md +24 -0
- package/docs/action-reference.md +85 -0
- package/docs/architecture.md +156 -0
- package/docs/configuration.md +83 -0
- package/docs/contributing.md +46 -0
- package/docs/getting-started.md +92 -0
- package/docs/github-actions.md +141 -0
- package/docs/operations.md +203 -0
- package/docs/review-results.md +173 -0
- package/docs/security.md +64 -0
- package/docs/standards.md +62 -0
- package/examples/assess-pull-request.yml +109 -0
- package/package.json +56 -5
|
@@ -0,0 +1,309 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
export declare const object: (value: unknown) => Record<string, unknown>;
|
|
3
|
+
export declare const objects: (value: unknown) => Record<string, unknown>[];
|
|
4
|
+
export declare const string: (value: unknown, fallback?: string) => string;
|
|
5
|
+
export declare function developerFindingLocations(finding: Record<string, unknown>): string;
|
|
6
|
+
export declare function developerFindingGroupLabel(accounts: Record<string, unknown>[]): string;
|
|
7
|
+
/** Display connected overlapping pinned ranges; preserve every account without asserting semantic equivalence. */
|
|
8
|
+
export declare function groupDeveloperFindings(input: unknown): Record<string, unknown>[][];
|
|
9
|
+
export declare function markdownText(value: unknown, limit?: number): string;
|
|
10
|
+
declare const runSchema: z.ZodObject<{
|
|
11
|
+
id: z.ZodString;
|
|
12
|
+
attempt: z.ZodNumber;
|
|
13
|
+
cliRunId: z.ZodNullable<z.ZodString>;
|
|
14
|
+
base: z.ZodNullable<z.ZodString>;
|
|
15
|
+
head: z.ZodNullable<z.ZodString>;
|
|
16
|
+
at: z.ZodISODateTime;
|
|
17
|
+
assessment: z.ZodEnum<{
|
|
18
|
+
unknown: "unknown";
|
|
19
|
+
complete: "complete";
|
|
20
|
+
incomplete: "incomplete";
|
|
21
|
+
not_started: "not_started";
|
|
22
|
+
running: "running";
|
|
23
|
+
}>;
|
|
24
|
+
execution: z.ZodEnum<{
|
|
25
|
+
unknown: "unknown";
|
|
26
|
+
failed: "failed";
|
|
27
|
+
finished: "finished";
|
|
28
|
+
}>;
|
|
29
|
+
exit: z.ZodNullable<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
|
|
30
|
+
findings: z.ZodNumber;
|
|
31
|
+
unresolved: z.ZodNumber;
|
|
32
|
+
durationMs: z.ZodNullable<z.ZodNumber>;
|
|
33
|
+
cost: z.ZodNullable<z.ZodNumber>;
|
|
34
|
+
costComplete: z.ZodBoolean;
|
|
35
|
+
packageVersion: z.ZodString;
|
|
36
|
+
reviewerVersion: z.ZodNullable<z.ZodNumber>;
|
|
37
|
+
provider: z.ZodEnum<{
|
|
38
|
+
unknown: "unknown";
|
|
39
|
+
openai: "openai";
|
|
40
|
+
openrouter: "openrouter";
|
|
41
|
+
}>;
|
|
42
|
+
model: z.ZodString;
|
|
43
|
+
effort: z.ZodEnum<{
|
|
44
|
+
"": "";
|
|
45
|
+
none: "none";
|
|
46
|
+
minimal: "minimal";
|
|
47
|
+
low: "low";
|
|
48
|
+
medium: "medium";
|
|
49
|
+
high: "high";
|
|
50
|
+
xhigh: "xhigh";
|
|
51
|
+
}>;
|
|
52
|
+
phaseModels: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
53
|
+
phase: z.ZodString;
|
|
54
|
+
provider: z.ZodEnum<{
|
|
55
|
+
unknown: "unknown";
|
|
56
|
+
openai: "openai";
|
|
57
|
+
openrouter: "openrouter";
|
|
58
|
+
}>;
|
|
59
|
+
model: z.ZodString;
|
|
60
|
+
effort: z.ZodEnum<{
|
|
61
|
+
"": "";
|
|
62
|
+
none: "none";
|
|
63
|
+
minimal: "minimal";
|
|
64
|
+
low: "low";
|
|
65
|
+
medium: "medium";
|
|
66
|
+
high: "high";
|
|
67
|
+
xhigh: "xhigh";
|
|
68
|
+
}>;
|
|
69
|
+
}, z.core.$strict>>>;
|
|
70
|
+
}, z.core.$strict>;
|
|
71
|
+
declare const assessmentSchema: z.ZodObject<{
|
|
72
|
+
base: z.ZodString;
|
|
73
|
+
head: z.ZodString;
|
|
74
|
+
run: z.ZodString;
|
|
75
|
+
cliRunId: z.ZodString;
|
|
76
|
+
attempt: z.ZodNumber;
|
|
77
|
+
reviewerVersion: z.ZodNullable<z.ZodNumber>;
|
|
78
|
+
scopeIdentity: z.ZodString;
|
|
79
|
+
provider: z.ZodEnum<{
|
|
80
|
+
unknown: "unknown";
|
|
81
|
+
openai: "openai";
|
|
82
|
+
openrouter: "openrouter";
|
|
83
|
+
}>;
|
|
84
|
+
model: z.ZodString;
|
|
85
|
+
effort: z.ZodEnum<{
|
|
86
|
+
"": "";
|
|
87
|
+
none: "none";
|
|
88
|
+
minimal: "minimal";
|
|
89
|
+
low: "low";
|
|
90
|
+
medium: "medium";
|
|
91
|
+
high: "high";
|
|
92
|
+
xhigh: "xhigh";
|
|
93
|
+
}>;
|
|
94
|
+
entries: z.ZodArray<z.ZodObject<{
|
|
95
|
+
nodeId: z.ZodString;
|
|
96
|
+
version: z.ZodNumber;
|
|
97
|
+
disposition: z.ZodEnum<{
|
|
98
|
+
not_evaluated: "not_evaluated";
|
|
99
|
+
evaluated: "evaluated";
|
|
100
|
+
observed: "observed";
|
|
101
|
+
not_applicable: "not_applicable";
|
|
102
|
+
unresolved: "unresolved";
|
|
103
|
+
}>;
|
|
104
|
+
finding: z.ZodEnum<{
|
|
105
|
+
none: "none";
|
|
106
|
+
binding_violation: "binding_violation";
|
|
107
|
+
behavioral_defect: "behavioral_defect";
|
|
108
|
+
guidance_departure: "guidance_departure";
|
|
109
|
+
}>;
|
|
110
|
+
explanation: z.ZodString;
|
|
111
|
+
correction: z.ZodString;
|
|
112
|
+
}, z.core.$strict>>;
|
|
113
|
+
omitted: z.ZodNumber;
|
|
114
|
+
}, z.core.$strict>;
|
|
115
|
+
declare const historySchema: z.ZodObject<{
|
|
116
|
+
version: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>;
|
|
117
|
+
repository: z.ZodString;
|
|
118
|
+
pr: z.ZodNumber;
|
|
119
|
+
reviewer: z.ZodString;
|
|
120
|
+
runs: z.ZodArray<z.ZodObject<{
|
|
121
|
+
id: z.ZodString;
|
|
122
|
+
attempt: z.ZodNumber;
|
|
123
|
+
cliRunId: z.ZodNullable<z.ZodString>;
|
|
124
|
+
base: z.ZodNullable<z.ZodString>;
|
|
125
|
+
head: z.ZodNullable<z.ZodString>;
|
|
126
|
+
at: z.ZodISODateTime;
|
|
127
|
+
assessment: z.ZodEnum<{
|
|
128
|
+
unknown: "unknown";
|
|
129
|
+
complete: "complete";
|
|
130
|
+
incomplete: "incomplete";
|
|
131
|
+
not_started: "not_started";
|
|
132
|
+
running: "running";
|
|
133
|
+
}>;
|
|
134
|
+
execution: z.ZodEnum<{
|
|
135
|
+
unknown: "unknown";
|
|
136
|
+
failed: "failed";
|
|
137
|
+
finished: "finished";
|
|
138
|
+
}>;
|
|
139
|
+
exit: z.ZodNullable<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
|
|
140
|
+
findings: z.ZodNumber;
|
|
141
|
+
unresolved: z.ZodNumber;
|
|
142
|
+
durationMs: z.ZodNullable<z.ZodNumber>;
|
|
143
|
+
cost: z.ZodNullable<z.ZodNumber>;
|
|
144
|
+
costComplete: z.ZodBoolean;
|
|
145
|
+
packageVersion: z.ZodString;
|
|
146
|
+
reviewerVersion: z.ZodNullable<z.ZodNumber>;
|
|
147
|
+
provider: z.ZodEnum<{
|
|
148
|
+
unknown: "unknown";
|
|
149
|
+
openai: "openai";
|
|
150
|
+
openrouter: "openrouter";
|
|
151
|
+
}>;
|
|
152
|
+
model: z.ZodString;
|
|
153
|
+
effort: z.ZodEnum<{
|
|
154
|
+
"": "";
|
|
155
|
+
none: "none";
|
|
156
|
+
minimal: "minimal";
|
|
157
|
+
low: "low";
|
|
158
|
+
medium: "medium";
|
|
159
|
+
high: "high";
|
|
160
|
+
xhigh: "xhigh";
|
|
161
|
+
}>;
|
|
162
|
+
phaseModels: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
163
|
+
phase: z.ZodString;
|
|
164
|
+
provider: z.ZodEnum<{
|
|
165
|
+
unknown: "unknown";
|
|
166
|
+
openai: "openai";
|
|
167
|
+
openrouter: "openrouter";
|
|
168
|
+
}>;
|
|
169
|
+
model: z.ZodString;
|
|
170
|
+
effort: z.ZodEnum<{
|
|
171
|
+
"": "";
|
|
172
|
+
none: "none";
|
|
173
|
+
minimal: "minimal";
|
|
174
|
+
low: "low";
|
|
175
|
+
medium: "medium";
|
|
176
|
+
high: "high";
|
|
177
|
+
xhigh: "xhigh";
|
|
178
|
+
}>;
|
|
179
|
+
}, z.core.$strict>>>;
|
|
180
|
+
}, z.core.$strict>>;
|
|
181
|
+
omitted: z.ZodNumber;
|
|
182
|
+
assessment: z.ZodNullable<z.ZodObject<{
|
|
183
|
+
base: z.ZodString;
|
|
184
|
+
head: z.ZodString;
|
|
185
|
+
run: z.ZodString;
|
|
186
|
+
cliRunId: z.ZodString;
|
|
187
|
+
attempt: z.ZodNumber;
|
|
188
|
+
reviewerVersion: z.ZodNullable<z.ZodNumber>;
|
|
189
|
+
scopeIdentity: z.ZodString;
|
|
190
|
+
provider: z.ZodEnum<{
|
|
191
|
+
unknown: "unknown";
|
|
192
|
+
openai: "openai";
|
|
193
|
+
openrouter: "openrouter";
|
|
194
|
+
}>;
|
|
195
|
+
model: z.ZodString;
|
|
196
|
+
effort: z.ZodEnum<{
|
|
197
|
+
"": "";
|
|
198
|
+
none: "none";
|
|
199
|
+
minimal: "minimal";
|
|
200
|
+
low: "low";
|
|
201
|
+
medium: "medium";
|
|
202
|
+
high: "high";
|
|
203
|
+
xhigh: "xhigh";
|
|
204
|
+
}>;
|
|
205
|
+
entries: z.ZodArray<z.ZodObject<{
|
|
206
|
+
nodeId: z.ZodString;
|
|
207
|
+
version: z.ZodNumber;
|
|
208
|
+
disposition: z.ZodEnum<{
|
|
209
|
+
not_evaluated: "not_evaluated";
|
|
210
|
+
evaluated: "evaluated";
|
|
211
|
+
observed: "observed";
|
|
212
|
+
not_applicable: "not_applicable";
|
|
213
|
+
unresolved: "unresolved";
|
|
214
|
+
}>;
|
|
215
|
+
finding: z.ZodEnum<{
|
|
216
|
+
none: "none";
|
|
217
|
+
binding_violation: "binding_violation";
|
|
218
|
+
behavioral_defect: "behavioral_defect";
|
|
219
|
+
guidance_departure: "guidance_departure";
|
|
220
|
+
}>;
|
|
221
|
+
explanation: z.ZodString;
|
|
222
|
+
correction: z.ZodString;
|
|
223
|
+
}, z.core.$strict>>;
|
|
224
|
+
omitted: z.ZodNumber;
|
|
225
|
+
}, z.core.$strict>>;
|
|
226
|
+
}, z.core.$strict>;
|
|
227
|
+
export type HistoryConfiguration = {
|
|
228
|
+
repository: string;
|
|
229
|
+
pr: number;
|
|
230
|
+
reviewer: string;
|
|
231
|
+
};
|
|
232
|
+
export type AssessmentHistory = z.infer<typeof historySchema>;
|
|
233
|
+
export type RunRecord = {
|
|
234
|
+
row: z.infer<typeof runSchema>;
|
|
235
|
+
assessment: z.infer<typeof assessmentSchema> | null;
|
|
236
|
+
};
|
|
237
|
+
export declare const assessmentMarker: (config: HistoryConfiguration | string) => string;
|
|
238
|
+
export declare function readHistory(body: unknown, c: HistoryConfiguration): AssessmentHistory | null;
|
|
239
|
+
export declare function summarizeUsage(state: unknown): {
|
|
240
|
+
calls: number | null;
|
|
241
|
+
cost: {
|
|
242
|
+
value: number | null;
|
|
243
|
+
reported: number;
|
|
244
|
+
complete: boolean;
|
|
245
|
+
};
|
|
246
|
+
input: {
|
|
247
|
+
value: number | null;
|
|
248
|
+
reported: number;
|
|
249
|
+
complete: boolean;
|
|
250
|
+
};
|
|
251
|
+
output: {
|
|
252
|
+
value: number | null;
|
|
253
|
+
reported: number;
|
|
254
|
+
complete: boolean;
|
|
255
|
+
};
|
|
256
|
+
total: {
|
|
257
|
+
value: number | null;
|
|
258
|
+
reported: number;
|
|
259
|
+
complete: boolean;
|
|
260
|
+
};
|
|
261
|
+
cached: {
|
|
262
|
+
value: number | null;
|
|
263
|
+
reported: number;
|
|
264
|
+
complete: boolean;
|
|
265
|
+
};
|
|
266
|
+
reasoning: {
|
|
267
|
+
value: number | null;
|
|
268
|
+
reported: number;
|
|
269
|
+
complete: boolean;
|
|
270
|
+
};
|
|
271
|
+
};
|
|
272
|
+
export type PresentationOptions = {
|
|
273
|
+
artifactUrl?: string;
|
|
274
|
+
runUrl?: string;
|
|
275
|
+
packageVersion?: string;
|
|
276
|
+
failedStage?: string;
|
|
277
|
+
diagnostic?: string;
|
|
278
|
+
comparisonStatus?: string;
|
|
279
|
+
reviewExit?: number | null;
|
|
280
|
+
artifactOutcome?: string;
|
|
281
|
+
feedback?: string;
|
|
282
|
+
};
|
|
283
|
+
/** Human progress from complete canonical assessment handoffs; never promotes proposals to verdicts. */
|
|
284
|
+
export declare function assessmentCoverage(input: unknown): {
|
|
285
|
+
total: number;
|
|
286
|
+
assessed: number;
|
|
287
|
+
currentAssessments: number;
|
|
288
|
+
savedProposals: number;
|
|
289
|
+
verified: number;
|
|
290
|
+
awaitingVerification: number;
|
|
291
|
+
needsReassessment: number;
|
|
292
|
+
unexamined: number;
|
|
293
|
+
entries: {
|
|
294
|
+
assessmentId: string;
|
|
295
|
+
status: string;
|
|
296
|
+
}[];
|
|
297
|
+
};
|
|
298
|
+
/** Human orientation is separate from the governed result and never controls enforcement. */
|
|
299
|
+
export declare function renderReaderGuidance(input: unknown): string;
|
|
300
|
+
export declare function assessmentProgressLabel(status: string, focused?: boolean): string;
|
|
301
|
+
export declare function renderAssessmentReport(input: unknown, options?: PresentationOptions): string;
|
|
302
|
+
/** Compact developer view; the Action summary retains the complete audit explanation. */
|
|
303
|
+
export declare function renderAssessmentComment(input: unknown, options?: PresentationOptions): string;
|
|
304
|
+
export declare function renderActionSummary(input: unknown, options?: PresentationOptions): string;
|
|
305
|
+
export declare function runRecord(config: HistoryConfiguration & Record<string, unknown>, fixed: unknown, input: unknown, exit: unknown, cost: unknown, costComplete: boolean): RunRecord;
|
|
306
|
+
export declare function withHistory(summary: string, previous: {
|
|
307
|
+
body?: unknown;
|
|
308
|
+
} | null, current: RunRecord, c: HistoryConfiguration): string;
|
|
309
|
+
export {};
|