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,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;
@@ -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.strictObject({ revision: digestSchema, graphId: idSchema }).optional(),
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";
@@ -46,7 +46,7 @@ export function failureFingerprint(kind, message) {
46
46
  // Предел выше всей диагностики проверки (оба потока и упавшие testcases,
47
47
  // каждое со своим лимитом): при прежних 300 символах ошибка stderr
48
48
  // оказывалась за пределом, и разные провалы получали один отпечаток.
49
- .slice(0, 2000);
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>;
@@ -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;