@lumpcode/cli-types 0.1.1 → 0.3.0

package/dist/index.cjs

@@ -36,15 +36,13 @@ function defineGetContextListFn(fn) {
     return fn;
 }
 
-const defineGitAddCommandFn = (identity);
-
-const defineGitCommitCommandFn = (identity);
+const defineGitAddCommitFn = (identity);
 
 function defineGitCommitMessageFn(fn) {
     return fn;
 }
 
-const defineGitPushCommandFn = (identity);
+const defineGitPushFn = (identity);
 
 function definePostCommandExecFn(fn) {
     return fn;
@@ -75,10 +73,9 @@ exports.defineConfig = defineConfig;
 exports.defineContextMatchFn = defineContextMatchFn;
 exports.defineContextOptionsFn = defineContextOptionsFn;
 exports.defineGetContextListFn = defineGetContextListFn;
-exports.defineGitAddCommandFn = defineGitAddCommandFn;
-exports.defineGitCommitCommandFn = defineGitCommitCommandFn;
+exports.defineGitAddCommitFn = defineGitAddCommitFn;
 exports.defineGitCommitMessageFn = defineGitCommitMessageFn;
-exports.defineGitPushCommandFn = defineGitPushCommandFn;
+exports.defineGitPushFn = defineGitPushFn;
 exports.definePostCommandExecFn = definePostCommandExecFn;
 exports.definePromptFn = definePromptFn;
 exports.defineSetupFn = defineSetupFn;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { LumpVariables, BranchFn, StepVariables, CommandFn, SetupFn, TeardownFn, ContextList, MaybePromise, PromptFnInput, PostCommandExecFn, Step, PromptFn, CodeBasePath, Maybe, Context, GetContextListFnOutput, RunLumpInput, GitAddCommandFn, GitCommitCommandFn, GitCommitMessageFn, GitPushCommandFn } from '@lumpcode/core';
-export { AsyncFnSuccess, BranchFn, CodeBasePath, CommandFn, Context, ContextList, ContextRunState, ContextStatus, ExtractSuccess, GetContextListFnOutput, GitAddCommandFn, GitCommitCommandFn, GitCommitMessageFn, GitPushCommandFn, LumpVariables, Maybe, MaybePromise, PostCommandExecFn, PromptFn, PromptFnInput, SetupFn, Step, StepVariables, Steps, TeardownFn } from '@lumpcode/core';
+import { LumpVariables, BranchFn, StepVariables, CommandFn, SetupFn, TeardownFn, ContextList, MaybePromise, PromptFnInput, PostCommandExecFn, Step, PromptFn, CodeBasePath, Maybe, Context, GetContextListFnOutput, RunLumpInput, GitAddCommitFn, GitCommitMessageFn, GitPushFn } from '@lumpcode/core';
+export { AsyncFnSuccess, BranchFn, CodeBasePath, CommandFn, Context, ContextList, ContextRunState, ContextStatus, ExtractSuccess, GetContextListFnOutput, GitAddCommitFn, GitCommitMessageFn, GitPushFn, LumpVariables, Maybe, MaybePromise, PostCommandExecFn, PromptFn, PromptFnInput, SetupFn, Step, StepVariables, Steps, TeardownFn } from '@lumpcode/core';
 import * as z from 'zod';
 
 declare function defineBranchFn<V extends LumpVariables = LumpVariables>(fn: NoInfer<BranchFn<V>>): BranchFn<V>;
@@ -72,10 +72,38 @@ type GetContextListFnInput<V extends LumpVariables = LumpVariables> = {
 };
 type GetContextListFn<V extends LumpVariables = LumpVariables> = (params: GetContextListFnInput<V>) => GetContextListFnOutput;
 
+/**
+ * How Lumpcode prepares the per-lump git workspace inside the preflight repo root.
+ *
+ * - `checkout`: switch the main worktree to a fresh lump branch (default).
+ * - `worktree`: add a linked worktree under `.lumpcode/worktrees/<branch>/`.
+ */
+type WorkspaceStrategy = 'checkout' | 'worktree';
+
+type PostSetupWorkspaceFnInput<V extends LumpVariables = LumpVariables> = {
+    baseBranch: string;
+    branchName: string;
+    contextList: ContextList;
+    /** Branch workspace. Already prepared on a real run. Read-only. */
+    workspacePath: string;
+    executionWorkspacePath: string;
+    workspaceStrategy: WorkspaceStrategy;
+    projectRoot: string;
+    lumpVariables: V;
+};
+
+type PostSetupWorkspaceFn<V extends LumpVariables = LumpVariables> = (input: PostSetupWorkspaceFnInput<V>) => MaybePromise<{
+    command?: string;
+} | void>;
+
+type PostTeardownWorkspaceFn<V extends LumpVariables = LumpVariables> = (input: PostSetupWorkspaceFnInput<V>) => MaybePromise<{
+    command?: string;
+} | void>;
+
 type LumpJsConfigSoloStep<V extends LumpVariables = LumpVariables, SV extends StepVariables = StepVariables> = LumpJsConfigStep<V, SV> | LumpJsConfigStep<V, SV>['promptTemplate'] | LumpJsConfigStep<V, SV>['promptFn'];
 type LumpJsConfig<V extends LumpVariables = LumpVariables, SV extends StepVariables = StepVariables> = MergeObjs<Omit<{
     [K in keyof RunLumpInput<V, SV>]?: NonNullable<RunLumpInput<V, SV>[K]> extends Function ? (RunLumpInput<V, SV>[K] | FilePath) : RunLumpInput<V, SV>[K];
-}, 'gitCommitMessageFn' | 'projectRoot' | 'branchFn' | 'baseBranch' | 'setupWorkspaceFn' | 'teardownWorkspaceFn' | 'gitAddCommandFn' | 'gitCommitCommandFn' | 'gitPushCommandFn' | 'getContextListFn' | 'refreshRemoteTrackingRefsFn'>, {
+}, 'gitCommitMessageFn' | 'projectRoot' | 'branchFn' | 'baseBranch' | 'setupWorkspaceFn' | 'teardownWorkspaceFn' | 'gitAddCommitFn' | 'gitPushFn' | 'getContextListFn' | 'refreshRemoteTrackingRefsFn'>, {
     /**
      * Execution integration branch. Exact string, `BaseBranchFn`, or FilePath to a module.
      * Omit → concrete effective discovery branch. Pattern strings are rejected at resolve.
@@ -100,6 +128,20 @@ type LumpJsConfig<V extends LumpVariables = LumpVariables, SV extends StepVariab
     registerCommands?: string[];
     keepHistory?: boolean;
     verbose?: boolean;
+    /**
+     * After generated checkout/worktree setup. Mutually exclusive with
+     * `postSetupWorkspaceCommand`.
+     */
+    postSetupWorkspaceFn?: FilePath | PostSetupWorkspaceFn<V>;
+    /** Shell fragment in the branch workspace. Mutually exclusive with `postSetupWorkspaceFn`. */
+    postSetupWorkspaceCommand?: string;
+    /**
+     * Before generated workspace teardown. Mutually exclusive with
+     * `postTeardownWorkspaceCommand`.
+     */
+    postTeardownWorkspaceFn?: FilePath | PostTeardownWorkspaceFn<V>;
+    /** Shell fragment in the branch workspace. Mutually exclusive with `postTeardownWorkspaceFn`. */
+    postTeardownWorkspaceCommand?: string;
 }>;
 
 declare function defineConfig<V extends LumpVariables = LumpVariables, SV extends StepVariables = StepVariables>(config: NoInfer<LumpJsConfig<V, SV>>): LumpJsConfig<V, SV>;
@@ -110,13 +152,11 @@ declare const defineContextOptionsFn: (e: ContextOptionsFn) => ContextOptionsFn;
 
 declare function defineGetContextListFn<V extends LumpVariables = LumpVariables>(fn: NoInfer<GetContextListFn<V>>): GetContextListFn<V>;
 
-declare const defineGitAddCommandFn: (e: GitAddCommandFn) => GitAddCommandFn;
-
-declare const defineGitCommitCommandFn: (e: GitCommitCommandFn) => GitCommitCommandFn;
+declare const defineGitAddCommitFn: (e: GitAddCommitFn) => GitAddCommitFn;
 
 declare function defineGitCommitMessageFn<V extends LumpVariables = LumpVariables>(fn: NoInfer<GitCommitMessageFn<V>>): GitCommitMessageFn<V>;
 
-declare const defineGitPushCommandFn: (e: GitPushCommandFn) => GitPushCommandFn;
+declare const defineGitPushFn: (e: GitPushFn) => GitPushFn;
 
 declare function definePostCommandExecFn<V extends LumpVariables = LumpVariables, SV extends StepVariables = StepVariables>(fn: NoInfer<LumpJsConfigPostCommandExecFn<V, SV>>): LumpJsConfigPostCommandExecFn<V, SV>;
 
@@ -144,6 +184,7 @@ type LumpJsonConfig<V extends LumpVariables = LumpVariables, SV extends StepVari
 
 declare const resolvedProjectLocalConfigSchema: z.ZodObject<{
     verbose: z.ZodOptional<z.ZodBoolean>;
+    refreshCommand: z.ZodOptional<z.ZodString>;
     command: z.ZodOptional<z.ZodString>;
     maximumNumberOfConcurrentBranches: z.ZodOptional<z.ZodNumber>;
     keepHistory: z.ZodOptional<z.ZodBoolean>;
@@ -168,7 +209,7 @@ type ResolvedProjectLocalConfig = z.infer<typeof resolvedProjectLocalConfigSchem
  * Shape of `.lumpcode/local.json` — Pick from resolved config.
  * `mode` is required on the file schema; other keys optional.
  */
-type LocalJsonConfig = Pick<ResolvedProjectLocalConfig, 'mode' | 'workspaceStrategy' | 'disabled' | 'maxParallelRun' | 'primaryBranch' | 'primaryBranches' | 'projectBaseBranch' | 'command' | 'maximumNumberOfConcurrentBranches' | 'keepHistory' | 'verbose'>;
+type LocalJsonConfig = Pick<ResolvedProjectLocalConfig, 'mode' | 'workspaceStrategy' | 'disabled' | 'maxParallelRun' | 'primaryBranch' | 'primaryBranches' | 'projectBaseBranch' | 'command' | 'maximumNumberOfConcurrentBranches' | 'keepHistory' | 'verbose' | 'refreshCommand'>;
 
 /**
  * Shape of `.lumpcode/local.json` — alias of {@link LocalJsonConfig}.
@@ -190,12 +231,12 @@ type Mode = 'shared' | 'dedicated';
  * Shape of `.lumpcode/project.json` — Pick from resolved config.
  * `projectName` is required on the file schema; other keys optional.
  */
-type ProjectJsonConfig = Pick<ResolvedProjectLocalConfig, 'projectName' | 'primaryBranch' | 'primaryBranches' | 'projectBaseBranch' | 'command' | 'maximumNumberOfConcurrentBranches' | 'keepHistory'>;
+type ProjectJsonConfig = Pick<ResolvedProjectLocalConfig, 'projectName' | 'primaryBranch' | 'primaryBranches' | 'projectBaseBranch' | 'command' | 'maximumNumberOfConcurrentBranches' | 'keepHistory' | 'refreshCommand'>;
 
 /**
  * Shape of `.lumpcode/project.json` — alias of {@link ProjectJsonConfig}.
  */
 type ProjectConfig = ProjectJsonConfig;
 
-export { defineBranchFn, defineCommand, defineCommandModule, defineCommandSetup, defineCommandTeardown, defineConfig, defineContextMatchFn, defineContextOptionsFn, defineGetContextListFn, defineGitAddCommandFn, defineGitCommitCommandFn, defineGitCommitMessageFn, defineGitPushCommandFn, definePostCommandExecFn, definePromptFn, defineSetupFn, defineStep, defineTeardownFn };
-export type { BaseBranchFn, BaseBranchFnInput, CommandModule, CommandTag, ContextMatchFn, ContextOptionsFn, FilePath, FilePathOrString, GetContextListFn, GetContextListFnInput, LocalConfig, LumpJsConfig, LumpJsConfigPostCommandExecFn, LumpJsConfigStep, LumpJsConfigSteps, LumpJsConfigStepsFn, LumpJsConfigStepsItem, LumpJsonConfig, LumpJsonConfigStep, MergeObjs, Mode, ProjectConfig, StepFn };
+export { defineBranchFn, defineCommand, defineCommandModule, defineCommandSetup, defineCommandTeardown, defineConfig, defineContextMatchFn, defineContextOptionsFn, defineGetContextListFn, defineGitAddCommitFn, defineGitCommitMessageFn, defineGitPushFn, definePostCommandExecFn, definePromptFn, defineSetupFn, defineStep, defineTeardownFn };
+export type { BaseBranchFn, BaseBranchFnInput, CommandModule, CommandTag, ContextMatchFn, ContextOptionsFn, FilePath, FilePathOrString, GetContextListFn, GetContextListFnInput, LocalConfig, LumpJsConfig, LumpJsConfigPostCommandExecFn, LumpJsConfigStep, LumpJsConfigSteps, LumpJsConfigStepsFn, LumpJsConfigStepsItem, LumpJsonConfig, LumpJsonConfigStep, MergeObjs, Mode, PostSetupWorkspaceFn, PostSetupWorkspaceFnInput, PostTeardownWorkspaceFn, ProjectConfig, StepFn };

package/dist/index.js

@@ -34,15 +34,13 @@ function defineGetContextListFn(fn) {
     return fn;
 }
 
-const defineGitAddCommandFn = (identity);
-
-const defineGitCommitCommandFn = (identity);
+const defineGitAddCommitFn = (identity);
 
 function defineGitCommitMessageFn(fn) {
     return fn;
 }
 
-const defineGitPushCommandFn = (identity);
+const defineGitPushFn = (identity);
 
 function definePostCommandExecFn(fn) {
     return fn;
@@ -64,4 +62,4 @@ function defineTeardownFn(fn) {
     return fn;
 }
 
-export { defineBranchFn, defineCommand, defineCommandModule, defineCommandSetup, defineCommandTeardown, defineConfig, defineContextMatchFn, defineContextOptionsFn, defineGetContextListFn, defineGitAddCommandFn, defineGitCommitCommandFn, defineGitCommitMessageFn, defineGitPushCommandFn, definePostCommandExecFn, definePromptFn, defineSetupFn, defineStep, defineTeardownFn };
+export { defineBranchFn, defineCommand, defineCommandModule, defineCommandSetup, defineCommandTeardown, defineConfig, defineContextMatchFn, defineContextOptionsFn, defineGetContextListFn, defineGitAddCommitFn, defineGitCommitMessageFn, defineGitPushFn, definePostCommandExecFn, definePromptFn, defineSetupFn, defineStep, defineTeardownFn };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumpcode/cli-types",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "description": "Types and defineX helpers for Lumpcode CLI lump config and command modules",
   "keywords": [
     "lumpcode",
@@ -37,7 +37,7 @@
     "build": "rollup -c"
   },
   "dependencies": {
-    "@lumpcode/core": "^0.1.1"
+    "@lumpcode/core": "^0.3.0"
   },
   "devDependencies": {
     "@rollup/plugin-commonjs": "^28.0.1",