@bakers-build/addon-info 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/addon-info
 
-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 info: resolved project and workspace context for an agent the conductor did not start (BB-495).
+
+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/index.d.ts

@@ -0,0 +1,5 @@
+import type { BbCommandPlugin } from '@bakers-build/core';
+declare const infoCommand: BbCommandPlugin;
+export default infoCommand;
+export type { BbInfoResult, ResolveBbInfoOptions } from './info.js';
+export { resolveBbInfo } from './info.js';

package/dist/src/index.js

@@ -0,0 +1,27 @@
+import { resolveBbInfo } from './info.js';
+const infoCommand = {
+    kind: 'command',
+    name: 'info',
+    describe: 'print the resolved project and workspace context as JSON',
+    register(program, host) {
+        program
+            .command('info')
+            .description('Print the resolved project and workspace context (BB-495) as JSON')
+            .option('--config <path>', 'connection config path')
+            .option('--connection <id>', 'named connection from ~/.bakers/connections')
+            .action(async (options) => {
+            const result = await resolveBbInfo({
+                host,
+                ...(options.config !== undefined
+                    ? { explicitConfig: options.config }
+                    : {}),
+                ...(options.connection !== undefined
+                    ? { connection: options.connection }
+                    : {}),
+            });
+            process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+        });
+    },
+};
+export default infoCommand;
+export { resolveBbInfo } from './info.js';

package/dist/src/info.d.ts

@@ -0,0 +1,31 @@
+import { type BbCommandHost } from '@bakers-build/core';
+/**
+ * The resolved project/workspace context (BB-495). A value that cannot be
+ * resolved is `null` (or `[]` for `workspace_ids`), never omitted — the shape
+ * is always stable, which is what lets an unattended agent parse it without a
+ * presence check per key.
+ */
+export interface BbInfoResult {
+    project: string | null;
+    project_id: string | null;
+    workspace: string | null;
+    workspace_id: string | null;
+    workspace_ids: string[];
+}
+export interface ResolveBbInfoOptions {
+    host: BbCommandHost;
+    /** Defaults to `process.env`; injectable for tests. */
+    env?: Record<string, string | undefined>;
+    cwd?: string;
+    explicitConfig?: string;
+    connection?: string;
+}
+/**
+ * Resolve the five context values BB-495 D3 gives an agent: read the
+ * reserved env vars the conductor set at dispatch first (the fast path), and
+ * for any that is unset, resolve it live over the connection — never
+ * prompting, never writing to disk. This is what `bakers info` covers: the
+ * agent that was not started by the conductor, and the shell where nothing
+ * is set.
+ */
+export declare function resolveBbInfo(opts: ResolveBbInfoOptions): Promise<BbInfoResult>;

package/dist/src/info.js

@@ -0,0 +1,97 @@
+import { resolveBbProjectContext } from '@bakers-build/conductor/contract';
+import { readBbProjectSelection } from '@bakers-build/conductor/project-context';
+import { createBbConnectionClient, discoverBbWorkspaces, loadReadyBbConnection, resolveConfigPath, } from '@bakers-build/core';
+/**
+ * Resolve the five context values BB-495 D3 gives an agent: read the
+ * reserved env vars the conductor set at dispatch first (the fast path), and
+ * for any that is unset, resolve it live over the connection — never
+ * prompting, never writing to disk. This is what `bakers info` covers: the
+ * agent that was not started by the conductor, and the shell where nothing
+ * is set.
+ */
+export async function resolveBbInfo(opts) {
+    const env = opts.env ?? process.env;
+    let project = env.BB_PROJECT ?? null;
+    let projectId = env.BB_PROJECT_ID ?? null;
+    let workspace = env.BB_WORKSPACE ?? null;
+    let workspaceId = env.BB_WORKSPACE_ID ?? null;
+    let workspaceIds = env.BB_WORKSPACE_IDS
+        ? env.BB_WORKSPACE_IDS.split(',').filter((id) => id !== '')
+        : [];
+    const loadOpts = {
+        ...(opts.cwd !== undefined ? { cwd: opts.cwd } : {}),
+        explicit: opts.explicitConfig,
+        ...(opts.connection ? { connection: opts.connection } : {}),
+    };
+    // Resolving the project layer is part of the same optional read as parsing
+    // it: standing outside any checkout is not an error here, it is the ordinary
+    // situation of someone who has a machine and a connection and no project
+    // yet. Both the failed walk and an absent file report ENOENT, so the
+    // connection-derived keys below still answer.
+    let configured;
+    try {
+        configured = readBbProjectSelection(resolveConfigPath(undefined, opts.cwd ?? process.cwd()));
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT')
+            throw error;
+    }
+    if (project === null && configured)
+        project = configured.project;
+    if (workspace === null && configured?.workspace)
+        workspace = configured.workspace;
+    if (configured?.workspace)
+        loadOpts.workspaceSelector = configured.workspace;
+    if (configured && !configured.workspace)
+        loadOpts.workspaceIdOverride = '';
+    let connection = null;
+    if (workspace === null ||
+        workspaceId === null ||
+        workspaceIds.length === 0 ||
+        (projectId === null && project !== null)) {
+        try {
+            connection = await loadReadyBbConnection(opts.host, loadOpts);
+            if (workspaceId === null)
+                workspaceId = connection.workspace_id ?? null;
+            if (workspace === null && connection.workspace_id) {
+                try {
+                    const client = await createBbConnectionClient(connection);
+                    const ws = await client.resource('bb_workspace', connection.workspace_id);
+                    workspace = ws.attr('name') ?? null;
+                }
+                catch {
+                    // Leave workspace null — the connection resolved but the resource
+                    // read did not; workspace_id/workspace_ids may still be usable.
+                }
+            }
+            if (workspaceIds.length === 0) {
+                try {
+                    const choices = await discoverBbWorkspaces(connection);
+                    workspaceIds = choices.map((c) => c.id);
+                }
+                catch {
+                    // Leave workspace_ids empty — not a hard failure for the other keys.
+                }
+            }
+        }
+        catch {
+            // No usable connection — every connection-derived key stays null/empty.
+        }
+    }
+    if (projectId === null && configured) {
+        connection ??= await loadReadyBbConnection(opts.host, loadOpts);
+        const client = await createBbConnectionClient(connection);
+        const context = await resolveBbProjectContext(client, configured);
+        projectId = context.projectId;
+        project = context.project;
+        workspaceId = context.workspaceId;
+        workspace = context.workspace;
+    }
+    return {
+        project,
+        project_id: projectId,
+        workspace,
+        workspace_id: workspaceId,
+        workspace_ids: workspaceIds,
+    };
+}

package/dist/src/preset.d.ts

@@ -0,0 +1,2 @@
+import type { BbPreset } from '@bakers-build/core';
+export declare const commands: BbPreset['commands'];

package/dist/src/preset.js

@@ -0,0 +1,8 @@
+export const commands = (acc) => [
+    ...acc,
+    {
+        name: 'info',
+        plugin: '@bakers-build/addon-info',
+        describe: 'print the resolved project and workspace context as JSON',
+    },
+];

package/package.json

@@ -1,6 +1,29 @@
 {
   "name": "@bakers-build/addon-info",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0-next.42",
+  "description": "bakers info: resolved project and workspace context for an agent the conductor did not start (BB-495).",
+  "type": "module",
+  "license": "MIT",
+  "exports": {
+    ".": "./dist/src/index.js",
+    "./preset": "./dist/src/preset.js"
+  },
+  "files": [
+    "dist/src"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://git.key-tec.de/bakers-build/bakers-build.git",
+    "directory": "bakers-cli/addons/info"
+  },
+  "dependencies": {
+    "commander": "^12.1.0"
+  },
+  "peerDependencies": {
+    "@bakers-build/conductor": "^0.1.0-next.42",
+    "@bakers-build/core": "^0.1.0-next.42"
+  }
+}