@bakers-build/conductor 0.0.0-stage → 0.1.0-next.42

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 keytec GmbH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,5 @@
-# Temporary Holding Version
+# @bakers-build/conductor
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+bakers.build conductor engine + CLI: registers, claims tickets via JSON:API, dispatches agents.
+
+Part of the bakers.build CLI. Install the meta package `@bakers-build/bakers` to get the `bakers` CLI with all addons. Source: https://git.key-tec.de/bakers-build/bakers-build (bakers-cli/).

package/dist/src/bakers-project-context.d.ts

@@ -0,0 +1,12 @@
+import type { JsonApiClient } from 'dropsh/plugin';
+import type { BbProjectSelection } from './cli/project-context.js';
+export interface ResolvedBbProjectContext {
+    projectId: string;
+    project: string;
+    workspaceId: string;
+    workspace: string;
+}
+export declare class AmbiguousProjectNameError extends Error {
+    readonly name = "AmbiguousProjectNameError";
+}
+export declare function resolveBbProjectContext(client: JsonApiClient, selection: BbProjectSelection): Promise<ResolvedBbProjectContext>;

package/dist/src/bakers-project-context.js

@@ -0,0 +1,59 @@
+export class AmbiguousProjectNameError extends Error {
+    name = 'AmbiguousProjectNameError';
+}
+export async function resolveBbProjectContext(client, selection) {
+    let selectedWorkspace;
+    if (selection.workspace) {
+        const workspaces = await client
+            .collection('bb_workspace')
+            .where('name', '=', selection.workspace)
+            .page(2)
+            .list();
+        const matchingWorkspace = workspaces[0];
+        if (workspaces.length !== 1 || !matchingWorkspace) {
+            const reachable = await client
+                .collection('bb_workspace')
+                .page(100)
+                .list();
+            const names = reachable.map((row) => row.attr('name') ?? row.id);
+            throw new Error(`${workspaces.length ? 'Ambiguous' : 'Unknown'} workspace "${selection.workspace}". Reachable workspaces: ${names.join(', ') || '(none)'}.`);
+        }
+        selectedWorkspace = { id: matchingWorkspace.id, name: selection.workspace };
+    }
+    let query = client
+        .collection('bb_project')
+        .where('name', '=', selection.project);
+    if (selectedWorkspace)
+        query = query.where('group_id.workspace_id.id', '=', selectedWorkspace.id);
+    const projects = await query.page(2).list();
+    if (projects.length === 0) {
+        const reachable = selectedWorkspace
+            ? selectedWorkspace.name
+            : (await client.collection('bb_workspace').page(100).list())
+                .map((row) => row.attr('name') ?? row.id)
+                .join(', ');
+        throw new Error(`bakers.build project "${selection.project}" not found. Reachable workspaces: ${reachable || '(none)'}.`);
+    }
+    const contexts = await Promise.all(projects.map(async (project) => {
+        const groupId = project.rel('group_id');
+        if (!groupId)
+            throw new Error(`bakers.build project "${selection.project}" has no owning group.`);
+        const group = await client.resource('bb_group', groupId);
+        const workspaceId = group.rel('workspace_id');
+        if (!workspaceId)
+            throw new Error(`bakers.build project "${selection.project}" has no owning workspace.`);
+        const workspace = await client.resource('bb_workspace', workspaceId);
+        return {
+            projectId: project.id,
+            project: selection.project,
+            workspaceId,
+            workspace: workspace.attr('name') ?? workspaceId,
+        };
+    }));
+    if (contexts.length > 1)
+        throw new AmbiguousProjectNameError(`bakers.build project "${selection.project}" is ambiguous: ${contexts.map((row) => `${row.workspace}/${row.project} (${row.projectId})`).join(', ')}. Commit bakers.workspace to disambiguate.`);
+    const context = contexts[0];
+    if (!context)
+        throw new Error(`bakers.build project "${selection.project}" not found.`);
+    return context;
+}

package/dist/src/cli/config-plan.d.ts

@@ -0,0 +1,35 @@
+import { type ConfigInventoryOptions, type ConfigReport } from '@bakers-build/core';
+import { type ConnectionAuthType } from './config-templates.js';
+export interface ConfigPlanOptions extends ConfigInventoryOptions {
+    inputs?: {
+        machineId?: string;
+        userId?: string;
+        maxParallel?: number;
+        baseUrl?: string;
+        clientId?: string;
+        secret?: string;
+        workspaceId?: string;
+        workspace?: string;
+        authType?: ConnectionAuthType;
+        /** The operator's own answer for each lifecycle hook; bakers-cli names no provisioning tool. */
+        hooks?: {
+            after_create?: string;
+            after_done?: string;
+        };
+    };
+}
+export interface ConfigWrite {
+    path: string;
+    before: string | null;
+    after: string | null;
+    mode: number;
+}
+/** Only report is safe to serialize. Writes contain private source text. */
+export interface ConfigPlan {
+    report: ConfigReport;
+    writes: ConfigWrite[];
+    fingerprints: Map<string, string | null>;
+}
+/** Inventory, transform in memory, validate the complete proposed installation. */
+export declare function planConfig(options?: ConfigPlanOptions): ConfigPlan;
+export declare function applyConfigPlan(plan: ConfigPlan): ConfigReport;