@kitman-sh/sdk 0.10.69 → 0.10.71

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.
@@ -260,6 +260,25 @@ export declare const PipelineStatus: Schema.Struct<{
260
260
  * with `verify` on the head and posts the result with `reportPipeline`, and may do so again for a failure it doubts.
261
261
  */
262
262
  readonly runnerChecks: Schema.optionalKey<Schema.$Array<Schema.String>>;
263
+ /** The newest head of the ChangeRequest an approval in Kitman covers, with no request for changes on it since. */
264
+ readonly approved: Schema.optionalKey<Schema.String>;
265
+ /** The ChangeRequest's RepoBinding. */
266
+ readonly repository: Schema.optionalKey<Schema.String>;
267
+ /**
268
+ * While the pipeline fails: the head of the ChangeRequest's target branch and the forge's checks on it, none where
269
+ * the forge runs no pipeline. Left out when the forge could not say.
270
+ */
271
+ readonly target: Schema.optionalKey<Schema.Struct<{
272
+ readonly branch: Schema.String;
273
+ readonly head: Schema.String;
274
+ readonly jobs: Schema.$Array<Schema.Struct<{
275
+ readonly name: Schema.String;
276
+ readonly status: Schema.Literals<readonly ["running", "success", "failed", "skipped"]>;
277
+ readonly url: Schema.optional<Schema.String>;
278
+ /** The redacted end of a failed job's log, at most 4000 characters, where the forge serves job logs. */
279
+ readonly logTail: Schema.optional<Schema.String>;
280
+ }>>;
281
+ }>>;
263
282
  }>;
264
283
  export type PipelineStatus = typeof PipelineStatus.Type;
265
284
  /** A review conversation not yet resolved, with its comments oldest first. */
@@ -728,6 +747,18 @@ export declare const pipelineStatus: (name: string, request: typeof ChangeReques
728
747
  }[];
729
748
  readonly readAt?: string;
730
749
  readonly runnerChecks?: readonly string[];
750
+ readonly approved?: string;
751
+ readonly repository?: string;
752
+ readonly target?: {
753
+ readonly branch: string;
754
+ readonly head: string;
755
+ readonly jobs: readonly {
756
+ readonly name: string;
757
+ readonly status: "failed" | "running" | "skipped" | "success";
758
+ readonly url?: string | undefined;
759
+ readonly logTail?: string | undefined;
760
+ }[];
761
+ };
731
762
  }, import("./steps").CapabilityDenied | import("./steps").DuplicateStep | StepFailed, ChangeRequestReadActivity | import("./steps").LoopRun | import("effect/workflow/WorkflowEngine").WorkflowEngine | import("effect/workflow/WorkflowEngine").WorkflowInstance>;
732
763
  /** A ChangeRequest's unresolved review conversations, read when the Step runs. */
733
764
  export declare const reviewThreads: (name: string, request: typeof ChangeRequestReadRequest.Type) => Effect.Effect<{
@@ -15,6 +15,10 @@ export declare const EvidenceCheck: Schema.Struct<{
15
15
  readonly outputTail: Schema.optionalKey<Schema.String>;
16
16
  /** An agent suggested it because the repository has none approved; a person should check it. */
17
17
  readonly suggested: Schema.optionalKey<Schema.Boolean>;
18
+ /** Tests its JUnit reports show ran on the baseline and were skipped on this tree. */
19
+ readonly skippedSinceBaseline: Schema.optionalKey<Schema.$Array<Schema.String>>;
20
+ /** Tests new on this tree that its JUnit reports show skipped, so they never ran. */
21
+ readonly newNotRun: Schema.optionalKey<Schema.$Array<Schema.String>>;
18
22
  }>;
19
23
  export type EvidenceCheck = typeof EvidenceCheck.Type;
20
24
  /** Evidence for a revision; `tree` is its git tree id, and the evidence holds for any revision with that tree. */
@@ -37,6 +41,10 @@ export declare const VerifyResult: Schema.Struct<{
37
41
  readonly outputTail: Schema.optionalKey<Schema.String>;
38
42
  /** An agent suggested it because the repository has none approved; a person should check it. */
39
43
  readonly suggested: Schema.optionalKey<Schema.Boolean>;
44
+ /** Tests its JUnit reports show ran on the baseline and were skipped on this tree. */
45
+ readonly skippedSinceBaseline: Schema.optionalKey<Schema.$Array<Schema.String>>;
46
+ /** Tests new on this tree that its JUnit reports show skipped, so they never ran. */
47
+ readonly newNotRun: Schema.optionalKey<Schema.$Array<Schema.String>>;
40
48
  }>>;
41
49
  }>;
42
50
  export type VerifyResult = typeof VerifyResult.Type;
@@ -77,5 +85,13 @@ export type EvidenceVerdict = {
77
85
  readonly reasons: readonly string[];
78
86
  };
79
87
  export declare const failsOn: (side: 'base' | 'head', name: string, tree: string | undefined) => string;
80
- /** Whether the Run's evidence closes its Outcome, per `OutcomeTable`; claims in Outputs never count. */
88
+ /**
89
+ * Each check's tests that verify never ran on the tree, which a passing check does not vouch for: new tests it skipped,
90
+ * and tests the baseline ran that it skipped.
91
+ */
92
+ export declare const testsNotRunReasons: (result: VerifyResult) => string[];
93
+ /**
94
+ * Whether the Run's evidence closes its Outcome, per `OutcomeTable`; claims in Outputs never count, and neither do tests
95
+ * the head's checks skipped where the baseline ran them or did not have them.
96
+ */
81
97
  export declare const evidenceGate: (input: EvidenceGateInput) => EvidenceVerdict;
@@ -216,6 +216,8 @@ export declare const verifyDeferred: (step: string) => DurableDeferred.DurableDe
216
216
  readonly evidenceId: Schema.String;
217
217
  readonly outputTail: Schema.optionalKey<Schema.String>;
218
218
  readonly suggested: Schema.optionalKey<Schema.Boolean>;
219
+ readonly skippedSinceBaseline: Schema.optionalKey<Schema.$Array<Schema.String>>;
220
+ readonly newNotRun: Schema.optionalKey<Schema.$Array<Schema.String>>;
219
221
  }>>;
220
222
  }>, typeof StepFailed>;
221
223
  /** Claims the Step name for this Run and checks its capability before running it. */
@@ -338,6 +340,8 @@ export declare const verify: (name: string, request: {
338
340
  readonly evidenceId: string;
339
341
  readonly outputTail?: string;
340
342
  readonly suggested?: boolean;
343
+ readonly skippedSinceBaseline?: readonly string[];
344
+ readonly newNotRun?: readonly string[];
341
345
  }[];
342
346
  }, CapabilityDenied | DuplicateStep | StepFailed, LoopHost | LoopRun | import("effect/workflow/WorkflowEngine").WorkflowEngine | import("effect/workflow/WorkflowEngine").WorkflowInstance>;
343
347
  /** Asks a human to approve a verification, for example one an agent's Output suggested. */
@@ -73,6 +73,15 @@ export type TestLoopScript = {
73
73
  readonly claims?: {
74
74
  readonly [step: string]: ClaimResult;
75
75
  };
76
+ /**
77
+ * Settles each claim and let go itself, as a queue that several test Runs share does: what it gives a claim wins over
78
+ * `claims`, and a claim waits for as long as it takes.
79
+ */
80
+ readonly claimed?: (request: {
81
+ readonly step: string;
82
+ readonly resource: string;
83
+ readonly action: 'claim' | 'take_over' | 'let_go';
84
+ }) => Effect.Effect<ClaimResult | undefined>;
76
85
  /** What the control plane grants; the declared capabilities by default. */
77
86
  readonly grant?: readonly LoopCapability[];
78
87
  /** Replaces the default host Activities method by method; a method left out keeps its default. */