@lumpcode/core 0.0.16 → 0.1.0

package/dist/types/ExecShellFn.d.ts

@@ -0,0 +1,16 @@
+import type { ExecFailureData } from './ExecFailureData';
+import type { Failure } from './Failure';
+import type { MaybePromise } from './MaybePromise';
+import type { Success } from './Success';
+export type ExecShellResult = Success<{
+    stdout: unknown;
+    stderr: unknown;
+}> | Failure<ExecFailureData>;
+/**
+ * Shell runner used by the engine for workspace setup/teardown and git add/commit/push.
+ * Defaults to `execAsync`. CLI may wrap it (e.g. git-common-dir lock).
+ */
+export type ExecShellFn = (command: string, options?: {
+    cwd?: string;
+}) => MaybePromise<ExecShellResult>;
+//# sourceMappingURL=ExecShellFn.d.ts.map

package/dist/types/ExecShellFn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecShellFn.d.ts","sourceRoot":"","sources":["../../src/types/ExecShellFn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,MAAM,eAAe,GACrB,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,GAC7C,OAAO,CAAC,eAAe,CAAC,CAAC;AAE/B;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,CACtB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,KACzB,YAAY,CAAC,eAAe,CAAC,CAAC"}

package/dist/types/GitAddCommandFn.d.ts

@@ -1,6 +1,12 @@
 import { Context } from "./Context";
 import { GitAndWorkspaceFnsInput } from "./GitAndWorkspaceFnsInput";
+import { Maybe } from "./Maybe";
+import { MaybePromise } from "./MaybePromise";
+/**
+ * Returns a shell command for core to `execAsync`, or null/undefined when the
+ * injector already performed the work (or intentionally no-ops).
+ */
 export type GitAddCommandFn = (input: Omit<GitAndWorkspaceFnsInput, 'contextList'> & {
     context: Context;
-}) => string;
+}) => MaybePromise<Maybe<string>>;
 //# sourceMappingURL=GitAddCommandFn.d.ts.map

package/dist/types/GitAddCommandFn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GitAddCommandFn.d.ts","sourceRoot":"","sources":["../../src/types/GitAddCommandFn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,uBAAuB,EAAE,aAAa,CAAC,GAAG;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,KAAK,MAAM,CAAC"}
+{"version":3,"file":"GitAddCommandFn.d.ts","sourceRoot":"","sources":["../../src/types/GitAddCommandFn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,CAC1B,KAAK,EAAE,IAAI,CAAC,uBAAuB,EAAE,aAAa,CAAC,GAAG;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,KACzE,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC"}

package/dist/types/GitCommitCommandFn.d.ts

@@ -1,7 +1,13 @@
 import { Context } from "./Context";
 import { GitAndWorkspaceFnsInput } from "./GitAndWorkspaceFnsInput";
+import { Maybe } from "./Maybe";
+import { MaybePromise } from "./MaybePromise";
+/**
+ * Returns a shell command for core to `execAsync`, or null/undefined when the
+ * injector already performed the work (or intentionally no-ops).
+ */
 export type GitCommitCommandFn = (input: Omit<GitAndWorkspaceFnsInput, 'contextList'> & {
     context: Context;
     commitMessage: string;
-}) => string;
+}) => MaybePromise<Maybe<string>>;
 //# sourceMappingURL=GitCommitCommandFn.d.ts.map

package/dist/types/GitCommitCommandFn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GitCommitCommandFn.d.ts","sourceRoot":"","sources":["../../src/types/GitCommitCommandFn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,uBAAuB,EAAE,aAAa,CAAC,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,KAAK,MAAM,CAAC"}
+{"version":3,"file":"GitCommitCommandFn.d.ts","sourceRoot":"","sources":["../../src/types/GitCommitCommandFn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC7B,KAAK,EAAE,IAAI,CAAC,uBAAuB,EAAE,aAAa,CAAC,GAAG;IAClD,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACzB,KACA,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC"}

package/dist/types/GitPushCommandFn.d.ts

@@ -1,3 +1,9 @@
 import { GitAndWorkspaceFnsInput } from "./GitAndWorkspaceFnsInput";
-export type GitPushCommandFn = (input: GitAndWorkspaceFnsInput) => string;
+import { Maybe } from "./Maybe";
+import { MaybePromise } from "./MaybePromise";
+/**
+ * Returns a shell command for core to `execAsync`, or null/undefined when the
+ * injector already performed the work (or intentionally no-ops).
+ */
+export type GitPushCommandFn = (input: GitAndWorkspaceFnsInput) => MaybePromise<Maybe<string>>;
 //# sourceMappingURL=GitPushCommandFn.d.ts.map

package/dist/types/GitPushCommandFn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GitPushCommandFn.d.ts","sourceRoot":"","sources":["../../src/types/GitPushCommandFn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,uBAAuB,KAAK,MAAM,CAAC"}
+{"version":3,"file":"GitPushCommandFn.d.ts","sourceRoot":"","sources":["../../src/types/GitPushCommandFn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC3B,KAAK,EAAE,uBAAuB,KAC7B,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC"}

package/dist/usages/runLump/main.d.ts

@@ -1,5 +1,5 @@
 import { Success, Failure, BranchFn, GetContextListFn, SetupFn, LumpVariables, StepVariables, TeardownFn, Steps, GitAddCommandFn, GitCommitCommandFn, GitCommitMessageFn, GitPushCommandFn, SetupWorkspaceFn, TeardownWorkspaceFn, ExtractSuccess, Context, Logger, ExecuteStepsFailureData } from "../../types";
-import { ExecuteStepsForContextListResult } from "../../helpers";
+import { ExecuteStepsForContextListResult, type RefreshRemoteTrackingRefsFn } from "../../helpers";
 export declare function runLump<V extends LumpVariables = LumpVariables, SV extends StepVariables = StepVariables>(input: RunLumpInput<V, SV>): Promise<Success<RunLumpOutput> | Failure<ExecuteStepsFailureData>>;
 export interface RunLumpInput<V extends LumpVariables = LumpVariables, SV extends StepVariables = StepVariables> {
     projectRoot: string;
@@ -21,6 +21,11 @@ export interface RunLumpInput<V extends LumpVariables = LumpVariables, SV extend
     getKeepHistoryFilePathFn?: (context: Context) => string | undefined;
     /** When aborted, in-flight commands are killed and the step walk stops (ignores continueOnError). */
     signal?: AbortSignal;
+    /**
+     * Optional one-shot remote refresh before context status (CLI locks this).
+     * Defaults to unlocked core `refreshRemoteTrackingRefs` inside getToDoContextList.
+     */
+    refreshRemoteTrackingRefsFn?: RefreshRemoteTrackingRefsFn;
 }
 export interface RunLumpOutput {
     result: ExtractSuccess<ExecuteStepsForContextListResult>;

package/dist/usages/runLump/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../src/usages/runLump/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAEjT,OAAO,EAGH,gCAAgC,EACnC,MAAM,eAAe,CAAC;AAGvB,wBAAsB,OAAO,CACzB,CAAC,SAAS,aAAa,GAAG,aAAa,EACvC,EAAE,SAAS,aAAa,GAAG,aAAa,EAC1C,KAAK,EAAE,YAAY,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,OAAO,CACtC,OAAO,CAAC,aAAa,CAAC,GACtB,OAAO,CAAC,uBAAuB,CAAC,CAC/B,CA8FA;AAED,MAAM,WAAW,YAAY,CACzB,CAAC,SAAS,aAAa,GAAG,aAAa,EACvC,EAAE,SAAS,aAAa,GAAG,aAAa;IAExC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACtB,gBAAgB,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACtC,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACpB,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,aAAa,CAAC,EAAE,CAAC,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACrB,UAAU,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IAC3B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;IAC3C,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wBAAwB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;IACpE,qGAAqG;IACrG,MAAM,CAAC,EAAE,WAAW,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC1B,MAAM,EAAE,cAAc,CAAC,gCAAgC,CAAC,CAAC;CAC5D"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../src/usages/runLump/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAEjT,OAAO,EAGH,gCAAgC,EAChC,KAAK,2BAA2B,EACnC,MAAM,eAAe,CAAC;AAGvB,wBAAsB,OAAO,CACzB,CAAC,SAAS,aAAa,GAAG,aAAa,EACvC,EAAE,SAAS,aAAa,GAAG,aAAa,EAC1C,KAAK,EAAE,YAAY,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,OAAO,CACtC,OAAO,CAAC,aAAa,CAAC,GACtB,OAAO,CAAC,uBAAuB,CAAC,CAC/B,CAgGA;AAED,MAAM,WAAW,YAAY,CACzB,CAAC,SAAS,aAAa,GAAG,aAAa,EACvC,EAAE,SAAS,aAAa,GAAG,aAAa;IAExC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACtB,gBAAgB,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACtC,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACpB,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,aAAa,CAAC,EAAE,CAAC,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACrB,UAAU,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IAC3B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;IAC3C,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wBAAwB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;IACpE,qGAAqG;IACrG,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;OAGG;IACH,2BAA2B,CAAC,EAAE,2BAA2B,CAAC;CAC7D;AAED,MAAM,WAAW,aAAa;IAC1B,MAAM,EAAE,cAAc,CAAC,gCAAgC,CAAC,CAAC;CAC5D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumpcode/core",
-  "version": "0.0.16",
+  "version": "0.1.0",
   "description": "Core engine for Lumpcode agent loops — runLump orchestrates prompts across contexts with git-tracked progress",
   "keywords": [
     "lumpcode",