devcontour-harness 0.1.0-alpha.24 → 0.1.0-alpha.26
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 +44 -2
- package/docs/architecture.md +13 -0
- package/docs/compatibility.md +2 -0
- package/docs/connectors.md +69 -3
- package/docs/contracts.md +15 -1
- package/docs/release-notes/0.1.0-alpha.25.md +33 -0
- package/docs/release-notes/0.1.0-alpha.26.md +35 -0
- package/docs/review-protocol.md +9 -1
- package/lib/agents/cli-adapter.d.ts +6 -0
- package/lib/agents/cli-adapter.js +12 -2
- package/lib/agents/review-probe.d.ts +5 -0
- package/lib/agents/review-probe.js +29 -9
- package/lib/agents/schemas.d.ts +4 -0
- package/lib/agents/schemas.js +3 -1
- package/lib/cli.js +9 -5
- package/lib/contracts/cli.d.ts +60 -1
- package/lib/contracts/cli.js +36 -2
- package/lib/contracts/failure.js +1 -1
- package/lib/contracts/ports.d.ts +17 -0
- package/lib/contracts/review.d.ts +69 -0
- package/lib/contracts/review.js +29 -14
- package/lib/contracts/work.d.ts +6 -0
- package/lib/contracts/work.js +13 -12
- package/lib/control/review.js +9 -2
- package/lib/engine/engine.js +4 -2
- package/lib/engine/prompt.js +8 -2
- package/lib/engine/runner.js +7 -3
- package/lib/environment/bounded-read.d.ts +12 -0
- package/lib/environment/bounded-read.js +40 -0
- package/lib/integrations/connector/commands.d.ts +35 -7
- package/lib/integrations/connector/commands.js +52 -7
- package/lib/integrations/connector/config.d.ts +37 -0
- package/lib/integrations/connector/config.js +37 -5
- package/lib/integrations/connector/delivery.js +17 -1
- package/lib/integrations/connector/index.d.ts +2 -2
- package/lib/integrations/connector/index.js +1 -1
- package/lib/integrations/connector/snapshot.d.ts +10 -8
- package/lib/integrations/connector/snapshot.js +78 -8
- package/lib/integrations/connector/source.d.ts +8 -2
- package/lib/integrations/connector/source.js +32 -6
- package/lib/integrations/connector/summary.d.ts +6 -0
- package/lib/integrations/connector/summary.js +5 -0
- package/lib/integrations/connector/testing.js +18 -0
- package/lib/integrations/relay-v1/index.js +6 -4
- package/lib/integrations/relay-v2/protocol.js +8 -6
- package/lib/verification/confirm.js +10 -2
- package/lib/verification/gates.js +34 -12
- package/lib/verification/joint.d.ts +120 -1
- package/lib/verification/joint.js +38 -1
- package/package.json +6 -3
package/lib/contracts/cli.d.ts
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
2
|
import { API_VERSION } from './version.ts';
|
|
3
|
-
import { type ErrorCode } from './errors.ts';
|
|
3
|
+
import { HarnessError, type ErrorCode } from './errors.ts';
|
|
4
4
|
/**
|
|
5
5
|
* Договор CLI `harness`.
|
|
6
6
|
*
|
|
@@ -1165,6 +1165,11 @@ export declare const runDataSchema: z.ZodObject<{
|
|
|
1165
1165
|
graphId: z.ZodString;
|
|
1166
1166
|
digest: z.ZodString;
|
|
1167
1167
|
resumed: z.ZodBoolean;
|
|
1168
|
+
baseline: z.ZodOptional<z.ZodObject<{
|
|
1169
|
+
sha: z.ZodString;
|
|
1170
|
+
reason: z.ZodString;
|
|
1171
|
+
tasks: z.ZodArray<z.ZodString>;
|
|
1172
|
+
}, z.core.$strict>>;
|
|
1168
1173
|
works: z.ZodArray<z.ZodObject<{
|
|
1169
1174
|
id: z.ZodString;
|
|
1170
1175
|
status: z.ZodEnum<{
|
|
@@ -1597,16 +1602,37 @@ export declare const sourceCheckDataSchema: z.ZodObject<{
|
|
|
1597
1602
|
}, z.core.$strict>;
|
|
1598
1603
|
problems: z.ZodArray<z.ZodString>;
|
|
1599
1604
|
}, z.core.$strict>;
|
|
1605
|
+
/** Закреплённый локальный пакет `tasks[].context`: то, что называет manifest снимка. */
|
|
1606
|
+
export declare const localContextManifestSchema: z.ZodObject<{
|
|
1607
|
+
id: z.ZodString;
|
|
1608
|
+
digest: z.ZodString;
|
|
1609
|
+
files: z.ZodNumber;
|
|
1610
|
+
references: z.ZodNumber;
|
|
1611
|
+
bytes: z.ZodNumber;
|
|
1612
|
+
}, z.core.$strict>;
|
|
1613
|
+
export type LocalContextManifest = z.infer<typeof localContextManifestSchema>;
|
|
1600
1614
|
export declare const sourceSnapshotDataSchema: z.ZodObject<{
|
|
1601
1615
|
connector: z.ZodString;
|
|
1602
1616
|
graphId: z.ZodString;
|
|
1603
1617
|
graphDigest: z.ZodString;
|
|
1604
1618
|
contextDigest: z.ZodString;
|
|
1619
|
+
localContext: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
1620
|
+
id: z.ZodString;
|
|
1621
|
+
digest: z.ZodString;
|
|
1622
|
+
files: z.ZodNumber;
|
|
1623
|
+
references: z.ZodNumber;
|
|
1624
|
+
bytes: z.ZodNumber;
|
|
1625
|
+
}, z.core.$strict>>>;
|
|
1605
1626
|
revision: z.ZodString;
|
|
1606
1627
|
created: z.ZodBoolean;
|
|
1607
1628
|
eligible: z.ZodBoolean;
|
|
1608
1629
|
problems: z.ZodArray<z.ZodString>;
|
|
1609
1630
|
truncated: z.ZodArray<z.ZodString>;
|
|
1631
|
+
baseline: z.ZodOptional<z.ZodObject<{
|
|
1632
|
+
sha: z.ZodString;
|
|
1633
|
+
reason: z.ZodString;
|
|
1634
|
+
tasks: z.ZodArray<z.ZodString>;
|
|
1635
|
+
}, z.core.$strict>>;
|
|
1610
1636
|
tasks: z.ZodArray<z.ZodObject<{
|
|
1611
1637
|
identity: z.ZodString;
|
|
1612
1638
|
key: z.ZodString;
|
|
@@ -1631,6 +1657,11 @@ export declare const sourceStatusDataSchema: z.ZodObject<{
|
|
|
1631
1657
|
snapshot: z.ZodOptional<z.ZodObject<{
|
|
1632
1658
|
revision: z.ZodString;
|
|
1633
1659
|
graphId: z.ZodString;
|
|
1660
|
+
baseline: z.ZodOptional<z.ZodObject<{
|
|
1661
|
+
sha: z.ZodString;
|
|
1662
|
+
reason: z.ZodString;
|
|
1663
|
+
tasks: z.ZodArray<z.ZodString>;
|
|
1664
|
+
}, z.core.$strict>>;
|
|
1634
1665
|
}, z.core.$strict>>;
|
|
1635
1666
|
ownership: z.ZodObject<{
|
|
1636
1667
|
stateDir: z.ZodString;
|
|
@@ -2089,6 +2120,11 @@ export declare const cliDataSchemas: {
|
|
|
2089
2120
|
graphId: z.ZodString;
|
|
2090
2121
|
digest: z.ZodString;
|
|
2091
2122
|
resumed: z.ZodBoolean;
|
|
2123
|
+
baseline: z.ZodOptional<z.ZodObject<{
|
|
2124
|
+
sha: z.ZodString;
|
|
2125
|
+
reason: z.ZodString;
|
|
2126
|
+
tasks: z.ZodArray<z.ZodString>;
|
|
2127
|
+
}, z.core.$strict>>;
|
|
2092
2128
|
works: z.ZodArray<z.ZodObject<{
|
|
2093
2129
|
id: z.ZodString;
|
|
2094
2130
|
status: z.ZodEnum<{
|
|
@@ -4529,11 +4565,23 @@ export declare const cliDataSchemas: {
|
|
|
4529
4565
|
graphId: z.ZodString;
|
|
4530
4566
|
graphDigest: z.ZodString;
|
|
4531
4567
|
contextDigest: z.ZodString;
|
|
4568
|
+
localContext: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
4569
|
+
id: z.ZodString;
|
|
4570
|
+
digest: z.ZodString;
|
|
4571
|
+
files: z.ZodNumber;
|
|
4572
|
+
references: z.ZodNumber;
|
|
4573
|
+
bytes: z.ZodNumber;
|
|
4574
|
+
}, z.core.$strict>>>;
|
|
4532
4575
|
revision: z.ZodString;
|
|
4533
4576
|
created: z.ZodBoolean;
|
|
4534
4577
|
eligible: z.ZodBoolean;
|
|
4535
4578
|
problems: z.ZodArray<z.ZodString>;
|
|
4536
4579
|
truncated: z.ZodArray<z.ZodString>;
|
|
4580
|
+
baseline: z.ZodOptional<z.ZodObject<{
|
|
4581
|
+
sha: z.ZodString;
|
|
4582
|
+
reason: z.ZodString;
|
|
4583
|
+
tasks: z.ZodArray<z.ZodString>;
|
|
4584
|
+
}, z.core.$strict>>;
|
|
4537
4585
|
tasks: z.ZodArray<z.ZodObject<{
|
|
4538
4586
|
identity: z.ZodString;
|
|
4539
4587
|
key: z.ZodString;
|
|
@@ -4558,6 +4606,11 @@ export declare const cliDataSchemas: {
|
|
|
4558
4606
|
snapshot: z.ZodOptional<z.ZodObject<{
|
|
4559
4607
|
revision: z.ZodString;
|
|
4560
4608
|
graphId: z.ZodString;
|
|
4609
|
+
baseline: z.ZodOptional<z.ZodObject<{
|
|
4610
|
+
sha: z.ZodString;
|
|
4611
|
+
reason: z.ZodString;
|
|
4612
|
+
tasks: z.ZodArray<z.ZodString>;
|
|
4613
|
+
}, z.core.$strict>>;
|
|
4561
4614
|
}, z.core.$strict>>;
|
|
4562
4615
|
ownership: z.ZodObject<{
|
|
4563
4616
|
stateDir: z.ZodString;
|
|
@@ -4728,6 +4781,12 @@ export declare const cliErrorSchema: z.ZodObject<{
|
|
|
4728
4781
|
message: z.ZodString;
|
|
4729
4782
|
}, z.core.$strict>>;
|
|
4730
4783
|
}, z.core.$strict>;
|
|
4784
|
+
/**
|
|
4785
|
+
* Нарушение схемы внутри harness (ответ команды вне договора, собственная
|
|
4786
|
+
* запись) — дефект, а не ошибка ввода: INTERNAL с путями полей вместо дампа
|
|
4787
|
+
* ZodError в сообщении.
|
|
4788
|
+
*/
|
|
4789
|
+
export declare const contractViolation: (error: z.ZodError) => HarnessError;
|
|
4731
4790
|
export type CliEnvelope<C extends CliCommand | 'version' = CliCommand | 'version'> = {
|
|
4732
4791
|
apiVersion: typeof API_VERSION;
|
|
4733
4792
|
command: C;
|
package/lib/contracts/cli.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
2
|
import { API_VERSION, STATE_VERSION } from "./version.js";
|
|
3
3
|
import { digestSchema, gitShaSchema, idSchema, isoTimeSchema, runtimeNameSchema, targetRefSchema, } from "./primitives.js";
|
|
4
|
-
import { errorCodes } from "./errors.js";
|
|
4
|
+
import { HarnessError, errorCodes } from "./errors.js";
|
|
5
5
|
import { controlStateSchema, controllerLeaseSchema, workStatusSchema } from "./execution.js";
|
|
6
6
|
import { runEventSchema } from "./events.js";
|
|
7
7
|
import { deliveryStateSchema, resultEnvelopeSchema } from "./result.js";
|
|
@@ -573,11 +573,18 @@ export const eventsDataSchema = z.strictObject({
|
|
|
573
573
|
/** Номер для следующего `--after`. */
|
|
574
574
|
next: z.number().int().min(0),
|
|
575
575
|
});
|
|
576
|
+
/** Зависимости, принятые человеком по базовой линии: решение, а не доказательство. */
|
|
577
|
+
const baselineViewSchema = z.strictObject({
|
|
578
|
+
sha: gitShaSchema,
|
|
579
|
+
reason: z.string(),
|
|
580
|
+
tasks: z.array(z.string()),
|
|
581
|
+
});
|
|
576
582
|
export const runDataSchema = z.strictObject({
|
|
577
583
|
graphId: idSchema,
|
|
578
584
|
digest: digestSchema,
|
|
579
585
|
/** Граф уже был зарегистрирован этой редакцией: работа продолжена. */
|
|
580
586
|
resumed: z.boolean(),
|
|
587
|
+
baseline: baselineViewSchema.optional(),
|
|
581
588
|
works: z.array(z.strictObject({
|
|
582
589
|
id: idSchema,
|
|
583
590
|
status: workStatusSchema,
|
|
@@ -687,17 +694,28 @@ export const sourceCheckDataSchema = z.strictObject({
|
|
|
687
694
|
ownership: ownershipSchema,
|
|
688
695
|
problems: z.array(z.string()),
|
|
689
696
|
});
|
|
697
|
+
/** Закреплённый локальный пакет `tasks[].context`: то, что называет manifest снимка. */
|
|
698
|
+
export const localContextManifestSchema = z.strictObject({
|
|
699
|
+
id: idSchema,
|
|
700
|
+
digest: digestSchema,
|
|
701
|
+
files: z.number().int().nonnegative(),
|
|
702
|
+
references: z.number().int().nonnegative(),
|
|
703
|
+
bytes: z.number().int().nonnegative(),
|
|
704
|
+
});
|
|
690
705
|
export const sourceSnapshotDataSchema = z.strictObject({
|
|
691
706
|
connector: idSchema,
|
|
692
707
|
graphId: idSchema,
|
|
693
708
|
graphDigest: digestSchema,
|
|
694
709
|
contextDigest: digestSchema,
|
|
710
|
+
/** Пакеты `tasks[].context`; без них поля нет. */
|
|
711
|
+
localContext: z.array(localContextManifestSchema).optional(),
|
|
695
712
|
/** Semantic digest набора задач (`graph.source.revision`); не Git SHA. */
|
|
696
713
|
revision: digestSchema,
|
|
697
714
|
created: z.boolean(),
|
|
698
715
|
eligible: z.boolean(),
|
|
699
716
|
problems: z.array(z.string()),
|
|
700
717
|
truncated: z.array(z.string()),
|
|
718
|
+
baseline: baselineViewSchema.optional(),
|
|
701
719
|
tasks: z.array(z.strictObject({
|
|
702
720
|
identity: z.string(),
|
|
703
721
|
key: z.string(),
|
|
@@ -727,7 +745,13 @@ export const sourceStatusDataSchema = z.strictObject({
|
|
|
727
745
|
connector: idSchema,
|
|
728
746
|
provider: providerSchema,
|
|
729
747
|
projectId: z.string(),
|
|
730
|
-
snapshot: z
|
|
748
|
+
snapshot: z
|
|
749
|
+
.strictObject({
|
|
750
|
+
revision: digestSchema,
|
|
751
|
+
graphId: idSchema,
|
|
752
|
+
baseline: baselineViewSchema.optional(),
|
|
753
|
+
})
|
|
754
|
+
.optional(),
|
|
731
755
|
ownership: ownershipSchema,
|
|
732
756
|
tasks: z.array(z.strictObject({
|
|
733
757
|
index: z.number().int(),
|
|
@@ -847,5 +871,15 @@ export const cliErrorSchema = z.strictObject({
|
|
|
847
871
|
message: z.string(),
|
|
848
872
|
issues: z.array(z.strictObject({ path: z.array(z.union([z.string(), z.number()])), message: z.string() })),
|
|
849
873
|
});
|
|
874
|
+
/**
|
|
875
|
+
* Нарушение схемы внутри harness (ответ команды вне договора, собственная
|
|
876
|
+
* запись) — дефект, а не ошибка ввода: INTERNAL с путями полей вместо дампа
|
|
877
|
+
* ZodError в сообщении.
|
|
878
|
+
*/
|
|
879
|
+
export const contractViolation = (error) => new HarnessError('INTERNAL', 'Данные harness не соответствуют его договору (дефект harness, а не настроек): ' +
|
|
880
|
+
error.issues.map((i) => `${i.path.join('.') || '(корень)'}: ${i.message}`).join('; '), error.issues.map((i) => ({
|
|
881
|
+
path: i.path.filter((p) => typeof p !== 'symbol'),
|
|
882
|
+
message: i.message,
|
|
883
|
+
})));
|
|
850
884
|
/** Входной документ контракта для `review-contract` — см. `checks.ts`. */
|
|
851
885
|
export { contractDocumentSchema } from "./checks.js";
|
package/lib/contracts/failure.js
CHANGED
|
@@ -46,7 +46,7 @@ export function failureFingerprint(kind, message) {
|
|
|
46
46
|
// Предел выше всей диагностики проверки (оба потока и упавшие testcases,
|
|
47
47
|
// каждое со своим лимитом): при прежних 300 символах ошибка stderr
|
|
48
48
|
// оказывалась за пределом, и разные провалы получали один отпечаток.
|
|
49
|
-
.slice(0,
|
|
49
|
+
.slice(0, 4000);
|
|
50
50
|
return createHash('sha256')
|
|
51
51
|
.update(kind + '\n' + normalized)
|
|
52
52
|
.digest('hex')
|
package/lib/contracts/ports.d.ts
CHANGED
|
@@ -295,6 +295,13 @@ export interface ResultSink {
|
|
|
295
295
|
result: RunResult;
|
|
296
296
|
}): Promise<DeliveryOutcome>;
|
|
297
297
|
}
|
|
298
|
+
/** Принятая доверенным хостом граница завершённого цикла совместной проверки. */
|
|
299
|
+
export interface JointBudgetCheckpoint {
|
|
300
|
+
/** Успешная проверка, которую хост действительно принял. */
|
|
301
|
+
readonly verificationId: string;
|
|
302
|
+
/** Неизменяемый снимок завершённых проверок при принятии, включая verificationId. */
|
|
303
|
+
readonly settledVerificationIds: readonly string[];
|
|
304
|
+
}
|
|
298
305
|
/**
|
|
299
306
|
* Основания согласования и попыток. Формулы digest — договор хоста:
|
|
300
307
|
* DevContour вычисляет их по сохранённым формулам (они включают поля
|
|
@@ -326,6 +333,16 @@ export interface BasisProvider {
|
|
|
326
333
|
* сверяется; при начале проверки её ещё нет.
|
|
327
334
|
*/
|
|
328
335
|
jointSpecDigest?(workIds: string[], view: ExecutionView, verificationId?: string): string;
|
|
336
|
+
/**
|
|
337
|
+
* Принятые хостом циклы проверки этого набора. Только доверенная локальная
|
|
338
|
+
* acceptance закрывает их бюджет: один passed без принятия недостаточен.
|
|
339
|
+
* Снимки фиксируются при acceptance и не расширяются при чтении. Все
|
|
340
|
+
* последующие проверки набора разделяют бюджет вне объединения снимков,
|
|
341
|
+
* независимо от ID набора хоста, политики, постановки и порядка истории.
|
|
342
|
+
* Без hook сохраняется предел всей истории sameWorks. Вызывается внутри
|
|
343
|
+
* транзакции jointStart; исключение откатывает начало проверки.
|
|
344
|
+
*/
|
|
345
|
+
jointBudgetCheckpoints?(workIds: string[], view: ExecutionView): readonly JointBudgetCheckpoint[];
|
|
329
346
|
/**
|
|
330
347
|
* Основание эпизода разбора по свойству (постановка и контракты поручения)
|
|
331
348
|
* по формуле хоста; без неё — формула harness (`episodeBasis`). Хост с
|
|
@@ -83,6 +83,12 @@ export declare const alreadySatisfiedSchema: z.ZodObject<{
|
|
|
83
83
|
evidence: z.ZodString;
|
|
84
84
|
}, z.core.$strict>;
|
|
85
85
|
export type AlreadySatisfied = z.infer<typeof alreadySatisfiedSchema>;
|
|
86
|
+
/**
|
|
87
|
+
* Предел находок и переходов в одном ответе reviewer и в раунде истории. Без
|
|
88
|
+
* предела каждый лишний элемент ответа давал отдельные ошибки разбора и
|
|
89
|
+
* гигабайты кучи. Реальные ответы на порядки меньше.
|
|
90
|
+
*/
|
|
91
|
+
export declare const REVIEW_ITEMS_LIMIT = 500;
|
|
86
92
|
export declare const reviewResultSchema: z.ZodObject<{
|
|
87
93
|
execution: z.ZodOptional<z.ZodObject<{
|
|
88
94
|
commands: z.ZodArray<z.ZodObject<{
|
|
@@ -143,6 +149,69 @@ export declare const reviewResultSchema: z.ZodObject<{
|
|
|
143
149
|
}, z.core.$strict>>>;
|
|
144
150
|
}, z.core.$strip>;
|
|
145
151
|
export type ReviewResult = z.infer<typeof reviewResultSchema>;
|
|
152
|
+
/**
|
|
153
|
+
* Записанный ответ reviewer (`review.json`). Предел `reviewResultSchema` —
|
|
154
|
+
* граница приёма: файлы прежних версий с длинными списками читаются и дальше.
|
|
155
|
+
*/
|
|
156
|
+
export declare const storedReviewResultSchema: z.ZodObject<{
|
|
157
|
+
execution: z.ZodOptional<z.ZodObject<{
|
|
158
|
+
commands: z.ZodArray<z.ZodObject<{
|
|
159
|
+
command: z.ZodString;
|
|
160
|
+
exitCode: z.ZodNumber;
|
|
161
|
+
summary: z.ZodString;
|
|
162
|
+
}, z.core.$strict>>;
|
|
163
|
+
noCommandsReason: z.ZodNullable<z.ZodString>;
|
|
164
|
+
}, z.core.$strict>>;
|
|
165
|
+
approved: z.ZodBoolean;
|
|
166
|
+
summary: z.ZodString;
|
|
167
|
+
discoveries: z.ZodDefault<z.ZodArray<z.ZodObject<{
|
|
168
|
+
kind: z.ZodEnum<{
|
|
169
|
+
bug: "bug";
|
|
170
|
+
debt: "debt";
|
|
171
|
+
}>;
|
|
172
|
+
title: z.ZodString;
|
|
173
|
+
path: z.ZodString;
|
|
174
|
+
line: z.ZodNumber;
|
|
175
|
+
observation: z.ZodString;
|
|
176
|
+
consequence: z.ZodString;
|
|
177
|
+
reproduction: z.ZodString;
|
|
178
|
+
}, z.core.$strict>>>;
|
|
179
|
+
alreadySatisfied: z.ZodOptional<z.ZodNullable<z.ZodObject<{
|
|
180
|
+
gates: z.ZodArray<z.ZodString>;
|
|
181
|
+
evidence: z.ZodString;
|
|
182
|
+
}, z.core.$strict>>>;
|
|
183
|
+
findings: z.ZodArray<z.ZodObject<{
|
|
184
|
+
severity: z.ZodEnum<{
|
|
185
|
+
blocking: "blocking";
|
|
186
|
+
note: "note";
|
|
187
|
+
}>;
|
|
188
|
+
message: z.ZodString;
|
|
189
|
+
path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
|
|
190
|
+
line: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
|
|
191
|
+
rule: z.ZodOptional<z.ZodNullable<z.ZodString>>;
|
|
192
|
+
consequence: z.ZodOptional<z.ZodNullable<z.ZodString>>;
|
|
193
|
+
evidence: z.ZodOptional<z.ZodNullable<z.ZodString>>;
|
|
194
|
+
reproduction: z.ZodCatch<z.ZodOptional<z.ZodNullable<z.ZodObject<{
|
|
195
|
+
property: z.ZodNullable<z.ZodString>;
|
|
196
|
+
input: z.ZodString;
|
|
197
|
+
inputClass: z.ZodOptional<z.ZodNullable<z.ZodString>>;
|
|
198
|
+
expected: z.ZodNullable<z.ZodString>;
|
|
199
|
+
actual: z.ZodNullable<z.ZodString>;
|
|
200
|
+
command: z.ZodNullable<z.ZodArray<z.ZodString>>;
|
|
201
|
+
executed: z.ZodBoolean;
|
|
202
|
+
run: z.ZodOptional<z.ZodNullable<z.ZodString>>;
|
|
203
|
+
}, z.core.$strip>>>>;
|
|
204
|
+
}, z.core.$strip>>;
|
|
205
|
+
previous: z.ZodDefault<z.ZodArray<z.ZodObject<{
|
|
206
|
+
id: z.ZodString;
|
|
207
|
+
status: z.ZodEnum<{
|
|
208
|
+
open: "open";
|
|
209
|
+
closed: "closed";
|
|
210
|
+
withdrawn: "withdrawn";
|
|
211
|
+
}>;
|
|
212
|
+
basis: z.ZodString;
|
|
213
|
+
}, z.core.$strict>>>;
|
|
214
|
+
}, z.core.$strip>;
|
|
146
215
|
/** Идентичность находки: предмет, класс и текст. Новый текст — новая находка. */
|
|
147
216
|
export declare const findingId: (subject: string, finding: {
|
|
148
217
|
rule?: string | null;
|
package/lib/contracts/review.js
CHANGED
|
@@ -74,23 +74,30 @@ export const alreadySatisfiedSchema = z.strictObject({
|
|
|
74
74
|
gates: gateScopeSchema(z.string().min(1).max(200)).min(1),
|
|
75
75
|
evidence: z.string().min(1).max(4000),
|
|
76
76
|
});
|
|
77
|
+
const reviewResultFindingSchema = z.object({
|
|
78
|
+
severity: z.enum(['blocking', 'note']),
|
|
79
|
+
message: z.string(),
|
|
80
|
+
path: z.string().nullable().optional(),
|
|
81
|
+
line: z.number().int().positive().nullable().optional(),
|
|
82
|
+
rule: z.string().nullable().optional(),
|
|
83
|
+
consequence: z.string().nullable().optional(),
|
|
84
|
+
evidence: z.string().nullable().optional(),
|
|
85
|
+
// Негодное воспроизведение отбрасывает только его, а не весь оплаченный вердикт.
|
|
86
|
+
reproduction: reproductionSchema.nullable().optional().catch(null),
|
|
87
|
+
});
|
|
88
|
+
/**
|
|
89
|
+
* Предел находок и переходов в одном ответе reviewer и в раунде истории. Без
|
|
90
|
+
* предела каждый лишний элемент ответа давал отдельные ошибки разбора и
|
|
91
|
+
* гигабайты кучи. Реальные ответы на порядки меньше.
|
|
92
|
+
*/
|
|
93
|
+
export const REVIEW_ITEMS_LIMIT = 500;
|
|
77
94
|
export const reviewResultSchema = z.object({
|
|
78
95
|
execution: reviewExecutionSchema.optional(),
|
|
79
96
|
approved: z.boolean(),
|
|
80
97
|
summary: z.string(),
|
|
81
98
|
discoveries: z.array(discoverySchema).max(20).default([]),
|
|
82
|
-
findings: z.array(
|
|
83
|
-
|
|
84
|
-
message: z.string(),
|
|
85
|
-
path: z.string().nullable().optional(),
|
|
86
|
-
line: z.number().int().positive().nullable().optional(),
|
|
87
|
-
rule: z.string().nullable().optional(),
|
|
88
|
-
consequence: z.string().nullable().optional(),
|
|
89
|
-
evidence: z.string().nullable().optional(),
|
|
90
|
-
// Негодное воспроизведение отбрасывает только его, а не весь оплаченный вердикт.
|
|
91
|
-
reproduction: reproductionSchema.nullable().optional().catch(null),
|
|
92
|
-
})),
|
|
93
|
-
previous: z.array(findingTransitionSchema).default([]),
|
|
99
|
+
findings: z.array(reviewResultFindingSchema).max(REVIEW_ITEMS_LIMIT),
|
|
100
|
+
previous: z.array(findingTransitionSchema).max(REVIEW_ITEMS_LIMIT).default([]),
|
|
94
101
|
/**
|
|
95
102
|
* Подтверждение reviewer, что приёмка поручения уже выполнена на базе без
|
|
96
103
|
* изменений (исполнитель сдал пустой результат): gates, чьё прошедшее
|
|
@@ -99,6 +106,14 @@ export const reviewResultSchema = z.object({
|
|
|
99
106
|
*/
|
|
100
107
|
alreadySatisfied: alreadySatisfiedSchema.nullable().optional(),
|
|
101
108
|
});
|
|
109
|
+
/**
|
|
110
|
+
* Записанный ответ reviewer (`review.json`). Предел `reviewResultSchema` —
|
|
111
|
+
* граница приёма: файлы прежних версий с длинными списками читаются и дальше.
|
|
112
|
+
*/
|
|
113
|
+
export const storedReviewResultSchema = reviewResultSchema.extend({
|
|
114
|
+
findings: z.array(reviewResultFindingSchema),
|
|
115
|
+
previous: z.array(findingTransitionSchema).default([]),
|
|
116
|
+
});
|
|
102
117
|
/** Идентичность находки: предмет, класс и текст. Новый текст — новая находка. */
|
|
103
118
|
export const findingId = (subject, finding) => digestOf({ subject, rule: finding.rule ?? null, message: finding.message });
|
|
104
119
|
export const reviewFindingSchema = z.strictObject({
|
|
@@ -220,7 +235,7 @@ export const reviewRoundSchema = z.strictObject({
|
|
|
220
235
|
*/
|
|
221
236
|
protocol: z.enum(['valid', 'invalid', 'unsafe']),
|
|
222
237
|
/** Открытые находки, состояние которых reviewer должен был назвать. */
|
|
223
|
-
expected: z.array(digestSchema).max(
|
|
238
|
+
expected: z.array(digestSchema).max(REVIEW_ITEMS_LIMIT),
|
|
224
239
|
issues: z.array(protocolIssueSchema).max(50).optional(),
|
|
225
240
|
transitions: z
|
|
226
241
|
.array(z.strictObject({
|
|
@@ -229,7 +244,7 @@ export const reviewRoundSchema = z.strictObject({
|
|
|
229
244
|
to: z.enum(findingStatuses),
|
|
230
245
|
basis: z.string().max(4000),
|
|
231
246
|
}))
|
|
232
|
-
.max(
|
|
247
|
+
.max(REVIEW_ITEMS_LIMIT)
|
|
233
248
|
.optional(),
|
|
234
249
|
/** Согласованная постановка поручения на момент раунда. */
|
|
235
250
|
spec: digestSchema.optional(),
|
package/lib/contracts/work.d.ts
CHANGED
|
@@ -32,6 +32,12 @@ export declare const consumerSchema: z.ZodObject<{
|
|
|
32
32
|
repositoryId: z.ZodString;
|
|
33
33
|
gates: z.ZodArray<z.ZodString>;
|
|
34
34
|
}, z.core.$strict>;
|
|
35
|
+
/**
|
|
36
|
+
* Область записи: изменения вне неё отклоняют попытку. `["."]` — весь
|
|
37
|
+
* репозиторий (защищённые и генерируемые пути и область роли по-прежнему
|
|
38
|
+
* ограничивают запись); `.` допустим только как единственный элемент.
|
|
39
|
+
*/
|
|
40
|
+
export declare const writeScopeSchema: z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<".">, z.ZodString]>>;
|
|
35
41
|
/**
|
|
36
42
|
* Исполняемое поручение. Это снимок постановки, а не редактируемая задача:
|
|
37
43
|
* изменение любого поля — новая редакция источника и новый digest, и прежнее
|
package/lib/contracts/work.js
CHANGED
|
@@ -33,6 +33,18 @@ export const consumerSchema = z.strictObject({
|
|
|
33
33
|
repositoryId: idSchema,
|
|
34
34
|
gates: gateScopeSchema(gateRefSchema).min(1),
|
|
35
35
|
});
|
|
36
|
+
/**
|
|
37
|
+
* Область записи: изменения вне неё отклоняют попытку. `["."]` — весь
|
|
38
|
+
* репозиторий (защищённые и генерируемые пути и область роли по-прежнему
|
|
39
|
+
* ограничивают запись); `.` допустим только как единственный элемент.
|
|
40
|
+
*/
|
|
41
|
+
export const writeScopeSchema = z
|
|
42
|
+
.array(z.union([z.literal('.'), relativePathSchema]))
|
|
43
|
+
.min(1)
|
|
44
|
+
.max(100)
|
|
45
|
+
.refine((paths) => !paths.includes('.') || paths.length === 1, {
|
|
46
|
+
message: 'Весь репозиторий (".") — единственный элемент области записи',
|
|
47
|
+
});
|
|
36
48
|
/**
|
|
37
49
|
* Исполняемое поручение. Это снимок постановки, а не редактируемая задача:
|
|
38
50
|
* изменение любого поля — новая редакция источника и новый digest, и прежнее
|
|
@@ -49,18 +61,7 @@ export const workOrderSchema = z.strictObject({
|
|
|
49
61
|
repositoryId: idSchema,
|
|
50
62
|
/** Связанные репозитории поручения уровня workspace; пусто — один репозиторий. */
|
|
51
63
|
relatedRepositories: z.array(idSchema).max(10).default([]),
|
|
52
|
-
|
|
53
|
-
* Область записи: изменения вне неё отклоняют попытку. `["."]` — весь
|
|
54
|
-
* репозиторий (защищённые и генерируемые пути и область роли по-прежнему
|
|
55
|
-
* ограничивают запись); `.` допустим только как единственный элемент.
|
|
56
|
-
*/
|
|
57
|
-
writeScope: z
|
|
58
|
-
.array(z.union([z.literal('.'), relativePathSchema]))
|
|
59
|
-
.min(1)
|
|
60
|
-
.max(100)
|
|
61
|
-
.refine((paths) => !paths.includes('.') || paths.length === 1, {
|
|
62
|
-
message: 'Весь репозиторий (".") — единственный элемент области записи',
|
|
63
|
-
}),
|
|
64
|
+
writeScope: writeScopeSchema,
|
|
64
65
|
dependsOn: z.array(idSchema).max(100).default([]),
|
|
65
66
|
/** Область доказательства: подмножество gates/групп политики. Нет поля — все gates репозитория. */
|
|
66
67
|
gates: gateScopeSchema(gateRefSchema).optional(),
|
package/lib/control/review.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { randomUUID } from 'node:crypto';
|
|
2
2
|
import { mkdir, writeFile } from 'node:fs/promises';
|
|
3
3
|
import { join } from 'node:path';
|
|
4
|
-
import { HarnessError, WORKSPACE_OWNER, contextDigest, findingId, mcpEnvironment, reviewIssues, reviewResultSchema, selectReviewer, } from "../contracts/index.js";
|
|
4
|
+
import { HarnessError, WORKSPACE_OWNER, contextDigest, findingId, mcpEnvironment, reviewIssues, issuePath, reviewResultSchema, selectReviewer, } from "../contracts/index.js";
|
|
5
5
|
import { reviewOutputSchema } from "../agents/schemas.js";
|
|
6
6
|
import { redactInspection } from "../agents/inspect.js";
|
|
7
7
|
import { executionEnvironment } from "../environment/lifecycle.js";
|
|
@@ -112,7 +112,14 @@ export async function technicalReview(engine, policy, adapters, input) {
|
|
|
112
112
|
if (response.status !== 'ok')
|
|
113
113
|
throw new HarnessError('RUNTIME_UNAVAILABLE', `Ревью ${kind}: ${response.status}${response.diagnostics.reason ? ': ' + response.diagnostics.reason : ''}`);
|
|
114
114
|
const parsed = reviewResultSchema.safeParse(response.output);
|
|
115
|
-
const
|
|
115
|
+
const issue = parsed.error?.issues[0];
|
|
116
|
+
const issues = parsed.success
|
|
117
|
+
? reviewIssues(parsed.data, open)
|
|
118
|
+
: [
|
|
119
|
+
execution
|
|
120
|
+
.redact(`Ответ ревью вне схемы: ${issuePath(issue?.path ?? [])}: ${issue?.message}`)
|
|
121
|
+
.slice(0, 500),
|
|
122
|
+
];
|
|
116
123
|
// Ответ применяется только целиком валидным (docs/review-protocol.md, §8):
|
|
117
124
|
// невалидный не закрывает прежних находок и не заводит новых — раунд
|
|
118
125
|
// записывается неодобренным с причинами, история остаётся прежней.
|
package/lib/engine/engine.js
CHANGED
|
@@ -11,7 +11,7 @@ import { contractDocuments, corpusBindingHolds, effectiveChecks, episodeBasis, o
|
|
|
11
11
|
import { afterFailure, afterSuccess, blocksClaim, closeIfBasisChanged, } from "./property-recovery.js";
|
|
12
12
|
import { REQUIREMENT_GATE } from "../verification/requirements.js";
|
|
13
13
|
import { pinnedCorpus, propertyProofProblem } from "../verification/acceptance.js";
|
|
14
|
-
import { jointImpact, jointPolicyDigest, jointSpecDigest, publicJoint, sameWorks, } from "../verification/joint.js";
|
|
14
|
+
import { jointImpact, jointPolicyDigest, jointSpecDigest, publicJoint, sameWorks, jointBudgetAttempts, } from "../verification/joint.js";
|
|
15
15
|
/** Префикс причины неудавшегося продления: первая причина не затирается следствиями. */
|
|
16
16
|
export const HEARTBEAT_FAILED = 'Продление владения не удалось';
|
|
17
17
|
const iso = (ms) => new Date(ms).toISOString();
|
|
@@ -2070,7 +2070,9 @@ export class Engine {
|
|
|
2070
2070
|
payload: { verificationId: v.id, status: 'failed', error },
|
|
2071
2071
|
});
|
|
2072
2072
|
}
|
|
2073
|
-
const previous = tx
|
|
2073
|
+
const previous = jointBudgetAttempts(tx, input.workIds, this.host.basis.jointBudgetCheckpoints
|
|
2074
|
+
? this.host.basis.jointBudgetCheckpoints([...input.workIds], tx)
|
|
2075
|
+
: []);
|
|
2074
2076
|
if (previous.length >= this.policy.maxAttempts)
|
|
2075
2077
|
throw new HarnessError('ATTEMPTS_EXHAUSTED', 'Исчерпан предел совместных проверок этого набора');
|
|
2076
2078
|
const works = input.workIds.map((id) => tx.work(id));
|
package/lib/engine/prompt.js
CHANGED
|
@@ -24,8 +24,12 @@ export const CLOSED_FINDINGS_HEADER = 'Closed or withdrawn review findings (hist
|
|
|
24
24
|
* writer — открытые находки, которые нужно устранить.
|
|
25
25
|
*/
|
|
26
26
|
export function findingsText(history, review) {
|
|
27
|
-
if (!history
|
|
27
|
+
if (!history)
|
|
28
28
|
return '';
|
|
29
|
+
if (!history.findings.length)
|
|
30
|
+
return review
|
|
31
|
+
? 'There are no controller-issued review findings. Return `previous` as exactly []. Historical attempt errors and gate observations are not review findings: do not invent or compute ids for them.'
|
|
32
|
+
: '';
|
|
29
33
|
const open = history.findings.filter((f) => f.status === 'open');
|
|
30
34
|
const closed = history.findings.filter((f) => f.status !== 'open');
|
|
31
35
|
const brief = (f) => ({
|
|
@@ -108,7 +112,9 @@ export function prompt(input) {
|
|
|
108
112
|
JSON.stringify(attempt.dependencies)
|
|
109
113
|
: '',
|
|
110
114
|
'Gates that prove this work: ' + JSON.stringify(input.gates),
|
|
111
|
-
|
|
115
|
+
(review && input.findings
|
|
116
|
+
? 'Historical attempt errors and gate observations (diagnostic context only). Only controller-issued ids in the review findings sections below may appear in `previous`; do not derive ids from this history: '
|
|
117
|
+
: 'Previous attempts, with the findings each review left. Address every finding that is still open first and say what you changed for it: ') +
|
|
112
118
|
JSON.stringify(previousAttempts(input.history, attempt.id)),
|
|
113
119
|
findingsText(input.findings, !!review),
|
|
114
120
|
!review && attempt.continuedFrom?.applied
|
package/lib/engine/runner.js
CHANGED
|
@@ -3,7 +3,7 @@ import { randomUUID } from 'node:crypto';
|
|
|
3
3
|
import { existsSync } from 'node:fs';
|
|
4
4
|
import { mkdir, readFile, readdir, realpath, rm, writeFile } from 'node:fs/promises';
|
|
5
5
|
import { dirname, isAbsolute, join, relative, resolve } from 'node:path';
|
|
6
|
-
import { roleBinding, selectReviewer, mcpEnvironment, HarnessError, digestOf, contextDigest, implementationResultSchema, codeReviewHistory, codeReviewScope, checkCodeReview, logicalReview, DEFAULT_REVIEW_PROTOCOL_RETRIES,
|
|
6
|
+
import { roleBinding, selectReviewer, mcpEnvironment, HarnessError, digestOf, contextDigest, implementationResultSchema, codeReviewHistory, codeReviewScope, checkCodeReview, logicalReview, DEFAULT_REVIEW_PROTOCOL_RETRIES, REVIEW_ITEMS_LIMIT, storedReviewResultSchema, sha256, } from "../contracts/index.js";
|
|
7
7
|
import { git, hostGitArgs } from "../environment/process.js";
|
|
8
8
|
import { protectedChanges, protectedSnapshot, SandboxPolicyError, } from "../environment/isolation.js";
|
|
9
9
|
import { executionEnvironment, runSteps, withEnvironment } from "../environment/lifecycle.js";
|
|
@@ -13,7 +13,7 @@ import { redactDeep } from "../environment/redaction.js";
|
|
|
13
13
|
import { alreadySatisfiedReviewOutputSchema, implementationOutputSchema, reviewOutputSchema, } from "../agents/schemas.js";
|
|
14
14
|
import { reviewInspection } from "../agents/inspect.js";
|
|
15
15
|
import { reviewerRunsChecks } from "../agents/cli-adapter.js";
|
|
16
|
-
import { gateProbePrompt, observeReproductions, probeCommand, probeGates, probeLimits, probeRecord, readProbeJournal, recoverProbeLog, probeTool, } from "../agents/review-probe.js";
|
|
16
|
+
import { gateProbePrompt, observeReproductions, assertProbeSpec, probeCommand, probeGates, probeLimits, probeRecord, readProbeJournal, recoverProbeLog, probeTool, } from "../agents/review-probe.js";
|
|
17
17
|
import { runGate } from "../verification/gates.js";
|
|
18
18
|
import { orderedScope } from "../verification/gate-scope.js";
|
|
19
19
|
import { alreadySatisfiedVerdict, contractCheckGates, withinWriteScope, } from "../verification/already-satisfied.js";
|
|
@@ -1378,6 +1378,7 @@ export class Runner {
|
|
|
1378
1378
|
scope: { attempt: attempt.id, phase, sha, call },
|
|
1379
1379
|
artifacts: join(dir, 'probe-runs'),
|
|
1380
1380
|
};
|
|
1381
|
+
assertProbeSpec(spec);
|
|
1381
1382
|
const specPath = join(dir, 'probe.json');
|
|
1382
1383
|
await writeFile(specPath, JSON.stringify(spec, null, 2));
|
|
1383
1384
|
const seconds = (ms) => Math.round(ms / 1000);
|
|
@@ -1503,6 +1504,9 @@ export class Runner {
|
|
|
1503
1504
|
const expected = legacy
|
|
1504
1505
|
? []
|
|
1505
1506
|
: history.findings.filter((f) => f.status === 'open').map((f) => f.id);
|
|
1507
|
+
// Раунд с таким списком не записался бы: остановка до вызова reviewer.
|
|
1508
|
+
if (expected.length > REVIEW_ITEMS_LIMIT)
|
|
1509
|
+
throw new TaskFailure('review-protocol', `REVIEW_PROTOCOL_INVALID: открытых находок ${expected.length}, предел раунда ревью ${REVIEW_ITEMS_LIMIT} (попытка ${attempt.id}); нового вызова нет`);
|
|
1506
1510
|
const round = history.round + 1;
|
|
1507
1511
|
// Запрос одинаков для всех вызовов логического ревью: меняется только
|
|
1508
1512
|
// диагностика ошибки протокола.
|
|
@@ -1972,7 +1976,7 @@ export class Runner {
|
|
|
1972
1976
|
return;
|
|
1973
1977
|
const items = [];
|
|
1974
1978
|
for (const e of reviews) {
|
|
1975
|
-
const saved =
|
|
1979
|
+
const saved = storedReviewResultSchema.safeParse(JSON.parse(await readFile(e.log, 'utf8').catch(() => 'null')));
|
|
1976
1980
|
if (!saved.success)
|
|
1977
1981
|
continue;
|
|
1978
1982
|
for (const f of saved.data.findings)
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
/** Файл больше предела: дальше предела он не читался. */
|
|
2
|
+
export declare class OversizedFile extends Error {
|
|
3
|
+
readonly limit: number;
|
|
4
|
+
constructor(limit: number);
|
|
5
|
+
}
|
|
6
|
+
/**
|
|
7
|
+
* Текст файла, который пишет чужой процесс, не больше `limit` байт. Память
|
|
8
|
+
* ограничена и тогда, когда файл растёт после проверки размера: читается
|
|
9
|
+
* не больше `limit + 1` байта. Symlink не разыменовывается, FIFO без писателя
|
|
10
|
+
* не держит `open` (O_NONBLOCK) и отклоняется как не обычный файл.
|
|
11
|
+
*/
|
|
12
|
+
export declare function readBounded(path: string, limit: number): Promise<string>;
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
import { constants, open } from 'node:fs/promises';
|
|
2
|
+
/** Файл больше предела: дальше предела он не читался. */
|
|
3
|
+
export class OversizedFile extends Error {
|
|
4
|
+
limit;
|
|
5
|
+
constructor(limit) {
|
|
6
|
+
super(`файл больше предела ${limit} байт`);
|
|
7
|
+
this.limit = limit;
|
|
8
|
+
this.name = 'OversizedFile';
|
|
9
|
+
}
|
|
10
|
+
}
|
|
11
|
+
/**
|
|
12
|
+
* Текст файла, который пишет чужой процесс, не больше `limit` байт. Память
|
|
13
|
+
* ограничена и тогда, когда файл растёт после проверки размера: читается
|
|
14
|
+
* не больше `limit + 1` байта. Symlink не разыменовывается, FIFO без писателя
|
|
15
|
+
* не держит `open` (O_NONBLOCK) и отклоняется как не обычный файл.
|
|
16
|
+
*/
|
|
17
|
+
export async function readBounded(path, limit) {
|
|
18
|
+
const handle = await open(path, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
|
|
19
|
+
try {
|
|
20
|
+
const stat = await handle.stat();
|
|
21
|
+
if (!stat.isFile())
|
|
22
|
+
throw new Error('не обычный файл');
|
|
23
|
+
if (stat.size > limit)
|
|
24
|
+
throw new OversizedFile(limit);
|
|
25
|
+
const buffer = Buffer.allocUnsafe(limit + 1);
|
|
26
|
+
let size = 0;
|
|
27
|
+
for (;;) {
|
|
28
|
+
const { bytesRead } = await handle.read(buffer, size, buffer.length - size);
|
|
29
|
+
if (!bytesRead)
|
|
30
|
+
break;
|
|
31
|
+
size += bytesRead;
|
|
32
|
+
if (size > limit)
|
|
33
|
+
throw new OversizedFile(limit);
|
|
34
|
+
}
|
|
35
|
+
return buffer.toString('utf8', 0, size);
|
|
36
|
+
}
|
|
37
|
+
finally {
|
|
38
|
+
await handle.close();
|
|
39
|
+
}
|
|
40
|
+
}
|