@gitkraken/compose-tools 0.1.0

package/dist/workflows/undo.d.ts

@@ -0,0 +1,56 @@
+import { ComposeGitPort } from "../ports/git.js";
+import { UndoId, UndoResult, UndoValidation } from "@gitkraken/shared-tools";
+
+//#region src/workflows/undo.d.ts
+interface UndoComposeInput {
+  git: ComposeGitPort;
+  /** The undo ID returned by `compose()` or `split()`. */
+  undoId: UndoId;
+  /**
+   * When true, downgrades `branch_has_new_commits` blockers to warnings and
+   * proceeds. The `dirty_workdir` blocker is never force-able.
+   */
+  force?: boolean;
+  /** Called before each undo step with a human-readable description. */
+  onProgress?: (step: string) => void;
+  /** Optional cancellation signal. Forwarded to every git operation. */
+  signal?: AbortSignal;
+}
+interface ValidateUndoComposeInput {
+  git: ComposeGitPort;
+  /** The undo ID to validate. */
+  undoId: UndoId;
+  /** Optional cancellation signal. Forwarded to every git operation. */
+  signal?: AbortSignal;
+}
+/**
+ * Validate whether undoing a compose/split operation can safely proceed.
+ *
+ * Returns blockers (hard stops) and warnings (notable conditions). Does not
+ * mutate the repository. Use this for dry-run checks before {@link undoCompose}.
+ */
+declare function validateUndoCompose(input: ValidateUndoComposeInput): Promise<UndoValidation>;
+/**
+ * Reverse a previous `compose()` or `split()` operation.
+ *
+ * Loads the undo manifest persisted during the original operation, validates
+ * that the undo can proceed safely, then surgically reverses only the git
+ * mutations that were recorded. Returns a structured {@link UndoResult}.
+ *
+ * Safety:
+ * - Refuses to proceed when the working directory has uncommitted changes.
+ * - Refuses when a branch created by the operation has been modified since
+ *   (unless `force` is set).
+ * - Best-effort on working directory restoration from stash backup.
+ */
+declare function undoCompose(input: UndoComposeInput): Promise<UndoResult>;
+/**
+ * List all undo manifest IDs stored in this repository.
+ *
+ * Returns IDs for all workflows that used the shared undo infrastructure
+ * (compose, split, and any future packages). Each ID can be passed to
+ * {@link validateUndoCompose} or {@link undoCompose}.
+ */
+declare function listUndoIds(git: ComposeGitPort, signal?: AbortSignal): Promise<UndoId[]>;
+//#endregion
+export { UndoComposeInput, ValidateUndoComposeInput, listUndoIds, undoCompose, validateUndoCompose };

package/dist/workflows/undo.js

@@ -0,0 +1 @@
+import{requireExec as e}from"../git/require-exec.js";import{UndoStore as t,undoOperation as n,validateUndo as r}from"@gitkraken/shared-tools";async function i(t){return r({git:e(t.git,`undo validation`),manifestId:t.undoId,signal:t.signal})}async function a(t){return n({git:e(t.git,`undo execution`),manifestId:t.undoId,force:t.force,onProgress:t.onProgress,signal:t.signal})}async function o(n,r){return new t(e(n,`undo listing`)).list({signal:r})}export{o as listUndoIds,a as undoCompose,i as validateUndoCompose};

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@gitkraken/compose-tools",
+  "version": "0.1.0",
+  "description": "AI-powered organization of git changes into clean, atomic commits and branches.",
+  "license": "SEE LICENSE IN LICENSE",
+  "author": "Axosoft, LLC dba GitKraken",
+  "engines": {
+    "node": ">= 22"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "dependencies": {
+    "zod": "^4.3.6",
+    "@gitkraken/shared-tools": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.1"
+  },
+  "scripts": {
+    "build": "tsdown --config-loader=unrun",
+    "build:dev": "tsdown --config tsdown.dev.config.ts --config-loader=unrun",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}