@abloh/cli 0.1.4 → 1.0.0

package/dist/index.d.ts

@@ -5,5 +5,30 @@ declare function gitMergeBase(cwd: string, base: string, head: string): Promise<
  * verify each ref resolves to a commit in the target repo before any work starts.
  */
 declare function assertCommitRef(cwd: string, flag: string, ref: string): Promise<void>;
+/**
+ * Make `--base` usable before anything is checked against it, deepening a shallow checkout when
+ * that is what stands in the way.
+ *
+ * Runs BEFORE assertCommitRef and gitMergeBase, and it is the reason those two now describe a
+ * repository that could not be repaired rather than one that merely arrived incomplete. A checkout
+ * that already holds the base pays one `cat-file` and one `merge-base` for this, and touches no
+ * network; a depth-1 CI clone pays a bounded fetch and then runs.
+ *
+ * TWO CAUSES ARE PASSED THROUGH, and they are the two where nothing was attempted: a name this
+ * checkout does not have (`unknown-ref`), and a base that does not resolve in a repository with no
+ * remote. Both are the flag's own story, and `--base ref not found in <dir>: <ref>` names the flag
+ * the customer typed, which is the better sentence. Every other cause has already had its bounded
+ * repair tried and failed, so its remedy is the one to raise.
+ */
+declare function ensureBaseUsable(cwd: string, base: string, head: string, onProgress?: (line: string) => void): Promise<void>;
+
+/**
+ * The longest of the baseline's runs, in milliseconds, or undefined when there was no baseline.
+ *
+ * THE LONGEST rather than the mean, because this feeds a DEADLINE: a deadline set from an average
+ * is one half the observations already exceed. `--skip-baseline` leaves it undefined, and the
+ * engine then keeps its own default rather than deriving from a number nobody measured.
+ */
+declare function longestBaselineRunMs(durationsMs: readonly number[] | undefined): number | undefined;
 
-export { assertCommitRef, gitMergeBase, gitRevParse };
+export { assertCommitRef, ensureBaseUsable, gitMergeBase, gitRevParse, longestBaselineRunMs };