@cat-factory/orchestration 0.294.0 → 0.296.0

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/modules/bootstrap/BootstrapService.d.ts

@@ -1,13 +1,23 @@
-import type { BootstrapFailureKind, BootstrapJob, BootstrapRepoInput, CreateReferenceArchitectureInput, ReferenceArchitecture, UpdateReferenceArchitectureInput } from '@cat-factory/kernel';
+import type { AdoptionReviewInput, BootstrapFailureKind, BootstrapJob, BootstrapRepoInput, CreateReferenceArchitectureInput, ReferenceArchitecture, UpdateReferenceArchitectureInput } from '@cat-factory/kernel';
 import type { Clock, IdGenerator } from '@cat-factory/kernel';
 import type { BlockRepository, ServiceFragmentDefaultsRepository, ServiceRepository, WorkspaceMountRepository, WorkspaceRepository } from '@cat-factory/kernel';
 import type { BootstrapJobRepository, ReferenceArchitectureRepository } from '@cat-factory/kernel';
 import type { RepoBootstrapper } from '@cat-factory/kernel';
 import type { BootstrapRunner } from '@cat-factory/kernel';
 import type { ExecutionEventPublisher } from '@cat-factory/kernel';
-/** The poll's terminal-ness, returned to the durable driver so it knows when to stop. */
+import type { Logger } from '@cat-factory/kernel';
+import { type MonorepoBootstrapDeps } from './MonorepoBootstrapController.js';
+/**
+ * The poll's terminal-ness, returned to the durable driver so it knows when to stop.
+ *
+ * `awaiting_review` is a STOP that is not an end: the monorepo flow's survey has parked the run
+ * on a human decision, so the driver returns (a park can last days, and holding a Workflows
+ * instance or a pg-boss job open across it buys nothing) and the review's own resume starts a
+ * fresh drive. Kept distinct from `done` because the run has produced no service yet: a caller
+ * that collapsed the two would report a bootstrap as finished with nothing committed.
+ */
 export interface BootstrapPollResult {
-    state: 'running' | 'done' | 'failed';
+    state: 'running' | 'awaiting_review' | 'done' | 'failed';
     /** Present when `state === 'failed'`. */
     error?: string;
 }
@@ -45,9 +55,22 @@ export interface BootstrapServiceDependencies {
      * blueprint-only pipeline; absent in tests / when blueprints aren't configured.
      */
     onBootstrapSucceeded?: (workspaceId: string, blockId: string) => Promise<void>;
+    /**
+     * The monorepo flow's collaborators (checkout-free reads, the adoption advisor, the budget
+     * probe). Absent ⇒ a request naming a `monorepo` target is refused with a 503, because
+     * `resolveTarget` cannot pre-flight the target directory without the reader; a plain new-repo
+     * bootstrap is unaffected, which is what keeps the two flows independently wireable.
+     */
+    monorepo?: Omit<MonorepoBootstrapDeps, 'clock' | 'logger'>;
+    /** Facade logger; the survey's reads and drops are otherwise unowned. */
+    logger?: Logger;
 }
 export declare class BootstrapService {
     private readonly deps;
+    /** The monorepo flow's decisions; a plain new-repo run never reaches it. */
+    private readonly monorepo;
+    /** Normalised once, so the best-effort paths stay unit-testable with no logger wired. */
+    private readonly log;
     constructor(deps: BootstrapServiceDependencies);
     /** True when a bootstrap run can actually be performed (the bootstrapper is wired). */
     get canBootstrap(): boolean;
@@ -106,9 +129,74 @@ export declare class BootstrapService {
         reason?: string;
         kind?: BootstrapFailureKind;
     }): Promise<BootstrapJob>;
+    /**
+     * The durable-driver key a run is CURRENTLY driven under, for the stale-run sweeper.
+     *
+     * The sweeper reads `agent_runs` generically and only ever learns a run's id, but a monorepo
+     * run in its apply phase is driven under a different key, so probing and re-driving it by run
+     * id would find no instance and finalize a perfectly healthy run as an orphan. Falls back to
+     * the run id for a run it cannot read, which is the key every single-drive run uses.
+     */
+    driveIdOf(workspaceId: string, jobId: string): Promise<string>;
+    /**
+     * The SURVEY phase, run on the durable driver's first poll: read the monorepo and the
+     * reference template, ask the advisor what the new service should adopt from each, and park
+     * the run on the human decision.
+     *
+     * It never fails the run. A missing model, an unreadable repository or an unusable reply all
+     * park with a plan recorded `unavailable` and the cause, because the DECISION is the point of
+     * the phase and the suggestion is only an aid: a human bootstrapping into a monorepo on a
+     * deployment with no model still gets to make the call, unaided and told so.
+     *
+     * Guarded by an ATOMIC CLAIM taken BEFORE the model call, not by the plan written after it. A
+     * stored plan short-circuits a LATER drive, but two drives racing the FIRST one both read no
+     * plan, and the survey's cost is a vendor call plus a `park` that would replace the plan under
+     * a reviewer already looking at the other one (whose answers then 422). `claimSurvey` is one
+     * conditional UPDATE, so exactly one drive proceeds and the loser leaves the run alone.
+     */
+    private runSurvey;
+    /** Record the plan, flip the run + its frame to "waiting for you", and announce it. */
+    private park;
+    /**
+     * Settle a parked run's adoption decisions and resume it.
+     *
+     * The refusals are the interesting half. A run that is not parked is a 409 naming where it
+     * actually is (the reviewer is looking at a stale tab, and applying their answers to a run
+     * that has moved on would build under a review given for a different proposal), and an
+     * incomplete or mismatched set of choices is a 422 from `resolveAdoptionReview`, never a
+     * silent fill from the recommendation, which would erase the difference between a human
+     * agreeing with the suggestion and never having read it.
+     */
+    submitAdoptionReview(workspaceId: string, jobId: string, input: AdoptionReviewInput, reviewedByUserId: string | null): Promise<BootstrapJob>;
+    /**
+     * The APPLY phase: dispatch the container that writes the service into the monorepo under the
+     * settled decisions and opens the pull request.
+     *
+     * Its own drive id, because this is the run's SECOND durable drive: the survey's already went
+     * terminal, and neither facade's driver can be re-keyed on a key that has (a Workflows
+     * instance id cannot be recreated; a pg-boss singleton would dedupe against the finished job).
+     */
+    private dispatchApply;
+    /**
+     * Finish a monorepo apply: bind the frame's service to the monorepo AT ITS DIRECTORY and
+     * report the pull request.
+     *
+     * A completed apply with NO pull request is a failure, not a success with a null field: the
+     * deliverable of a monorepo bootstrap is the PR (nothing is merged for the reviewer), so a run
+     * that reports done without one has left the work somewhere nobody can find it. Failing here
+     * says that, where marking the frame ready would claim a service that does not exist.
+     */
+    private finishMonorepoApply;
     /** The workspace default fragment ids a new service inherits; empty / never throws. */
     private defaultServiceFragmentIds;
-    /** Create the provisional, in-progress service frame a bootstrap run materialises. */
+    /**
+     * Create the provisional, in-progress service frame a bootstrap run materialises.
+     *
+     * A monorepo run's frame carries its `directory` from the start, while the repo binding waits
+     * for the run to succeed exactly as the new-repo path's does: the directory is a fact the
+     * pre-flight already settled (and what the board card is about), whereas the linkage is a
+     * claim that there is code there, which is only true once the pull request exists.
+     */
     private createServiceFrame;
     /** Flip a bootstrap's frame to a terminal status + description; null-safe. */
     private markFrame;

package/dist/modules/bootstrap/BootstrapService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BootstrapService.d.ts","sourceRoot":"","sources":["../../../src/modules/bootstrap/BootstrapService.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"BootstrapService.d.ts","sourceRoot":"","sources":["../../../src/modules/bootstrap/BootstrapService.ts"],"names":[],"mappings":"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"}