@kitman-sh/sdk 0.10.82 → 0.10.84

package/types/packages/sdk/src/loop/activities.d.ts

@@ -265,6 +265,8 @@ export declare const PipelineStatus: Schema.Struct<{
     readonly approved: Schema.optionalKey<Schema.String>;
     /** The ChangeRequest's RepoBinding. */
     readonly repository: Schema.optionalKey<Schema.String>;
+    /** The branch the ChangeRequest merges into; left out by a Kitman from before it said. */
+    readonly targetBranch: Schema.optionalKey<Schema.String>;
     /** The forge says the ChangeRequest conflicts with its target; left out while it has not worked that out. */
     readonly conflicts: Schema.optionalKey<Schema.Boolean>;
     /** The forge says the branch must take its target in before it can merge, as a semi-linear project does. */
@@ -754,6 +756,7 @@ export declare const pipelineStatus: (name: string, request: typeof ChangeReques
     readonly runnerChecks?: readonly string[];
     readonly approved?: string;
     readonly repository?: string;
+    readonly targetBranch?: string;
     readonly conflicts?: boolean;
     readonly needsRebase?: boolean;
     readonly target?: {

package/types/packages/sdk/src/loop/index.d.ts

@@ -10,6 +10,7 @@ export * from './config';
 export * from './sync';
 export * from './continuing';
 export * from './measure';
+export * from './resolve';
 export * from './claims';
 /** What a verification is called, as a Loop's Output names one. */
 export { CheckName } from '../../../core/src/work-unit';

package/types/packages/sdk/src/loop/resolve.d.ts

@@ -0,0 +1,13 @@
+import { ResolvedRevisions } from '../../../core/src/work-unit';
+import * as Effect from 'effect/Effect';
+import { DurableDeferred } from 'effect/workflow';
+import { StepFailed } from './steps';
+export { ResolvedRevisions };
+export declare const resolveDeferred: (step: string) => DurableDeferred.DurableDeferred<import("effect/Schema").Struct<{
+    readonly commits: import("effect/Schema").$Array<import("effect/Schema").String>;
+}>, typeof StepFailed>;
+/**
+ * Resolves each revision, such as `origin/main` or a commit SHA, to the full SHA of the commit it names now, on a
+ * Runner with no agent and no checks. A revision that names no commit fails the Step.
+ */
+export declare const resolveRevisions: (name: string, revisions: readonly [string, ...string[]]) => Effect.Effect<readonly string[], import("./steps").CapabilityDenied | import("./steps").DuplicateStep | StepFailed, import("./steps").LoopHost | import("./steps").LoopRun | import("effect/workflow/WorkflowEngine").WorkflowEngine | import("effect/workflow/WorkflowEngine").WorkflowInstance>;

package/types/packages/sdk/src/loop/steps.d.ts

@@ -151,6 +151,11 @@ export type VerificationLaunch = Launch & {
     readonly rerunFailed?: boolean;
     /** Benchmarks the revision against `base` (the Run's base branch head when left out) in place of checks. */
     readonly measure?: MeasureLaunch;
+    /** Resolves revisions to the commits they name now, in place of checks. */
+    readonly resolve?: ResolveLaunch;
+};
+export type ResolveLaunch = {
+    readonly revisions: readonly string[];
 };
 export type MeasureLaunch = {
     readonly base?: string;

package/types/packages/sdk/src/loop/sync.d.ts

@@ -1,13 +1,16 @@
 import * as Schema from 'effect/Schema';
 /**
  * What a base sync did: nothing to take, a merge that went in, or the files it could not settle. A merge carries the
- * Runner's `catchUp` report of what it did to the branch's own change, when the Runner made one.
+ * Runner's `catchUp` report of what it did to the branch's own change, when the Runner made one; each carries `base`,
+ * the commit the Runner read the target branch at, when the Runner reports one.
  */
 export declare const BaseSync: Schema.Union<readonly [Schema.Struct<{
     readonly status: Schema.Literal<"up_to_date">;
+    readonly base: Schema.optionalKey<Schema.String>;
 }>, Schema.Struct<{
     readonly status: Schema.Literal<"merged">;
     readonly settled: Schema.$Array<Schema.String>;
+    readonly base: Schema.optionalKey<Schema.String>;
     readonly catchUp: Schema.optionalKey<Schema.Struct<{
         readonly from: Schema.String;
         readonly head: Schema.String;
@@ -21,6 +24,7 @@ export declare const BaseSync: Schema.Union<readonly [Schema.Struct<{
     /** The files it could not settle; the merge was aborted, so the branch is as it was. */
     readonly files: Schema.NonEmptyArray<Schema.String>;
     readonly reason: Schema.String;
+    readonly base: Schema.optionalKey<Schema.String>;
 }>]>;
 export type BaseSync = typeof BaseSync.Type;
 /**
@@ -35,9 +39,11 @@ export declare const syncBase: (name: string, options: {
     readonly target?: string;
 }) => import("effect/Effect").Effect<{
     readonly status: "up_to_date";
+    readonly base?: string;
 } | {
     readonly status: "merged";
     readonly settled: readonly string[];
+    readonly base?: string;
     readonly catchUp?: {
         readonly from: string;
         readonly head: string;
@@ -50,4 +56,5 @@ export declare const syncBase: (name: string, options: {
     readonly status: "conflict";
     readonly files: readonly [string, ...string[]];
     readonly reason: string;
+    readonly base?: string;
 }, import("./steps").CapabilityDenied | import("./steps").DuplicateStep | import("./steps").OutputInvalid | import("./steps").StepFailed, import("./steps").LoopHost | import("./steps").LoopRun | import("effect/workflow/WorkflowEngine").WorkflowEngine | import("effect/workflow/WorkflowEngine").WorkflowInstance>;

package/types/packages/sdk/src/loop/test-loop.d.ts

@@ -74,6 +74,13 @@ export type TestLoopScript = {
     readonly measurements?: {
         readonly [step: string]: MeasureEvidence | ScriptedFailure;
     };
+    /**
+     * The commit each revision a `resolveRevisions` Step resolves names, by revision; `null` names none. A revision left
+     * out names itself when it is a full SHA, and otherwise a commit made up from its name.
+     */
+    readonly commits?: {
+        readonly [revision: string]: string | null;
+    };
     /** What each `claim` Step came to; a claim left out is granted. */
     readonly claims?: {
         readonly [step: string]: ClaimResult;

package/types/packages/sdk/src/program/engine.d.ts

@@ -1,6 +1,6 @@
 import { type OrchestrationWorkUnit, type ProgramWorkUnit, type RunFilePartUrl, type RunFileRecord, type RunFileUpload } from '../../../core/src/index';
 import { type QuestionAdvice } from '../../../core/src/question-recommendation';
-import { StepFailed, type MeasureLaunch, type ChangeRequestResult, type EventFilter, type OtherEvent, type IntegrationBranch, type LoopDefinition, type MergeResult, type ReleaseResult, type PlanTicket, type ProposeRequest, type TranscriptsResult, type AlertTaskResult, type PipelineStatus, type ReportPipelineResult, type ReviewThreads, type OpenChangeRequests, type OwnChangeRequests, type DraftUpdateRequest, type ProjectActivityResult, type WriteBackMilestones, type SuggestedVerification } from '../loop';
+import { StepFailed, type MeasureLaunch, type ResolveLaunch, type ChangeRequestResult, type EventFilter, type OtherEvent, type IntegrationBranch, type LoopDefinition, type MergeResult, type ReleaseResult, type PlanTicket, type ProposeRequest, type TranscriptsResult, type AlertTaskResult, type PipelineStatus, type ReportPipelineResult, type ReviewThreads, type OpenChangeRequests, type OwnChangeRequests, type DraftUpdateRequest, type ProjectActivityResult, type WriteBackMilestones, type SuggestedVerification } from '../loop';
 import * as Cause from 'effect/Cause';
 import * as Effect from 'effect/Effect';
 import * as FileSystem from 'effect/FileSystem';
@@ -57,6 +57,7 @@ export type ProgramCapabilities = {
         readonly suggested?: readonly SuggestedVerification[];
         readonly rerunFailed?: boolean;
         readonly measure?: MeasureLaunch;
+        readonly resolve?: ResolveLaunch;
     }) => Effect.Effect<{
         readonly verificationId: string;
     }, Error>;