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.
- package/README.md +16 -2
- package/docs/architecture.md +59 -0
- package/docs/compatibility.md +25 -11
- package/docs/connectors.md +72 -3
- package/docs/contracts.md +60 -24
- package/docs/release-notes/0.1.0-alpha.26.md +35 -0
- package/docs/release-notes/0.1.0-alpha.27.md +36 -0
- package/docs/review-protocol.md +16 -2
- package/docs/toolchains.md +83 -0
- package/docs/upgrade.md +10 -0
- 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 +22 -5
- package/lib/contracts/cli.d.ts +184 -1
- package/lib/contracts/cli.js +102 -2
- package/lib/contracts/failure.js +1 -1
- package/lib/contracts/policy.d.ts +30 -0
- package/lib/contracts/policy.js +23 -0
- package/lib/contracts/published.d.ts +8 -0
- package/lib/contracts/review.d.ts +69 -0
- package/lib/contracts/review.js +29 -14
- package/lib/contracts/work.d.ts +6 -0
- package/lib/contracts/work.js +13 -12
- package/lib/control/harness.d.ts +12 -0
- package/lib/control/harness.js +4 -0
- package/lib/control/review.js +14 -2
- package/lib/engine/joint-runner.js +34 -1
- package/lib/engine/runner.d.ts +29 -0
- package/lib/engine/runner.js +207 -5
- package/lib/engine/worktree-cleanup.d.ts +131 -0
- package/lib/engine/worktree-cleanup.js +520 -0
- package/lib/environment/bounded-read.d.ts +12 -0
- package/lib/environment/bounded-read.js +40 -0
- package/lib/environment/isolation.d.ts +1 -0
- package/lib/environment/isolation.js +2 -1
- package/lib/environment/os-tools.d.ts +4 -2
- package/lib/environment/os-tools.js +4 -2
- package/lib/environment/process.d.ts +5 -0
- package/lib/environment/process.js +40 -17
- package/lib/environment/resources.d.ts +9 -0
- package/lib/environment/resources.js +24 -0
- package/lib/index.d.ts +1 -0
- package/lib/index.js +1 -0
- package/lib/integrations/connector/commands.d.ts +37 -8
- package/lib/integrations/connector/commands.js +61 -8
- 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/store.d.ts +1 -1
- package/lib/integrations/connector/store.js +11 -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/profiles/resolve.d.ts +6 -0
- package/lib/toolchains/inspect.d.ts +1 -1
- package/lib/toolchains/inspect.js +29 -1
- package/lib/toolchains/probe.d.ts +16 -0
- package/lib/toolchains/probe.js +20 -0
- package/lib/verification/confirm.d.ts +3 -1
- package/lib/verification/confirm.js +26 -4
- package/lib/verification/dependencies.d.ts +3 -0
- package/lib/verification/dependencies.js +11 -0
- package/lib/verification/dependency-store.d.ts +117 -0
- package/lib/verification/dependency-store.js +811 -0
- package/lib/verification/gates-at.js +18 -0
- package/lib/verification/gates.js +24 -7
- package/package.json +2 -2
- package/schemas/execution-policy.schema.json +34 -0
package/lib/contracts/cli.d.ts
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
2
|
import { API_VERSION } from './version.ts';
|
|
3
|
-
import { type ErrorCode } from './errors.ts';
|
|
3
|
+
import { HarnessError, type ErrorCode } from './errors.ts';
|
|
4
4
|
/**
|
|
5
5
|
* Договор CLI `harness`.
|
|
6
6
|
*
|
|
@@ -210,6 +210,18 @@ export declare const cliCommands: {
|
|
|
210
210
|
}];
|
|
211
211
|
readonly refusals: ["NOT_FOUND", "REVISION_CONFLICT"];
|
|
212
212
|
};
|
|
213
|
+
readonly 'worktree-cleanup': {
|
|
214
|
+
readonly description: "Убрать рабочие деревья закончившихся попыток: ветки и достижимые коммиты остаются, неподтверждённые правки сохраняются проверенным патчем в артефактах попытки, игнорируемые файлы не сохраняются и перечисляются в ответе; индекс, который патч не сохранит, — отказ; в сомнении дерево остаётся, а отказ назван; модель не вызывается";
|
|
215
|
+
readonly writes: true;
|
|
216
|
+
readonly idempotency: "Повтор не находит уже убранных деревьев и ничего не меняет";
|
|
217
|
+
readonly args: [CliArgument, {
|
|
218
|
+
readonly name: "--dry-run";
|
|
219
|
+
readonly value: "flag";
|
|
220
|
+
readonly required: false;
|
|
221
|
+
readonly description: "Только показать, что было бы убрано, что исчезнет (игнорируемое) и почему отказано; ничего не пишет";
|
|
222
|
+
}];
|
|
223
|
+
readonly refusals: ["NOT_FOUND", "NOT_READY"];
|
|
224
|
+
};
|
|
213
225
|
readonly cleanup: {
|
|
214
226
|
readonly description: "Довести незавершённую очистку закончившейся попытки: повторить teardown по сохранённым receipt окружений и убрать её рабочие деревья; модели, gates и Git-приёмка не вызываются";
|
|
215
227
|
readonly writes: true;
|
|
@@ -1165,6 +1177,11 @@ export declare const runDataSchema: z.ZodObject<{
|
|
|
1165
1177
|
graphId: z.ZodString;
|
|
1166
1178
|
digest: z.ZodString;
|
|
1167
1179
|
resumed: z.ZodBoolean;
|
|
1180
|
+
baseline: z.ZodOptional<z.ZodObject<{
|
|
1181
|
+
sha: z.ZodString;
|
|
1182
|
+
reason: z.ZodString;
|
|
1183
|
+
tasks: z.ZodArray<z.ZodString>;
|
|
1184
|
+
}, z.core.$strict>>;
|
|
1168
1185
|
works: z.ZodArray<z.ZodObject<{
|
|
1169
1186
|
id: z.ZodString;
|
|
1170
1187
|
status: z.ZodEnum<{
|
|
@@ -1597,16 +1614,37 @@ export declare const sourceCheckDataSchema: z.ZodObject<{
|
|
|
1597
1614
|
}, z.core.$strict>;
|
|
1598
1615
|
problems: z.ZodArray<z.ZodString>;
|
|
1599
1616
|
}, z.core.$strict>;
|
|
1617
|
+
/** Закреплённый локальный пакет `tasks[].context`: то, что называет manifest снимка. */
|
|
1618
|
+
export declare const localContextManifestSchema: z.ZodObject<{
|
|
1619
|
+
id: z.ZodString;
|
|
1620
|
+
digest: z.ZodString;
|
|
1621
|
+
files: z.ZodNumber;
|
|
1622
|
+
references: z.ZodNumber;
|
|
1623
|
+
bytes: z.ZodNumber;
|
|
1624
|
+
}, z.core.$strict>;
|
|
1625
|
+
export type LocalContextManifest = z.infer<typeof localContextManifestSchema>;
|
|
1600
1626
|
export declare const sourceSnapshotDataSchema: z.ZodObject<{
|
|
1601
1627
|
connector: z.ZodString;
|
|
1602
1628
|
graphId: z.ZodString;
|
|
1603
1629
|
graphDigest: z.ZodString;
|
|
1604
1630
|
contextDigest: z.ZodString;
|
|
1631
|
+
localContext: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
1632
|
+
id: z.ZodString;
|
|
1633
|
+
digest: z.ZodString;
|
|
1634
|
+
files: z.ZodNumber;
|
|
1635
|
+
references: z.ZodNumber;
|
|
1636
|
+
bytes: z.ZodNumber;
|
|
1637
|
+
}, z.core.$strict>>>;
|
|
1605
1638
|
revision: z.ZodString;
|
|
1606
1639
|
created: z.ZodBoolean;
|
|
1607
1640
|
eligible: z.ZodBoolean;
|
|
1608
1641
|
problems: z.ZodArray<z.ZodString>;
|
|
1609
1642
|
truncated: z.ZodArray<z.ZodString>;
|
|
1643
|
+
baseline: z.ZodOptional<z.ZodObject<{
|
|
1644
|
+
sha: z.ZodString;
|
|
1645
|
+
reason: z.ZodString;
|
|
1646
|
+
tasks: z.ZodArray<z.ZodString>;
|
|
1647
|
+
}, z.core.$strict>>;
|
|
1610
1648
|
tasks: z.ZodArray<z.ZodObject<{
|
|
1611
1649
|
identity: z.ZodString;
|
|
1612
1650
|
key: z.ZodString;
|
|
@@ -1631,6 +1669,11 @@ export declare const sourceStatusDataSchema: z.ZodObject<{
|
|
|
1631
1669
|
snapshot: z.ZodOptional<z.ZodObject<{
|
|
1632
1670
|
revision: z.ZodString;
|
|
1633
1671
|
graphId: z.ZodString;
|
|
1672
|
+
baseline: z.ZodOptional<z.ZodObject<{
|
|
1673
|
+
sha: z.ZodString;
|
|
1674
|
+
reason: z.ZodString;
|
|
1675
|
+
tasks: z.ZodArray<z.ZodString>;
|
|
1676
|
+
}, z.core.$strict>>;
|
|
1634
1677
|
}, z.core.$strict>>;
|
|
1635
1678
|
ownership: z.ZodObject<{
|
|
1636
1679
|
stateDir: z.ZodString;
|
|
@@ -1753,6 +1796,62 @@ export declare const cleanupDataSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
|
1753
1796
|
status: z.ZodLiteral<"cleaned">;
|
|
1754
1797
|
receipts: z.ZodArray<z.ZodString>;
|
|
1755
1798
|
}, z.core.$strict>], "status">;
|
|
1799
|
+
export declare const worktreeCleanupDataSchema: z.ZodObject<{
|
|
1800
|
+
dryRun: z.ZodBoolean;
|
|
1801
|
+
removed: z.ZodNumber;
|
|
1802
|
+
removable: z.ZodNumber;
|
|
1803
|
+
refused: z.ZodNumber;
|
|
1804
|
+
failed: z.ZodNumber;
|
|
1805
|
+
reclaimedKb: z.ZodNumber;
|
|
1806
|
+
worktrees: z.ZodArray<z.ZodObject<{
|
|
1807
|
+
path: z.ZodString;
|
|
1808
|
+
repositoryId: z.ZodString;
|
|
1809
|
+
attemptId: z.ZodOptional<z.ZodString>;
|
|
1810
|
+
action: z.ZodEnum<{
|
|
1811
|
+
refused: "refused";
|
|
1812
|
+
failed: "failed";
|
|
1813
|
+
removed: "removed";
|
|
1814
|
+
remove: "remove";
|
|
1815
|
+
}>;
|
|
1816
|
+
reason: z.ZodOptional<z.ZodEnum<{
|
|
1817
|
+
active: "active";
|
|
1818
|
+
recoverable: "recoverable";
|
|
1819
|
+
"cleanup-pending": "cleanup-pending";
|
|
1820
|
+
"cleanup-unreadable": "cleanup-unreadable";
|
|
1821
|
+
"unknown-attempt": "unknown-attempt";
|
|
1822
|
+
untrusted: "untrusted";
|
|
1823
|
+
"embedded-repository": "embedded-repository";
|
|
1824
|
+
"scan-limit": "scan-limit";
|
|
1825
|
+
"scan-failed": "scan-failed";
|
|
1826
|
+
"read-only-path": "read-only-path";
|
|
1827
|
+
"undecodable-path": "undecodable-path";
|
|
1828
|
+
"worktree-locked": "worktree-locked";
|
|
1829
|
+
"clean-filter": "clean-filter";
|
|
1830
|
+
"tree-changed": "tree-changed";
|
|
1831
|
+
"ignore-rules-changed": "ignore-rules-changed";
|
|
1832
|
+
"hidden-changes": "hidden-changes";
|
|
1833
|
+
"staged-ignored": "staged-ignored";
|
|
1834
|
+
"staged-differs": "staged-differs";
|
|
1835
|
+
"unreachable-head": "unreachable-head";
|
|
1836
|
+
"patch-unusable": "patch-unusable";
|
|
1837
|
+
"removal-incomplete": "removal-incomplete";
|
|
1838
|
+
"not-registered": "not-registered";
|
|
1839
|
+
}>>;
|
|
1840
|
+
error: z.ZodOptional<z.ZodString>;
|
|
1841
|
+
head: z.ZodOptional<z.ZodString>;
|
|
1842
|
+
sizeKb: z.ZodOptional<z.ZodNumber>;
|
|
1843
|
+
uncommitted: z.ZodOptional<z.ZodNumber>;
|
|
1844
|
+
ignored: z.ZodOptional<z.ZodObject<{
|
|
1845
|
+
count: z.ZodNumber;
|
|
1846
|
+
paths: z.ZodArray<z.ZodString>;
|
|
1847
|
+
}, z.core.$strict>>;
|
|
1848
|
+
record: z.ZodOptional<z.ZodString>;
|
|
1849
|
+
removalStarted: z.ZodOptional<z.ZodBoolean>;
|
|
1850
|
+
registered: z.ZodOptional<z.ZodBoolean>;
|
|
1851
|
+
treePresent: z.ZodOptional<z.ZodBoolean>;
|
|
1852
|
+
patch: z.ZodOptional<z.ZodString>;
|
|
1853
|
+
}, z.core.$strict>>;
|
|
1854
|
+
}, z.core.$strict>;
|
|
1756
1855
|
/** `init`: план или результат подготовки проекта. */
|
|
1757
1856
|
export declare const initDataSchema: z.ZodObject<{
|
|
1758
1857
|
mode: z.ZodEnum<{
|
|
@@ -2089,6 +2188,11 @@ export declare const cliDataSchemas: {
|
|
|
2089
2188
|
graphId: z.ZodString;
|
|
2090
2189
|
digest: z.ZodString;
|
|
2091
2190
|
resumed: z.ZodBoolean;
|
|
2191
|
+
baseline: z.ZodOptional<z.ZodObject<{
|
|
2192
|
+
sha: z.ZodString;
|
|
2193
|
+
reason: z.ZodString;
|
|
2194
|
+
tasks: z.ZodArray<z.ZodString>;
|
|
2195
|
+
}, z.core.$strict>>;
|
|
2092
2196
|
works: z.ZodArray<z.ZodObject<{
|
|
2093
2197
|
id: z.ZodString;
|
|
2094
2198
|
status: z.ZodEnum<{
|
|
@@ -3852,6 +3956,62 @@ export declare const cliDataSchemas: {
|
|
|
3852
3956
|
status: z.ZodLiteral<"cleaned">;
|
|
3853
3957
|
receipts: z.ZodArray<z.ZodString>;
|
|
3854
3958
|
}, z.core.$strict>], "status">;
|
|
3959
|
+
readonly 'worktree-cleanup': z.ZodObject<{
|
|
3960
|
+
dryRun: z.ZodBoolean;
|
|
3961
|
+
removed: z.ZodNumber;
|
|
3962
|
+
removable: z.ZodNumber;
|
|
3963
|
+
refused: z.ZodNumber;
|
|
3964
|
+
failed: z.ZodNumber;
|
|
3965
|
+
reclaimedKb: z.ZodNumber;
|
|
3966
|
+
worktrees: z.ZodArray<z.ZodObject<{
|
|
3967
|
+
path: z.ZodString;
|
|
3968
|
+
repositoryId: z.ZodString;
|
|
3969
|
+
attemptId: z.ZodOptional<z.ZodString>;
|
|
3970
|
+
action: z.ZodEnum<{
|
|
3971
|
+
refused: "refused";
|
|
3972
|
+
failed: "failed";
|
|
3973
|
+
removed: "removed";
|
|
3974
|
+
remove: "remove";
|
|
3975
|
+
}>;
|
|
3976
|
+
reason: z.ZodOptional<z.ZodEnum<{
|
|
3977
|
+
active: "active";
|
|
3978
|
+
recoverable: "recoverable";
|
|
3979
|
+
"cleanup-pending": "cleanup-pending";
|
|
3980
|
+
"cleanup-unreadable": "cleanup-unreadable";
|
|
3981
|
+
"unknown-attempt": "unknown-attempt";
|
|
3982
|
+
untrusted: "untrusted";
|
|
3983
|
+
"embedded-repository": "embedded-repository";
|
|
3984
|
+
"scan-limit": "scan-limit";
|
|
3985
|
+
"scan-failed": "scan-failed";
|
|
3986
|
+
"read-only-path": "read-only-path";
|
|
3987
|
+
"undecodable-path": "undecodable-path";
|
|
3988
|
+
"worktree-locked": "worktree-locked";
|
|
3989
|
+
"clean-filter": "clean-filter";
|
|
3990
|
+
"tree-changed": "tree-changed";
|
|
3991
|
+
"ignore-rules-changed": "ignore-rules-changed";
|
|
3992
|
+
"hidden-changes": "hidden-changes";
|
|
3993
|
+
"staged-ignored": "staged-ignored";
|
|
3994
|
+
"staged-differs": "staged-differs";
|
|
3995
|
+
"unreachable-head": "unreachable-head";
|
|
3996
|
+
"patch-unusable": "patch-unusable";
|
|
3997
|
+
"removal-incomplete": "removal-incomplete";
|
|
3998
|
+
"not-registered": "not-registered";
|
|
3999
|
+
}>>;
|
|
4000
|
+
error: z.ZodOptional<z.ZodString>;
|
|
4001
|
+
head: z.ZodOptional<z.ZodString>;
|
|
4002
|
+
sizeKb: z.ZodOptional<z.ZodNumber>;
|
|
4003
|
+
uncommitted: z.ZodOptional<z.ZodNumber>;
|
|
4004
|
+
ignored: z.ZodOptional<z.ZodObject<{
|
|
4005
|
+
count: z.ZodNumber;
|
|
4006
|
+
paths: z.ZodArray<z.ZodString>;
|
|
4007
|
+
}, z.core.$strict>>;
|
|
4008
|
+
record: z.ZodOptional<z.ZodString>;
|
|
4009
|
+
removalStarted: z.ZodOptional<z.ZodBoolean>;
|
|
4010
|
+
registered: z.ZodOptional<z.ZodBoolean>;
|
|
4011
|
+
treePresent: z.ZodOptional<z.ZodBoolean>;
|
|
4012
|
+
patch: z.ZodOptional<z.ZodString>;
|
|
4013
|
+
}, z.core.$strict>>;
|
|
4014
|
+
}, z.core.$strict>;
|
|
3855
4015
|
readonly profile: z.ZodObject<{
|
|
3856
4016
|
pin: z.ZodObject<{
|
|
3857
4017
|
id: z.ZodString;
|
|
@@ -4529,11 +4689,23 @@ export declare const cliDataSchemas: {
|
|
|
4529
4689
|
graphId: z.ZodString;
|
|
4530
4690
|
graphDigest: z.ZodString;
|
|
4531
4691
|
contextDigest: z.ZodString;
|
|
4692
|
+
localContext: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
4693
|
+
id: z.ZodString;
|
|
4694
|
+
digest: z.ZodString;
|
|
4695
|
+
files: z.ZodNumber;
|
|
4696
|
+
references: z.ZodNumber;
|
|
4697
|
+
bytes: z.ZodNumber;
|
|
4698
|
+
}, z.core.$strict>>>;
|
|
4532
4699
|
revision: z.ZodString;
|
|
4533
4700
|
created: z.ZodBoolean;
|
|
4534
4701
|
eligible: z.ZodBoolean;
|
|
4535
4702
|
problems: z.ZodArray<z.ZodString>;
|
|
4536
4703
|
truncated: z.ZodArray<z.ZodString>;
|
|
4704
|
+
baseline: z.ZodOptional<z.ZodObject<{
|
|
4705
|
+
sha: z.ZodString;
|
|
4706
|
+
reason: z.ZodString;
|
|
4707
|
+
tasks: z.ZodArray<z.ZodString>;
|
|
4708
|
+
}, z.core.$strict>>;
|
|
4537
4709
|
tasks: z.ZodArray<z.ZodObject<{
|
|
4538
4710
|
identity: z.ZodString;
|
|
4539
4711
|
key: z.ZodString;
|
|
@@ -4558,6 +4730,11 @@ export declare const cliDataSchemas: {
|
|
|
4558
4730
|
snapshot: z.ZodOptional<z.ZodObject<{
|
|
4559
4731
|
revision: z.ZodString;
|
|
4560
4732
|
graphId: z.ZodString;
|
|
4733
|
+
baseline: z.ZodOptional<z.ZodObject<{
|
|
4734
|
+
sha: z.ZodString;
|
|
4735
|
+
reason: z.ZodString;
|
|
4736
|
+
tasks: z.ZodArray<z.ZodString>;
|
|
4737
|
+
}, z.core.$strict>>;
|
|
4561
4738
|
}, z.core.$strict>>;
|
|
4562
4739
|
ownership: z.ZodObject<{
|
|
4563
4740
|
stateDir: z.ZodString;
|
|
@@ -4728,6 +4905,12 @@ export declare const cliErrorSchema: z.ZodObject<{
|
|
|
4728
4905
|
message: z.ZodString;
|
|
4729
4906
|
}, z.core.$strict>>;
|
|
4730
4907
|
}, z.core.$strict>;
|
|
4908
|
+
/**
|
|
4909
|
+
* Нарушение схемы внутри harness (ответ команды вне договора, собственная
|
|
4910
|
+
* запись) — дефект, а не ошибка ввода: INTERNAL с путями полей вместо дампа
|
|
4911
|
+
* ZodError в сообщении.
|
|
4912
|
+
*/
|
|
4913
|
+
export declare const contractViolation: (error: z.ZodError) => HarnessError;
|
|
4731
4914
|
export type CliEnvelope<C extends CliCommand | 'version' = CliCommand | 'version'> = {
|
|
4732
4915
|
apiVersion: typeof API_VERSION;
|
|
4733
4916
|
command: C;
|
package/lib/contracts/cli.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
2
|
import { API_VERSION, STATE_VERSION } from "./version.js";
|
|
3
3
|
import { digestSchema, gitShaSchema, idSchema, isoTimeSchema, runtimeNameSchema, targetRefSchema, } from "./primitives.js";
|
|
4
|
-
import { errorCodes } from "./errors.js";
|
|
4
|
+
import { HarnessError, errorCodes } from "./errors.js";
|
|
5
5
|
import { controlStateSchema, controllerLeaseSchema, workStatusSchema } from "./execution.js";
|
|
6
6
|
import { runEventSchema } from "./events.js";
|
|
7
7
|
import { deliveryStateSchema, resultEnvelopeSchema } from "./result.js";
|
|
@@ -250,6 +250,21 @@ export const cliCommands = {
|
|
|
250
250
|
],
|
|
251
251
|
refusals: ['NOT_FOUND', 'REVISION_CONFLICT'],
|
|
252
252
|
},
|
|
253
|
+
'worktree-cleanup': {
|
|
254
|
+
description: 'Убрать рабочие деревья закончившихся попыток: ветки и достижимые коммиты остаются, неподтверждённые правки сохраняются проверенным патчем в артефактах попытки, игнорируемые файлы не сохраняются и перечисляются в ответе; индекс, который патч не сохранит, — отказ; в сомнении дерево остаётся, а отказ назван; модель не вызывается',
|
|
255
|
+
writes: true,
|
|
256
|
+
idempotency: 'Повтор не находит уже убранных деревьев и ничего не меняет',
|
|
257
|
+
args: [
|
|
258
|
+
state,
|
|
259
|
+
{
|
|
260
|
+
name: '--dry-run',
|
|
261
|
+
value: 'flag',
|
|
262
|
+
required: false,
|
|
263
|
+
description: 'Только показать, что было бы убрано, что исчезнет (игнорируемое) и почему отказано; ничего не пишет',
|
|
264
|
+
},
|
|
265
|
+
],
|
|
266
|
+
refusals: ['NOT_FOUND', 'NOT_READY'],
|
|
267
|
+
},
|
|
253
268
|
cleanup: {
|
|
254
269
|
description: 'Довести незавершённую очистку закончившейся попытки: повторить teardown по сохранённым receipt окружений и убрать её рабочие деревья; модели, gates и Git-приёмка не вызываются',
|
|
255
270
|
writes: true,
|
|
@@ -573,11 +588,18 @@ export const eventsDataSchema = z.strictObject({
|
|
|
573
588
|
/** Номер для следующего `--after`. */
|
|
574
589
|
next: z.number().int().min(0),
|
|
575
590
|
});
|
|
591
|
+
/** Зависимости, принятые человеком по базовой линии: решение, а не доказательство. */
|
|
592
|
+
const baselineViewSchema = z.strictObject({
|
|
593
|
+
sha: gitShaSchema,
|
|
594
|
+
reason: z.string(),
|
|
595
|
+
tasks: z.array(z.string()),
|
|
596
|
+
});
|
|
576
597
|
export const runDataSchema = z.strictObject({
|
|
577
598
|
graphId: idSchema,
|
|
578
599
|
digest: digestSchema,
|
|
579
600
|
/** Граф уже был зарегистрирован этой редакцией: работа продолжена. */
|
|
580
601
|
resumed: z.boolean(),
|
|
602
|
+
baseline: baselineViewSchema.optional(),
|
|
581
603
|
works: z.array(z.strictObject({
|
|
582
604
|
id: idSchema,
|
|
583
605
|
status: workStatusSchema,
|
|
@@ -687,17 +709,28 @@ export const sourceCheckDataSchema = z.strictObject({
|
|
|
687
709
|
ownership: ownershipSchema,
|
|
688
710
|
problems: z.array(z.string()),
|
|
689
711
|
});
|
|
712
|
+
/** Закреплённый локальный пакет `tasks[].context`: то, что называет manifest снимка. */
|
|
713
|
+
export const localContextManifestSchema = z.strictObject({
|
|
714
|
+
id: idSchema,
|
|
715
|
+
digest: digestSchema,
|
|
716
|
+
files: z.number().int().nonnegative(),
|
|
717
|
+
references: z.number().int().nonnegative(),
|
|
718
|
+
bytes: z.number().int().nonnegative(),
|
|
719
|
+
});
|
|
690
720
|
export const sourceSnapshotDataSchema = z.strictObject({
|
|
691
721
|
connector: idSchema,
|
|
692
722
|
graphId: idSchema,
|
|
693
723
|
graphDigest: digestSchema,
|
|
694
724
|
contextDigest: digestSchema,
|
|
725
|
+
/** Пакеты `tasks[].context`; без них поля нет. */
|
|
726
|
+
localContext: z.array(localContextManifestSchema).optional(),
|
|
695
727
|
/** Semantic digest набора задач (`graph.source.revision`); не Git SHA. */
|
|
696
728
|
revision: digestSchema,
|
|
697
729
|
created: z.boolean(),
|
|
698
730
|
eligible: z.boolean(),
|
|
699
731
|
problems: z.array(z.string()),
|
|
700
732
|
truncated: z.array(z.string()),
|
|
733
|
+
baseline: baselineViewSchema.optional(),
|
|
701
734
|
tasks: z.array(z.strictObject({
|
|
702
735
|
identity: z.string(),
|
|
703
736
|
key: z.string(),
|
|
@@ -727,7 +760,13 @@ export const sourceStatusDataSchema = z.strictObject({
|
|
|
727
760
|
connector: idSchema,
|
|
728
761
|
provider: providerSchema,
|
|
729
762
|
projectId: z.string(),
|
|
730
|
-
snapshot: z
|
|
763
|
+
snapshot: z
|
|
764
|
+
.strictObject({
|
|
765
|
+
revision: digestSchema,
|
|
766
|
+
graphId: idSchema,
|
|
767
|
+
baseline: baselineViewSchema.optional(),
|
|
768
|
+
})
|
|
769
|
+
.optional(),
|
|
731
770
|
ownership: ownershipSchema,
|
|
732
771
|
tasks: z.array(z.strictObject({
|
|
733
772
|
index: z.number().int(),
|
|
@@ -778,6 +817,56 @@ export const cleanupDataSchema = z.discriminatedUnion('status', [
|
|
|
778
817
|
/** Очищено: receipts окружений, по которым повторён teardown. */
|
|
779
818
|
z.strictObject({ status: z.literal('cleaned'), receipts: z.array(z.string()) }),
|
|
780
819
|
]);
|
|
820
|
+
export const worktreeCleanupDataSchema = z.strictObject({
|
|
821
|
+
dryRun: z.boolean(),
|
|
822
|
+
removed: z.number().int(),
|
|
823
|
+
removable: z.number().int(),
|
|
824
|
+
refused: z.number().int(),
|
|
825
|
+
failed: z.number().int(),
|
|
826
|
+
reclaimedKb: z.number().int(),
|
|
827
|
+
worktrees: z.array(z.strictObject({
|
|
828
|
+
path: z.string(),
|
|
829
|
+
repositoryId: z.string(),
|
|
830
|
+
attemptId: z.string().optional(),
|
|
831
|
+
action: z.enum(['remove', 'removed', 'refused', 'failed']),
|
|
832
|
+
reason: z
|
|
833
|
+
.enum([
|
|
834
|
+
'active',
|
|
835
|
+
'recoverable',
|
|
836
|
+
'cleanup-pending',
|
|
837
|
+
'cleanup-unreadable',
|
|
838
|
+
'unknown-attempt',
|
|
839
|
+
'untrusted',
|
|
840
|
+
'embedded-repository',
|
|
841
|
+
'scan-limit',
|
|
842
|
+
'scan-failed',
|
|
843
|
+
'read-only-path',
|
|
844
|
+
'undecodable-path',
|
|
845
|
+
'worktree-locked',
|
|
846
|
+
'clean-filter',
|
|
847
|
+
'tree-changed',
|
|
848
|
+
'ignore-rules-changed',
|
|
849
|
+
'hidden-changes',
|
|
850
|
+
'staged-ignored',
|
|
851
|
+
'staged-differs',
|
|
852
|
+
'unreachable-head',
|
|
853
|
+
'patch-unusable',
|
|
854
|
+
'removal-incomplete',
|
|
855
|
+
'not-registered',
|
|
856
|
+
])
|
|
857
|
+
.optional(),
|
|
858
|
+
error: z.string().optional(),
|
|
859
|
+
head: z.string().optional(),
|
|
860
|
+
sizeKb: z.number().int().optional(),
|
|
861
|
+
uncommitted: z.number().int().optional(),
|
|
862
|
+
ignored: z.strictObject({ count: z.number().int(), paths: z.array(z.string()) }).optional(),
|
|
863
|
+
record: z.string().optional(),
|
|
864
|
+
removalStarted: z.boolean().optional(),
|
|
865
|
+
registered: z.boolean().optional(),
|
|
866
|
+
treePresent: z.boolean().optional(),
|
|
867
|
+
patch: z.string().optional(),
|
|
868
|
+
})),
|
|
869
|
+
});
|
|
781
870
|
/** `init`: план или результат подготовки проекта. */
|
|
782
871
|
export const initDataSchema = z.strictObject({
|
|
783
872
|
mode: z.enum(['plan', 'apply']),
|
|
@@ -827,6 +916,7 @@ export const cliDataSchemas = {
|
|
|
827
916
|
result: resultEnvelopeSchema,
|
|
828
917
|
deliver: resultEnvelopeSchema,
|
|
829
918
|
cleanup: cleanupDataSchema,
|
|
919
|
+
'worktree-cleanup': worktreeCleanupDataSchema,
|
|
830
920
|
profile: profileDataSchema,
|
|
831
921
|
doctor: doctorDataSchema,
|
|
832
922
|
init: initDataSchema,
|
|
@@ -847,5 +937,15 @@ export const cliErrorSchema = z.strictObject({
|
|
|
847
937
|
message: z.string(),
|
|
848
938
|
issues: z.array(z.strictObject({ path: z.array(z.union([z.string(), z.number()])), message: z.string() })),
|
|
849
939
|
});
|
|
940
|
+
/**
|
|
941
|
+
* Нарушение схемы внутри harness (ответ команды вне договора, собственная
|
|
942
|
+
* запись) — дефект, а не ошибка ввода: INTERNAL с путями полей вместо дампа
|
|
943
|
+
* ZodError в сообщении.
|
|
944
|
+
*/
|
|
945
|
+
export const contractViolation = (error) => new HarnessError('INTERNAL', 'Данные harness не соответствуют его договору (дефект harness, а не настроек): ' +
|
|
946
|
+
error.issues.map((i) => `${i.path.join('.') || '(корень)'}: ${i.message}`).join('; '), error.issues.map((i) => ({
|
|
947
|
+
path: i.path.filter((p) => typeof p !== 'symbol'),
|
|
948
|
+
message: i.message,
|
|
949
|
+
})));
|
|
850
950
|
/** Входной документ контракта для `review-contract` — см. `checks.ts`. */
|
|
851
951
|
export { contractDocumentSchema } from "./checks.js";
|
package/lib/contracts/failure.js
CHANGED
|
@@ -46,7 +46,7 @@ export function failureFingerprint(kind, message) {
|
|
|
46
46
|
// Предел выше всей диагностики проверки (оба потока и упавшие testcases,
|
|
47
47
|
// каждое со своим лимитом): при прежних 300 символах ошибка stderr
|
|
48
48
|
// оказывалась за пределом, и разные провалы получали один отпечаток.
|
|
49
|
-
.slice(0,
|
|
49
|
+
.slice(0, 4000);
|
|
50
50
|
return createHash('sha256')
|
|
51
51
|
.update(kind + '\n' + normalized)
|
|
52
52
|
.digest('hex')
|
|
@@ -217,6 +217,20 @@ export declare const roleBindingSchema: z.ZodObject<{
|
|
|
217
217
|
}, z.core.$strict>>;
|
|
218
218
|
requiresContract: z.ZodDefault<z.ZodBoolean>;
|
|
219
219
|
}, z.core.$strict>;
|
|
220
|
+
/**
|
|
221
|
+
* Хранилище зависимостей репозитория: harness сам держит seed менеджера пакетов
|
|
222
|
+
* по lockfile целевой ветки и разворачивает его в каждый checkout (см.
|
|
223
|
+
* `verification/dependency-store.ts`). Нет поля — поведение и digest прежние.
|
|
224
|
+
*/
|
|
225
|
+
export declare const dependencyStoreSchema: z.ZodObject<{
|
|
226
|
+
manager: z.ZodEnum<{
|
|
227
|
+
pnpm: "pnpm";
|
|
228
|
+
}>;
|
|
229
|
+
lockfile: z.ZodDefault<z.ZodString>;
|
|
230
|
+
maxBytes: z.ZodDefault<z.ZodNumber>;
|
|
231
|
+
timeoutMs: z.ZodDefault<z.ZodNumber>;
|
|
232
|
+
}, z.core.$strict>;
|
|
233
|
+
export type DependencyStorePolicy = z.infer<typeof dependencyStoreSchema>;
|
|
220
234
|
export declare const repositoryPolicySchema: z.ZodObject<{
|
|
221
235
|
id: z.ZodString;
|
|
222
236
|
roles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
|
|
@@ -378,6 +392,14 @@ export declare const repositoryPolicySchema: z.ZodObject<{
|
|
|
378
392
|
command: z.ZodArray<z.ZodString>;
|
|
379
393
|
timeoutMs: z.ZodDefault<z.ZodNumber>;
|
|
380
394
|
}, z.core.$strict>>>;
|
|
395
|
+
dependencyStore: z.ZodOptional<z.ZodObject<{
|
|
396
|
+
manager: z.ZodEnum<{
|
|
397
|
+
pnpm: "pnpm";
|
|
398
|
+
}>;
|
|
399
|
+
lockfile: z.ZodDefault<z.ZodString>;
|
|
400
|
+
maxBytes: z.ZodDefault<z.ZodNumber>;
|
|
401
|
+
timeoutMs: z.ZodDefault<z.ZodNumber>;
|
|
402
|
+
}, z.core.$strict>>;
|
|
381
403
|
dependencyBuild: z.ZodDefault<z.ZodArray<z.ZodObject<{
|
|
382
404
|
id: z.ZodString;
|
|
383
405
|
command: z.ZodArray<z.ZodString>;
|
|
@@ -630,6 +652,14 @@ export declare const executionPolicySchema: z.ZodObject<{
|
|
|
630
652
|
command: z.ZodArray<z.ZodString>;
|
|
631
653
|
timeoutMs: z.ZodDefault<z.ZodNumber>;
|
|
632
654
|
}, z.core.$strict>>>;
|
|
655
|
+
dependencyStore: z.ZodOptional<z.ZodObject<{
|
|
656
|
+
manager: z.ZodEnum<{
|
|
657
|
+
pnpm: "pnpm";
|
|
658
|
+
}>;
|
|
659
|
+
lockfile: z.ZodDefault<z.ZodString>;
|
|
660
|
+
maxBytes: z.ZodDefault<z.ZodNumber>;
|
|
661
|
+
timeoutMs: z.ZodDefault<z.ZodNumber>;
|
|
662
|
+
}, z.core.$strict>>;
|
|
633
663
|
dependencyBuild: z.ZodDefault<z.ZodArray<z.ZodObject<{
|
|
634
664
|
id: z.ZodString;
|
|
635
665
|
command: z.ZodArray<z.ZodString>;
|
package/lib/contracts/policy.js
CHANGED
|
@@ -98,6 +98,27 @@ export const roleBindingSchema = z.strictObject({
|
|
|
98
98
|
review: reviewRuleSchema.optional(),
|
|
99
99
|
requiresContract: z.boolean().default(false),
|
|
100
100
|
});
|
|
101
|
+
/**
|
|
102
|
+
* Хранилище зависимостей репозитория: harness сам держит seed менеджера пакетов
|
|
103
|
+
* по lockfile целевой ветки и разворачивает его в каждый checkout (см.
|
|
104
|
+
* `verification/dependency-store.ts`). Нет поля — поведение и digest прежние.
|
|
105
|
+
*/
|
|
106
|
+
export const dependencyStoreSchema = z.strictObject({
|
|
107
|
+
manager: z.enum(['pnpm']),
|
|
108
|
+
/** Lockfile относительно корня репозитория. */
|
|
109
|
+
lockfile: relativePathSchema.default('pnpm-lock.yaml'),
|
|
110
|
+
/** Предел логического размера seeds репозитория на диске. */
|
|
111
|
+
maxBytes: z
|
|
112
|
+
.number()
|
|
113
|
+
.int()
|
|
114
|
+
.min(1024 * 1024)
|
|
115
|
+
.default(8 * 1024 * 1024 * 1024),
|
|
116
|
+
/**
|
|
117
|
+
* Верхний предел сборки seed вместе с ожиданием чужой сборки. Действует ещё и
|
|
118
|
+
* доля остатка времени фазы: хранилище не расходует время попытки до отказа.
|
|
119
|
+
*/
|
|
120
|
+
timeoutMs: z.number().int().positive().max(3_600_000).default(600000),
|
|
121
|
+
});
|
|
101
122
|
export const repositoryPolicySchema = z.strictObject({
|
|
102
123
|
id: idSchema,
|
|
103
124
|
/**
|
|
@@ -119,6 +140,8 @@ export const repositoryPolicySchema = z.strictObject({
|
|
|
119
140
|
environment: environmentSchema.optional(),
|
|
120
141
|
lifecycle: lifecycleSchema.optional(),
|
|
121
142
|
prepare: z.array(stepSchema).default([]),
|
|
143
|
+
/** Необязательное поле без умолчания: политика без него сохраняет digest. */
|
|
144
|
+
dependencyStore: dependencyStoreSchema.optional(),
|
|
122
145
|
dependencyBuild: z.array(stepSchema).default([]),
|
|
123
146
|
dependencyArtifacts: z.array(relativePathSchema).default([]),
|
|
124
147
|
preflight: z.array(stepSchema).default([]),
|
|
@@ -272,6 +272,14 @@ export declare const publishedSchemas: {
|
|
|
272
272
|
command: z.ZodArray<z.ZodString>;
|
|
273
273
|
timeoutMs: z.ZodDefault<z.ZodNumber>;
|
|
274
274
|
}, z.core.$strict>>>;
|
|
275
|
+
dependencyStore: z.ZodOptional<z.ZodObject<{
|
|
276
|
+
manager: z.ZodEnum<{
|
|
277
|
+
pnpm: "pnpm";
|
|
278
|
+
}>;
|
|
279
|
+
lockfile: z.ZodDefault<z.ZodString>;
|
|
280
|
+
maxBytes: z.ZodDefault<z.ZodNumber>;
|
|
281
|
+
timeoutMs: z.ZodDefault<z.ZodNumber>;
|
|
282
|
+
}, z.core.$strict>>;
|
|
275
283
|
dependencyBuild: z.ZodDefault<z.ZodArray<z.ZodObject<{
|
|
276
284
|
id: z.ZodString;
|
|
277
285
|
command: z.ZodArray<z.ZodString>;
|
|
@@ -83,6 +83,12 @@ export declare const alreadySatisfiedSchema: z.ZodObject<{
|
|
|
83
83
|
evidence: z.ZodString;
|
|
84
84
|
}, z.core.$strict>;
|
|
85
85
|
export type AlreadySatisfied = z.infer<typeof alreadySatisfiedSchema>;
|
|
86
|
+
/**
|
|
87
|
+
* Предел находок и переходов в одном ответе reviewer и в раунде истории. Без
|
|
88
|
+
* предела каждый лишний элемент ответа давал отдельные ошибки разбора и
|
|
89
|
+
* гигабайты кучи. Реальные ответы на порядки меньше.
|
|
90
|
+
*/
|
|
91
|
+
export declare const REVIEW_ITEMS_LIMIT = 500;
|
|
86
92
|
export declare const reviewResultSchema: z.ZodObject<{
|
|
87
93
|
execution: z.ZodOptional<z.ZodObject<{
|
|
88
94
|
commands: z.ZodArray<z.ZodObject<{
|
|
@@ -143,6 +149,69 @@ export declare const reviewResultSchema: z.ZodObject<{
|
|
|
143
149
|
}, z.core.$strict>>>;
|
|
144
150
|
}, z.core.$strip>;
|
|
145
151
|
export type ReviewResult = z.infer<typeof reviewResultSchema>;
|
|
152
|
+
/**
|
|
153
|
+
* Записанный ответ reviewer (`review.json`). Предел `reviewResultSchema` —
|
|
154
|
+
* граница приёма: файлы прежних версий с длинными списками читаются и дальше.
|
|
155
|
+
*/
|
|
156
|
+
export declare const storedReviewResultSchema: z.ZodObject<{
|
|
157
|
+
execution: z.ZodOptional<z.ZodObject<{
|
|
158
|
+
commands: z.ZodArray<z.ZodObject<{
|
|
159
|
+
command: z.ZodString;
|
|
160
|
+
exitCode: z.ZodNumber;
|
|
161
|
+
summary: z.ZodString;
|
|
162
|
+
}, z.core.$strict>>;
|
|
163
|
+
noCommandsReason: z.ZodNullable<z.ZodString>;
|
|
164
|
+
}, z.core.$strict>>;
|
|
165
|
+
approved: z.ZodBoolean;
|
|
166
|
+
summary: z.ZodString;
|
|
167
|
+
discoveries: z.ZodDefault<z.ZodArray<z.ZodObject<{
|
|
168
|
+
kind: z.ZodEnum<{
|
|
169
|
+
bug: "bug";
|
|
170
|
+
debt: "debt";
|
|
171
|
+
}>;
|
|
172
|
+
title: z.ZodString;
|
|
173
|
+
path: z.ZodString;
|
|
174
|
+
line: z.ZodNumber;
|
|
175
|
+
observation: z.ZodString;
|
|
176
|
+
consequence: z.ZodString;
|
|
177
|
+
reproduction: z.ZodString;
|
|
178
|
+
}, z.core.$strict>>>;
|
|
179
|
+
alreadySatisfied: z.ZodOptional<z.ZodNullable<z.ZodObject<{
|
|
180
|
+
gates: z.ZodArray<z.ZodString>;
|
|
181
|
+
evidence: z.ZodString;
|
|
182
|
+
}, z.core.$strict>>>;
|
|
183
|
+
findings: z.ZodArray<z.ZodObject<{
|
|
184
|
+
severity: z.ZodEnum<{
|
|
185
|
+
blocking: "blocking";
|
|
186
|
+
note: "note";
|
|
187
|
+
}>;
|
|
188
|
+
message: z.ZodString;
|
|
189
|
+
path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
|
|
190
|
+
line: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
|
|
191
|
+
rule: z.ZodOptional<z.ZodNullable<z.ZodString>>;
|
|
192
|
+
consequence: z.ZodOptional<z.ZodNullable<z.ZodString>>;
|
|
193
|
+
evidence: z.ZodOptional<z.ZodNullable<z.ZodString>>;
|
|
194
|
+
reproduction: z.ZodCatch<z.ZodOptional<z.ZodNullable<z.ZodObject<{
|
|
195
|
+
property: z.ZodNullable<z.ZodString>;
|
|
196
|
+
input: z.ZodString;
|
|
197
|
+
inputClass: z.ZodOptional<z.ZodNullable<z.ZodString>>;
|
|
198
|
+
expected: z.ZodNullable<z.ZodString>;
|
|
199
|
+
actual: z.ZodNullable<z.ZodString>;
|
|
200
|
+
command: z.ZodNullable<z.ZodArray<z.ZodString>>;
|
|
201
|
+
executed: z.ZodBoolean;
|
|
202
|
+
run: z.ZodOptional<z.ZodNullable<z.ZodString>>;
|
|
203
|
+
}, z.core.$strip>>>>;
|
|
204
|
+
}, z.core.$strip>>;
|
|
205
|
+
previous: z.ZodDefault<z.ZodArray<z.ZodObject<{
|
|
206
|
+
id: z.ZodString;
|
|
207
|
+
status: z.ZodEnum<{
|
|
208
|
+
open: "open";
|
|
209
|
+
closed: "closed";
|
|
210
|
+
withdrawn: "withdrawn";
|
|
211
|
+
}>;
|
|
212
|
+
basis: z.ZodString;
|
|
213
|
+
}, z.core.$strict>>>;
|
|
214
|
+
}, z.core.$strip>;
|
|
146
215
|
/** Идентичность находки: предмет, класс и текст. Новый текст — новая находка. */
|
|
147
216
|
export declare const findingId: (subject: string, finding: {
|
|
148
217
|
rule?: string | null;
|