bareloop 0.32.0 → 0.34.0

package/types/userrun.d.ts

@@ -48,6 +48,11 @@ export type Deps = {
      * even when `env` is injected; production never sets it.
      */
     keysHome?: string | undefined;
+    /**
+     * the command this run was actually reached through (`src/invoke.js`);
+     * `src/cli.js` passes `'bareloop run-u'`, `scripts/run-u.mjs` passes none.
+     */
+    invokedAs?: string | undefined;
     out?: ((s: string) => void) | undefined;
     err?: ((s: string) => void) | undefined;
     /**
@@ -65,6 +70,45 @@ export type Deps = {
      */
     runlistHome?: string | undefined;
 };
+/**
+ * The one-runner door's hand-in (`src/bundlerun.js`, the exported bundle's `bareloop run`):
+ * where a bundle run's books live and how it prints its own re-invocation. Set ONLY by
+ * that caller through `startRun`/`resumeRun` opts, in-process — `main`'s argv never builds
+ * it, so a local job cannot reach it. Absent, every use below is today's expression.
+ */
+export type BundleRun = {
+    /**
+     * the run id (also the `runs/<runid>` directory name)
+     */
+    runid: string;
+    /**
+     * `<bundle>/runs/<runid>`: spine.jsonl, gate-audit.jsonl and close/ live here
+     */
+    runDir: string;
+    /**
+     * the bare re-invocation prefix printed in resume hints (`bareloop run <bundle> --repo <path>`), no ceiling flags
+     */
+    invoke: string;
+    /**
+     * the ceilings the person tightened on THIS leg; printed after `invoke` on every resume line except a money halt's (which never prints the exhausted `--budget`)
+     */
+    tightened: {
+        budgetUsd?: number;
+        wallMin?: number;
+    };
+    /**
+     * the bundle's SIGNED spec budgetUsd (the tightened leg ceiling is `spec.budgetUsd`); printed only, never enforced from here
+     */
+    signedBudgetUsd: number;
+    /**
+     * the hash printed after `--approve` in those hints (the bundle's, not the run spec's)
+     */
+    printApprove: string;
+    /**
+     * creates the run's tree (fresh worktree) and its books; the engine calls it once every $0 refusal has passed, so a refusal leaks nothing
+     */
+    prepareTree: () => void;
+};
 export type RunOpts = {
     /**
      * the parsed, not-yet-validated job spec — read by
@@ -136,6 +180,10 @@ export type RunOpts = {
      * how a "go edit the spec" hint should read
      */
     specDesc?: string | undefined;
+    /**
+     * set only by the bundle door (see `BundleRun`)
+     */
+    bundle?: BundleRun | undefined;
     deps?: Deps | undefined;
 };
 export type RunCtx = {
@@ -159,5 +207,6 @@ export type RunCtx = {
     door: string | null;
     decide: string | null;
     text: string | null;
+    bundle?: BundleRun | undefined;
     deps: Deps;
 };