devcontour-harness 0.1.0-alpha.34 → 0.1.0-alpha.37

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 (125) hide show
  1. package/README.md +22 -2
  2. package/docs/contracts.md +309 -35
  3. package/docs/release-notes/0.1.0-alpha.35.md +27 -0
  4. package/docs/release-notes/0.1.0-alpha.36.md +26 -0
  5. package/docs/release-notes/0.1.0-alpha.37.md +40 -0
  6. package/docs/standalone.md +20 -0
  7. package/docs/toolchains.md +57 -2
  8. package/docs/upgrade.md +143 -0
  9. package/lib/agents/cli-adapter.d.ts +10 -1
  10. package/lib/agents/cli-adapter.js +38 -7
  11. package/lib/agents/schemas.d.ts +84 -2
  12. package/lib/agents/schemas.js +49 -1
  13. package/lib/agents/usage.d.ts +9 -0
  14. package/lib/agents/usage.js +22 -1
  15. package/lib/cli.js +149 -1
  16. package/lib/contracts/cli.d.ts +1544 -171
  17. package/lib/contracts/cli.js +233 -2
  18. package/lib/contracts/diagnosis.d.ts +10 -4
  19. package/lib/contracts/diagnosis.js +4 -0
  20. package/lib/contracts/errors.d.ts +9 -1
  21. package/lib/contracts/errors.js +8 -0
  22. package/lib/contracts/events.d.ts +468 -60
  23. package/lib/contracts/events.js +79 -0
  24. package/lib/contracts/execution.d.ts +301 -50
  25. package/lib/contracts/execution.js +60 -0
  26. package/lib/contracts/failure.d.ts +20 -3
  27. package/lib/contracts/failure.js +14 -2
  28. package/lib/contracts/handoff.d.ts +79 -20
  29. package/lib/contracts/handoff.js +42 -1
  30. package/lib/contracts/index.d.ts +1 -0
  31. package/lib/contracts/index.js +1 -0
  32. package/lib/contracts/input-state.d.ts +13 -0
  33. package/lib/contracts/input-state.js +32 -0
  34. package/lib/contracts/input.d.ts +442 -0
  35. package/lib/contracts/input.js +321 -0
  36. package/lib/contracts/planning.d.ts +4 -0
  37. package/lib/contracts/policy.d.ts +17 -2
  38. package/lib/contracts/policy.js +31 -2
  39. package/lib/contracts/ports.d.ts +64 -2
  40. package/lib/contracts/project.d.ts +127 -0
  41. package/lib/contracts/project.js +99 -0
  42. package/lib/contracts/published.d.ts +631 -92
  43. package/lib/contracts/published.js +4 -1
  44. package/lib/contracts/repair-policy.d.ts +30 -1
  45. package/lib/contracts/repair-policy.js +52 -0
  46. package/lib/contracts/report.d.ts +55 -21
  47. package/lib/contracts/report.js +33 -2
  48. package/lib/contracts/result.d.ts +28 -24
  49. package/lib/contracts/review.d.ts +47 -8
  50. package/lib/contracts/review.js +21 -1
  51. package/lib/control/harness.d.ts +2555 -51
  52. package/lib/control/harness.js +112 -6
  53. package/lib/control/recovery.d.ts +2 -2
  54. package/lib/control/report.js +1 -0
  55. package/lib/control/status.d.ts +30 -22
  56. package/lib/control/status.js +11 -1
  57. package/lib/control/workflow.d.ts +8 -8
  58. package/lib/engine/budget.d.ts +86 -3
  59. package/lib/engine/budget.js +45 -10
  60. package/lib/engine/classify.js +1 -1
  61. package/lib/engine/engine.d.ts +3091 -83
  62. package/lib/engine/engine.js +1209 -101
  63. package/lib/engine/failure.d.ts +1 -1
  64. package/lib/engine/failure.js +1 -1
  65. package/lib/engine/input-policy.d.ts +68 -0
  66. package/lib/engine/input-policy.js +285 -0
  67. package/lib/engine/input-requests.d.ts +64 -0
  68. package/lib/engine/input-requests.js +187 -0
  69. package/lib/engine/measured.d.ts +6 -1
  70. package/lib/engine/measured.js +12 -1
  71. package/lib/engine/prompt.d.ts +4 -2
  72. package/lib/engine/prompt.js +13 -1
  73. package/lib/engine/property-recovery.js +4 -0
  74. package/lib/engine/repair.d.ts +2 -0
  75. package/lib/engine/repair.js +13 -4
  76. package/lib/engine/reuse.js +2 -0
  77. package/lib/engine/runner.d.ts +33 -4
  78. package/lib/engine/runner.js +275 -23
  79. package/lib/environment/lifecycle.d.ts +8 -0
  80. package/lib/environment/lifecycle.js +15 -2
  81. package/lib/explain/state.d.ts +16 -2
  82. package/lib/explain/state.js +262 -79
  83. package/lib/handoff/markdown.js +10 -0
  84. package/lib/handoff/pack.js +42 -1
  85. package/lib/index.d.ts +11 -1
  86. package/lib/index.js +11 -1
  87. package/lib/init/inspect.d.ts +34 -0
  88. package/lib/init/inspect.js +292 -0
  89. package/lib/init/project.js +14 -31
  90. package/lib/integrations/connector/commands.d.ts +12 -12
  91. package/lib/integrations/connector/config.d.ts +4 -4
  92. package/lib/integrations/connector/delivery.d.ts +1 -1
  93. package/lib/integrations/relay-v2/protocol.d.ts +4 -4
  94. package/lib/profiles/resolve.d.ts +2 -1
  95. package/lib/projections/enums.d.ts +1 -1
  96. package/lib/projections/enums.js +4 -0
  97. package/lib/projections/index.d.ts +1 -0
  98. package/lib/projections/index.js +1 -0
  99. package/lib/projections/input.d.ts +17 -0
  100. package/lib/projections/input.js +28 -0
  101. package/lib/projections/stop.d.ts +42 -1
  102. package/lib/projections/stop.js +117 -6
  103. package/lib/report/compute.d.ts +4 -1
  104. package/lib/report/compute.js +26 -0
  105. package/lib/report/document.js +2 -1
  106. package/lib/storage/document.d.ts +68 -28
  107. package/lib/testing/index.d.ts +1 -1
  108. package/lib/testing/index.js +1 -1
  109. package/lib/testing/store-contract.d.ts +8 -1
  110. package/lib/testing/store-contract.js +194 -1
  111. package/lib/verification/confirm.d.ts +3 -3
  112. package/lib/verification/corpus.d.ts +9 -9
  113. package/lib/verification/gates.d.ts +119 -0
  114. package/lib/verification/gates.js +311 -4
  115. package/package.json +1 -1
  116. package/schemas/execution-document.schema.json +141 -0
  117. package/schemas/execution-policy.schema.json +26 -0
  118. package/schemas/handoff-pack.schema.json +155 -4
  119. package/schemas/input-request.schema.json +665 -0
  120. package/schemas/project-facts.schema.json +393 -0
  121. package/schemas/result-envelope.schema.json +2 -0
  122. package/schemas/run-event.schema.json +628 -0
  123. package/schemas/run-result.schema.json +2 -0
  124. package/schemas/stop-diagnosis.schema.json +7 -1
  125. package/schemas/value-report.schema.json +79 -7
@@ -3,6 +3,8 @@ import { API_VERSION } from "./version.js";
3
3
  import { digestSchema, gitShaSchema, idSchema, isoTimeSchema, runtimeNameSchema, } from "./primitives.js";
4
4
  import { sourceRefSchema } from "./work.js";
5
5
  import { activitySchema, failureKindSchema, livenessStateSchema, stallActionSchema, workStatusSchema, } from "./execution.js";
6
+ import { inputFloorSchema, inputRequestSchema } from "./input.js";
7
+ const inputRequestId = inputRequestSchema.shape.id;
6
8
  const sha = gitShaSchema;
7
9
  const text = z.string().max(4000);
8
10
  const runtime = runtimeNameSchema;
@@ -275,6 +277,75 @@ export const eventPayloads = {
275
277
  status: z.enum(['requested', 'failed', 'cleared']),
276
278
  error: text.optional(),
277
279
  }),
280
+ /**
281
+ * Исполнитель остановился с вопросом или controller записал неблокирующий
282
+ * запрос (follow-up, отклонённый вопрос): только ID, вид, серьёзность,
283
+ * минимумы и digests — текста вопроса в журнале нет.
284
+ */
285
+ 'input.requested': z.strictObject({
286
+ requestId: inputRequestId,
287
+ kind: z.enum(['question', 'follow-up']),
288
+ blocking: z.boolean(),
289
+ lifecycle: z.enum(['pending', 'cancelled']),
290
+ effectiveSeverity: z.number().int().min(1).max(10),
291
+ floors: z.array(inputFloorSchema).max(2),
292
+ criticalHits: z.number().int().min(0),
293
+ questionDigest: digestSchema,
294
+ draftDigest: digestSchema.nullable(),
295
+ }),
296
+ /** Записан ответ (новая версия): digest и вид, без текста. */
297
+ 'input.answered': z.strictObject({
298
+ requestId: inputRequestId,
299
+ revision: z.number().int().positive(),
300
+ answerDigest: digestSchema,
301
+ kind: z.enum(['clarification', 'requirement-change']),
302
+ actor: z.enum(['operator', 'lead', 'host']),
303
+ }),
304
+ /**
305
+ * Ответ применён: основание продолжения активировано, поручение
306
+ * возвращено в очередь (`retried`) — одной транзакцией, без вызова модели.
307
+ */
308
+ 'input.applied': z.strictObject({
309
+ requestId: inputRequestId,
310
+ answerDigest: digestSchema,
311
+ targetDigest: digestSchema,
312
+ contextDigest: digestSchema.nullable(),
313
+ retried: z.boolean(),
314
+ }),
315
+ /** Запрос закрыт без продолжения: отменён или заменён преемником. */
316
+ 'input.closed': z.strictObject({
317
+ requestId: inputRequestId,
318
+ lifecycle: z.enum(['cancelled', 'superseded']),
319
+ by: z.enum(['operator', 'lead', 'host', 'controller']),
320
+ successor: z.string().min(1).max(200).optional(),
321
+ }),
322
+ /**
323
+ * Применённое основание устарело до выдачи (claim): запрос снова
324
+ * `answered`, работа ждёт нового применения; без текста.
325
+ */
326
+ 'input.stale': z.strictObject({
327
+ requestId: inputRequestId,
328
+ targetDigest: digestSchema,
329
+ reason: z.enum(['context', 'graph', 'order', 'policy']),
330
+ }),
331
+ /** Ответ передан исполнителю: начался вызов runtime попытки с этим ответом. */
332
+ 'input.delivered': z.strictObject({
333
+ requestId: inputRequestId,
334
+ answerDigest: digestSchema,
335
+ callId: z.string().min(1).max(200),
336
+ }),
337
+ /**
338
+ * Развилки, решённые исполнителем: только число, наибольшая действующая
339
+ * серьёзность, число сработавших минимумов и неблокирующих запросов,
340
+ * digest списка — текста допущений в журнале нет.
341
+ */
342
+ 'attempt.assumptions': z.strictObject({
343
+ count: z.number().int().min(0).max(20),
344
+ maxSeverity: z.number().int().min(0).max(10),
345
+ floors: z.number().int().min(0),
346
+ followUps: z.number().int().min(0),
347
+ digest: digestSchema,
348
+ }),
278
349
  'delivery.pending': z.strictObject(delivery),
279
350
  'delivery.delivered': z.strictObject({ ...delivery, receipt: z.string().max(1000).optional() }),
280
351
  'delivery.failed': z.strictObject({ ...delivery, error: text }),
@@ -416,4 +487,12 @@ export const transactionKinds = [
416
487
  'checks.awaiting-operator',
417
488
  'checks.adoption-abandoned',
418
489
  'checks.spike',
490
+ /** Ответ на вопрос исполнителя (`input.answered`). */
491
+ 'input.answered',
492
+ /** Применение ответа: активация основания и повтор (`input.applied`). */
493
+ 'input.applied',
494
+ /** Отмена или замена запроса (`input.closed`). */
495
+ 'input.closed',
496
+ /** Подтверждение передачи ответа началом вызова (`input.delivered`). */
497
+ 'input.delivered',
419
498
  ];