devcontour-harness 0.1.0-alpha.35 → 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.
- package/README.md +16 -2
- package/docs/contracts.md +261 -33
- package/docs/release-notes/0.1.0-alpha.36.md +26 -0
- package/docs/release-notes/0.1.0-alpha.37.md +40 -0
- package/docs/standalone.md +20 -0
- package/docs/toolchains.md +57 -2
- package/docs/upgrade.md +108 -0
- package/lib/agents/schemas.d.ts +84 -2
- package/lib/agents/schemas.js +49 -1
- package/lib/cli.js +149 -1
- package/lib/contracts/cli.d.ts +1495 -170
- package/lib/contracts/cli.js +232 -2
- package/lib/contracts/diagnosis.d.ts +8 -4
- package/lib/contracts/diagnosis.js +3 -0
- package/lib/contracts/errors.d.ts +7 -1
- package/lib/contracts/errors.js +6 -0
- package/lib/contracts/events.d.ts +453 -60
- package/lib/contracts/events.js +79 -0
- package/lib/contracts/execution.d.ts +270 -50
- package/lib/contracts/execution.js +41 -0
- package/lib/contracts/failure.d.ts +14 -1
- package/lib/contracts/failure.js +9 -1
- package/lib/contracts/handoff.d.ts +70 -20
- package/lib/contracts/handoff.js +42 -1
- package/lib/contracts/index.d.ts +1 -0
- package/lib/contracts/index.js +1 -0
- package/lib/contracts/input-state.d.ts +13 -0
- package/lib/contracts/input-state.js +32 -0
- package/lib/contracts/input.d.ts +442 -0
- package/lib/contracts/input.js +321 -0
- package/lib/contracts/planning.d.ts +2 -0
- package/lib/contracts/policy.d.ts +17 -2
- package/lib/contracts/policy.js +31 -2
- package/lib/contracts/ports.d.ts +54 -0
- package/lib/contracts/project.d.ts +127 -0
- package/lib/contracts/project.js +99 -0
- package/lib/contracts/published.d.ts +603 -92
- package/lib/contracts/published.js +4 -1
- package/lib/contracts/repair-policy.d.ts +20 -0
- package/lib/contracts/repair-policy.js +34 -0
- package/lib/contracts/report.d.ts +53 -21
- package/lib/contracts/report.js +33 -2
- package/lib/contracts/result.d.ts +26 -24
- package/lib/contracts/review.d.ts +47 -8
- package/lib/contracts/review.js +21 -1
- package/lib/control/harness.d.ts +2555 -51
- package/lib/control/harness.js +112 -6
- package/lib/control/recovery.d.ts +2 -2
- package/lib/control/report.js +1 -0
- package/lib/control/status.d.ts +30 -22
- package/lib/control/status.js +11 -1
- package/lib/control/workflow.d.ts +8 -8
- package/lib/engine/budget.d.ts +86 -3
- package/lib/engine/budget.js +45 -10
- package/lib/engine/engine.d.ts +3091 -85
- package/lib/engine/engine.js +1206 -101
- package/lib/engine/input-policy.d.ts +68 -0
- package/lib/engine/input-policy.js +285 -0
- package/lib/engine/input-requests.d.ts +64 -0
- package/lib/engine/input-requests.js +187 -0
- package/lib/engine/measured.d.ts +6 -1
- package/lib/engine/measured.js +12 -1
- package/lib/engine/prompt.d.ts +4 -2
- package/lib/engine/prompt.js +3 -1
- package/lib/engine/property-recovery.js +2 -0
- package/lib/engine/repair.d.ts +2 -0
- package/lib/engine/repair.js +10 -3
- package/lib/engine/runner.d.ts +33 -4
- package/lib/engine/runner.js +266 -23
- package/lib/environment/lifecycle.d.ts +8 -0
- package/lib/environment/lifecycle.js +15 -2
- package/lib/explain/state.d.ts +16 -2
- package/lib/explain/state.js +254 -77
- package/lib/handoff/markdown.js +10 -0
- package/lib/handoff/pack.js +42 -1
- package/lib/index.d.ts +10 -0
- package/lib/index.js +10 -0
- package/lib/init/inspect.d.ts +34 -0
- package/lib/init/inspect.js +292 -0
- package/lib/init/project.js +14 -31
- package/lib/integrations/connector/commands.d.ts +12 -12
- package/lib/integrations/connector/config.d.ts +4 -4
- package/lib/integrations/connector/delivery.d.ts +1 -1
- package/lib/integrations/relay-v2/protocol.d.ts +4 -4
- package/lib/profiles/resolve.d.ts +2 -1
- package/lib/projections/enums.d.ts +1 -1
- package/lib/projections/enums.js +4 -0
- package/lib/projections/index.d.ts +1 -0
- package/lib/projections/index.js +1 -0
- package/lib/projections/input.d.ts +17 -0
- package/lib/projections/input.js +28 -0
- package/lib/projections/stop.d.ts +40 -1
- package/lib/projections/stop.js +87 -4
- package/lib/report/compute.d.ts +4 -1
- package/lib/report/compute.js +25 -0
- package/lib/report/document.js +1 -0
- package/lib/storage/document.d.ts +66 -28
- package/lib/testing/index.d.ts +1 -1
- package/lib/testing/index.js +1 -1
- package/lib/testing/store-contract.d.ts +8 -1
- package/lib/testing/store-contract.js +194 -1
- package/lib/verification/confirm.d.ts +3 -3
- package/lib/verification/corpus.d.ts +9 -9
- package/lib/verification/gates.d.ts +119 -0
- package/lib/verification/gates.js +311 -4
- package/package.json +1 -1
- package/schemas/execution-document.schema.json +130 -0
- package/schemas/execution-policy.schema.json +26 -0
- package/schemas/handoff-pack.schema.json +146 -4
- package/schemas/input-request.schema.json +665 -0
- package/schemas/project-facts.schema.json +393 -0
- package/schemas/result-envelope.schema.json +1 -0
- package/schemas/run-event.schema.json +625 -0
- package/schemas/run-result.schema.json +1 -0
- package/schemas/stop-diagnosis.schema.json +5 -1
- package/schemas/value-report.schema.json +78 -7
package/lib/contracts/cli.js
CHANGED
|
@@ -15,6 +15,7 @@ import { toolchainReportSchema } from "./toolchain.js";
|
|
|
15
15
|
import { operationCatalogSchema } from "./catalog.js";
|
|
16
16
|
import { reportDataSchema } from "./report.js";
|
|
17
17
|
import { handoffPackSchema } from "./handoff.js";
|
|
18
|
+
import { inputAnswerSchema, inputLifecycles, inputRequestSchema, inputStateNames, inputTargetSchema, } from "./input.js";
|
|
18
19
|
const state = {
|
|
19
20
|
name: '--state',
|
|
20
21
|
value: 'dir',
|
|
@@ -57,6 +58,24 @@ const source = {
|
|
|
57
58
|
required: true,
|
|
58
59
|
description: 'Конфигурация коннектора задач (provider relay-v1-http | relay-v2-cli)',
|
|
59
60
|
};
|
|
61
|
+
const inputRequestArg = {
|
|
62
|
+
name: '--request',
|
|
63
|
+
value: 'id',
|
|
64
|
+
required: true,
|
|
65
|
+
description: 'ID запроса исполнителя (IR-…)',
|
|
66
|
+
};
|
|
67
|
+
const requestVersionArg = {
|
|
68
|
+
name: '--request-version',
|
|
69
|
+
value: 'number',
|
|
70
|
+
required: true,
|
|
71
|
+
description: 'Версия запроса, которую видел вызывающий (CAS)',
|
|
72
|
+
};
|
|
73
|
+
const contextDigestArg = {
|
|
74
|
+
name: '--context-digest',
|
|
75
|
+
value: 'digest',
|
|
76
|
+
required: true,
|
|
77
|
+
description: 'Digest снимка контекста с ответом (input-context), прошедшего review-plan',
|
|
78
|
+
};
|
|
60
79
|
export const cliCommands = {
|
|
61
80
|
validate: {
|
|
62
81
|
description: 'Проверить граф, политику, их связь и (если задан) снимок контекста без вызова моделей и записи состояния',
|
|
@@ -116,7 +135,7 @@ export const cliCommands = {
|
|
|
116
135
|
},
|
|
117
136
|
{ name: '--subject', value: 'id', required: true, description: 'ID графа или контракта' },
|
|
118
137
|
],
|
|
119
|
-
refusals: ['APPROVAL_STALE', 'APPROVAL_REQUIRED', 'REVIEW_REJECTED'],
|
|
138
|
+
refusals: ['APPROVAL_STALE', 'APPROVAL_REQUIRED', 'REVIEW_REJECTED', 'INPUT_REQUIRED'],
|
|
120
139
|
},
|
|
121
140
|
run: {
|
|
122
141
|
description: 'Зарегистрировать согласованный граф (идемпотентно по connector, ref, revision, digest) и вести работу до простоя',
|
|
@@ -165,6 +184,7 @@ export const cliCommands = {
|
|
|
165
184
|
'BUDGET_UNKNOWN',
|
|
166
185
|
'ATTEMPTS_EXHAUSTED',
|
|
167
186
|
'CONTEXT_EXHAUSTED',
|
|
187
|
+
'INPUT_REQUIRED',
|
|
168
188
|
],
|
|
169
189
|
},
|
|
170
190
|
status: {
|
|
@@ -234,7 +254,13 @@ export const cliCommands = {
|
|
|
234
254
|
},
|
|
235
255
|
{ name: '--reason', value: 'text', required: false, description: 'Причина сброса' },
|
|
236
256
|
],
|
|
237
|
-
refusals: [
|
|
257
|
+
refusals: [
|
|
258
|
+
'NOT_FOUND',
|
|
259
|
+
'ATTEMPTS_EXHAUSTED',
|
|
260
|
+
'BUDGET_EXHAUSTED',
|
|
261
|
+
'BUDGET_UNKNOWN',
|
|
262
|
+
'INPUT_REQUIRED',
|
|
263
|
+
],
|
|
238
264
|
},
|
|
239
265
|
result: {
|
|
240
266
|
description: 'Машинный результат последней завершённой попытки поручения и состояние доставки',
|
|
@@ -592,6 +618,139 @@ export const cliCommands = {
|
|
|
592
618
|
],
|
|
593
619
|
refusals: ['NOT_FOUND', 'CONTROLLER_BUSY'],
|
|
594
620
|
},
|
|
621
|
+
'input-list': {
|
|
622
|
+
description: 'Вопросы исполнителей (H02): ID, поручение, вид, состояние, серьёзность и версия запроса — без текста',
|
|
623
|
+
writes: false,
|
|
624
|
+
idempotency: 'Только чтение',
|
|
625
|
+
args: [state, { ...work, required: false, description: 'Только вопросы этого поручения' }],
|
|
626
|
+
refusals: ['NOT_FOUND'],
|
|
627
|
+
},
|
|
628
|
+
'input-show': {
|
|
629
|
+
description: 'Запрос исполнителя целиком: вопрос, варианты, основание, ответы, цель применения',
|
|
630
|
+
writes: false,
|
|
631
|
+
idempotency: 'Только чтение',
|
|
632
|
+
args: [state, inputRequestArg],
|
|
633
|
+
refusals: ['NOT_FOUND'],
|
|
634
|
+
},
|
|
635
|
+
'input-answer': {
|
|
636
|
+
description: 'Записать ответ на вопрос исполнителя новой неизменяемой версией; работу ответ не возобновляет — дальше input-context, review-plan, input-target, input-apply',
|
|
637
|
+
writes: true,
|
|
638
|
+
idempotency: 'Тот же текст, вариант и вид — прежний ответ без записи; иначе новая версия при совпадении --request-version (CAS); закрытый запрос — NOT_READY',
|
|
639
|
+
args: [
|
|
640
|
+
state,
|
|
641
|
+
inputRequestArg,
|
|
642
|
+
{ name: '--text', value: 'text', required: true, description: 'Ответ (до 3000 знаков)' },
|
|
643
|
+
{ name: '--option', value: 'id', required: false, description: 'Выбранный вариант (ID)' },
|
|
644
|
+
{
|
|
645
|
+
name: '--kind',
|
|
646
|
+
value: 'text',
|
|
647
|
+
required: false,
|
|
648
|
+
description: 'clarification (по умолчанию: продолжение той же работы) или requirement-change (новая ревизия: input-supersede)',
|
|
649
|
+
},
|
|
650
|
+
{
|
|
651
|
+
name: '--actor',
|
|
652
|
+
value: 'text',
|
|
653
|
+
required: false,
|
|
654
|
+
description: 'Кто отвечает: operator (по умолчанию) или lead',
|
|
655
|
+
},
|
|
656
|
+
requestVersionArg,
|
|
657
|
+
],
|
|
658
|
+
refusals: ['NOT_FOUND', 'REVISION_CONFLICT', 'NOT_READY'],
|
|
659
|
+
},
|
|
660
|
+
'input-context': {
|
|
661
|
+
description: 'Снимок контекста с последним ответом: действующий снимок графа и источник input-answer (вопрос, ответ, manifest с точным digest и версией ответа); сохраняется по digest и пишется в --out, но не активируется',
|
|
662
|
+
writes: true,
|
|
663
|
+
idempotency: 'Тот же ответ и тот же действующий снимок — тот же digest и те же байты',
|
|
664
|
+
args: [
|
|
665
|
+
state,
|
|
666
|
+
inputRequestArg,
|
|
667
|
+
{
|
|
668
|
+
name: '--out',
|
|
669
|
+
value: 'path',
|
|
670
|
+
required: true,
|
|
671
|
+
description: 'Файл ContextSnapshot JSON для review-plan --context',
|
|
672
|
+
},
|
|
673
|
+
],
|
|
674
|
+
refusals: ['NOT_FOUND', 'INPUT_REQUIRED'],
|
|
675
|
+
},
|
|
676
|
+
'input-target': {
|
|
677
|
+
description: 'Основание продолжения для снимка с ответом (только чтение): digest, который назовёт input-apply, и причины, по которым применение сейчас откажет',
|
|
678
|
+
writes: false,
|
|
679
|
+
idempotency: 'Только чтение',
|
|
680
|
+
args: [state, inputRequestArg, contextDigestArg],
|
|
681
|
+
refusals: ['NOT_FOUND'],
|
|
682
|
+
},
|
|
683
|
+
'input-apply': {
|
|
684
|
+
description: 'Применить ответ одной транзакцией: проверки approve и retry, активация согласования снимка с ответом, запрос applied и обычный повтор поручения; модель не вызывается, пауза и удержания остаются',
|
|
685
|
+
writes: true,
|
|
686
|
+
idempotency: 'Повтор того же применения ничего не меняет и второй попытки не создаёт; идущие попытки графа, исчерпанные попытки или бюджет — applied:false, запрос и согласование не меняются (exit 3)',
|
|
687
|
+
args: [
|
|
688
|
+
state,
|
|
689
|
+
inputRequestArg,
|
|
690
|
+
{
|
|
691
|
+
name: '--answer',
|
|
692
|
+
value: 'digest',
|
|
693
|
+
required: true,
|
|
694
|
+
description: 'Digest последнего ответа (input-show)',
|
|
695
|
+
},
|
|
696
|
+
requestVersionArg,
|
|
697
|
+
contextDigestArg,
|
|
698
|
+
{
|
|
699
|
+
name: '--target',
|
|
700
|
+
value: 'digest',
|
|
701
|
+
required: true,
|
|
702
|
+
description: 'Digest основания из input-target',
|
|
703
|
+
},
|
|
704
|
+
{
|
|
705
|
+
name: '--reset',
|
|
706
|
+
value: 'flag',
|
|
707
|
+
required: false,
|
|
708
|
+
description: 'Сбросить исчерпанный счётчик попыток; требует --reason',
|
|
709
|
+
},
|
|
710
|
+
{ name: '--reason', value: 'text', required: false, description: 'Причина сброса' },
|
|
711
|
+
],
|
|
712
|
+
refusals: [
|
|
713
|
+
'NOT_FOUND',
|
|
714
|
+
'REVISION_CONFLICT',
|
|
715
|
+
'APPROVAL_STALE',
|
|
716
|
+
'APPROVAL_REQUIRED',
|
|
717
|
+
'REVIEW_REJECTED',
|
|
718
|
+
'INPUT_REQUIRED',
|
|
719
|
+
'NOT_READY',
|
|
720
|
+
'ATTEMPTS_EXHAUSTED',
|
|
721
|
+
'BUDGET_EXHAUSTED',
|
|
722
|
+
],
|
|
723
|
+
},
|
|
724
|
+
'input-cancel': {
|
|
725
|
+
description: 'Отменить вопрос: работа больше его не ждёт (обычный повтор снова по своим правилам); применённый ответ не отменяется',
|
|
726
|
+
writes: true,
|
|
727
|
+
idempotency: 'Повтор для отменённого ничего не меняет',
|
|
728
|
+
args: [
|
|
729
|
+
state,
|
|
730
|
+
inputRequestArg,
|
|
731
|
+
requestVersionArg,
|
|
732
|
+
{ name: '--reason', value: 'text', required: true, description: 'Причина' },
|
|
733
|
+
],
|
|
734
|
+
refusals: ['NOT_FOUND', 'REVISION_CONFLICT', 'NOT_READY'],
|
|
735
|
+
},
|
|
736
|
+
'input-supersede': {
|
|
737
|
+
description: 'Заменить вопрос преемником: ответ меняет требования — новая ревизия или работа, а не продолжение этой',
|
|
738
|
+
writes: true,
|
|
739
|
+
idempotency: 'Повтор для заменённого ничего не меняет',
|
|
740
|
+
args: [
|
|
741
|
+
state,
|
|
742
|
+
inputRequestArg,
|
|
743
|
+
requestVersionArg,
|
|
744
|
+
{ name: '--reason', value: 'text', required: true, description: 'Причина' },
|
|
745
|
+
{
|
|
746
|
+
name: '--successor',
|
|
747
|
+
value: 'id',
|
|
748
|
+
required: true,
|
|
749
|
+
description: 'Преемник: новая работа или запрос',
|
|
750
|
+
},
|
|
751
|
+
],
|
|
752
|
+
refusals: ['NOT_FOUND', 'REVISION_CONFLICT', 'NOT_READY'],
|
|
753
|
+
},
|
|
595
754
|
};
|
|
596
755
|
/* ------------------------------------------------------------------ */
|
|
597
756
|
/* Данные ответов */
|
|
@@ -701,6 +860,20 @@ export const statusDataSchema = z.strictObject({
|
|
|
701
860
|
*/
|
|
702
861
|
liveness: z.enum(['quiet', 'stalled']).optional(),
|
|
703
862
|
resultSha: gitShaSchema.optional(),
|
|
863
|
+
/**
|
|
864
|
+
* Последний незакрытый вопрос исполнителя (H02): ID, состояние, версия
|
|
865
|
+
* и действующая серьёзность, без текста. Нет поля — вопросов нет.
|
|
866
|
+
*/
|
|
867
|
+
input: z
|
|
868
|
+
.strictObject({
|
|
869
|
+
requestId: inputRequestSchema.shape.id,
|
|
870
|
+
state: z.enum(inputStateNames),
|
|
871
|
+
version: z.number().int().positive(),
|
|
872
|
+
severity: z.number().int().min(1).max(10),
|
|
873
|
+
})
|
|
874
|
+
.optional(),
|
|
875
|
+
/** Неблокирующие запросы ведущему в ожидании (автономный режим). */
|
|
876
|
+
followUps: z.number().int().positive().optional(),
|
|
704
877
|
/** Почему поручение сейчас не выдаётся; пусто — может быть выдано. */
|
|
705
878
|
blockers: z.array(blocker),
|
|
706
879
|
})),
|
|
@@ -1066,6 +1239,55 @@ export const initDataSchema = z.strictObject({
|
|
|
1066
1239
|
});
|
|
1067
1240
|
/** `explain`: объяснения остановок. */
|
|
1068
1241
|
export const explainDataSchema = z.strictObject({ diagnoses: z.array(stopDiagnosisSchema) });
|
|
1242
|
+
const requestIdSchema = inputRequestSchema.shape.id;
|
|
1243
|
+
export const inputListDataSchema = z.strictObject({
|
|
1244
|
+
requests: z.array(z.strictObject({
|
|
1245
|
+
id: requestIdSchema,
|
|
1246
|
+
workId: idSchema,
|
|
1247
|
+
kind: z.enum(['question', 'follow-up']),
|
|
1248
|
+
blocking: z.boolean(),
|
|
1249
|
+
lifecycle: z.enum(inputLifecycles),
|
|
1250
|
+
state: z.enum(inputStateNames).optional(),
|
|
1251
|
+
severity: z.number().int().min(1).max(10),
|
|
1252
|
+
version: z.number().int().positive(),
|
|
1253
|
+
answers: z.number().int().min(0),
|
|
1254
|
+
createdAt: isoTimeSchema,
|
|
1255
|
+
})),
|
|
1256
|
+
});
|
|
1257
|
+
export const inputAnswerDataSchema = z.strictObject({
|
|
1258
|
+
request: inputRequestSchema,
|
|
1259
|
+
answer: inputAnswerSchema,
|
|
1260
|
+
changed: z.boolean(),
|
|
1261
|
+
});
|
|
1262
|
+
export const inputContextDataSchema = z.strictObject({
|
|
1263
|
+
requestId: requestIdSchema,
|
|
1264
|
+
answerDigest: digestSchema,
|
|
1265
|
+
digest: digestSchema,
|
|
1266
|
+
out: z.string().min(1),
|
|
1267
|
+
});
|
|
1268
|
+
export const inputTargetDataSchema = z.strictObject({
|
|
1269
|
+
requestId: requestIdSchema,
|
|
1270
|
+
target: inputTargetSchema.optional(),
|
|
1271
|
+
problems: z.array(z.string()),
|
|
1272
|
+
});
|
|
1273
|
+
export const inputApplyDataSchema = z.strictObject({
|
|
1274
|
+
requestId: requestIdSchema,
|
|
1275
|
+
applied: z.boolean(),
|
|
1276
|
+
changed: z.boolean(),
|
|
1277
|
+
lifecycle: z.enum(inputLifecycles),
|
|
1278
|
+
work: z
|
|
1279
|
+
.strictObject({ id: idSchema, status: workStatusSchema, attempt: z.number().int().min(0) })
|
|
1280
|
+
.optional(),
|
|
1281
|
+
active: z.array(z.strictObject({ id: z.string().min(1), workId: idSchema })).optional(),
|
|
1282
|
+
joint: z.literal(true).optional(),
|
|
1283
|
+
blocker: blocker.optional(),
|
|
1284
|
+
});
|
|
1285
|
+
export const inputCloseDataSchema = z.strictObject({
|
|
1286
|
+
requestId: requestIdSchema,
|
|
1287
|
+
lifecycle: z.enum(inputLifecycles),
|
|
1288
|
+
version: z.number().int().positive(),
|
|
1289
|
+
changed: z.boolean(),
|
|
1290
|
+
});
|
|
1069
1291
|
/** Схема `data` каждой команды. */
|
|
1070
1292
|
export const cliDataSchemas = {
|
|
1071
1293
|
validate: validateDataSchema,
|
|
@@ -1097,6 +1319,14 @@ export const cliDataSchemas = {
|
|
|
1097
1319
|
'source-status': sourceStatusDataSchema,
|
|
1098
1320
|
'source-deliver': sourceDeliverDataSchema,
|
|
1099
1321
|
'source-reconcile': sourceReconcileDataSchema,
|
|
1322
|
+
'input-list': inputListDataSchema,
|
|
1323
|
+
'input-show': inputRequestSchema,
|
|
1324
|
+
'input-answer': inputAnswerDataSchema,
|
|
1325
|
+
'input-context': inputContextDataSchema,
|
|
1326
|
+
'input-target': inputTargetDataSchema,
|
|
1327
|
+
'input-apply': inputApplyDataSchema,
|
|
1328
|
+
'input-cancel': inputCloseDataSchema,
|
|
1329
|
+
'input-supersede': inputCloseDataSchema,
|
|
1100
1330
|
version: versionDataSchema,
|
|
1101
1331
|
};
|
|
1102
1332
|
export const cliErrorSchema = z.strictObject({
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
2
|
export declare const diagnosisActors: readonly ["controller", "lead", "user"];
|
|
3
|
-
export declare const diagnosisActions: readonly ["none", "wait", "review-plan", "retry", "diagnose-failure", "reset-attempts", "raise-budget", "replan-dependents", "recovery-decision", "user-decision", "resume-queue", "fix-environment", "fix-access"];
|
|
4
|
-
export declare const diagnosisCauses: readonly ["provider-auth", "environment", "timeout", "stalled", "context-exhausted", "stale-base", "empty-result", "unfinished", "scope-violation", "gate", "review", "review-protocol", "merge", "cancelled", "budget", "needs-lead", "unknown", "runtime-missing", "controller-busy", "operator-pause", "approval-required", "not-ready"];
|
|
3
|
+
export declare const diagnosisActions: readonly ["none", "wait", "review-plan", "retry", "diagnose-failure", "reset-attempts", "raise-budget", "replan-dependents", "recovery-decision", "user-decision", "resume-queue", "fix-environment", "fix-access", "answer-input", "apply-input"];
|
|
4
|
+
export declare const diagnosisCauses: readonly ["provider-auth", "environment", "timeout", "stalled", "context-exhausted", "stale-base", "empty-result", "unfinished", "scope-violation", "gate", "review", "review-protocol", "merge", "cancelled", "budget", "needs-lead", "needs-input", "unknown", "runtime-missing", "controller-busy", "operator-pause", "approval-required", "not-ready"];
|
|
5
5
|
export declare const diagnosisPhases: readonly ["preflight", "claim", "implementation", "gates", "review", "integration", "delivery"];
|
|
6
6
|
/** Объяснение остановки: код, причина, фаза, кто действует и что допустимо. */
|
|
7
7
|
export declare const stopDiagnosisSchema: z.ZodObject<{
|
|
@@ -30,6 +30,7 @@ export declare const stopDiagnosisSchema: z.ZodObject<{
|
|
|
30
30
|
BUDGET_UNKNOWN: "BUDGET_UNKNOWN";
|
|
31
31
|
ATTEMPTS_EXHAUSTED: "ATTEMPTS_EXHAUSTED";
|
|
32
32
|
CONTEXT_EXHAUSTED: "CONTEXT_EXHAUSTED";
|
|
33
|
+
INPUT_REQUIRED: "INPUT_REQUIRED";
|
|
33
34
|
REVISION_CONFLICT: "REVISION_CONFLICT";
|
|
34
35
|
CANCELLED: "CANCELLED";
|
|
35
36
|
NOT_FOUND: "NOT_FOUND";
|
|
@@ -61,6 +62,7 @@ export declare const stopDiagnosisSchema: z.ZodObject<{
|
|
|
61
62
|
merge: "merge";
|
|
62
63
|
budget: "budget";
|
|
63
64
|
"needs-lead": "needs-lead";
|
|
65
|
+
"needs-input": "needs-input";
|
|
64
66
|
"runtime-missing": "runtime-missing";
|
|
65
67
|
"controller-busy": "controller-busy";
|
|
66
68
|
"operator-pause": "operator-pause";
|
|
@@ -69,16 +71,16 @@ export declare const stopDiagnosisSchema: z.ZodObject<{
|
|
|
69
71
|
}>;
|
|
70
72
|
phase: z.ZodEnum<{
|
|
71
73
|
gates: "gates";
|
|
72
|
-
preflight: "preflight";
|
|
73
74
|
review: "review";
|
|
75
|
+
preflight: "preflight";
|
|
74
76
|
integration: "integration";
|
|
75
77
|
delivery: "delivery";
|
|
76
78
|
claim: "claim";
|
|
77
79
|
implementation: "implementation";
|
|
78
80
|
}>;
|
|
79
81
|
actor: z.ZodNullable<z.ZodEnum<{
|
|
80
|
-
controller: "controller";
|
|
81
82
|
lead: "lead";
|
|
83
|
+
controller: "controller";
|
|
82
84
|
user: "user";
|
|
83
85
|
}>>;
|
|
84
86
|
action: z.ZodEnum<{
|
|
@@ -95,6 +97,8 @@ export declare const stopDiagnosisSchema: z.ZodObject<{
|
|
|
95
97
|
"resume-queue": "resume-queue";
|
|
96
98
|
"fix-environment": "fix-environment";
|
|
97
99
|
"fix-access": "fix-access";
|
|
100
|
+
"answer-input": "answer-input";
|
|
101
|
+
"apply-input": "apply-input";
|
|
98
102
|
}>;
|
|
99
103
|
retryPlanned: z.ZodBoolean;
|
|
100
104
|
message: z.ZodString;
|
|
@@ -17,6 +17,8 @@ export const diagnosisActions = [
|
|
|
17
17
|
'resume-queue',
|
|
18
18
|
'fix-environment',
|
|
19
19
|
'fix-access',
|
|
20
|
+
'answer-input',
|
|
21
|
+
'apply-input',
|
|
20
22
|
];
|
|
21
23
|
export const diagnosisCauses = [
|
|
22
24
|
'provider-auth',
|
|
@@ -35,6 +37,7 @@ export const diagnosisCauses = [
|
|
|
35
37
|
'cancelled',
|
|
36
38
|
'budget',
|
|
37
39
|
'needs-lead',
|
|
40
|
+
'needs-input',
|
|
38
41
|
'unknown',
|
|
39
42
|
'runtime-missing',
|
|
40
43
|
'controller-busy',
|
|
@@ -39,6 +39,12 @@ export declare const errorCodes: {
|
|
|
39
39
|
readonly ATTEMPTS_EXHAUSTED: "refused";
|
|
40
40
|
/** Задача или её контекст не помещаются в окно контекста модели (`context-exhausted`). */
|
|
41
41
|
readonly CONTEXT_EXHAUSTED: "refused";
|
|
42
|
+
/**
|
|
43
|
+
* Работу держит вопрос исполнителя без применённого ответа (`needs-input`):
|
|
44
|
+
* claim, retry, repair и finish отклоняются до `applyInput`; контекст с
|
|
45
|
+
* неприменённым ответом не активируется обходным согласованием.
|
|
46
|
+
*/
|
|
47
|
+
readonly INPUT_REQUIRED: "refused";
|
|
42
48
|
readonly REVISION_CONFLICT: "refused";
|
|
43
49
|
readonly CANCELLED: "refused";
|
|
44
50
|
readonly NOT_FOUND: "refused";
|
|
@@ -69,7 +75,7 @@ export declare class HarnessError extends Error {
|
|
|
69
75
|
readonly class: ErrorClass;
|
|
70
76
|
constructor(code: ErrorCode, message: string, issues?: ErrorIssue[]);
|
|
71
77
|
toJSON(): {
|
|
72
|
-
code: "INVALID_INPUT" | "UNSUPPORTED_COMMAND" | "UNSUPPORTED_VERSION" | "GRAPH_CYCLE" | "GRAPH_UNKNOWN_DEPENDENCY" | "GRAPH_DUPLICATE_ID" | "GATE_UNKNOWN" | "GATE_GROUP_CYCLE" | "REVIEWER_SAME_VENDOR" | "REVIEWER_MISSING" | "RESPONSE_TOO_LARGE" | "APPROVAL_STALE" | "APPROVAL_REQUIRED" | "LEASE_STALE" | "CONTROLLER_BUSY" | "PAUSED" | "NOT_READY" | "SCOPE_VIOLATION" | "GATE_FAILED" | "REVIEW_REJECTED" | "BUDGET_EXHAUSTED" | "BUDGET_UNKNOWN" | "ATTEMPTS_EXHAUSTED" | "CONTEXT_EXHAUSTED" | "REVISION_CONFLICT" | "CANCELLED" | "NOT_FOUND" | "PATH_CONFLICT" | "STATE_VERSION_UNSUPPORTED" | "RUNTIME_UNAVAILABLE" | "REVIEW_PROTOCOL_INVALID" | "SANDBOX_UNAVAILABLE" | "GIT_FAILED" | "STORAGE_FAILED" | "DELIVERY_FAILED" | "INTERNAL";
|
|
78
|
+
code: "INVALID_INPUT" | "UNSUPPORTED_COMMAND" | "UNSUPPORTED_VERSION" | "GRAPH_CYCLE" | "GRAPH_UNKNOWN_DEPENDENCY" | "GRAPH_DUPLICATE_ID" | "GATE_UNKNOWN" | "GATE_GROUP_CYCLE" | "REVIEWER_SAME_VENDOR" | "REVIEWER_MISSING" | "RESPONSE_TOO_LARGE" | "APPROVAL_STALE" | "APPROVAL_REQUIRED" | "LEASE_STALE" | "CONTROLLER_BUSY" | "PAUSED" | "NOT_READY" | "SCOPE_VIOLATION" | "GATE_FAILED" | "REVIEW_REJECTED" | "BUDGET_EXHAUSTED" | "BUDGET_UNKNOWN" | "ATTEMPTS_EXHAUSTED" | "CONTEXT_EXHAUSTED" | "INPUT_REQUIRED" | "REVISION_CONFLICT" | "CANCELLED" | "NOT_FOUND" | "PATH_CONFLICT" | "STATE_VERSION_UNSUPPORTED" | "RUNTIME_UNAVAILABLE" | "REVIEW_PROTOCOL_INVALID" | "SANDBOX_UNAVAILABLE" | "GIT_FAILED" | "STORAGE_FAILED" | "DELIVERY_FAILED" | "INTERNAL";
|
|
73
79
|
class: "input" | "refused" | "infrastructure";
|
|
74
80
|
message: string;
|
|
75
81
|
issues: ErrorIssue[];
|
package/lib/contracts/errors.js
CHANGED
|
@@ -38,6 +38,12 @@ export const errorCodes = {
|
|
|
38
38
|
ATTEMPTS_EXHAUSTED: 'refused',
|
|
39
39
|
/** Задача или её контекст не помещаются в окно контекста модели (`context-exhausted`). */
|
|
40
40
|
CONTEXT_EXHAUSTED: 'refused',
|
|
41
|
+
/**
|
|
42
|
+
* Работу держит вопрос исполнителя без применённого ответа (`needs-input`):
|
|
43
|
+
* claim, retry, repair и finish отклоняются до `applyInput`; контекст с
|
|
44
|
+
* неприменённым ответом не активируется обходным согласованием.
|
|
45
|
+
*/
|
|
46
|
+
INPUT_REQUIRED: 'refused',
|
|
41
47
|
REVISION_CONFLICT: 'refused',
|
|
42
48
|
CANCELLED: 'refused',
|
|
43
49
|
NOT_FOUND: 'refused',
|