devcontour-harness 0.1.0-alpha.25 → 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 +9 -2
- 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.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/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/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 +24 -7
- package/package.json +2 -2
|
@@ -43,6 +43,17 @@ export declare const taskMappingSchema: z.ZodObject<{
|
|
|
43
43
|
context: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
44
44
|
}, z.core.$strict>;
|
|
45
45
|
export type TaskMapping = z.infer<typeof taskMappingSchema>;
|
|
46
|
+
/**
|
|
47
|
+
* Базовая линия: зависимости, закрытые до внедрения harness, принимает человек.
|
|
48
|
+
* Только явные ключи задач и один полный SHA: без шаблонов, дат и общего
|
|
49
|
+
* переключателя. Это решение оператора, а не доказательство результата.
|
|
50
|
+
*/
|
|
51
|
+
export declare const baselineSchema: z.ZodObject<{
|
|
52
|
+
sha: z.ZodString;
|
|
53
|
+
tasks: z.ZodArray<z.ZodString>;
|
|
54
|
+
reason: z.ZodString;
|
|
55
|
+
}, z.core.$strict>;
|
|
56
|
+
export type Baseline = z.infer<typeof baselineSchema>;
|
|
46
57
|
export declare const connectorConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
47
58
|
provider: z.ZodLiteral<"relay-v1-http">;
|
|
48
59
|
relay: z.ZodIntersection<z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodObject<{
|
|
@@ -76,6 +87,11 @@ export declare const connectorConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject
|
|
|
76
87
|
requiredDocuments: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
77
88
|
context: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
78
89
|
}, z.core.$strict>>;
|
|
90
|
+
baseline: z.ZodOptional<z.ZodObject<{
|
|
91
|
+
sha: z.ZodString;
|
|
92
|
+
tasks: z.ZodArray<z.ZodString>;
|
|
93
|
+
reason: z.ZodString;
|
|
94
|
+
}, z.core.$strict>>;
|
|
79
95
|
completion: z.ZodDefault<z.ZodObject<{
|
|
80
96
|
mode: z.ZodDefault<z.ZodEnum<{
|
|
81
97
|
complete: "complete";
|
|
@@ -149,6 +165,11 @@ export declare const connectorConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject
|
|
|
149
165
|
requiredDocuments: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
150
166
|
context: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
151
167
|
}, z.core.$strict>>;
|
|
168
|
+
baseline: z.ZodOptional<z.ZodObject<{
|
|
169
|
+
sha: z.ZodString;
|
|
170
|
+
tasks: z.ZodArray<z.ZodString>;
|
|
171
|
+
reason: z.ZodString;
|
|
172
|
+
}, z.core.$strict>>;
|
|
152
173
|
completion: z.ZodDefault<z.ZodObject<{
|
|
153
174
|
mode: z.ZodDefault<z.ZodEnum<{
|
|
154
175
|
complete: "complete";
|
|
@@ -214,6 +235,22 @@ export declare const contextIdOf: (orderId: string) => string;
|
|
|
214
235
|
export declare const graphIdOf: (provider: ProviderId, projectId: string, taskIds: string[]) => string;
|
|
215
236
|
/** Digest сопоставления задачи: входит в semantic digest — смена mapping требует нового согласования. */
|
|
216
237
|
export declare const mappingDigest: (config: ConnectorConfig, mapping: TaskMapping) => string;
|
|
238
|
+
/**
|
|
239
|
+
* Запись базовой линии для зависимости; её digest — receipt предпосылки. Вся
|
|
240
|
+
* `baseline` внутри: любая её правка отзывает выданные предпосылки.
|
|
241
|
+
*/
|
|
242
|
+
export declare const baselineRecord: (config: ConnectorConfig, key: string, orderId: string, repositoryId: string) => {
|
|
243
|
+
kind: string;
|
|
244
|
+
issuer: string;
|
|
245
|
+
key: string;
|
|
246
|
+
orderId: string;
|
|
247
|
+
repositoryId: string;
|
|
248
|
+
baseline: {
|
|
249
|
+
sha: string;
|
|
250
|
+
tasks: string[];
|
|
251
|
+
reason: string;
|
|
252
|
+
} | undefined;
|
|
253
|
+
};
|
|
217
254
|
/** Колонка завершения по правилам конфигурации. */
|
|
218
255
|
export declare const completionColumn: (config: ConnectorConfig) => TaskColumn;
|
|
219
256
|
/** Файл хранилища коннектора внутри каталога состояния. */
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { readFileSync } from 'node:fs';
|
|
2
2
|
import { dirname, isAbsolute, resolve } from 'node:path';
|
|
3
3
|
import { z } from 'zod';
|
|
4
|
-
import { HarnessError, digestOf, gateRefSchema, idSchema,
|
|
4
|
+
import { HarnessError, digestOf, gateRefSchema, idSchema, roleIdSchema, sha256, gateScopeSchema, writeScopeSchema, } from "../../contracts/index.js";
|
|
5
5
|
/**
|
|
6
6
|
* Конфигурация коннектора внешнего хранилища задач.
|
|
7
7
|
*
|
|
@@ -49,10 +49,7 @@ export const taskMappingSchema = z.strictObject({
|
|
|
49
49
|
ref: z.string().min(1).max(200),
|
|
50
50
|
role: roleIdSchema.default('developer'),
|
|
51
51
|
repositoryId: idSchema.optional(),
|
|
52
|
-
writeScope:
|
|
53
|
-
.array(z.union([z.literal('.'), relativePathSchema]))
|
|
54
|
-
.min(1)
|
|
55
|
-
.max(100),
|
|
52
|
+
writeScope: writeScopeSchema,
|
|
56
53
|
gates: gateScopeSchema(gateRefSchema).optional(),
|
|
57
54
|
criteria: z.array(criterionMappingSchema).max(100).default([]),
|
|
58
55
|
/** Документы, без которых запуск блокируется (ID, ключ или имя). Остальные — дополнительные. */
|
|
@@ -65,6 +62,25 @@ export const taskMappingSchema = z.strictObject({
|
|
|
65
62
|
*/
|
|
66
63
|
context: z.array(idSchema).min(1).max(10).optional(),
|
|
67
64
|
});
|
|
65
|
+
/**
|
|
66
|
+
* Базовая линия: зависимости, закрытые до внедрения harness, принимает человек.
|
|
67
|
+
* Только явные ключи задач и один полный SHA: без шаблонов, дат и общего
|
|
68
|
+
* переключателя. Это решение оператора, а не доказательство результата.
|
|
69
|
+
*/
|
|
70
|
+
export const baselineSchema = z.strictObject({
|
|
71
|
+
/** Полный SHA коммита; движок проверяет его доступность в target ref. */
|
|
72
|
+
sha: z.string().regex(/^[a-f0-9]{40}$/, 'Ожидается полный SHA коммита (40 hex)'),
|
|
73
|
+
tasks: z
|
|
74
|
+
.array(z
|
|
75
|
+
.string()
|
|
76
|
+
.max(200)
|
|
77
|
+
.regex(/^[A-Za-z0-9][A-Za-z0-9._-]*$/, 'Ожидается точный ключ задачи, без шаблонов'))
|
|
78
|
+
.min(1)
|
|
79
|
+
.max(500)
|
|
80
|
+
.refine((keys) => new Set(keys).size === keys.length, { message: 'Ключ задачи указан дважды' }),
|
|
81
|
+
/** Почему человек принимает эти задачи без receipt. */
|
|
82
|
+
reason: z.string().trim().min(1).max(1000),
|
|
83
|
+
});
|
|
68
84
|
const relaySettings = z.record(z.string(), z.unknown());
|
|
69
85
|
const common = {
|
|
70
86
|
version: z.literal(1),
|
|
@@ -84,6 +100,7 @@ const common = {
|
|
|
84
100
|
path: z.string().min(1).max(1000).optional(),
|
|
85
101
|
}),
|
|
86
102
|
tasks: z.array(taskMappingSchema).min(1).max(50),
|
|
103
|
+
baseline: baselineSchema.optional(),
|
|
87
104
|
completion: z
|
|
88
105
|
.strictObject({
|
|
89
106
|
/** `complete` — закрыть задачу по правилам backend; `review-only` — оставить на проверку человеку. */
|
|
@@ -170,6 +187,9 @@ export function parseConfig(value, baseDir, file) {
|
|
|
170
187
|
const dup = refs.find((r, i) => refs.indexOf(r) !== i);
|
|
171
188
|
if (dup)
|
|
172
189
|
throw new HarnessError('INVALID_INPUT', 'source: задача указана дважды: ' + dup);
|
|
190
|
+
const own = parsed.data.baseline?.tasks.find((key) => refs.includes(key));
|
|
191
|
+
if (own)
|
|
192
|
+
throw new HarnessError('INVALID_INPUT', `source: задача ${own} исполняется этой конфигурацией и не может быть в baseline`);
|
|
173
193
|
// ID контекста задачи — `c` + 20 hex (contextIdOf): локальный пакет не может его занять.
|
|
174
194
|
const taken = parsed.data.tasks
|
|
175
195
|
.flatMap((t) => t.context ?? [])
|
|
@@ -225,6 +245,18 @@ export const mappingDigest = (config, mapping) => digestOf({
|
|
|
225
245
|
repository: config.repository.id,
|
|
226
246
|
completion: config.completion,
|
|
227
247
|
});
|
|
248
|
+
/**
|
|
249
|
+
* Запись базовой линии для зависимости; её digest — receipt предпосылки. Вся
|
|
250
|
+
* `baseline` внутри: любая её правка отзывает выданные предпосылки.
|
|
251
|
+
*/
|
|
252
|
+
export const baselineRecord = (config, key, orderId, repositoryId) => ({
|
|
253
|
+
kind: 'baseline',
|
|
254
|
+
issuer: connectorIdOf(config.provider, config.projectId),
|
|
255
|
+
key,
|
|
256
|
+
orderId,
|
|
257
|
+
repositoryId,
|
|
258
|
+
baseline: config.baseline,
|
|
259
|
+
});
|
|
228
260
|
/** Колонка завершения по правилам конфигурации. */
|
|
229
261
|
export const completionColumn = (config) => config.completion.column ?? (config.completion.mode === 'complete' ? 'done' : 'review');
|
|
230
262
|
/** Файл хранилища коннектора внутри каталога состояния. */
|
|
@@ -158,7 +158,20 @@ export class RelaySink {
|
|
|
158
158
|
? 'задача уже завершена другим участником'
|
|
159
159
|
: undefined;
|
|
160
160
|
const identity = `${this.config.provider}:${this.config.projectId}:${read.task.id}`;
|
|
161
|
-
|
|
161
|
+
// Принятое без доказательства остаётся видно в итоге: только этой постановки.
|
|
162
|
+
const pinned = store.latestSnapshot(result.graphId)?.manifest;
|
|
163
|
+
const accepted = pinned?.tasks
|
|
164
|
+
.find((t) => t.id === read.task.id && t.semanticDigest === digest)
|
|
165
|
+
?.dependencies.filter((d) => d.proof === 'baseline')
|
|
166
|
+
.map((d) => d.key);
|
|
167
|
+
const base = {
|
|
168
|
+
casRevision: read.task.revision,
|
|
169
|
+
taskKey: read.task.key,
|
|
170
|
+
identity,
|
|
171
|
+
...(accepted?.length && pinned?.baseline
|
|
172
|
+
? { baseline: { ...pinned.baseline, tasks: accepted } }
|
|
173
|
+
: {}),
|
|
174
|
+
};
|
|
162
175
|
if (problem) {
|
|
163
176
|
// Текущая задача не закрывается старым результатом; допустим только явно исторический комментарий.
|
|
164
177
|
const steps = this.config.completion.historicalComment && result.outcome === 'accepted'
|
|
@@ -397,6 +410,9 @@ export class RelaySink {
|
|
|
397
410
|
criteria: step.input.criteria ?? [],
|
|
398
411
|
completion: op.receipt?.completion ?? op.reason ?? '',
|
|
399
412
|
historical: step.kind === 'historical-comment',
|
|
413
|
+
...(step.input.baseline
|
|
414
|
+
? { baseline: step.input.baseline }
|
|
415
|
+
: {}),
|
|
400
416
|
redact: this.redact,
|
|
401
417
|
});
|
|
402
418
|
return {
|
|
@@ -4,9 +4,9 @@
|
|
|
4
4
|
* загружается только для явно выбранного provider.
|
|
5
5
|
*/
|
|
6
6
|
export * from './transport.ts';
|
|
7
|
-
export { connectorConfigSchema, criterionMappingSchema, taskMappingSchema, loadConfig, parseConfig, connectorIdOf, taskIdentity, parseIdentity, orderIdOf, graphIdOf, contextIdOf, mappingDigest, completionColumn, storeFileOf, type ConnectorConfig, type ConnectorConfigInput, type CriterionMapping, type TaskMapping, type LoadedConfig, } from './config.ts';
|
|
7
|
+
export { connectorConfigSchema, baselineSchema, criterionMappingSchema, taskMappingSchema, loadConfig, parseConfig, connectorIdOf, taskIdentity, parseIdentity, orderIdOf, graphIdOf, contextIdOf, mappingDigest, completionColumn, storeFileOf, type Baseline, type ConnectorConfig, type ConnectorConfigInput, type CriterionMapping, type TaskMapping, type LoadedConfig, } from './config.ts';
|
|
8
8
|
export { ConnectorStore, LeaseLost, type OperationRecord, type OperationStatus, type StepRecord, type StepStatus, type LeaseRecord, type ReceiptRecord, type SnapshotRecord, } from './store.ts';
|
|
9
|
-
export { buildSnapshot, checkIdentity, readStable, semanticDigest, contextLimitIssues, localContext, takeSnapshot, assertEligible, type BuiltSnapshot, type SnapshotManifest, type SnapshotProblem, type TaskManifest, } from './snapshot.ts';
|
|
9
|
+
export { buildSnapshot, checkIdentity, readStable, semanticDigest, contextLimitIssues, localContext, takeSnapshot, assertEligible, type BaselineManifest, type BuiltSnapshot, type SnapshotManifest, type SnapshotProblem, type TaskManifest, } from './snapshot.ts';
|
|
10
10
|
export { RelayWorkSource } from './source.ts';
|
|
11
11
|
export { RelaySink, operationKey, type ReconcileDecision, type SinkOptions } from './delivery.ts';
|
|
12
12
|
export { HistoryRecorder, type SessionLink } from './history.ts';
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
* загружается только для явно выбранного provider.
|
|
5
5
|
*/
|
|
6
6
|
export * from "./transport.js";
|
|
7
|
-
export { connectorConfigSchema, criterionMappingSchema, taskMappingSchema, loadConfig, parseConfig, connectorIdOf, taskIdentity, parseIdentity, orderIdOf, graphIdOf, contextIdOf, mappingDigest, completionColumn, storeFileOf, } from "./config.js";
|
|
7
|
+
export { connectorConfigSchema, baselineSchema, criterionMappingSchema, taskMappingSchema, loadConfig, parseConfig, connectorIdOf, taskIdentity, parseIdentity, orderIdOf, graphIdOf, contextIdOf, mappingDigest, completionColumn, storeFileOf, } from "./config.js";
|
|
8
8
|
export { ConnectorStore, LeaseLost, } from "./store.js";
|
|
9
9
|
export { buildSnapshot, checkIdentity, readStable, semanticDigest, contextLimitIssues, localContext, takeSnapshot, assertEligible, } from "./snapshot.js";
|
|
10
10
|
export { RelayWorkSource } from "./source.js";
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { HarnessError, type ContextSnapshot, type ContextSourceEntry, type WorkGraph } from '../../contracts/index.ts';
|
|
1
|
+
import { HarnessError, type ContextSnapshot, type ContextSourceEntry, type LocalContextManifest, type WorkGraph } from '../../contracts/index.ts';
|
|
2
2
|
import { type ConnectorConfig, type TaskMapping } from './config.ts';
|
|
3
3
|
import type { ReceiptRecord } from './store.ts';
|
|
4
4
|
import { type CriterionRecord, type RelayTransport, type TaskRead, type TransportIdentity } from './transport.ts';
|
|
@@ -57,6 +57,8 @@ export interface TaskManifest {
|
|
|
57
57
|
column: string;
|
|
58
58
|
finished: boolean;
|
|
59
59
|
inGraph: boolean;
|
|
60
|
+
/** Основание внешней зависимости: `receipt` доказан, `baseline` принят человеком. */
|
|
61
|
+
proof?: 'receipt' | 'baseline';
|
|
60
62
|
}[];
|
|
61
63
|
children: {
|
|
62
64
|
id: string;
|
|
@@ -86,13 +88,13 @@ export interface SnapshotManifest {
|
|
|
86
88
|
problems: SnapshotProblem[];
|
|
87
89
|
/** Закреплённые локальные пакеты `tasks[].context`; без них поля нет. */
|
|
88
90
|
localContext?: LocalContextManifest[];
|
|
91
|
+
/** Зависимости, принятые человеком по базовой линии; без них поля нет. */
|
|
92
|
+
baseline?: BaselineManifest;
|
|
89
93
|
}
|
|
90
|
-
export interface
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
references: number;
|
|
95
|
-
bytes: number;
|
|
94
|
+
export interface BaselineManifest {
|
|
95
|
+
sha: string;
|
|
96
|
+
reason: string;
|
|
97
|
+
tasks: string[];
|
|
96
98
|
}
|
|
97
99
|
export interface BuiltSnapshot {
|
|
98
100
|
graph: WorkGraph;
|
|
@@ -131,7 +133,7 @@ export declare function buildSnapshot(input: {
|
|
|
131
133
|
/** Закреплённые локальные пакеты `tasks[].context` (localContext). */
|
|
132
134
|
local?: ContextSourceEntry[];
|
|
133
135
|
}): BuiltSnapshot;
|
|
134
|
-
/** Нарушения пределов снимка контекста: число источников, размер
|
|
136
|
+
/** Нарушения пределов снимка контекста: число источников, размер файла, сумма и договор источника. */
|
|
135
137
|
export declare function contextLimitIssues(context: ContextSnapshot): string[];
|
|
136
138
|
/**
|
|
137
139
|
* Локальные пакеты `tasks[].context` из `contextDir`: те же правила, что у
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { existsSync, statSync } from 'node:fs';
|
|
2
|
-
import { API_VERSION, HarnessError, CONTEXT_LIMITS, contextDigest, contextIssues, digestOf, sha256, sourceDigest, workGraphDigest, workGraphSchema, } from "../../contracts/index.js";
|
|
3
|
-
import { connectorIdOf, contextIdOf, graphIdOf, mappingDigest, orderIdOf, taskIdentity, } from "./config.js";
|
|
2
|
+
import { API_VERSION, HarnessError, CONTEXT_LIMITS, contextDigest, contextIssues, contextSnapshotSchema, digestOf, sha256, sourceDigest, workGraphDigest, workGraphSchema, } from "../../contracts/index.js";
|
|
3
|
+
import { baselineRecord, connectorIdOf, contextIdOf, graphIdOf, mappingDigest, orderIdOf, taskIdentity, } from "./config.js";
|
|
4
4
|
import { TransportError, } from "./transport.js";
|
|
5
5
|
import { FileContextSource } from "../../connectors/files.js";
|
|
6
6
|
/** Безопасная причина отказа транспорта при чтении: сеть/CLI — не пустой список. */
|
|
@@ -125,6 +125,7 @@ export function buildSnapshot(input) {
|
|
|
125
125
|
const sources = [];
|
|
126
126
|
const missing = [];
|
|
127
127
|
const prerequisites = new Map();
|
|
128
|
+
const accepted = new Set();
|
|
128
129
|
const tasks = [];
|
|
129
130
|
/** Какие локальные пакеты у какой задачи (по порядку): часть ревизии набора. */
|
|
130
131
|
const packsByTask = [];
|
|
@@ -154,12 +155,20 @@ export function buildSnapshot(input) {
|
|
|
154
155
|
else
|
|
155
156
|
mapped.add(found[0].id);
|
|
156
157
|
});
|
|
157
|
-
// Зависимости: внутри графа — dependsOn; вне —
|
|
158
|
+
// Зависимости: внутри графа — dependsOn; вне — с доверенным receipt или,
|
|
159
|
+
// если receipt нет, по явной записи базовой линии.
|
|
158
160
|
const dependsOn = [];
|
|
159
161
|
const deps = [];
|
|
160
162
|
for (const dep of read.dependencies) {
|
|
161
163
|
const inGraph = graphTasks.has(dep.id);
|
|
162
|
-
|
|
164
|
+
const entry = {
|
|
165
|
+
id: dep.id,
|
|
166
|
+
key: dep.key,
|
|
167
|
+
column: dep.column,
|
|
168
|
+
finished: dep.finished,
|
|
169
|
+
inGraph,
|
|
170
|
+
};
|
|
171
|
+
deps.push(entry);
|
|
163
172
|
const depOrder = orderIdOf(config.provider, config.projectId, dep.id);
|
|
164
173
|
if (inGraph) {
|
|
165
174
|
dependsOn.push(depOrder);
|
|
@@ -171,9 +180,32 @@ export function buildSnapshot(input) {
|
|
|
171
180
|
}
|
|
172
181
|
const receipt = input.receiptOf(depOrder);
|
|
173
182
|
if (!receipt) {
|
|
174
|
-
|
|
183
|
+
const repositoryId = mapping.repositoryId ?? config.repository.id;
|
|
184
|
+
const prior = prerequisites.get(depOrder);
|
|
185
|
+
if (!config.baseline?.tasks.includes(dep.key)) {
|
|
186
|
+
problem('DEPENDENCY_UNPROVEN', `Зависимость ${dep.key} в done, но проверяемого receipt этого коннектора нет: статус done не доказывает результат. Если она закрыта до внедрения harness, человек может принять её явно: добавьте ${dep.key} в baseline.tasks конфигурации коннектора (baseline: sha, tasks, reason; docs/connectors.md)`);
|
|
187
|
+
}
|
|
188
|
+
else if (prior && prior.repositoryId !== repositoryId) {
|
|
189
|
+
problem('DEPENDENCY_UNPROVEN', `Зависимость ${dep.key} в baseline, но её требуют задачи разных репозиториев (${prior.repositoryId}, ${repositoryId}); baseline — один коммит`);
|
|
190
|
+
}
|
|
191
|
+
else {
|
|
192
|
+
dependsOn.push(depOrder);
|
|
193
|
+
entry.proof = 'baseline';
|
|
194
|
+
accepted.add(dep.key);
|
|
195
|
+
prerequisites.set(depOrder, {
|
|
196
|
+
id: depOrder,
|
|
197
|
+
repositoryId,
|
|
198
|
+
resultSha: config.baseline.sha,
|
|
199
|
+
receipt: {
|
|
200
|
+
kind: 'trusted',
|
|
201
|
+
issuer: connector,
|
|
202
|
+
digest: digestOf(baselineRecord(config, dep.key, depOrder, repositoryId)),
|
|
203
|
+
},
|
|
204
|
+
});
|
|
205
|
+
}
|
|
175
206
|
continue;
|
|
176
207
|
}
|
|
208
|
+
entry.proof = 'receipt';
|
|
177
209
|
dependsOn.push(depOrder);
|
|
178
210
|
prerequisites.set(depOrder, {
|
|
179
211
|
id: depOrder,
|
|
@@ -372,6 +404,8 @@ export function buildSnapshot(input) {
|
|
|
372
404
|
connector,
|
|
373
405
|
tasks: tasks.map((t) => [t.identity, t.semanticDigest]),
|
|
374
406
|
prerequisites: prereqs,
|
|
407
|
+
// Любая правка базовой линии — новое согласование; без неё ревизия прежняя.
|
|
408
|
+
...(config.baseline ? { baseline: digestOf(config.baseline) } : {}),
|
|
375
409
|
// Без локальных пакетов ревизия та же, что до их появления. С ними —
|
|
376
410
|
// содержимое пакетов и их распределение по задачам: перенос пакета между
|
|
377
411
|
// задачами или смена порядка — тоже новое согласование.
|
|
@@ -383,7 +417,7 @@ export function buildSnapshot(input) {
|
|
|
383
417
|
: {}),
|
|
384
418
|
});
|
|
385
419
|
const joined = `${config.provider}:${config.projectId}:${taskIds.join('+')}`;
|
|
386
|
-
const
|
|
420
|
+
const parsed = workGraphSchema.safeParse({
|
|
387
421
|
apiVersion: API_VERSION,
|
|
388
422
|
id: graphId,
|
|
389
423
|
source: {
|
|
@@ -394,6 +428,15 @@ export function buildSnapshot(input) {
|
|
|
394
428
|
orders,
|
|
395
429
|
prerequisites: prereqs,
|
|
396
430
|
});
|
|
431
|
+
// Конфигурация уже проверена: сюда доходит только то, что зависит от данных
|
|
432
|
+
// задач (например, число зависимостей), и причина называется, а не теряется.
|
|
433
|
+
if (!parsed.success)
|
|
434
|
+
throw new HarnessError('NOT_READY', 'Поручения не собираются из задач: ' +
|
|
435
|
+
parsed.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`).join('; '), parsed.error.issues.map((i) => ({
|
|
436
|
+
path: ['source', ...i.path],
|
|
437
|
+
message: i.message,
|
|
438
|
+
})));
|
|
439
|
+
const graph = parsed.data;
|
|
397
440
|
const context = {
|
|
398
441
|
apiVersion: API_VERSION,
|
|
399
442
|
sources: [...sources, ...(input.local ?? [])],
|
|
@@ -421,13 +464,40 @@ export function buildSnapshot(input) {
|
|
|
421
464
|
truncated,
|
|
422
465
|
problems,
|
|
423
466
|
...(input.local?.length ? { localContext: input.local.map(localManifest) } : {}),
|
|
467
|
+
...(accepted.size
|
|
468
|
+
? {
|
|
469
|
+
baseline: {
|
|
470
|
+
sha: config.baseline.sha,
|
|
471
|
+
reason: config.baseline.reason,
|
|
472
|
+
tasks: [...accepted].sort(),
|
|
473
|
+
},
|
|
474
|
+
}
|
|
475
|
+
: {}),
|
|
424
476
|
};
|
|
425
477
|
return { graph, context, manifest, revision, problems };
|
|
426
478
|
}
|
|
427
479
|
const CONTEXT_SOURCES_MAX = 30;
|
|
428
|
-
/**
|
|
480
|
+
/**
|
|
481
|
+
* Нарушения договора источника (число файлов и справок, имя файла): запуск
|
|
482
|
+
* проверяет снимок той же схемой, поэтому они видны здесь, а не после approve.
|
|
483
|
+
* Число источников называет `contextLimitIssues`.
|
|
484
|
+
*/
|
|
485
|
+
function sourceSchemaIssues(context) {
|
|
486
|
+
const parsed = contextSnapshotSchema.safeParse(context);
|
|
487
|
+
if (parsed.success)
|
|
488
|
+
return [];
|
|
489
|
+
return parsed.error.issues
|
|
490
|
+
.filter((i) => i.path[0] === 'sources' && i.path.length > 2)
|
|
491
|
+
.map((i) => {
|
|
492
|
+
const [, index, field, file] = i.path;
|
|
493
|
+
const source = context.sources[index];
|
|
494
|
+
const name = file === undefined ? field : (source[field]?.[file]?.path ?? field);
|
|
495
|
+
return `${source.id}/${name}: ${i.message}`;
|
|
496
|
+
});
|
|
497
|
+
}
|
|
498
|
+
/** Нарушения пределов снимка контекста: число источников, размер файла, сумма и договор источника. */
|
|
429
499
|
export function contextLimitIssues(context) {
|
|
430
|
-
const issues = contextIssues(context);
|
|
500
|
+
const issues = [...contextIssues(context), ...sourceSchemaIssues(context)];
|
|
431
501
|
if (context.sources.length > CONTEXT_SOURCES_MAX)
|
|
432
502
|
issues.push(`Источников контекста ${context.sources.length} при пределе ${CONTEXT_SOURCES_MAX} (задачи и локальные пакеты)`);
|
|
433
503
|
return issues.map((i) => /больше предела/.test(i)
|
|
@@ -11,8 +11,9 @@ import { type RelayTransport } from './transport.ts';
|
|
|
11
11
|
* - `revision` — текущий semantic digest задачи (или набора) для обнаружения
|
|
12
12
|
* конфликта; ошибка сети/CLI — исключение, а не «записи нет»;
|
|
13
13
|
* - `trusts` — только receipt, выданный этим коннектором (`issuer` = его ID),
|
|
14
|
-
* digest которого совпадает с записью в его
|
|
15
|
-
*
|
|
14
|
+
* digest которого совпадает с записью в его состоянии, либо запись базовой
|
|
15
|
+
* линии текущей конфигурации для задачи, которую подтверждает backend.
|
|
16
|
+
* Статус задачи done доверием не является.
|
|
16
17
|
*/
|
|
17
18
|
export declare class RelayWorkSource implements WorkSource {
|
|
18
19
|
readonly options: {
|
|
@@ -38,4 +39,9 @@ export declare class RelayWorkSource implements WorkSource {
|
|
|
38
39
|
}>;
|
|
39
40
|
revision(ref: string): Promise<string | undefined>;
|
|
40
41
|
trusts(prerequisite: Prerequisite): Promise<boolean>;
|
|
42
|
+
/**
|
|
43
|
+
* Предпосылка базовой линии сверяется с загруженной конфигурацией целиком.
|
|
44
|
+
* Digest не секрет: что ключ — именно задача предпосылки, подтверждает backend.
|
|
45
|
+
*/
|
|
46
|
+
private trustsBaseline;
|
|
41
47
|
}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { HarnessError, digestOf, } from "../../contracts/index.js";
|
|
2
|
-
import { connectorIdOf, parseIdentity } from "./config.js";
|
|
2
|
+
import { baselineRecord, connectorIdOf, orderIdOf, parseIdentity, } from "./config.js";
|
|
3
3
|
import { assertEligible, readFailure, semanticDigest, takeSnapshot, } from "./snapshot.js";
|
|
4
4
|
import { TransportError } from "./transport.js";
|
|
5
5
|
/**
|
|
@@ -10,8 +10,9 @@ import { TransportError } from "./transport.js";
|
|
|
10
10
|
* - `revision` — текущий semantic digest задачи (или набора) для обнаружения
|
|
11
11
|
* конфликта; ошибка сети/CLI — исключение, а не «записи нет»;
|
|
12
12
|
* - `trusts` — только receipt, выданный этим коннектором (`issuer` = его ID),
|
|
13
|
-
* digest которого совпадает с записью в его
|
|
14
|
-
*
|
|
13
|
+
* digest которого совпадает с записью в его состоянии, либо запись базовой
|
|
14
|
+
* линии текущей конфигурации для задачи, которую подтверждает backend.
|
|
15
|
+
* Статус задачи done доверием не является.
|
|
15
16
|
*/
|
|
16
17
|
export class RelayWorkSource {
|
|
17
18
|
options;
|
|
@@ -59,16 +60,41 @@ export class RelayWorkSource {
|
|
|
59
60
|
const mapping = config.tasks.find((m) => m.ref === read.task.id || m.ref === read.task.key);
|
|
60
61
|
return mapping ? semanticDigest(config, mapping, read) : undefined;
|
|
61
62
|
}
|
|
62
|
-
trusts(prerequisite) {
|
|
63
|
+
async trusts(prerequisite) {
|
|
63
64
|
const receipt = prerequisite.receipt;
|
|
64
65
|
if (receipt.kind !== 'trusted' || receipt.issuer !== this.id)
|
|
65
|
-
return
|
|
66
|
+
return false;
|
|
66
67
|
const stored = this.options.store
|
|
67
68
|
.receipts(prerequisite.id)
|
|
68
69
|
.find((r) => r.issuer === this.id &&
|
|
69
70
|
digestOf(r) === receipt.digest &&
|
|
70
71
|
r.resultSha === prerequisite.resultSha &&
|
|
71
72
|
r.repositoryId === prerequisite.repositoryId);
|
|
72
|
-
return
|
|
73
|
+
return Boolean(stored) || this.trustsBaseline(prerequisite, receipt.digest);
|
|
74
|
+
}
|
|
75
|
+
/**
|
|
76
|
+
* Предпосылка базовой линии сверяется с загруженной конфигурацией целиком.
|
|
77
|
+
* Digest не секрет: что ключ — именно задача предпосылки, подтверждает backend.
|
|
78
|
+
*/
|
|
79
|
+
async trustsBaseline(prerequisite, digest) {
|
|
80
|
+
const config = this.options.config;
|
|
81
|
+
if (prerequisite.resultSha !== config.baseline?.sha)
|
|
82
|
+
return false;
|
|
83
|
+
const repositories = config.tasks.map((m) => m.repositoryId ?? config.repository.id);
|
|
84
|
+
if (!repositories.includes(prerequisite.repositoryId))
|
|
85
|
+
return false;
|
|
86
|
+
const key = config.baseline.tasks.find((k) => digestOf(baselineRecord(config, k, prerequisite.id, prerequisite.repositoryId)) === digest);
|
|
87
|
+
if (!key)
|
|
88
|
+
return false;
|
|
89
|
+
try {
|
|
90
|
+
const { task } = await this.options.transport.readTask(key);
|
|
91
|
+
return (task.key === key &&
|
|
92
|
+
orderIdOf(config.provider, config.projectId, task.id) === prerequisite.id);
|
|
93
|
+
}
|
|
94
|
+
catch (error) {
|
|
95
|
+
if (error instanceof TransportError && error.kind === 'not-found')
|
|
96
|
+
return false;
|
|
97
|
+
throw readFailure(error, 'Задача ' + key);
|
|
98
|
+
}
|
|
73
99
|
}
|
|
74
100
|
}
|
|
@@ -31,6 +31,12 @@ export declare function summaryText(input: {
|
|
|
31
31
|
criteria: CriterionOutcome[];
|
|
32
32
|
completion: string;
|
|
33
33
|
historical?: boolean;
|
|
34
|
+
/** Зависимости задачи, принятые человеком по базовой линии (не доказаны). */
|
|
35
|
+
baseline?: {
|
|
36
|
+
tasks: string[];
|
|
37
|
+
sha: string;
|
|
38
|
+
reason: string;
|
|
39
|
+
};
|
|
34
40
|
redact?: Redactor;
|
|
35
41
|
}): {
|
|
36
42
|
title: string;
|
|
@@ -29,6 +29,11 @@ export function summaryText(input) {
|
|
|
29
29
|
? [`- Причина: ${r.stopReason.code}: ${r.stopReason.message.slice(0, 500)}`]
|
|
30
30
|
: []),
|
|
31
31
|
`- Снимок постановки: ${input.task.identity} @ ${input.snapshot.revision} (CAS ${input.snapshot.casRevision})`,
|
|
32
|
+
...(input.baseline
|
|
33
|
+
? [
|
|
34
|
+
`- Зависимости без доказательства: ${input.baseline.tasks.join(', ')} приняты человеком по базовой линии @ ${shortSha(input.baseline.sha)}: ${input.baseline.reason}`,
|
|
35
|
+
]
|
|
36
|
+
: []),
|
|
32
37
|
'',
|
|
33
38
|
'**Gates**',
|
|
34
39
|
...(gates.length ? gates : ['- нет записей']),
|
|
@@ -811,6 +811,7 @@ export function connectorSuite(backend, options = {}) {
|
|
|
811
811
|
const snapD = await connD.snapshot(join(s.root, 'snapshot-d'));
|
|
812
812
|
assert.equal(snapD.eligible, false);
|
|
813
813
|
assert.ok(snapD.problems.some((p) => p.includes('DEPENDENCY_UNPROVEN')), snapD.problems.join('; '));
|
|
814
|
+
assert.ok(snapD.problems.some((p) => p.includes('baseline.tasks')), 'отказ называет выход: явное решение человека');
|
|
814
815
|
const writer = s.calls.writer;
|
|
815
816
|
await assert.rejects(connD.run(opened.h, { author: 'claude' }), refusedWith('NOT_READY'));
|
|
816
817
|
assert.equal(s.calls.writer, writer);
|
|
@@ -818,6 +819,23 @@ export function connectorSuite(backend, options = {}) {
|
|
|
818
819
|
finally {
|
|
819
820
|
connD.close();
|
|
820
821
|
}
|
|
822
|
+
// Человек принимает задачу явно: ключ backend, полный SHA, причина.
|
|
823
|
+
const sha = s.target();
|
|
824
|
+
cfgD.baseline = { sha, tasks: [c.key], reason: 'Closed before adoption' };
|
|
825
|
+
const connE = await openConnector(parseConfig(cfgD, s.root), {
|
|
826
|
+
stateDir: s.state,
|
|
827
|
+
transport: s.project.transport(),
|
|
828
|
+
});
|
|
829
|
+
try {
|
|
830
|
+
const snapE = await connE.snapshot(join(s.root, 'snapshot-e'));
|
|
831
|
+
assert.equal(snapE.eligible, true, snapE.problems.join('; '));
|
|
832
|
+
const accepted = snapE.snapshot.graph.prerequisites[0];
|
|
833
|
+
assert.equal(accepted.resultSha, sha);
|
|
834
|
+
assert.equal(await connE.source.trusts(accepted), true, 'ключ разрешён backend');
|
|
835
|
+
}
|
|
836
|
+
finally {
|
|
837
|
+
connE.close();
|
|
838
|
+
}
|
|
821
839
|
}
|
|
822
840
|
finally {
|
|
823
841
|
await s.cleanup();
|
|
@@ -56,6 +56,8 @@ const envelopeSchema = z.union([
|
|
|
56
56
|
}),
|
|
57
57
|
}),
|
|
58
58
|
]);
|
|
59
|
+
/** Предел массива в ответе Relay: страница запрашивается по 100 элементов. */
|
|
60
|
+
const MAX_ITEMS = 10_000;
|
|
59
61
|
const columnSchema = z.enum(['inbox', 'ready', 'in-progress', 'review', 'done', 'cancelled']);
|
|
60
62
|
const revisionSchema = z.number().int().nonnegative();
|
|
61
63
|
const idString = z.string().min(1);
|
|
@@ -66,12 +68,12 @@ const taskSummarySchema = z.object({
|
|
|
66
68
|
column: columnSchema,
|
|
67
69
|
revision: revisionSchema,
|
|
68
70
|
parentId: z.string().nullable(),
|
|
69
|
-
dependencies: z.array(z.string()),
|
|
71
|
+
dependencies: z.array(z.string()).max(MAX_ITEMS),
|
|
70
72
|
canComplete: z.boolean().optional(),
|
|
71
73
|
});
|
|
72
74
|
const taskViewSchema = taskSummarySchema.extend({ description: z.string() });
|
|
73
75
|
const offsetPage = (item) => z.object({
|
|
74
|
-
items: z.array(item),
|
|
76
|
+
items: z.array(item).max(MAX_ITEMS),
|
|
75
77
|
total: z.number().int().nonnegative(),
|
|
76
78
|
nextOffset: z.number().int().nonnegative().nullable(),
|
|
77
79
|
version: z.string().min(1),
|
|
@@ -101,7 +103,7 @@ const commentSummarySchema = z.object({
|
|
|
101
103
|
});
|
|
102
104
|
const commentSchema = commentSummarySchema.extend({ description: z.string() });
|
|
103
105
|
const commentsPageSchema = z.object({
|
|
104
|
-
items: z.array(commentSummarySchema),
|
|
106
|
+
items: z.array(commentSummarySchema).max(MAX_ITEMS),
|
|
105
107
|
nextCursor: z.string().nullable(),
|
|
106
108
|
snapshot: z.number().int().nonnegative(),
|
|
107
109
|
});
|
|
@@ -121,7 +123,7 @@ const documentDetailSchema = entitySummarySchema.extend({
|
|
|
121
123
|
const healthSchema = z.object({ status: z.string(), contractVersion: z.number().int() });
|
|
122
124
|
const contextSchema = z.object({
|
|
123
125
|
projectId: z.string().min(1),
|
|
124
|
-
capabilities: z.array(z.string()).optional(),
|
|
126
|
+
capabilities: z.array(z.string()).max(MAX_ITEMS).optional(),
|
|
125
127
|
});
|
|
126
128
|
const sessionSchema = z.object({
|
|
127
129
|
id: idString,
|
|
@@ -31,6 +31,8 @@ export const columnSchema = z.enum([
|
|
|
31
31
|
'done',
|
|
32
32
|
'cancelled',
|
|
33
33
|
]);
|
|
34
|
+
/** Предел массива в ответе Relay-2: размер всего ответа ограничен транспортом. */
|
|
35
|
+
const MAX_ITEMS = 10_000;
|
|
34
36
|
/** Общий envelope записи: `{id, kind, key, revision, …, data}`. */
|
|
35
37
|
const envelope = (kind, data) => z.object({
|
|
36
38
|
id: z.string().min(1),
|
|
@@ -60,14 +62,14 @@ export const taskSchema = envelope('task', z.object({
|
|
|
60
62
|
description: nullableText,
|
|
61
63
|
column: columnSchema,
|
|
62
64
|
parentId: z.string().nullable(),
|
|
63
|
-
dependencies: z.array(z.string()),
|
|
64
|
-
acceptanceCriteria: z.array(criterionSchema),
|
|
65
|
-
comments: z.array(commentSchema).optional(),
|
|
65
|
+
dependencies: z.array(z.string()).max(MAX_ITEMS),
|
|
66
|
+
acceptanceCriteria: z.array(criterionSchema).max(MAX_ITEMS),
|
|
67
|
+
comments: z.array(commentSchema).max(MAX_ITEMS).optional(),
|
|
66
68
|
}));
|
|
67
69
|
export const progressSchema = z.object({
|
|
68
70
|
completed: z.boolean(),
|
|
69
71
|
canComplete: z.boolean(),
|
|
70
|
-
blockers: z.array(z.string()),
|
|
72
|
+
blockers: z.array(z.string()).max(MAX_ITEMS),
|
|
71
73
|
});
|
|
72
74
|
export const documentSchema = envelope('document', z.object({ name: z.string(), body: z.string() }));
|
|
73
75
|
export const sessionSchema = envelope('work-session', z.object({
|
|
@@ -96,7 +98,7 @@ export const doctorSchema = z.object({
|
|
|
96
98
|
projectId: z.string().min(1),
|
|
97
99
|
generation: z.number().int().nonnegative(),
|
|
98
100
|
valid: z.boolean(),
|
|
99
|
-
issues: z.array(z.unknown()),
|
|
101
|
+
issues: z.array(z.unknown()).max(MAX_ITEMS),
|
|
100
102
|
});
|
|
101
103
|
export const pageMetaSchema = z.object({
|
|
102
104
|
page: z.object({
|
|
@@ -104,7 +106,7 @@ export const pageMetaSchema = z.object({
|
|
|
104
106
|
consistency: z.string().optional(),
|
|
105
107
|
}),
|
|
106
108
|
});
|
|
107
|
-
export const itemsSchema = z.object({ items: z.array(z.unknown()) });
|
|
109
|
+
export const itemsSchema = z.object({ items: z.array(z.unknown()).max(MAX_ITEMS) });
|
|
108
110
|
/** Стабильный код Relay-2 → класс отказа транспорта. Exit code — только грубый класс. */
|
|
109
111
|
export function classifyCode(code, exit, mutation) {
|
|
110
112
|
switch (code) {
|