bdy 1.25.6-dev → 1.25.7-dev

package/distTs/package.json

@@ -1,7 +1,7 @@
 {
   "name": "bdy",
   "preferGlobal": false,
-  "version": "1.25.6-dev",
+  "version": "1.25.7-dev",
   "type": "commonjs",
   "license": "MIT",
   "homepage": "https://buddy.works/docs/cli",

package/distTs/src/cliCommand.js

@@ -52,11 +52,13 @@ class CliCommand extends commander_1.Command {
     hideVersionUpdate;
     agentPort;
     skipPre = false;
+    usesDefaultContext = false;
     defaultErrorFormat = 'text';
     metadata;
     constructor(name, metadata = {}) {
         super(name);
         this.metadata = metadata;
+        this.option('--context <name>', texts_1.OPTION_CONTEXT);
     }
     addOption(option) {
         if (option.long === '--format' && !option.argChoices) {

package/distTs/src/cliIndex.js

@@ -30,10 +30,19 @@ const environment_1 = __importDefault(require("./command/environment"));
 const register_1 = __importDefault(require("./command/register"));
 const mcp_1 = __importDefault(require("./command/mcp"));
 const discover_1 = __importDefault(require("./command/discover"));
+const context_1 = __importDefault(require("./command/context"));
+const input_1 = __importDefault(require("./input"));
 const cliError_1 = __importDefault(require("./cliError"));
+const cliCommand_1 = __importDefault(require("./cliCommand"));
 const texts_2 = require("./texts");
 function cliIndex() {
     const program = (0, utils_1.newCommand)('bdy', texts_1.DESC_PROGRAM);
+    program.hook('preAction', (_, command) => {
+        const options = command.optsWithGlobals();
+        input_1.default.configureContext(command instanceof cliCommand_1.default && command.usesDefaultContext
+            ? { ...options, context: 'default' }
+            : options);
+    });
     program.hook('preAction', pre_1.default);
     program.configureHelp({
         formatHelp: utils_1.formatHelp,
@@ -65,6 +74,7 @@ function cliIndex() {
     program.addCommand(api_1.default);
     program.addCommand(mcp_1.default);
     program.addCommand(discover_1.default);
+    program.addCommand(context_1.default);
     program.action((_, cmd) => {
         if (cmd.args.length > 0) {
             output_1.default.exitError(new cliError_1.default('unknown_command', (0, texts_1.ERR_COMMAND_NOT_FOUND)(cmd.args[0]), (0, texts_2.TXT_CLI_USAGE_HINT)('bdy')));

package/distTs/src/command/context/add.js

@@ -0,0 +1,38 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("../../utils");
+const input_1 = __importDefault(require("../../input"));
+const output_1 = __importDefault(require("../../output"));
+const cfg_1 = __importDefault(require("../../tunnel/cfg"));
+const cliError_1 = __importDefault(require("../../cliError"));
+const texts_1 = require("../../texts");
+const command = (0, utils_1.newCommand)('add', texts_1.DESC_CONTEXT_ADD, {
+    requiredScopes: [],
+    examples: texts_1.EXAMPLE_CONTEXT_ADD,
+    helpText: texts_1.HELP_CONTEXT_ADD,
+});
+command.skipPre = true;
+command.argument('<name>', texts_1.OPTION_CONTEXT_NAME);
+command.option('--format <text|json>', texts_1.OPTION_FORMAT);
+command.option('-w, --workspace <domain>', texts_1.OPTION_REST_API_WORKSPACE);
+command.option('-p, --project <name>', texts_1.OPTION_REST_API_PROJECT);
+command.option('--token <token>', texts_1.OPTION_CONTEXT_TOKEN);
+command.option('--api <endpoint>', texts_1.OPTION_CONTEXT_API);
+command.option('--from-link', texts_1.OPTION_CONTEXT_LINK);
+command.option('--from-git', texts_1.OPTION_CONTEXT_GIT);
+command.option('--remote <name>', texts_1.OPTION_CONTEXT_REMOTE);
+command.action((name, options) => {
+    input_1.default.contextEditableName(name);
+    if (Object.hasOwn(cfg_1.default.getContexts(), name))
+        throw new cliError_1.default('usage_error', (0, texts_1.ERR_CONTEXT_EXISTS)(name));
+    const context = input_1.default.contextDefinition(options);
+    cfg_1.default.setContext(name, context);
+    if (options.format === 'json')
+        output_1.default.json({ name, source: context.source });
+    else
+        output_1.default.normal((0, texts_1.TXT_CONTEXT_SAVED)(name));
+});
+exports.default = command;

package/distTs/src/command/context/list.js

@@ -0,0 +1,33 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("../../utils");
+const output_1 = __importDefault(require("../../output"));
+const cfg_1 = __importDefault(require("../../tunnel/cfg"));
+const texts_1 = require("../../texts");
+const command = (0, utils_1.newCommand)('list', texts_1.DESC_CONTEXT_LIST, {
+    requiredScopes: [],
+    examples: texts_1.EXAMPLE_CONTEXT_LIST,
+    helpText: texts_1.HELP_CONTEXT_LIST,
+});
+command.skipPre = true;
+command.alias('ls');
+command.option('--format <text|json>', texts_1.OPTION_FORMAT);
+command.action((options) => {
+    const builtins = ['default', 'git', 'link'];
+    const active = cfg_1.default.getActiveContext();
+    const values = [...builtins, ...Object.keys(cfg_1.default.getContexts()).sort()].map((name) => ({
+        name,
+        active: name === active,
+        builtin: builtins.includes(name),
+        source: cfg_1.default.getContext(name)?.source || 'default',
+    }));
+    if (options.format === 'json')
+        output_1.default.json(values);
+    else
+        for (const item of values)
+            output_1.default.normal(`${item.active ? '*' : ' '} ${item.name}`);
+});
+exports.default = command;

package/distTs/src/command/context/remove.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("../../utils");
+const input_1 = __importDefault(require("../../input"));
+const output_1 = __importDefault(require("../../output"));
+const cfg_1 = __importDefault(require("../../tunnel/cfg"));
+const texts_1 = require("../../texts");
+const command = (0, utils_1.newCommand)('remove', texts_1.DESC_CONTEXT_REMOVE, {
+    requiredScopes: [],
+    examples: texts_1.EXAMPLE_CONTEXT_REMOVE,
+    helpText: texts_1.HELP_CONTEXT_REMOVE,
+});
+command.skipPre = true;
+command.alias('rm');
+command.argument('<name>', texts_1.OPTION_CONTEXT_NAME);
+command.option('--format <text|json>', texts_1.OPTION_FORMAT);
+command.option('-f, --force', texts_1.OPTION_CONFIRM_FORCE);
+command.action(async (name, options) => {
+    input_1.default.contextEditableName(name);
+    cfg_1.default.getContext(name);
+    const confirmed = options.force ||
+        (await output_1.default.confirm((0, texts_1.TXT_CONTEXT_REMOVE_CONFIRM)(name), options.format === 'json'));
+    if (confirmed)
+        cfg_1.default.removeContext(name);
+    if (options.format === 'json')
+        output_1.default.json({
+            removed: confirmed ? name : null,
+            active: cfg_1.default.getActiveContext(),
+        });
+    else if (confirmed)
+        output_1.default.normal((0, texts_1.TXT_CONTEXT_REMOVED)(name));
+});
+exports.default = command;

package/distTs/src/command/context/show.js

@@ -0,0 +1,35 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("../../utils");
+const input_1 = __importDefault(require("../../input"));
+const output_1 = __importDefault(require("../../output"));
+const texts_1 = require("../../texts");
+const command = (0, utils_1.newCommand)('show', texts_1.DESC_CONTEXT_SHOW, {
+    requiredScopes: [],
+    examples: texts_1.EXAMPLE_CONTEXT_SHOW,
+    helpText: texts_1.HELP_CONTEXT_SHOW,
+});
+command.skipPre = true;
+command.argument('[name]', texts_1.OPTION_CONTEXT_NAME);
+command.option('--format <text|json>', texts_1.OPTION_FORMAT);
+command.action((name, options, cmd) => {
+    if (name)
+        input_1.default.configureContext({ ...cmd.optsWithGlobals(), context: name });
+    const result = input_1.default.showContext();
+    if (options.format === 'json')
+        output_1.default.json(result);
+    else
+        output_1.default.object({
+            [texts_1.TXT_CONTEXT_LABEL]: result.name,
+            [texts_1.TXT_CONTEXT_SOURCE_LABEL]: result.source,
+            [texts_1.TXT_CONTEXT_WORKSPACE_LABEL]: `${result.workspace || '-'} (${result.sources.workspace || '-'})`,
+            [texts_1.TXT_CONTEXT_PROJECT_LABEL]: `${result.project || '-'} (${result.sources.project || '-'})`,
+            [texts_1.TXT_CONTEXT_API_LABEL]: `${result.api} (${result.sources.api})`,
+            [texts_1.TXT_CONTEXT_REMOTE_LABEL]: result.remote || '-',
+            [texts_1.TXT_CONTEXT_TOKEN_LABEL]: `${result.token.available ? texts_1.TXT_CONTEXT_TOKEN_AVAILABLE : texts_1.TXT_CONTEXT_TOKEN_MISSING} (${result.token.source || '-'})`,
+        });
+});
+exports.default = command;

package/distTs/src/command/context/use.js

@@ -0,0 +1,25 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("../../utils");
+const output_1 = __importDefault(require("../../output"));
+const cfg_1 = __importDefault(require("../../tunnel/cfg"));
+const texts_1 = require("../../texts");
+const command = (0, utils_1.newCommand)('use', texts_1.DESC_CONTEXT_USE, {
+    requiredScopes: [],
+    examples: texts_1.EXAMPLE_CONTEXT_USE,
+    helpText: texts_1.HELP_CONTEXT_USE,
+});
+command.skipPre = true;
+command.argument('<name>', texts_1.OPTION_CONTEXT_NAME);
+command.option('--format <text|json>', texts_1.OPTION_FORMAT);
+command.action((name, options) => {
+    cfg_1.default.setActiveContext(name);
+    if (options.format === 'json')
+        output_1.default.json({ active: name });
+    else
+        output_1.default.normal((0, texts_1.TXT_CONTEXT_ACTIVE)(name));
+});
+exports.default = command;

package/distTs/src/command/context.js

@@ -0,0 +1,22 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("../utils");
+const texts_1 = require("../texts");
+const add_1 = __importDefault(require("./context/add"));
+const list_1 = __importDefault(require("./context/list"));
+const show_1 = __importDefault(require("./context/show"));
+const use_1 = __importDefault(require("./context/use"));
+const remove_1 = __importDefault(require("./context/remove"));
+const commandContext = (0, utils_1.newCommand)('context', texts_1.DESC_CONTEXT, {
+    requiredScopes: [],
+    helpText: texts_1.HELP_CONTEXT,
+});
+commandContext.addCommand(add_1.default);
+commandContext.addCommand(list_1.default);
+commandContext.addCommand(show_1.default);
+commandContext.addCommand(use_1.default);
+commandContext.addCommand(remove_1.default);
+exports.default = commandContext;

package/distTs/src/command/login.js

@@ -293,6 +293,7 @@ async function authorize(options, forceRegisterEmail, forceRegisterName) {
     }
 }
 const commandLogin = (0, utils_1.newCommand)('login', texts_1.DESC_COMMAND_LOGIN);
+commandLogin.usesDefaultContext = true;
 commandLogin.alias('sign-in');
 commandLogin.option('--token <token>', texts_1.OPTION_REST_API_TOKEN);
 commandLogin.option('--api <url>', texts_1.OPTION_REST_API_ENDPOINT);

package/distTs/src/command/logout.js

@@ -9,6 +9,7 @@ const texts_1 = require("../texts");
 const utils_1 = require("../utils");
 const input_1 = __importDefault(require("../input"));
 const commandLogout = (0, utils_1.newCommand)('logout', texts_1.DESC_COMMAND_LOGOUT);
+commandLogout.usesDefaultContext = true;
 const tryRemovingApp = async () => {
     try {
         const clientId = cfg_1.default.getApiClientId();

package/distTs/src/command/project/link.js

@@ -10,6 +10,7 @@ const output_1 = __importDefault(require("../../output"));
 const node_path_1 = require("node:path");
 const node_fs_1 = __importDefault(require("node:fs"));
 const commandProjectLink = (0, utils_1.newCommand)('link', texts_1.DESC_COMMAND_PROJECT_LINK);
+commandProjectLink.usesDefaultContext = true;
 commandProjectLink.option('-w, --workspace <domain>', texts_1.OPTION_REST_API_WORKSPACE);
 commandProjectLink.option('-r, --relink', texts_1.OPT_COMMAND_PROJECT_LINK_RELINK);
 commandProjectLink.option('-g, --git', texts_1.OPT_COMMAND_PROJECT_LINK_GIT);

package/distTs/src/command/register.js

@@ -8,6 +8,7 @@ const texts_1 = require("../texts");
 const output_1 = __importDefault(require("../output"));
 const login_1 = require("./login");
 const commandRegister = (0, utils_1.newCommand)('register', texts_1.DESC_COMMAND_REGISTER);
+commandRegister.usesDefaultContext = true;
 commandRegister.alias('sign-up');
 commandRegister.option('--api <url>', texts_1.OPTION_REST_API_ENDPOINT);
 commandRegister.option('--region <region>', texts_1.OPTION_REST_API_REGION);

package/distTs/src/command/whoami.js

@@ -5,16 +5,13 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const utils_1 = require("../utils");
 const texts_1 = require("../texts");
-const cfg_1 = __importDefault(require("../tunnel/cfg"));
 const output_1 = __importDefault(require("../output"));
 const input_1 = __importDefault(require("../input"));
-const cfg_2 = __importDefault(require("../project/cfg"));
+const cfg_1 = __importDefault(require("../project/cfg"));
 const commandWhoami = (0, utils_1.newCommand)('whoami', texts_1.DESC_COMMAND_WHOAMI);
 commandWhoami.option('--format <text|json>', texts_1.OPTION_FORMAT);
 commandWhoami.action(async (options) => {
-    const workspace = cfg_1.default.getWorkspace();
-    const localWorkspace = cfg_2.default.getWorkspace();
-    const localProject = cfg_2.default.getProject();
+    const { workspace, project, localWorkspace } = input_1.default.accountScope();
     const client = input_1.default.restApiTokenClient();
     const user = await client.getInvoker();
     if (!user) {
@@ -30,12 +27,12 @@ commandWhoami.action(async (options) => {
     else {
         obj.Workspace = !workspace ? texts_1.TXT_WHOAMI_NO_WORKSPACE : workspace;
     }
-    if (localProject) {
-        obj.Project = localProject;
+    if (project) {
+        obj.Project = project;
     }
-    const vtSuite = cfg_2.default.getVtSuite();
-    const utSuite = cfg_2.default.getUtSuite();
-    const crawlSuite = cfg_2.default.getCrawlSuite();
+    const vtSuite = cfg_1.default.getVtSuite();
+    const utSuite = cfg_1.default.getUtSuite();
+    const crawlSuite = cfg_1.default.getCrawlSuite();
     if (vtSuite) {
         obj['Visual test suite'] = vtSuite;
     }

package/distTs/src/command/workspace/get.js

@@ -3,13 +3,13 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const cfg_1 = __importDefault(require("../../tunnel/cfg"));
+const input_1 = __importDefault(require("../../input"));
 const output_1 = __importDefault(require("../../output"));
 const texts_1 = require("../../texts");
 const utils_1 = require("../../utils");
 const commandWorkspaceGet = (0, utils_1.newCommand)('get', texts_1.DESC_COMMAND_WORKSPACE_GET);
 commandWorkspaceGet.action(async () => {
-    const workspace = cfg_1.default.getWorkspace();
+    const { workspace } = input_1.default.accountScope();
     if (!workspace) {
         output_1.default.exitError(texts_1.TXT_WORKSPACE_NONE);
     }

package/distTs/src/command/workspace/set.js

@@ -9,6 +9,7 @@ const texts_1 = require("../../texts");
 const utils_1 = require("../../utils");
 const input_1 = __importDefault(require("../../input"));
 const commandWorkspaceSet = (0, utils_1.newCommand)('set', texts_1.DESC_COMMAND_WORKSPACE_SET);
+commandWorkspaceSet.usesDefaultContext = true;
 commandWorkspaceSet.argument('[workspace]', texts_1.ARG_COMMAND_WORKSPACE);
 commandWorkspaceSet.action(async (workspaceDomain) => {
     output_1.default.handleSignals();

package/distTs/src/input.js

@@ -36,6 +36,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+const cfg_1 = __importDefault(require("./project/cfg"));
+const context_1 = require("./project/context");
 const cliError_1 = __importDefault(require("./cliError"));
 const output_1 = __importDefault(require("./output"));
 const netmask_1 = require("netmask");
@@ -48,10 +50,159 @@ const utils_1 = require("./utils");
 const texts_1 = require("./texts");
 const tunnel_1 = require("./types/tunnel");
 const node_path_1 = __importStar(require("node:path"));
-const cfg_1 = __importDefault(require("./tunnel/cfg"));
+const cfg_2 = __importDefault(require("./tunnel/cfg"));
 const sandbox_1 = require("./types/sandbox");
 const distro_1 = require("./types/distro");
 class Input {
+    static contextOptions = {};
+    static resolvedContextScope;
+    static configureContext(options) {
+        this.contextOptions = options;
+        this.resolvedContextScope = undefined;
+    }
+    static contextName() {
+        return this.contextOptions.context || cfg_2.default.getActiveContext();
+    }
+    static context() {
+        return cfg_2.default.getContext(this.contextName());
+    }
+    static contextScope() {
+        const context = this.context();
+        if (!context)
+            return null;
+        this.resolvedContextScope ??= (0, context_1.resolveContextScope)(context, process.cwd());
+        return this.resolvedContextScope;
+    }
+    static contextEditableName(name) {
+        if (['default', 'git', 'link'].includes(name))
+            throw new cliError_1.default('usage_error', texts_1.ERR_CONTEXT_RESERVED);
+        if (!/^[a-zA-Z0-9][a-zA-Z0-9_-]*$/.test(name))
+            throw new cliError_1.default('usage_error', texts_1.ERR_CONTEXT_NAME);
+        return name;
+    }
+    static contextApiEndpoint(api) {
+        try {
+            const url = new URL(api.includes('://') ? api : `https://${api}`);
+            if (url.protocol !== 'https:' ||
+                url.username ||
+                url.password ||
+                url.pathname !== '/' ||
+                url.search ||
+                url.hash)
+                throw new Error();
+            return url.origin;
+        }
+        catch {
+            throw new cliError_1.default('usage_error', texts_1.ERR_CONTEXT_API);
+        }
+    }
+    static contextDefinition(options) {
+        if ((options.fromLink && options.fromGit) ||
+            ((options.fromLink || options.fromGit) &&
+                (options.workspace !== undefined || options.project !== undefined)) ||
+            (options.remote !== undefined && !options.fromGit))
+            throw new cliError_1.default('usage_error', texts_1.ERR_CONTEXT_SOURCE);
+        if (options.project && !options.workspace)
+            throw new cliError_1.default('usage_error', texts_1.ERR_CONTEXT_PROJECT);
+        const api = options.api !== undefined
+            ? this.contextApiEndpoint(options.api)
+            : undefined;
+        return {
+            source: options.fromGit ? 'git' : options.fromLink ? 'link' : 'explicit',
+            ...(options.workspace ? { workspace: options.workspace } : {}),
+            ...(options.project ? { project: options.project } : {}),
+            ...(options.token ? { token: options.token } : {}),
+            ...(api ? { api } : {}),
+            ...(options.fromGit ? { remote: options.remote || 'origin' } : {}),
+        };
+    }
+    // Account display preserves the legacy distinction between global and linked
+    // workspace, while named contexts own their entire scope.
+    static accountScope() {
+        if (this.context())
+            return {
+                workspace: this.restApiWorkspace(undefined, true),
+                project: this.restApiProject(undefined, true),
+                localWorkspace: '',
+            };
+        return {
+            workspace: cfg_2.default.getWorkspace(),
+            project: cfg_1.default.getProject(),
+            localWorkspace: cfg_1.default.getWorkspace(),
+        };
+    }
+    static showContext() {
+        const context = this.context();
+        const workspace = this.restApiWorkspace(this.contextOptions.workspace, true);
+        const project = this.restApiProject(this.contextOptions.project, true);
+        const auth = this.restApiToken(true, this.contextOptions.token);
+        const api = this.restApiBaseUrl(this.contextOptions.api, this.contextOptions.region, auth.token).origin;
+        const inSandbox = (0, utils_1.isInSandbox)();
+        const tokenSource = this.contextOptions.token
+            ? 'flag'
+            : context?.token
+                ? 'context'
+                : !inSandbox && process.env.BUDDY_TOKEN
+                    ? 'environment'
+                    : cfg_2.default.getApiToken()
+                        ? 'config'
+                        : process.env.BUDDY_TOKEN
+                            ? 'environment'
+                            : null;
+        const workspaceSource = this.contextOptions.workspace
+            ? 'flag'
+            : context
+                ? workspace
+                    ? context.source
+                    : null
+                : !inSandbox && process.env.BUDDY_WORKSPACE
+                    ? 'environment'
+                    : cfg_1.default.getWorkspace()
+                        ? 'link'
+                        : cfg_2.default.getWorkspace()
+                            ? 'config'
+                            : process.env.BUDDY_WORKSPACE
+                                ? 'environment'
+                                : null;
+        const projectSource = !project
+            ? null
+            : this.contextOptions.project
+                ? 'flag'
+                : context
+                    ? context.source
+                    : process.env.BUDDY_PROJECT
+                        ? 'environment'
+                        : 'link';
+        const apiSource = this.contextOptions.api
+            ? 'flag'
+            : context?.api
+                ? 'context'
+                : this.restApiBaseUrlFromToken(auth.token)
+                    ? 'token'
+                    : process.env.BUDDY_API_ENDPOINT
+                        ? 'environment'
+                        : cfg_2.default.getBaseUrl()
+                            ? 'config'
+                            : this.contextOptions.region
+                                ? 'flag'
+                                : process.env.BUDDY_REGION
+                                    ? 'environment'
+                                    : 'default';
+        return {
+            name: this.contextName(),
+            source: context?.source || 'default',
+            workspace,
+            project,
+            api,
+            remote: context?.source === 'git' ? context.remote || 'origin' : null,
+            token: { available: !!auth.token, source: tokenSource },
+            sources: {
+                workspace: workspaceSource,
+                project: projectSource,
+                api: apiSource,
+            },
+        };
+    }
     static timeout(timeout) {
         const t = parseInt(timeout, 10);
         if (isNaN(t) || t <= 0 || t > 999) {
@@ -344,7 +495,7 @@ class Input {
         // Inside a sandbox, cfg (written by an explicit `bdy login`) takes precedence
         // over the sandbox-injected BUDDY_TOKEN env var. Outside a sandbox, env beats cfg
         const tokenEnv = process.env.BUDDY_TOKEN;
-        let t = token;
+        let t = token || this.context()?.token || '';
         if (!t && !inSandbox && tokenEnv)
             t = tokenEnv;
         let rf = '';
@@ -352,11 +503,11 @@ class Input {
         let cs = '';
         let ct = '';
         if (!t) {
-            t = cfg_1.default.getApiToken();
-            rf = cfg_1.default.getApiRefreshApiToken();
-            cid = cfg_1.default.getApiClientId();
-            cs = cfg_1.default.getApiClientSecret();
-            ct = cfg_1.default.getApiClientToken();
+            t = cfg_2.default.getApiToken();
+            rf = cfg_2.default.getApiRefreshApiToken();
+            cid = cfg_2.default.getApiClientId();
+            cs = cfg_2.default.getApiClientSecret();
+            ct = cfg_2.default.getApiClientToken();
         }
         if (!t && inSandbox && tokenEnv)
             t = tokenEnv;
@@ -869,13 +1020,13 @@ class Input {
         return null;
     }
     static restApiBaseUrl(api = '', region = '', token = '') {
-        let u = api;
+        let u = api || this.context()?.api || '';
         if (!u)
             u = this.restApiBaseUrlFromToken(token);
         if (!u)
             u = process.env.BUDDY_API_ENDPOINT || null;
         if (!u)
-            u = cfg_1.default.getBaseUrl();
+            u = cfg_2.default.getBaseUrl();
         if (!u) {
             const r = region || process.env.BUDDY_REGION;
             if (r?.toLowerCase() === utils_1.REST_API_REGION.EU) {
@@ -907,18 +1058,25 @@ class Input {
         return p;
     }
     static restApiWorkspace(workspace, allowNull, ignoreProjectConfig = false) {
+        if (!ignoreProjectConfig && this.context()) {
+            const value = workspace || this.contextScope()?.workspace;
+            if (value)
+                return value;
+            if (allowNull)
+                return null;
+            throw new cliError_1.default('usage_error', texts_1.ERR_REST_API_WORKSPACE, texts_1.TXT_CONTEXT_WORKSPACE_HINT);
+        }
         // Inside a sandbox, cfg/project cfg (set by an explicit `bdy login` or .bdy/cfg.json)
         // takes precedence over the sandbox-injected BUDDY_WORKSPACE env var.
         // Outside a sandbox, env beats cfg.
-        const ProjectCfg = require('./project/cfg').default;
         let w = workspace;
         const inSandbox = (0, utils_1.isInSandbox)();
         if (!w && !inSandbox && process.env.BUDDY_WORKSPACE)
             w = process.env.BUDDY_WORKSPACE;
         if (!w && !ignoreProjectConfig)
-            w = ProjectCfg.getWorkspace();
-        if (!w)
             w = cfg_1.default.getWorkspace();
+        if (!w)
+            w = cfg_2.default.getWorkspace();
         if (!w && inSandbox && process.env.BUDDY_WORKSPACE)
             w = process.env.BUDDY_WORKSPACE;
         if (!w) {
@@ -1247,12 +1405,35 @@ class Input {
         return sandboxId;
     }
     static restApiProject(project, allowNull) {
-        const ProjectCfg = require('./project/cfg').default;
+        const context = this.context();
+        if (context) {
+            let value = project;
+            if (!value) {
+                let scope;
+                try {
+                    scope = this.contextScope();
+                }
+                catch (err) {
+                    // An explicit workspace is sufficient for workspace-scoped commands.
+                    // If the dynamic source is unavailable, none of its project can carry over.
+                    if (!this.contextOptions.workspace || context.source === 'explicit')
+                        throw err;
+                }
+                const changedWorkspace = this.contextOptions.workspace && this.contextOptions.workspace !== scope?.workspace;
+                if (!changedWorkspace)
+                    value = scope?.project || '';
+            }
+            if (value)
+                return value;
+            if (allowNull)
+                return null;
+            throw new cliError_1.default('usage_error', texts_1.ERR_REST_API_PROJECT, texts_1.TXT_CONTEXT_PROJECT_HINT);
+        }
         let p = process.env.BUDDY_PROJECT;
         if (project)
             p = project;
         if (!p)
-            p = ProjectCfg.getProject();
+            p = cfg_1.default.getProject();
         if (!p) {
             if (allowNull)
                 return null;
@@ -1330,14 +1511,14 @@ class Input {
         const workspace = Input.restApiWorkspace('', true);
         const project = Input.restApiProject('', true);
         let fromLogin = false;
-        if (!token && cfg_1.default.getApiToken() && workspace) {
+        if (!token && (this.context() ? this.restApiToken(true).token : cfg_2.default.getApiToken()) && workspace) {
             const client = Input.restApiTokenClient();
             const result = await client.getTunnelToken(workspace, project);
             token = String(result?.token || '');
             fromLogin = true;
         }
         else if (!token) {
-            token = cfg_1.default.getToken();
+            token = cfg_2.default.getToken();
         }
         if (!token)
             throw new Error(texts_1.ERR_TOKEN_NOT_PROVIDED);
@@ -1350,7 +1531,7 @@ class Input {
             throw new Error(texts_1.ERR_WRONG_TOKEN);
         }
         if (!fromLogin)
-            cfg_1.default.setToken(token);
+            cfg_2.default.setToken(token);
         return {
             token,
             host: d.host,
@@ -1382,9 +1563,8 @@ class Input {
         const envToken = process.env.BUDDY_VT_TOKEN;
         if (envToken)
             return envToken;
-        const ProjectCfg = require('./project/cfg').default;
-        const suiteIdentifier = ProjectCfg.getVtSuite();
-        if (suiteIdentifier && (cfg_1.default.getApiToken() || process.env.BUDDY_TOKEN)) {
+        const suiteIdentifier = cfg_1.default.getVtSuite();
+        if (suiteIdentifier && this.restApiToken(true).token) {
             const workspace = Input.restApiWorkspace('', true);
             const project = Input.restApiProject('', true);
             if (workspace && project) {
@@ -1402,9 +1582,8 @@ class Input {
         const envToken = process.env.BUDDY_CRAWL_TOKEN;
         if (envToken)
             return envToken;
-        const ProjectCfg = require('./project/cfg').default;
-        const suiteIdentifier = ProjectCfg.getCrawlSuite();
-        if (suiteIdentifier && (cfg_1.default.getApiToken() || process.env.BUDDY_TOKEN)) {
+        const suiteIdentifier = cfg_1.default.getCrawlSuite();
+        if (suiteIdentifier && this.restApiToken(true).token) {
             const workspace = Input.restApiWorkspace('', true);
             const project = Input.restApiProject('', true);
             if (workspace && project) {
@@ -1422,9 +1601,8 @@ class Input {
         const envToken = process.env.BUDDY_UT_TOKEN;
         if (envToken)
             return envToken;
-        const ProjectCfg = require('./project/cfg').default;
-        const suiteIdentifier = ProjectCfg.getUtSuite();
-        if (suiteIdentifier && (cfg_1.default.getApiToken() || process.env.BUDDY_TOKEN)) {
+        const suiteIdentifier = cfg_1.default.getUtSuite();
+        if (suiteIdentifier && this.restApiToken(true).token) {
             const workspace = Input.restApiWorkspace('', true);
             const project = Input.restApiProject('', true);
             if (workspace && project) {

package/distTs/src/output.js

@@ -375,7 +375,7 @@ class Output {
             }
         });
     }
-    static async confirm(message = 'Are you sure?') {
+    static async confirm(message = 'Are you sure?', quiet = false) {
         if (this.isStdInTTY()) {
             const prompts = require('@inquirer/prompts');
             try {
@@ -383,15 +383,17 @@ class Output {
                     message,
                     theme: this.getInquirerTheme(),
                     default: false,
-                });
+                }, quiet ? { output: process.stderr } : undefined);
             }
             catch {
                 this.exitError(texts_1.ERR_CANCELLED);
             }
         }
-        this.cyan('? ', false);
-        this.label(message, false);
-        this.cyan(` No`);
+        if (!quiet) {
+            this.cyan('? ', false);
+            this.label(message, false);
+            this.cyan(` No`);
+        }
         return false;
     }
     static async inputString(message, def, required, signal) {

package/distTs/src/project/context.js

@@ -0,0 +1,97 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseBuddyRemote = parseBuddyRemote;
+exports.resolveContextScope = resolveContextScope;
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const cliError_1 = __importDefault(require("../cliError"));
+const utils_1 = require("../utils");
+const texts_1 = require("../texts");
+function parseBuddyRemote(remote) {
+    try {
+        // Accept both standard URLs and Git's scp-like SSH syntax.
+        const value = remote.includes('://')
+            ? remote
+            : remote.replace(/^(?:[^@/:]+@)?([^/:]+):(.+)$/, 'ssh://$1/$2');
+        const url = new URL(value);
+        if (!['https:', 'ssh:'].includes(url.protocol) ||
+            !Object.values(utils_1.REST_API_ENDPOINT).some((endpoint) => (0, utils_1.getAppHostByApiBaseUrl)(new URL(`https://${endpoint}`)) ===
+                url.hostname) ||
+            url.search ||
+            url.hash)
+            throw new Error();
+        const parts = url.pathname
+            .replace(/\/$/, '')
+            .replace(/\.git$/, '')
+            .split('/')
+            .slice(1);
+        if (parts.length !== 2 ||
+            parts.some((part) => !/^[a-zA-Z0-9_-]+$/.test(part)))
+            throw new Error();
+        return { workspace: parts[0], project: parts[1] };
+    }
+    catch {
+        // Do not include the raw URL: remotes can contain credentials.
+        throw new cliError_1.default('git_remote_unsupported', texts_1.ERR_CONTEXT_GIT_URL, texts_1.TXT_CONTEXT_GIT_HINT);
+    }
+}
+function resolveContextScope(context, cwd) {
+    if (context.source === 'explicit')
+        return {
+            workspace: context.workspace || null,
+            project: context.project || null,
+            remote: null,
+        };
+    if (context.source === 'link') {
+        let data;
+        try {
+            data = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(cwd, '.bdy/project.json'), 'utf8'));
+        }
+        catch (err) {
+            const missing = err.code === 'ENOENT';
+            throw new cliError_1.default(missing ? 'project_link_not_found' : 'project_link_invalid', missing ? texts_1.ERR_CONTEXT_LINK_MISSING : texts_1.ERR_CONTEXT_LINK_INVALID, texts_1.TXT_CONTEXT_LINK_HINT);
+        }
+        if (typeof data?.workspace !== 'string' ||
+            !data.workspace.trim() ||
+            typeof data?.project !== 'string' ||
+            !data.project.trim())
+            throw new cliError_1.default('project_link_invalid', texts_1.ERR_CONTEXT_LINK_INVALID, texts_1.TXT_CONTEXT_LINK_HINT);
+        return {
+            workspace: data.workspace,
+            project: data.project,
+            remote: null,
+        };
+    }
+    const remote = context.remote || 'origin';
+    let url;
+    try {
+        url = (0, node_child_process_1.execFileSync)('git', ['remote', 'get-url', '--', remote], {
+            cwd,
+            encoding: 'utf8',
+            timeout: 3000,
+            stdio: ['ignore', 'pipe', 'pipe'],
+            // Git diagnostics are classified below; keep their language deterministic.
+            env: { ...process.env, LC_ALL: 'C', LANG: 'C' },
+        }).trim();
+    }
+    catch (err) {
+        const failure = err;
+        if (failure.code === 'ENOENT')
+            throw new cliError_1.default('git_not_found', texts_1.ERR_CONTEXT_GIT_MISSING, texts_1.TXT_CONTEXT_GIT_HINT);
+        if (failure.code === 'ETIMEDOUT')
+            throw new cliError_1.default('timeout', texts_1.ERR_CONTEXT_GIT_TIMEOUT, texts_1.TXT_CONTEXT_GIT_HINT);
+        const stderr = String(failure.stderr || '');
+        if (failure.status === 128 && /fatal: not a git repository/i.test(stderr))
+            throw new cliError_1.default('git_repository_not_found', texts_1.ERR_CONTEXT_GIT_REPO, texts_1.TXT_CONTEXT_GIT_HINT);
+        if (failure.status === 2 && /error: No such remote /i.test(stderr))
+            throw new cliError_1.default('git_remote_not_found', (0, texts_1.ERR_CONTEXT_GIT_REMOTE)(remote), texts_1.TXT_CONTEXT_GIT_HINT);
+        // Neither permission errors nor an interrupted Git process imply a missing repo.
+        // Never forward raw diagnostics, which may contain remote credentials.
+        throw new cliError_1.default('command_failed', texts_1.ERR_CONTEXT_GIT_FAILED, texts_1.TXT_CONTEXT_GIT_HINT);
+    }
+    return { ...parseBuddyRemote(url), remote };
+}

package/distTs/src/texts.js

@@ -22,7 +22,8 @@ exports.DESC_COMMAND_ARTIFACT_GET = exports.TXT_ARTIFACT_DOCKER_LOGIN_FAILED = e
 exports.EXAMPLE_ROUTE_LIST = exports.EXAMPLE_ROUTE_UPDATE = exports.EXAMPLE_ROUTE_DELETE = exports.EXAMPLE_DISTRO_DELETE = exports.EXAMPLE_ROUTE_GET = exports.EXAMPLE_DISTRO_UPDATE = exports.EXAMPLE_DISTRO_GET = exports.EXAMPLE_DISTRO_LIST = exports.EXAMPLE_SANDBOX_CP = exports.ERR_PROJECT_NO_PROJECTS = exports.TXT_LOGIN_SELECT_PROJECT = exports.TXT_COMMAND_PROJECT_CREATED = exports.TXT_COMMAND_PROJECT_LINK_NOT_FOUND = exports.TXT_COMMAND_PROJECT_LINK_NAME = exports.TXT_COMMAND_PROJECT_LINK_SELECT_PROJECT = exports.TXT_COMMAND_PROJECT_LINK_TO = exports.TXT_COMMAND_PROJECT_LINK_EXISTING_DESC = exports.TXT_COMMAND_PROJECT_LINK_EXISTING = exports.TXT_COMMAND_PROJECT_LINK_CREATE_NEW_DESC = exports.TXT_COMMAND_PROJECT_LINK_CREATE_NEW = exports.ERR_COMMAND_PROJECT_LINK_DIR_NOT_DIR = exports.TXT_COMMAND_PROJECT_LINK_GIT_REPO_INITIALIZED = exports.TXT_COMMAND_PROJECT_LINK_GIT_REPO = exports.TXT_COMMAND_PROJECT_LINK_DIR_CONFIRM = exports.TXT_COMMAND_PROJECT_LINK_DIR_LINKED = exports.ERR_COMMAND_PROJECT_LINK_DIR_CREATE = exports.OPT_COMMAND_PROJECT_LINK_TRY_NOW = exports.OPT_COMMAND_PROJECT_LINK_SET_GIT_REMOTE = exports.OPT_COMMAND_PROJECT_LINK_HAS_REMOTE = exports.OPT_COMMAND_PROJECT_LINK_DIRECTORY = exports.OPT_COMMAND_PROJECT_LINK_GIT = exports.OPT_COMMAND_PROJECT_LINK_RELINK = exports.DESC_COMMAND_PROJECT_LINK = exports.DESC_COMMAND_PROJECT_LIST = exports.DESC_COMMAND_PROJECT_GIT = exports.DESC_COMMAND_PROJECT_GIT_CREDENTIAL = exports.DESC_COMMAND_PROJECT = exports.TXT_ARTIFACT_VERSION_DOWNLOAD = exports.TXT_ARTIFACT_PUBLISH = exports.TXT_ARTIFACT_CREATED = exports.TXT_ARTIFACT_VERSION_DELETED = exports.TXT_ARTIFACT_DELETED = exports.ERR_COMMAND_ARTIFACT_TYPE = exports.OPT_COMMAND_ARTIFACT_VERSION = exports.OPT_COMMAND_ARTIFACT_IDENTIFIER = exports.OPT_COMMAND_ARTIFACT_CREATE_IDENTIFIER = exports.OPT_COMMAND_ARTIFACT_NAME = exports.OPT_COMMAND_ARTIFACT_TYPE = exports.DESC_COMMAND_ARTIFACT_CREATE = exports.DESC_COMMAND_ARTIFACT_COMPOSER_PUBLISH = void 0;
 exports.HELP_PIPELINE_RUN_JSONL = exports.EXAMPLE_PIPELINE_RUN_STATUS = exports.EXAMPLE_PIPELINE_RUN_START = exports.EXAMPLE_SANDBOX_ENDPOINT_LIST = exports.EXAMPLE_SANDBOX_ENDPOINT_GET = exports.EXAMPLE_SANDBOX_ENDPOINT_DELETE = exports.EXAMPLE_SANDBOX_ENDPOINT_CREATE = exports.EXAMPLE_ENVIRONMENT_DELETE = exports.EXAMPLE_ENVIRONMENT_UPDATE = exports.EXAMPLE_ENVIRONMENT_CREATE = exports.EXAMPLE_ENVIRONMENT_GET = exports.EXAMPLE_ENVIRONMENT_LIST = exports.EXAMPLE_TARGET_EXEC_LOGS = exports.EXAMPLE_TARGET_EXEC_LIST = exports.EXAMPLE_TARGET_EXEC_KILL = exports.EXAMPLE_TARGET_EXEC_STATUS = exports.EXAMPLE_TARGET_EXEC_COMMAND = exports.EXAMPLE_TARGET_DELETE = exports.EXAMPLE_TARGET_UPDATE = exports.EXAMPLE_TARGET_CREATE = exports.EXAMPLE_TARGET_GET = exports.EXAMPLE_TARGET_LIST = exports.EXAMPLE_SANDBOX_SNAPSHOT_LIST = exports.EXAMPLE_SANDBOX_SNAPSHOT_GET = exports.EXAMPLE_SANDBOX_SNAPSHOT_DELETE = exports.EXAMPLE_SANDBOX_SNAPSHOT_CREATE = exports.EXAMPLE_SANDBOX_EXEC_STATUS = exports.EXAMPLE_SANDBOX_EXEC_LOGS = exports.EXAMPLE_SANDBOX_APP_STATUS = exports.EXAMPLE_SANDBOX_APP_STOP = exports.EXAMPLE_SANDBOX_APP_REMOVE = exports.EXAMPLE_SANDBOX_APP_ADD = exports.EXAMPLE_SANDBOX_APP_START = exports.EXAMPLE_SANDBOX_APP_LOGS = exports.EXAMPLE_SANDBOX_EXEC_LIST = exports.EXAMPLE_SANDBOX_APP_LIST = exports.EXAMPLE_SANDBOX_EXEC_KILL = exports.EXAMPLE_SANDBOX_SSH = exports.EXAMPLE_SANDBOX_EXEC_COMMAND = exports.EXAMPLE_TUNNEL_START = exports.EXAMPLE_TUNNEL_TCP = exports.EXAMPLE_TUNNEL_TLS = exports.EXAMPLE_AGENT_TUNNEL_START = exports.EXAMPLE_AGENT_TUNNEL_STATUS = exports.EXAMPLE_AGENT_TUNNEL_REMOVE = exports.EXAMPLE_AGENT_TUNNEL_LIST = exports.EXAMPLE_TUNNEL_HTTP = exports.EXAMPLE_SANDBOX_CREATE = exports.EXAMPLE_DISTRO_CREATE = exports.EXAMPLE_ROUTE_CREATE = void 0;
 exports.OPTION_YAML_VALIDATE_FILE = exports.DESC_COMMAND_YAML_VALIDATE = exports.DESC_COMMAND_YAML_ACTIONS_INFO = exports.DESC_COMMAND_YAML_ACTIONS_LIST = exports.DESC_COMMAND_YAML_ACTIONS = exports.DESC_COMMAND_YAML_PIPELINE = exports.DESC_COMMAND_YAML = exports.TXT_ACTION_SUGGESTED_FROM_REPO = exports.TXT_ACTION_USE_LIST = exports.TXT_ACTION_DID_YOU_MEAN = exports.ERR_ACTION_SEARCH_NO_RESULTS = exports.ERR_ACTION_NOT_FOUND = exports.OPTION_ACTION_TYPE = exports.OPTION_ACTION_SEARCH = exports.EXAMPLE_YAML_VALIDATE = exports.EXAMPLE_YAML_ACTIONS_INFO = exports.EXAMPLE_YAML_ACTIONS_LIST = exports.EXAMPLE_YAML_PIPELINE = exports.EXAMPLE_CRAWL_LINK = exports.EXAMPLE_CRAWL_RUN = exports.EXAMPLE_TESTS_CAPTURE = exports.EXAMPLE_TESTS_VISUAL_SESSION_CLOSE = exports.EXAMPLE_TESTS_VISUAL_SESSION_CREATE = exports.EXAMPLE_TESTS_VISUAL_LINK = exports.EXAMPLE_TESTS_VISUAL_UPLOAD = exports.EXAMPLE_TESTS_VISUAL_SETUP = exports.EXAMPLE_TESTS_UNIT_LINK = exports.EXAMPLE_TESTS_UNIT_UPLOAD = exports.EXAMPLE_ARTIFACT_VERSION_DELETE = exports.EXAMPLE_ARTIFACT_VERSION_GET = exports.EXAMPLE_ARTIFACT_VERSION_LIST = exports.EXAMPLE_ARTIFACT_CREATE = exports.EXAMPLE_ARTIFACT_DELETE = exports.EXAMPLE_ARTIFACT_DOWNLOAD = exports.EXAMPLE_ARTIFACT_PUBLISH = exports.EXAMPLE_ARTIFACT_COMPOSER_PUBLISH = exports.EXAMPLE_ARTIFACT_VERSION_CREATE = exports.EXAMPLE_PIPELINE_RUN_RETRY = exports.EXAMPLE_PIPELINE_RUN_LIST = exports.EXAMPLE_PIPELINE_LIST = exports.EXAMPLE_PIPELINE_YML = exports.EXAMPLE_PIPELINE_GET = exports.EXAMPLE_PIPELINE_UPDATE = exports.EXAMPLE_PIPELINE_DELETE = exports.EXAMPLE_PIPELINE_CREATE = exports.EXAMPLE_PIPELINE_RUN_CANCEL = exports.EXAMPLE_PIPELINE_RUN_APPLY = exports.EXAMPLE_PIPELINE_RUN_LOGS = exports.HELP_PIPELINE_RUN_LOGS = exports.HELP_PIPELINE_RUN_STATUS = void 0;
-exports.HELP_AGENT_STATUS_JSON = exports.HELP_SANDBOX_APP_ADD_JSON = exports.EXAMPLE_CONFIG_GET_TUNNELS = exports.EXAMPLE_CONFIG_GET_TUNNEL = exports.HELP_TARGET_EXEC_LOGS_JSONL = exports.HELP_SANDBOX_EXEC_COMMAND_JSONL = exports.HELP_SANDBOX_EXEC_JSONL = exports.HELP_TARGET_EXEC_COMMAND = exports.HELP_TARGET_EXEC_STATUS = exports.HELP_SANDBOX_EXEC_STATUS = exports.HELP_API_INFO_JSON = exports.HELP_DOMAIN_SEARCH_JSON = exports.HELP_YAML_VALIDATE_JSON = exports.EXAMPLE_AGENT_TAGS_GET = exports.EXAMPLE_AGENT_PROXY_STATUS = exports.EXAMPLE_AGENT_TARGET_STATUS = exports.EXAMPLE_AGENT_VERSION = exports.EXAMPLE_AGENT_STATUS = exports.EXAMPLE_DOMAIN_SEARCH = exports.EXAMPLE_API_LIST = exports.EXAMPLE_API_INFO = exports.ERR_API_SCHEMA_NOT_FOUND = exports.EXAMPLE_SANDBOX_LOGS = exports.ERR_YAML_SCHEMA_READ_FAILED = exports.ERR_YAML_SCHEMA_FETCH_FAILED = exports.TXT_YAML_UNKNOWN_TOP_LEVEL_KEYS = exports.ERR_YAML_ITEM_UNKNOWN = exports.ERR_YAML_ITEM_MISSING = exports.ERR_YAML_MUST_BE = exports.ERR_YAML_PIPELINE_NOT_OBJECT = exports.ERR_YAML_EMPTY_ARRAY = exports.ERR_YAML_PLAIN_OBJECT = exports.ERR_YAML_NOT_ARRAY = exports.ERR_YAML_PARSE = exports.ERR_YAML_VALIDATE_FAILED_COUNT = exports.TXT_YAML_VALIDATE_ALL_PASS = exports.ERR_YAML_VALIDATE_FAILED = exports.ERR_YAML_VALIDATE_FILE_NOT_FOUND = void 0;
+exports.OPTION_CONTEXT_TOKEN = exports.OPTION_CONTEXT_REMOTE = exports.OPTION_CONTEXT_GIT = exports.OPTION_CONTEXT_LINK = exports.OPTION_CONTEXT_NAME = exports.DESC_CONTEXT_REMOVE = exports.DESC_CONTEXT_USE = exports.DESC_CONTEXT_SHOW = exports.DESC_CONTEXT_LIST = exports.DESC_CONTEXT_ADD = exports.DESC_CONTEXT = exports.OPTION_CONTEXT = exports.HELP_AGENT_STATUS_JSON = exports.HELP_SANDBOX_APP_ADD_JSON = exports.EXAMPLE_CONFIG_GET_TUNNELS = exports.EXAMPLE_CONFIG_GET_TUNNEL = exports.HELP_TARGET_EXEC_LOGS_JSONL = exports.HELP_SANDBOX_EXEC_COMMAND_JSONL = exports.HELP_SANDBOX_EXEC_JSONL = exports.HELP_TARGET_EXEC_COMMAND = exports.HELP_TARGET_EXEC_STATUS = exports.HELP_SANDBOX_EXEC_STATUS = exports.HELP_API_INFO_JSON = exports.HELP_DOMAIN_SEARCH_JSON = exports.HELP_YAML_VALIDATE_JSON = exports.EXAMPLE_AGENT_TAGS_GET = exports.EXAMPLE_AGENT_PROXY_STATUS = exports.EXAMPLE_AGENT_TARGET_STATUS = exports.EXAMPLE_AGENT_VERSION = exports.EXAMPLE_AGENT_STATUS = exports.EXAMPLE_DOMAIN_SEARCH = exports.EXAMPLE_API_LIST = exports.EXAMPLE_API_INFO = exports.ERR_API_SCHEMA_NOT_FOUND = exports.EXAMPLE_SANDBOX_LOGS = exports.ERR_YAML_SCHEMA_READ_FAILED = exports.ERR_YAML_SCHEMA_FETCH_FAILED = exports.TXT_YAML_UNKNOWN_TOP_LEVEL_KEYS = exports.ERR_YAML_ITEM_UNKNOWN = exports.ERR_YAML_ITEM_MISSING = exports.ERR_YAML_MUST_BE = exports.ERR_YAML_PIPELINE_NOT_OBJECT = exports.ERR_YAML_EMPTY_ARRAY = exports.ERR_YAML_PLAIN_OBJECT = exports.ERR_YAML_NOT_ARRAY = exports.ERR_YAML_PARSE = exports.ERR_YAML_VALIDATE_FAILED_COUNT = exports.TXT_YAML_VALIDATE_ALL_PASS = exports.ERR_YAML_VALIDATE_FAILED = exports.ERR_YAML_VALIDATE_FILE_NOT_FOUND = void 0;
+exports.HELP_CONTEXT_REMOVE = exports.HELP_CONTEXT_USE = exports.HELP_CONTEXT_SHOW = exports.HELP_CONTEXT_LIST = exports.HELP_CONTEXT_ADD = exports.EXAMPLE_CONTEXT_REMOVE = exports.EXAMPLE_CONTEXT_USE = exports.EXAMPLE_CONTEXT_SHOW = exports.EXAMPLE_CONTEXT_LIST = exports.EXAMPLE_CONTEXT_ADD = exports.TXT_CONTEXT_TOKEN_MISSING = exports.TXT_CONTEXT_TOKEN_AVAILABLE = exports.TXT_CONTEXT_TOKEN_LABEL = exports.TXT_CONTEXT_REMOTE_LABEL = exports.TXT_CONTEXT_API_LABEL = exports.TXT_CONTEXT_PROJECT_LABEL = exports.TXT_CONTEXT_WORKSPACE_LABEL = exports.TXT_CONTEXT_SOURCE_LABEL = exports.TXT_CONTEXT_LABEL = exports.TXT_CONTEXT_REMOVE_CONFIRM = exports.ERR_CONTEXT_GIT_FAILED = exports.ERR_CONTEXT_GIT_TIMEOUT = exports.TXT_CONTEXT_PROJECT_HINT = exports.TXT_CONTEXT_WORKSPACE_HINT = exports.HELP_CONTEXT = exports.TXT_CONTEXT_REMOVED = exports.TXT_CONTEXT_ACTIVE = exports.TXT_CONTEXT_SAVED = exports.ERR_CONTEXT_LINK_INVALID = exports.ERR_CONTEXT_LINK_MISSING = exports.ERR_CONTEXT_GIT_URL = exports.ERR_CONTEXT_GIT_REMOTE = exports.ERR_CONTEXT_GIT_REPO = exports.ERR_CONTEXT_GIT_MISSING = exports.ERR_CONTEXT_API = exports.ERR_CONTEXT_PROJECT = exports.ERR_CONTEXT_SOURCE = exports.ERR_CONTEXT_NAME = exports.ERR_CONTEXT_EXISTS = exports.ERR_CONTEXT_RESERVED = exports.ERR_CONTEXT_UNKNOWN = exports.TXT_CONTEXT_LINK_HINT = exports.TXT_CONTEXT_GIT_HINT = exports.TXT_CONTEXT_HINT = exports.OPTION_CONTEXT_API = void 0;
 const utils_1 = require("./utils");
 exports.ERR_CANCELLED = 'Cancelled';
 const TXT_CLI_USAGE_HINT = (command) => `Run '${command} --help' for usage.`;
@@ -59,8 +60,8 @@ const WARN_REST_API_RATE_LIMIT_LOW = (remaining, rateLimitReset) => {
 };
 exports.WARN_REST_API_RATE_LIMIT_LOW = WARN_REST_API_RATE_LIMIT_LOW;
 // Shown on stderr when a list command narrows to PROJECT scope implicitly
-// (linked project / BUDDY_PROJECT), so the narrowing is never silent.
-const TXT_LIST_PROJECT_SCOPE_NOTE = (resource, project) => `Listing ${resource} of project "${project}" (inferred from the linked project or BUDDY_PROJECT). Use --scope WORKSPACE to list workspace ${resource}.`;
+// (context / linked project / BUDDY_PROJECT), so the narrowing is never silent.
+const TXT_LIST_PROJECT_SCOPE_NOTE = (resource, project) => `Listing ${resource} of project "${project}" (inferred from the context, linked project or BUDDY_PROJECT). Use --scope WORKSPACE to list workspace ${resource}.`;
 exports.TXT_LIST_PROJECT_SCOPE_NOTE = TXT_LIST_PROJECT_SCOPE_NOTE;
 exports.ERR_REST_API_URL = 'Valid rest api endpoint is required (--api)';
 exports.ERR_REST_API_REGION = 'Valid rest api region is required (eu, us, as, onprem)';
@@ -514,6 +515,7 @@ exports.EXAMPLE_DISCOVER = [
     },
 ];
 exports.DISCOVERY_TIPS = [
+    "Use --context git in a Buddy clone, --context link after 'bdy project link', or --context default for legacy configuration. Inspect resolved values with 'bdy context show git --format json'. Prefer --context per invocation in scripts; 'context use' changes the global selection.",
     "Authenticate with 'bdy login'. Discovery itself needs no login or network access.",
     "Set project context with 'bdy project link', or use --workspace / --project and BUDDY_WORKSPACE / BUDDY_PROJECT where supported.",
     'Human-readable identifiers and numeric IDs are not interchangeable. Check the argument description.',
@@ -2908,3 +2910,126 @@ JSON OUTPUT:
   An installed but stopped agent returns running=false and exits successfully.
   Version is null when unavailable. A missing or unreadable installation is an error.
 `;
+exports.OPTION_CONTEXT = 'Connection and scope context: default, git, link or a saved name. Overrides the globally active context for this invocation.';
+exports.DESC_CONTEXT = 'Manage connection and workspace/project contexts';
+exports.DESC_CONTEXT_ADD = 'Save a named context without activating it';
+exports.DESC_CONTEXT_LIST = 'List built-in and saved contexts without resolving their sources';
+exports.DESC_CONTEXT_SHOW = 'Show resolved context and value sources without changing the active context';
+exports.DESC_CONTEXT_USE = 'Select the globally active context';
+exports.DESC_CONTEXT_REMOVE = 'Remove a saved context; removing the active context selects default';
+exports.OPTION_CONTEXT_NAME = 'Context name';
+exports.OPTION_CONTEXT_LINK = 'Resolve workspace and project from .bdy/project.json in the current directory';
+exports.OPTION_CONTEXT_GIT = 'Resolve workspace and project from a Buddy Git remote in the current repository';
+exports.OPTION_CONTEXT_REMOTE = 'Git remote to read with --from-git. Default: origin';
+exports.OPTION_CONTEXT_TOKEN = 'REST API token for this context; omitted means inherit the default authentication mechanism';
+exports.OPTION_CONTEXT_API = 'HTTPS API endpoint for this context; omitted means inherit the default endpoint mechanism';
+exports.TXT_CONTEXT_HINT = "Run 'bdy context list' to see available contexts, or use --context default.";
+exports.TXT_CONTEXT_GIT_HINT = "Run in a Buddy clone with an origin remote, or create a context with 'bdy context add <name> --from-git --remote <remote>'.";
+exports.TXT_CONTEXT_LINK_HINT = "Run 'bdy project link' in this directory, or use --context default.";
+const ERR_CONTEXT_UNKNOWN = (name) => `Context not found: ${name}`;
+exports.ERR_CONTEXT_UNKNOWN = ERR_CONTEXT_UNKNOWN;
+exports.ERR_CONTEXT_RESERVED = 'The built-in contexts default, git and link cannot be changed or removed.';
+const ERR_CONTEXT_EXISTS = (name) => `Context already exists: ${name}. Remove it before creating a replacement.`;
+exports.ERR_CONTEXT_EXISTS = ERR_CONTEXT_EXISTS;
+exports.ERR_CONTEXT_NAME = 'Use a context name containing letters, numbers, underscores or hyphens, starting with a letter or number.';
+exports.ERR_CONTEXT_SOURCE = 'Choose exactly one scope source: workspace/project values, --from-link or --from-git. --remote requires --from-git.';
+exports.ERR_CONTEXT_PROJECT = 'A context with a project must also specify a workspace.';
+exports.ERR_CONTEXT_API = 'Provide an HTTPS API endpoint without credentials, a path, query or fragment.';
+exports.ERR_CONTEXT_GIT_MISSING = 'Git is not installed or cannot be executed.';
+exports.ERR_CONTEXT_GIT_REPO = 'The current directory is not an accessible Git repository.';
+const ERR_CONTEXT_GIT_REMOTE = (remote) => `Git remote not found or unreadable: ${remote}`;
+exports.ERR_CONTEXT_GIT_REMOTE = ERR_CONTEXT_GIT_REMOTE;
+exports.ERR_CONTEXT_GIT_URL = 'The selected remote is not a supported Buddy repository URL.';
+exports.ERR_CONTEXT_LINK_MISSING = 'No project link exists in the current directory.';
+exports.ERR_CONTEXT_LINK_INVALID = 'The project link is unreadable or does not contain a workspace and project.';
+const TXT_CONTEXT_SAVED = (name) => `Context saved: ${name}`;
+exports.TXT_CONTEXT_SAVED = TXT_CONTEXT_SAVED;
+const TXT_CONTEXT_ACTIVE = (name) => `Active context: ${name}`;
+exports.TXT_CONTEXT_ACTIVE = TXT_CONTEXT_ACTIVE;
+const TXT_CONTEXT_REMOVED = (name) => `Context removed: ${name}`;
+exports.TXT_CONTEXT_REMOVED = TXT_CONTEXT_REMOVED;
+exports.HELP_CONTEXT = `
+Built-in contexts:
+  default: existing flags, environment and configuration rules, including sandbox precedence.
+  git: workspace/project from remote origin of the current Buddy repository (HTTPS or SSH).
+  link: workspace/project from .bdy/project.json in the current directory; no ancestor search.
+
+Named contexts inherit authentication and endpoint resolution when omitted.
+Workspace and project never inherit from default, environment or project links.
+--from-link and --from-git save a dynamic source, not its current values.
+An unavailable source is an error; sources never fall back to each other.
+Explicit command flags override context values. Changing workspace drops the
+context project unless --project is also given. --scope workspace keeps workspace scope.
+Contexts do not select pipeline branches or revisions.
+
+--context <name> overrides the active context for one invocation.
+Without it, the saved active context is used; initially this is default.
+Use per-invocation selection in concurrent scripts and agents.
+show resolves locally without authenticating or making API calls. Token output
+contains only availability and source, never its value; availability does not
+prove authentication. list does not resolve Git or project links.
+Built-in names are reserved. Removing an active custom context selects default.
+login/logout, register, workspace set and project link use the default configuration.
+`;
+exports.TXT_CONTEXT_WORKSPACE_HINT = 'Pass --workspace <domain> or select a context containing a workspace.';
+exports.TXT_CONTEXT_PROJECT_HINT = 'Pass --project <name> or select a context containing a project.';
+exports.ERR_CONTEXT_GIT_TIMEOUT = 'Git timed out while reading the repository remote.';
+exports.ERR_CONTEXT_GIT_FAILED = 'Git could not read the repository remote.';
+const TXT_CONTEXT_REMOVE_CONFIRM = (name) => `Remove context "${name}" and its saved token? If active, default will be selected.`;
+exports.TXT_CONTEXT_REMOVE_CONFIRM = TXT_CONTEXT_REMOVE_CONFIRM;
+exports.TXT_CONTEXT_LABEL = 'Context';
+exports.TXT_CONTEXT_SOURCE_LABEL = 'Source';
+exports.TXT_CONTEXT_WORKSPACE_LABEL = 'Workspace';
+exports.TXT_CONTEXT_PROJECT_LABEL = 'Project';
+exports.TXT_CONTEXT_API_LABEL = 'API';
+exports.TXT_CONTEXT_REMOTE_LABEL = 'Remote';
+exports.TXT_CONTEXT_TOKEN_LABEL = 'Token';
+exports.TXT_CONTEXT_TOKEN_AVAILABLE = 'available';
+exports.TXT_CONTEXT_TOKEN_MISSING = 'missing';
+exports.EXAMPLE_CONTEXT_ADD = [
+    { description: 'Save a fixed workspace and project', command: 'bdy context add backend --workspace acme --project backend' },
+    { description: 'Resolve the buddy remote on each invocation', command: 'bdy context add company --from-git --remote buddy' },
+];
+exports.EXAMPLE_CONTEXT_LIST = [
+    { description: 'List contexts and the active selection as JSON', command: 'bdy context list --format json' },
+];
+exports.EXAMPLE_CONTEXT_SHOW = [
+    { description: 'Inspect the current repository scope without switching contexts', command: 'bdy context show git --format json' },
+];
+exports.EXAMPLE_CONTEXT_USE = [
+    { description: 'Restore the default configuration for subsequent invocations', command: 'bdy context use default' },
+];
+exports.EXAMPLE_CONTEXT_REMOVE = [
+    { description: 'Remove a saved context without prompting', command: 'bdy context remove backend --force' },
+];
+exports.HELP_CONTEXT_ADD = `
+Save exactly one scope source: explicit --workspace/--project, --from-link or --from-git.
+--remote requires --from-git and defaults to origin. Dynamic sources are resolved
+on each invocation, not when saved. Omitted token and endpoint inherit default
+resolution; workspace and project do not inherit. Adding does not activate the context.
+Built-in names are reserved; an existing name cannot be overwritten.
+`;
+exports.HELP_CONTEXT_LIST = `
+Lists built-in and saved contexts without reading Git or project links.
+Text shows names, with * marking the globally active context. JSON includes
+name, active, builtin and source. No credentials are printed.
+`;
+exports.HELP_CONTEXT_SHOW = `
+Resolves the selected context locally without authenticating or making API calls.
+An optional name overrides the invocation's --context or globally active context
+for this inspection only. JSON includes workspace, project, api, remote and
+sources. Token output contains only availability and source, never its value.
+Availability does not prove authentication. Dynamic sources resolve in the current directory.
+`;
+exports.HELP_CONTEXT_USE = `
+Saves the active context for subsequent invocations without resolving its scope.
+For scripts and parallel agents, prefer --context <name> on each command.
+Use default to restore the existing configuration rules.
+`;
+exports.HELP_CONTEXT_REMOVE = `
+Removes a saved context and its token after confirmation; --force skips the prompt.
+Built-in contexts cannot be removed. Removing the active context selects default.
+A declined confirmation leaves both the context and selection unchanged. In JSON,
+removed is the deleted name, or null when declined; active is the current selection.
+Non-interactive commands decline without --force.
+`;

package/distTs/src/tunnel/cfg.js

@@ -1,9 +1,14 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 const path_1 = require("path");
 const fs_1 = require("fs");
 const utils_1 = require("../utils");
+const cliError_1 = __importDefault(require("../cliError"));
 const texts_1 = require("../texts");
+const texts_2 = require("../texts");
 const tunnel_1 = require("../types/tunnel");
 class Cfg {
     dir;
@@ -22,7 +27,7 @@ class Cfg {
             });
         }
         catch {
-            throw new Error((0, texts_1.ERR_CANT_CREATE_DIR_IN_HOME)('.bdy'));
+            throw new Error((0, texts_2.ERR_CANT_CREATE_DIR_IN_HOME)('.bdy'));
         }
         try {
             (0, fs_1.chmodSync)(this.dir, 0o700);
@@ -36,7 +41,7 @@ class Cfg {
             (0, fs_1.writeFileSync)(this.file, '{}', 'utf-8');
         }
         catch {
-            throw new Error((0, texts_1.ERR_CANT_CREATE_DIR_IN_HOME)('.bdy/cfg.json'));
+            throw new Error((0, texts_2.ERR_CANT_CREATE_DIR_IN_HOME)('.bdy/cfg.json'));
         }
         try {
             (0, fs_1.chmodSync)(this.file, 0o600);
@@ -252,6 +257,40 @@ class Cfg {
     getBaseUrl() {
         return this.json.baseUrl || '';
     }
+    getContexts() {
+        return { ...this.json.contexts };
+    }
+    getActiveContext() {
+        return this.json.activeContext || 'default';
+    }
+    getContext(name) {
+        if (name === 'default')
+            return null;
+        if (name === 'git')
+            return { source: 'git', remote: 'origin' };
+        if (name === 'link')
+            return { source: 'link' };
+        const contexts = this.getContexts();
+        if (!Object.hasOwn(contexts, name))
+            throw new cliError_1.default('context_not_found', (0, texts_1.ERR_CONTEXT_UNKNOWN)(name), texts_1.TXT_CONTEXT_HINT);
+        return contexts[name];
+    }
+    setContext(name, context) {
+        this.json.contexts = { ...this.getContexts(), [name]: context };
+        this.save();
+    }
+    setActiveContext(name) {
+        this.getContext(name);
+        this.json.activeContext = name;
+        this.save();
+    }
+    removeContext(name) {
+        this.getContext(name);
+        delete this.json.contexts[name];
+        if (this.getActiveContext() === name)
+            this.json.activeContext = 'default';
+        this.save();
+    }
     clearLogin() {
         delete this.json.apiToken;
         delete this.json.apiRefreshToken;
@@ -282,7 +321,7 @@ class Cfg {
             this.json = JSON.parse(txt);
         }
         catch {
-            throw new Error(texts_1.ERR_CONFIG_CORRUPTED);
+            throw new Error(texts_2.ERR_CONFIG_CORRUPTED);
         }
     }
     save() {
@@ -291,7 +330,7 @@ class Cfg {
             (0, fs_1.writeFileSync)(this.file, JSON.stringify(this.json, null, 4), 'utf-8');
         }
         catch {
-            throw new Error((0, texts_1.ERR_CANT_CREATE_DIR_IN_HOME)('.bdy/cfg.json'));
+            throw new Error((0, texts_2.ERR_CANT_CREATE_DIR_IN_HOME)('.bdy/cfg.json'));
         }
         try {
             (0, fs_1.chmodSync)(this.file, 0o600);

package/distTs/src/types/context.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "bdy",
   "preferGlobal": false,
-  "version": "1.25.6-dev",
+  "version": "1.25.7-dev",
   "type": "commonjs",
   "license": "MIT",
   "homepage": "https://buddy.works/docs/cli",