toolroll 0.9.61 → 0.9.63

package/dist/landed-cleanup.d.ts

@@ -1,5 +1,6 @@
-import { type ExecResult } from "./exec.js";
+import type { RemoteMainRead, RemoteMains } from "./remote-main.js";
 import type { Store } from "./store.js";
+import { type Git } from "./teardown-git.js";
 import { type Runner, type WorktreePool } from "./worktree.js";
 /** `storage clean --landed` takes only what has waited at least this long. */
 export declare const BACKLOG_DAYS = 7;
@@ -10,13 +11,16 @@ export declare const LANDED_CLEANED_ACTION = "landed work cleaned up";
 /** Reconcile looks at most this many results and finishes at most this many items a pass; the pass by hand has no cap. */
 export declare const AUTO_LOOKS = 20;
 export declare const AUTO_ITEMS = 40;
-export type Git = (cwd: string, args: readonly string[]) => Promise<ExecResult>;
+export type { Git };
+/** Landed cleanup's git, reads and teardown alike: always the hardened teardown helper (teardown-git.ts). */
 export declare function gitOf(runner?: Runner): Git;
 export type LandedHow = "merged" | "in-main" | "content-in-main";
+/** `trusted`: it may complete a task automatically (a recorded merge, or the recorded remote's main). */
 export type LandedProof = {
     landed: true;
     how: LandedHow;
     reason: string;
+    trusted: boolean;
 } | {
     landed: false;
     why: string;
@@ -28,10 +32,17 @@ export type PullRequestFact = {
     number: number | null;
 };
 /**
- * Whether this commit's work landed, read from what Toolroll recorded and the local repository only. Fails closed:
- * every doubt is "not proven", with the reason in a few words.
+ * Whether this commit's work landed, read from what Toolroll recorded and the local repository. Fails closed: every
+ * doubt is "not proven", with the reason in a few words. Only a recorded merge is trusted to complete a task: a build
+ * can write the local main.
  */
 export declare function landedProof(git: Git, repo: string, head: string | null, pullRequest?: PullRequestFact | null): Promise<LandedProof>;
+/**
+ * The proof automatic completion trusts: a recorded merge of this exact commit, or its work in the main of the
+ * project's recorded remote, compared only in the private directory that main was fetched into. `remote` is read only
+ * when no recorded merge settles it.
+ */
+export declare function remoteLandedProof(remote: () => Promise<RemoteMainRead>, repo: string, head: string | null, pullRequest?: PullRequestFact | null): Promise<LandedProof>;
 export type LandedTarget = {
     kind: "checkout" | "branch";
     target: string;
@@ -54,6 +65,8 @@ export type LandedCandidate = {
     completes: boolean;
     how: LandedHow;
     reason: string;
+    /** Proven by a recorded merge or the recorded remote's main: only then may it complete. */
+    trusted: boolean;
     targets: LandedTarget[];
     keeps: LandedKeep[];
 };
@@ -62,7 +75,7 @@ export type LandedCandidate = {
  * `limit` caps how many results are read against git (reconcile's bound; results read before and unchanged since
  * don't count); `before` takes only results finished before it (the one-time pass's seven days).
  */
-export declare function landedResults(store: Store, git: Git, repo: string, root: string, now: Date, options?: {
+export declare function landedResults(store: Store, git: Git, remotes: RemoteMains, repo: string, root: string, now: Date, options?: {
     limit?: number;
     before?: string;
     memo?: boolean;
@@ -104,9 +117,10 @@ export type LandedStep = {
 /**
  * Finish what teardowns intended: pending items, oldest first (checkouts before branches). Each is checked again
  * right before it goes, and recorded right after. Doubt leaves it pending for the next pass; a branch that moved, or
- * a result that has newer work, is kept for good. `only` limits it to these teardowns.
+ * a result that has newer work, is kept for good. `limit` caps the items settled (removed, already gone or kept), so
+ * items left waiting never crowd out later ones. `only` limits it to these teardowns.
  */
-export declare function finishLanded(store: Store, pool: WorktreePool, git: Git, now: () => Date, options?: {
+export declare function finishLanded(store: Store, pool: WorktreePool, git: Git, remotes: RemoteMains, now: () => Date, options?: {
     repo?: string;
     limit?: number;
     only?: ReadonlySet<number>;
@@ -115,7 +129,7 @@ export declare function finishLanded(store: Store, pool: WorktreePool, git: Git,
  * Reconcile's part: finish teardowns a crash cut short, then find newly landed results (a bounded few), mark them
  * complete and tear them down.
  */
-export declare function reconcileLanded(store: Store, pool: WorktreePool, git: Git, repo: string, root: string, now: () => Date): Promise<{
+export declare function reconcileLanded(store: Store, pool: WorktreePool, git: Git, remotes: RemoteMains, repo: string, root: string, now: () => Date): Promise<{
     completed: string[];
     steps: LandedStep[];
 }>;
@@ -142,15 +156,15 @@ export type LandedPlan = {
 };
 /**
  * What `storage clean --landed` would do now, across every project: landed results finished at least a week ago,
- * and Toolroll's own branches (toolroll/, toolroll-plan/, standing-orders/) no task uses whose last commit is at
- * least a week old and landed in main. Reads only.
+ * and branches Toolroll created (toolroll/, toolroll-plan/, standing-orders/) at least a week ago that no task uses
+ * and that landed in main. Reads only.
  */
-export declare function landedBacklog(store: Store, git: Git, root: string, now: Date, options?: {
+export declare function landedBacklog(store: Store, git: Git, remotes: RemoteMains, root: string, now: Date, options?: {
     repos?: readonly string[];
 }): Promise<LandedPlan>;
 /** Act on a preview: record every teardown first, then carry them out. Refuses nothing it previewed silently: what
  * changed since is reported as kept. */
-export declare function cleanLandedBacklog(store: Store, pool: WorktreePool, git: Git, root: string, now: () => Date, plan: LandedPlan, actor: string): Promise<{
+export declare function cleanLandedBacklog(store: Store, pool: WorktreePool, git: Git, remotes: RemoteMains, root: string, now: () => Date, plan: LandedPlan, actor: string): Promise<{
     completed: string[];
     steps: LandedStep[];
     refused: LandedKeep[];