devcontour-harness 0.1.0-alpha.25 → 0.1.0-alpha.27

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (80) hide show
  1. package/README.md +16 -2
  2. package/docs/architecture.md +59 -0
  3. package/docs/compatibility.md +25 -11
  4. package/docs/connectors.md +72 -3
  5. package/docs/contracts.md +60 -24
  6. package/docs/release-notes/0.1.0-alpha.26.md +35 -0
  7. package/docs/release-notes/0.1.0-alpha.27.md +36 -0
  8. package/docs/review-protocol.md +16 -2
  9. package/docs/toolchains.md +83 -0
  10. package/docs/upgrade.md +10 -0
  11. package/lib/agents/cli-adapter.d.ts +6 -0
  12. package/lib/agents/cli-adapter.js +12 -2
  13. package/lib/agents/review-probe.d.ts +5 -0
  14. package/lib/agents/review-probe.js +29 -9
  15. package/lib/agents/schemas.d.ts +4 -0
  16. package/lib/agents/schemas.js +3 -1
  17. package/lib/cli.js +22 -5
  18. package/lib/contracts/cli.d.ts +184 -1
  19. package/lib/contracts/cli.js +102 -2
  20. package/lib/contracts/failure.js +1 -1
  21. package/lib/contracts/policy.d.ts +30 -0
  22. package/lib/contracts/policy.js +23 -0
  23. package/lib/contracts/published.d.ts +8 -0
  24. package/lib/contracts/review.d.ts +69 -0
  25. package/lib/contracts/review.js +29 -14
  26. package/lib/contracts/work.d.ts +6 -0
  27. package/lib/contracts/work.js +13 -12
  28. package/lib/control/harness.d.ts +12 -0
  29. package/lib/control/harness.js +4 -0
  30. package/lib/control/review.js +14 -2
  31. package/lib/engine/joint-runner.js +34 -1
  32. package/lib/engine/runner.d.ts +29 -0
  33. package/lib/engine/runner.js +207 -5
  34. package/lib/engine/worktree-cleanup.d.ts +131 -0
  35. package/lib/engine/worktree-cleanup.js +520 -0
  36. package/lib/environment/bounded-read.d.ts +12 -0
  37. package/lib/environment/bounded-read.js +40 -0
  38. package/lib/environment/isolation.d.ts +1 -0
  39. package/lib/environment/isolation.js +2 -1
  40. package/lib/environment/os-tools.d.ts +4 -2
  41. package/lib/environment/os-tools.js +4 -2
  42. package/lib/environment/process.d.ts +5 -0
  43. package/lib/environment/process.js +40 -17
  44. package/lib/environment/resources.d.ts +9 -0
  45. package/lib/environment/resources.js +24 -0
  46. package/lib/index.d.ts +1 -0
  47. package/lib/index.js +1 -0
  48. package/lib/integrations/connector/commands.d.ts +37 -8
  49. package/lib/integrations/connector/commands.js +61 -8
  50. package/lib/integrations/connector/config.d.ts +37 -0
  51. package/lib/integrations/connector/config.js +37 -5
  52. package/lib/integrations/connector/delivery.js +17 -1
  53. package/lib/integrations/connector/index.d.ts +2 -2
  54. package/lib/integrations/connector/index.js +1 -1
  55. package/lib/integrations/connector/snapshot.d.ts +10 -8
  56. package/lib/integrations/connector/snapshot.js +78 -8
  57. package/lib/integrations/connector/source.d.ts +8 -2
  58. package/lib/integrations/connector/source.js +32 -6
  59. package/lib/integrations/connector/store.d.ts +1 -1
  60. package/lib/integrations/connector/store.js +11 -6
  61. package/lib/integrations/connector/summary.d.ts +6 -0
  62. package/lib/integrations/connector/summary.js +5 -0
  63. package/lib/integrations/connector/testing.js +18 -0
  64. package/lib/integrations/relay-v1/index.js +6 -4
  65. package/lib/integrations/relay-v2/protocol.js +8 -6
  66. package/lib/profiles/resolve.d.ts +6 -0
  67. package/lib/toolchains/inspect.d.ts +1 -1
  68. package/lib/toolchains/inspect.js +29 -1
  69. package/lib/toolchains/probe.d.ts +16 -0
  70. package/lib/toolchains/probe.js +20 -0
  71. package/lib/verification/confirm.d.ts +3 -1
  72. package/lib/verification/confirm.js +26 -4
  73. package/lib/verification/dependencies.d.ts +3 -0
  74. package/lib/verification/dependencies.js +11 -0
  75. package/lib/verification/dependency-store.d.ts +117 -0
  76. package/lib/verification/dependency-store.js +811 -0
  77. package/lib/verification/gates-at.js +18 -0
  78. package/lib/verification/gates.js +24 -7
  79. package/package.json +2 -2
  80. package/schemas/execution-policy.schema.json +34 -0
@@ -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, relativePathSchema, roleIdSchema, sha256, gateScopeSchema, } from "../../contracts/index.js";
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: z
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
- const base = { casRevision: read.task.revision, taskKey: read.task.key, identity };
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 LocalContextManifest {
91
- id: string;
92
- digest: string;
93
- files: number;
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; вне — только с доверенным receipt.
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
- deps.push({ id: dep.id, key: dep.key, column: dep.column, finished: dep.finished, inGraph });
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
- problem('DEPENDENCY_UNPROVEN', `Зависимость ${dep.key} в done, но проверяемого receipt этого коннектора нет: статус done не доказывает результат`);
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 graph = workGraphSchema.parse({
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 которого совпадает с записью в его состоянии. Статус задачи done
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 которого совпадает с записью в его состоянии. Статус задачи done
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 Promise.resolve(false);
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 Promise.resolve(Boolean(stored));
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
  }
@@ -99,7 +99,7 @@ export declare class ConnectorStore {
99
99
  created: boolean;
100
100
  };
101
101
  snapshot(revision: string): SnapshotRecord | undefined;
102
- /** Последний снимок графа (по времени записи). */
102
+ /** Последний закреплённый снимок графа: порядок записи, а не время создания редакции. */
103
103
  latestSnapshot(graphId: string): SnapshotRecord | undefined;
104
104
  /** Последний закреплённый снимок любого графа этого коннектора. */
105
105
  latestSnapshotAny(): SnapshotRecord | undefined;
@@ -94,8 +94,15 @@ export class ConnectorStore {
94
94
  return this.tx(() => {
95
95
  const prior = this.snapshot(record.revision);
96
96
  // Повтор той же редакции не меняет записанный снимок (и время его создания).
97
- if (prior)
97
+ // Возврат к прежней редакции снова делает её последней: иначе снимок,
98
+ // совпавший со свежим чтением, не закрепить ничем, кроме новой правки.
99
+ if (prior) {
100
+ this.db
101
+ .prepare(`UPDATE snapshots SET rowid=(SELECT max(rowid) + 1 FROM snapshots)
102
+ WHERE revision=? AND rowid<(SELECT max(rowid) FROM snapshots)`)
103
+ .run(record.revision);
98
104
  return { record: prior, created: false };
105
+ }
99
106
  const full = { ...record, createdAt: now() };
100
107
  this.db
101
108
  .prepare('INSERT INTO snapshots VALUES(?, ?, ?, ?)')
@@ -107,18 +114,16 @@ export class ConnectorStore {
107
114
  const row = this.db.prepare('SELECT data FROM snapshots WHERE revision=?').get(revision);
108
115
  return row ? JSON.parse(row.data) : undefined;
109
116
  }
110
- /** Последний снимок графа (по времени записи). */
117
+ /** Последний закреплённый снимок графа: порядок записи, а не время создания редакции. */
111
118
  latestSnapshot(graphId) {
112
119
  const row = this.db
113
- .prepare('SELECT data FROM snapshots WHERE graph_id=? ORDER BY created_at DESC, rowid DESC LIMIT 1')
120
+ .prepare('SELECT data FROM snapshots WHERE graph_id=? ORDER BY rowid DESC LIMIT 1')
114
121
  .get(graphId);
115
122
  return row ? JSON.parse(row.data) : undefined;
116
123
  }
117
124
  /** Последний закреплённый снимок любого графа этого коннектора. */
118
125
  latestSnapshotAny() {
119
- const row = this.db
120
- .prepare('SELECT data FROM snapshots ORDER BY created_at DESC, rowid DESC LIMIT 1')
121
- .get();
126
+ const row = this.db.prepare('SELECT data FROM snapshots ORDER BY rowid DESC LIMIT 1').get();
122
127
  return row ? JSON.parse(row.data) : undefined;
123
128
  }
124
129
  /* ---------------------------------------------------------------- */
@@ -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) {
@@ -228,6 +228,12 @@ export declare function repositoryFromProfile(profile: ResolvedProfile, own: Pic
228
228
  timeoutMs: number;
229
229
  }[];
230
230
  } | undefined;
231
+ dependencyStore?: {
232
+ manager: "pnpm";
233
+ lockfile: string;
234
+ maxBytes: number;
235
+ timeoutMs: number;
236
+ } | undefined;
231
237
  toolchain?: {
232
238
  tools: Record<string, string>;
233
239
  packageManagers: Record<string, "npm" | "pnpm">;
@@ -7,7 +7,7 @@ type Field = (string | number)[];
7
7
  * Коды проблем диагностики toolchain. Каждая проблема называет поле
8
8
  * конфигурации (`field`) и, когда причина в файле проекта, — путь (`path`).
9
9
  */
10
- export declare const toolchainProblemCodes: readonly ["REPOSITORY_MISSING", "CWD_MISSING", "TOOL_MISSING", "TOOL_VERSION", "TOOL_VERSION_UNKNOWN", "TOOL_NOT_LOCKED", "MANIFEST_MISSING", "LOCKFILE_MISSING", "LOCKFILE_AMBIGUOUS", "SCRIPT_UNKNOWN", "TASK_UNKNOWN", "FILTER_UNKNOWN", "INSTALL_UNLOCKED", "UNPINNED", "IF_PRESENT", "CACHE_REPLAY", "REPORT_MISMATCH", "COMPOSITION_CONFLICT", "PROJECT_FILE_MISSING", "SCRIPT_UNRESOLVED", "TOOL_IN_PROJECT"];
10
+ export declare const toolchainProblemCodes: readonly ["REPOSITORY_MISSING", "CWD_MISSING", "TOOL_MISSING", "TOOL_VERSION", "TOOL_VERSION_UNKNOWN", "TOOL_NOT_LOCKED", "MANIFEST_MISSING", "LOCKFILE_MISSING", "LOCKFILE_AMBIGUOUS", "SCRIPT_UNKNOWN", "TASK_UNKNOWN", "FILTER_UNKNOWN", "INSTALL_UNLOCKED", "UNPINNED", "IF_PRESENT", "CACHE_REPLAY", "REPORT_MISMATCH", "COMPOSITION_CONFLICT", "PROJECT_FILE_MISSING", "SCRIPT_UNRESOLVED", "TOOL_IN_PROJECT", "DEPENDENCY_STORE"];
11
11
  export type ToolchainProblemCode = (typeof toolchainProblemCodes)[number];
12
12
  export interface ToolchainProblem {
13
13
  code: ToolchainProblemCode;