@atlassian-dc-mcp/common 0.17.1 → 0.19.0

package/CHANGELOG.md

@@ -3,6 +3,28 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [0.19.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.18.0...v0.19.0) (2026-04-27)
+
+
+### Features
+
+* **setup:** add CLI flags and non-interactive mode ([7de53f0](https://github.com/b1ff/atlassian-dc-mcp/commit/7de53f0b23704e84324b59bbcb8d830a1596f44a))
+
+
+
+
+
+# [0.18.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.17.1...v0.18.0) (2026-04-24)
+
+
+### Features
+
+* **setup:** validate credentials via product services with retry and friendly errors ([6056320](https://github.com/b1ff/atlassian-dc-mcp/commit/60563200e62b513fe8f3b5b4a190edfa1be25a13))
+
+
+
+
+
 ## [0.17.1](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.17.0...v0.17.1) (2026-04-23)
 
 

package/build/__tests__/args.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=args.test.d.ts.map

package/build/__tests__/args.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/args.test.ts"],"names":[],"mappings":""}

package/build/__tests__/args.test.js

@@ -0,0 +1,117 @@
+import { parseSetupArgs, printSetupHelp, SetupArgsError } from '../setup/args.js';
+describe('parseSetupArgs', () => {
+    it('returns defaults for an empty argv', () => {
+        const args = parseSetupArgs([]);
+        expect(args).toEqual({
+            host: undefined,
+            apiBasePath: undefined,
+            token: undefined,
+            defaultPageSize: undefined,
+            nonInteractive: false,
+            help: false,
+        });
+    });
+    it('parses every supported flag with = form and space form', () => {
+        const args = parseSetupArgs([
+            '--host=jira.example.com',
+            '--api-base-path',
+            '/rest/api/2',
+            '--token=secret',
+            '--default-page-size=50',
+            '--non-interactive',
+        ]);
+        expect(args).toEqual({
+            host: 'jira.example.com',
+            apiBasePath: '/rest/api/2',
+            token: 'secret',
+            defaultPageSize: '50',
+            nonInteractive: true,
+            help: false,
+        });
+    });
+    it('treats whitespace-only and empty values as not provided', () => {
+        const args = parseSetupArgs(['--host=', '--token=   ']);
+        expect(args.host).toBeUndefined();
+        expect(args.token).toBeUndefined();
+    });
+    it('supports -h as short alias for --help', () => {
+        expect(parseSetupArgs(['-h']).help).toBe(true);
+        expect(parseSetupArgs(['--help']).help).toBe(true);
+    });
+    it('supports short aliases for every flag', () => {
+        const args = parseSetupArgs([
+            '-H', 'jira.example.com',
+            '-b', '/rest/api/2',
+            '-t', 'short-token',
+            '-s', '50',
+            '-n',
+        ]);
+        expect(args).toEqual({
+            host: 'jira.example.com',
+            apiBasePath: '/rest/api/2',
+            token: 'short-token',
+            defaultPageSize: '50',
+            nonInteractive: true,
+            help: false,
+        });
+    });
+    describe('short alias mapping', () => {
+        it('-H sets host', () => {
+            expect(parseSetupArgs(['-H', 'jira.example.com']).host).toBe('jira.example.com');
+        });
+        it('-b sets api-base-path', () => {
+            expect(parseSetupArgs(['-b', '/rest/api/2']).apiBasePath).toBe('/rest/api/2');
+        });
+        it('-t sets token', () => {
+            expect(parseSetupArgs(['-t', 'secret']).token).toBe('secret');
+        });
+        it('-s sets default-page-size', () => {
+            expect(parseSetupArgs(['-s', '100']).defaultPageSize).toBe('100');
+        });
+        it('-n sets non-interactive', () => {
+            expect(parseSetupArgs(['-n']).nonInteractive).toBe(true);
+        });
+        it('short and long forms produce identical output', () => {
+            const short = parseSetupArgs([
+                '-H', 'jira.example.com',
+                '-b', '/rest',
+                '-t', 'tok',
+                '-s', '25',
+                '-n',
+            ]);
+            const long = parseSetupArgs([
+                '--host', 'jira.example.com',
+                '--api-base-path', '/rest',
+                '--token', 'tok',
+                '--default-page-size', '25',
+                '--non-interactive',
+            ]);
+            expect(short).toEqual(long);
+        });
+        it('-H is not aliased to help (lowercase -h is help, uppercase -H is host)', () => {
+            expect(parseSetupArgs(['-H', 'jira.example.com']).help).toBe(false);
+            expect(parseSetupArgs(['-h']).help).toBe(true);
+            expect(parseSetupArgs(['-h']).host).toBeUndefined();
+        });
+        it('rejects unknown single-letter flags', () => {
+            expect(() => parseSetupArgs(['-x'])).toThrow(SetupArgsError);
+        });
+    });
+    it('throws SetupArgsError on an unknown flag', () => {
+        expect(() => parseSetupArgs(['--unknown'])).toThrow(SetupArgsError);
+    });
+    it('throws SetupArgsError on a stray positional', () => {
+        expect(() => parseSetupArgs(['extra'])).toThrow(SetupArgsError);
+    });
+});
+describe('printSetupHelp', () => {
+    it('emits product-aware lines including the home file path', () => {
+        const out = [];
+        printSetupHelp('jira', (m) => out.push(m));
+        const joined = out.join('\n');
+        expect(joined).toContain('@atlassian-dc-mcp/jira setup');
+        expect(joined).toContain('--non-interactive');
+        expect(joined).toContain('~/.atlassian-dc-mcp/jira.env');
+    });
+});
+//# sourceMappingURL=args.test.js.map

package/build/__tests__/args.test.js.map

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

package/build/__tests__/describe-error.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=describe-error.test.d.ts.map

package/build/__tests__/describe-error.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-error.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/describe-error.test.ts"],"names":[],"mappings":""}

package/build/__tests__/describe-error.test.js

@@ -0,0 +1,54 @@
+import { describeValidationError } from '../setup/describe-error.js';
+describe('describeValidationError', () => {
+    it('formats HTTP errors with status, URL, and a 401 hint', () => {
+        const apiError = {
+            name: 'ApiError',
+            status: 401,
+            statusText: 'Unauthorized',
+            url: 'https://jira.example.com/rest/api/2/myself',
+            body: {},
+        };
+        expect(describeValidationError(apiError)).toBe('https://jira.example.com/rest/api/2/myself returned 401 Unauthorized. Check the host, API base path, and API token.');
+    });
+    it('formats non-auth HTTP errors without the auth hint', () => {
+        const apiError = {
+            name: 'ApiError',
+            status: 500,
+            statusText: 'Internal Server Error',
+            url: 'https://jira.example.com/rest/api/2/myself',
+        };
+        expect(describeValidationError(apiError)).toBe('https://jira.example.com/rest/api/2/myself returned 500 Internal Server Error.');
+    });
+    it('unwraps Node fetch TypeErrors with ECONNREFUSED via cause', () => {
+        const error = Object.assign(new TypeError('fetch failed'), {
+            cause: Object.assign(new Error('connect ECONNREFUSED 127.0.0.1:443'), {
+                code: 'ECONNREFUSED',
+            }),
+        });
+        expect(describeValidationError(error)).toBe('connection refused (ECONNREFUSED: connect ECONNREFUSED 127.0.0.1:443)');
+    });
+    it('unwraps DNS failures as ENOTFOUND', () => {
+        const error = Object.assign(new TypeError('fetch failed'), {
+            cause: Object.assign(new Error('getaddrinfo ENOTFOUND jira.nope'), {
+                code: 'ENOTFOUND',
+            }),
+        });
+        expect(describeValidationError(error)).toBe('could not resolve host (ENOTFOUND: getaddrinfo ENOTFOUND jira.nope)');
+    });
+    it('recognises self-signed certificate errors', () => {
+        const error = Object.assign(new TypeError('fetch failed'), {
+            cause: Object.assign(new Error('self-signed certificate'), {
+                code: 'DEPTH_ZERO_SELF_SIGNED_CERT',
+            }),
+        });
+        expect(describeValidationError(error)).toBe('server uses a self-signed TLS certificate (DEPTH_ZERO_SELF_SIGNED_CERT: self-signed certificate)');
+    });
+    it('describes aborted requests', () => {
+        const error = Object.assign(new Error('aborted'), { name: 'AbortError' });
+        expect(describeValidationError(error)).toBe('request was aborted (possibly timed out)');
+    });
+    it('falls back to the raw message when nothing else matches', () => {
+        expect(describeValidationError(new Error('something weird'))).toBe('something weird');
+    });
+});
+//# sourceMappingURL=describe-error.test.js.map

package/build/__tests__/describe-error.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-error.test.js","sourceRoot":"","sources":["../../src/__tests__/describe-error.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAErE,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,QAAQ,GAAG;YACf,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,GAAG;YACX,UAAU,EAAE,cAAc;YAC1B,GAAG,EAAE,4CAA4C;YACjD,IAAI,EAAE,EAAE;SACT,CAAC;QACF,MAAM,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAC5C,qHAAqH,CACtH,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,QAAQ,GAAG;YACf,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,GAAG;YACX,UAAU,EAAE,uBAAuB;YACnC,GAAG,EAAE,4CAA4C;SAClD,CAAC;QACF,MAAM,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAC5C,gFAAgF,CACjF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,cAAc,CAAC,EAAE;YACzD,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,oCAAoC,CAAC,EAAE;gBACpE,IAAI,EAAE,cAAc;aACrB,CAAC;SACH,CAAC,CAAC;QACH,MAAM,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CACzC,uEAAuE,CACxE,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,cAAc,CAAC,EAAE;YACzD,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,iCAAiC,CAAC,EAAE;gBACjE,IAAI,EAAE,WAAW;aAClB,CAAC;SACH,CAAC,CAAC;QACH,MAAM,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CACzC,qEAAqE,CACtE,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,cAAc,CAAC,EAAE;YACzD,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,yBAAyB,CAAC,EAAE;gBACzD,IAAI,EAAE,6BAA6B;aACpC,CAAC;SACH,CAAC,CAAC;QACH,MAAM,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CACzC,kGAAkG,CACnG,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;QAC1E,MAAM,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,CAAC,uBAAuB,CAAC,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACxF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/build/__tests__/setup-cli.test.js

@@ -2,7 +2,18 @@ import { DefaultConfigRegistry } from '../config/registry.js';
 import { HomeFileSource } from '../config/sources/home-file.js';
 import { MacosKeychainSource } from '../config/sources/macos-keychain.js';
 import { ProcessEnvSource } from '../config/sources/process-env.js';
-import { runSetup } from '../setup-cli.js';
+import { runSetup, } from '../setup-cli.js';
+function makeArgs(overrides = {}) {
+    return {
+        host: undefined,
+        apiBasePath: undefined,
+        token: undefined,
+        defaultPageSize: undefined,
+        nonInteractive: false,
+        help: false,
+        ...overrides,
+    };
+}
 const JIRA = {
     id: 'jira',
     envVars: {
@@ -67,14 +78,58 @@ class FakeHomeFile extends HomeFileSource {
         return `home-file-fake(${product.id})`;
     }
 }
+class StubCredentialValidator {
+    calls = [];
+    queue = [];
+    fallback = { ok: true };
+    returns(result) {
+        this.fallback = result;
+        return this;
+    }
+    reject(message) {
+        return this.returns({ ok: false, message });
+    }
+    enqueue(...results) {
+        this.queue.push(...results);
+        return this;
+    }
+    asFn() {
+        return async (ctx) => {
+            this.calls.push(ctx);
+            return this.queue.shift() ?? this.fallback;
+        };
+    }
+}
+function scriptedConfirms(script) {
+    return (message, fallbackDefault) => {
+        for (const [prefix, answer] of Object.entries(script)) {
+            if (message.startsWith(prefix))
+                return answer;
+        }
+        return fallbackDefault ?? false;
+    };
+}
 function makeRegistry(keychain, home) {
     return new DefaultConfigRegistry([new ProcessEnvSource(), home, keychain]);
 }
-function makePrompts(overrides = {}) {
+const standardAnswers = {
+    host: 'j-host',
+    apiBasePath: '/rest/api/2',
+    pageSize: '25',
+    token: 'secret',
+};
+function makePrompts(overrides = {}, answers = {}, confirms) {
+    const filled = { ...standardAnswers, ...answers };
     return {
-        input: async (opts) => opts.default ?? '',
-        password: async () => '',
-        confirm: async (opts) => opts.default ?? false,
+        input: async (opts) => {
+            if (opts.message.startsWith('Host'))
+                return filled.host;
+            if (opts.message.startsWith('API base path'))
+                return filled.apiBasePath;
+            return filled.pageSize;
+        },
+        password: async () => filled.token,
+        confirm: async (opts) => (confirms ?? ((_m, d) => d ?? false))(opts.message, opts.default),
         ...overrides,
     };
 }
@@ -95,18 +150,13 @@ describe('runSetup', () => {
         process.env = originalEnv;
     });
     it('writes the token to keychain first on darwin and clears home file token', async () => {
-        const prompts = makePrompts({
-            input: async (opts) => {
-                if (opts.message.startsWith('Host'))
-                    return 'j-host';
-                if (opts.message.startsWith('API base path'))
-                    return '/rest/api/2';
-                return '25';
-            },
-            password: async () => 'secret',
-        });
         const registry = makeRegistry(keychain, home);
-        await runSetup(JIRA, { registry, log: (m) => logs.push(m), exit: () => undefined, prompts });
+        await runSetup(JIRA, {
+            registry,
+            log: (m) => logs.push(m),
+            exit: () => undefined,
+            prompts: makePrompts(),
+        });
         expect(keychain.writeCalls).toBe(1);
         expect(keychain.store).toBe('secret');
         expect(home.clears).toContainEqual(['jira', 'token']);
@@ -114,53 +164,296 @@ describe('runSetup', () => {
     });
     it('falls back to home file when keychain is unavailable', async () => {
         keychain.available = false;
-        const prompts = makePrompts({
-            input: async (opts) => {
-                if (opts.message.startsWith('Host'))
-                    return 'j-host';
-                if (opts.message.startsWith('API base path'))
-                    return '/rest/api/2';
-                return '25';
-            },
-            password: async () => 'secret',
-        });
         const registry = makeRegistry(keychain, home);
-        await runSetup(JIRA, { registry, log: (m) => logs.push(m), exit: () => undefined, prompts });
+        await runSetup(JIRA, {
+            registry,
+            log: (m) => logs.push(m),
+            exit: () => undefined,
+            prompts: makePrompts(),
+        });
         expect(keychain.writeCalls).toBe(0);
         const tokenWrites = home.writes.filter(([, k]) => k === 'token');
         expect(tokenWrites).toHaveLength(1);
     });
     it('prints shadowing warning when env var is set higher than target', async () => {
         process.env.JIRA_API_TOKEN = 'shadow';
-        const prompts = makePrompts({
-            input: async (opts) => {
-                if (opts.message.startsWith('Host'))
-                    return 'j-host';
-                if (opts.message.startsWith('API base path'))
-                    return '/rest/api/2';
-                return '25';
-            },
-            password: async () => 'secret',
-        });
         const registry = makeRegistry(keychain, home);
-        await runSetup(JIRA, { registry, log: (m) => logs.push(m), exit: () => undefined, prompts });
+        await runSetup(JIRA, {
+            registry,
+            log: (m) => logs.push(m),
+            exit: () => undefined,
+            prompts: makePrompts(),
+        });
         expect(logs.some((l) => l.includes('JIRA_API_TOKEN') && l.includes('Warning'))).toBe(true);
     });
+    it('calls validateCredentials with the entered values before saving', async () => {
+        const validator = new StubCredentialValidator();
+        const registry = makeRegistry(keychain, home);
+        await runSetup(JIRA, {
+            registry,
+            log: (m) => logs.push(m),
+            exit: () => undefined,
+            prompts: makePrompts(),
+            validateCredentials: validator.asFn(),
+        });
+        expect(validator.calls).toEqual([
+            { host: 'j-host', apiBasePath: '/rest/api/2', token: 'secret' },
+        ]);
+        expect(keychain.writeCalls).toBe(1);
+    });
+    it('exits without writing when validation fails and user declines retry or save-anyway', async () => {
+        const validator = new StubCredentialValidator().reject('401 Unauthorized');
+        const exitFn = jest.fn();
+        const registry = makeRegistry(keychain, home);
+        await runSetup(JIRA, {
+            registry,
+            log: (m) => logs.push(m),
+            exit: exitFn,
+            prompts: makePrompts({}, { token: 'bad-token' }, scriptedConfirms({
+                'Try again': false,
+                'Save configuration anyway': false,
+            })),
+            validateCredentials: validator.asFn(),
+        });
+        expect(validator.calls).toHaveLength(1);
+        expect(exitFn).toHaveBeenCalledWith(1);
+        expect(keychain.writeCalls).toBe(0);
+        expect(home.writes).toHaveLength(0);
+        expect(logs.some((l) => l.includes('401 Unauthorized'))).toBe(true);
+    });
+    it('retries validation after a failure and writes once it succeeds', async () => {
+        const validator = new StubCredentialValidator().enqueue({ ok: false, message: '401 Unauthorized' }, { ok: true });
+        const registry = makeRegistry(keychain, home);
+        await runSetup(JIRA, {
+            registry,
+            log: (m) => logs.push(m),
+            exit: () => undefined,
+            prompts: makePrompts({}, {}, scriptedConfirms({ 'Try again': true })),
+            validateCredentials: validator.asFn(),
+        });
+        expect(validator.calls).toHaveLength(2);
+        expect(keychain.writeCalls).toBe(1);
+        expect(logs.some((l) => l.includes('401 Unauthorized'))).toBe(true);
+        expect(logs.some((l) => l.startsWith('Validation succeeded'))).toBe(true);
+    });
+    it('stops offering retry after the third failure and lets the user save anyway', async () => {
+        const validator = new StubCredentialValidator().reject('401 Unauthorized');
+        let retryPromptsShown = 0;
+        const confirms = (message) => {
+            if (message.startsWith('Try again')) {
+                retryPromptsShown++;
+                return true;
+            }
+            if (message.startsWith('Save configuration anyway'))
+                return true;
+            return false;
+        };
+        const registry = makeRegistry(keychain, home);
+        await runSetup(JIRA, {
+            registry,
+            log: (m) => logs.push(m),
+            exit: () => undefined,
+            prompts: makePrompts({}, {}, confirms),
+            validateCredentials: validator.asFn(),
+        });
+        expect(validator.calls).toHaveLength(3);
+        expect(retryPromptsShown).toBe(2);
+        expect(keychain.writeCalls).toBe(1);
+    });
     it('exits 130 on SIGINT cancellation before any write', async () => {
         const exitErr = Object.assign(new Error('closed'), {
             name: 'ExitPromptError',
         });
-        const prompts = makePrompts({
-            input: async () => {
-                throw exitErr;
-            },
-        });
         const exitFn = jest.fn();
         const registry = makeRegistry(keychain, home);
-        await runSetup(JIRA, { registry, log: (m) => logs.push(m), exit: exitFn, prompts });
+        await runSetup(JIRA, {
+            registry,
+            log: (m) => logs.push(m),
+            exit: exitFn,
+            prompts: makePrompts({
+                input: async () => {
+                    throw exitErr;
+                },
+            }),
+        });
         expect(exitFn).toHaveBeenCalledWith(130);
         expect(keychain.writeCalls).toBe(0);
         expect(home.writes).toHaveLength(0);
     });
+    it('skips the host prompt when --host is passed and still prompts for the rest', async () => {
+        const inputCalls = [];
+        const passwordCalls = jest.fn(async () => 'secret');
+        const registry = makeRegistry(keychain, home);
+        await runSetup(JIRA, {
+            registry,
+            log: (m) => logs.push(m),
+            exit: () => undefined,
+            args: makeArgs({ host: 'cli-host.example.com' }),
+            prompts: {
+                input: async (opts) => {
+                    inputCalls.push(opts.message);
+                    if (opts.message.startsWith('API base path'))
+                        return '/rest/api/2';
+                    return '25';
+                },
+                password: passwordCalls,
+                confirm: async (opts) => opts.default ?? false,
+            },
+        });
+        expect(inputCalls.some((m) => m.startsWith('Host'))).toBe(false);
+        expect(inputCalls.some((m) => m.startsWith('API base path'))).toBe(true);
+        expect(passwordCalls).toHaveBeenCalledTimes(1);
+        expect(home.values.jira.host).toBe('cli-host.example.com');
+    });
+    describe('non-interactive mode', () => {
+        function nonInteractivePrompts() {
+            const inputCalls = [];
+            let passwordCalls = 0;
+            return Object.assign({
+                input: async (opts) => {
+                    inputCalls.push(opts.message);
+                    return '';
+                },
+                password: async () => {
+                    passwordCalls++;
+                    return '';
+                },
+                confirm: async () => false,
+            }, {
+                inputCalls,
+                get passwordCalls() {
+                    return passwordCalls;
+                },
+            });
+        }
+        it('writes everything without prompts when all required fields come from CLI args', async () => {
+            const validator = new StubCredentialValidator();
+            const exitFn = jest.fn();
+            const registry = makeRegistry(keychain, home);
+            const prompts = nonInteractivePrompts();
+            await runSetup(JIRA, {
+                registry,
+                log: (m) => logs.push(m),
+                exit: exitFn,
+                prompts,
+                validateCredentials: validator.asFn(),
+                args: makeArgs({
+                    host: 'cli-host.example.com',
+                    token: 'cli-token',
+                    nonInteractive: true,
+                }),
+            });
+            expect(prompts.inputCalls).toHaveLength(0);
+            expect(prompts.passwordCalls).toBe(0);
+            expect(exitFn).not.toHaveBeenCalled();
+            expect(validator.calls).toEqual([
+                { host: 'cli-host.example.com', apiBasePath: '/rest/api/2', token: 'cli-token' },
+            ]);
+            expect(home.values.jira.host).toBe('cli-host.example.com');
+            expect(home.values.jira.apiBasePath).toBe('/rest/api/2');
+            expect(keychain.store).toBe('cli-token');
+        });
+        it('exits 1 when --token is missing and there is no existing token', async () => {
+            const validator = new StubCredentialValidator();
+            const exitFn = jest.fn();
+            const registry = makeRegistry(keychain, home);
+            await runSetup(JIRA, {
+                registry,
+                log: (m) => logs.push(m),
+                exit: exitFn,
+                prompts: nonInteractivePrompts(),
+                validateCredentials: validator.asFn(),
+                args: makeArgs({ host: 'cli-host.example.com', nonInteractive: true }),
+            });
+            expect(exitFn).toHaveBeenCalledWith(1);
+            expect(validator.calls).toHaveLength(0);
+            expect(keychain.writeCalls).toBe(0);
+            expect(home.writes).toHaveLength(0);
+            expect(logs.some((l) => l.includes('JIRA_API_TOKEN'))).toBe(true);
+        });
+        it('reuses an existing keychain token without rewriting it when --token is omitted', async () => {
+            keychain.store = 'kept-token';
+            const validator = new StubCredentialValidator();
+            const exitFn = jest.fn();
+            const registry = makeRegistry(keychain, home);
+            await runSetup(JIRA, {
+                registry,
+                log: (m) => logs.push(m),
+                exit: exitFn,
+                prompts: nonInteractivePrompts(),
+                validateCredentials: validator.asFn(),
+                args: makeArgs({ host: 'cli-host.example.com', nonInteractive: true }),
+            });
+            expect(exitFn).not.toHaveBeenCalled();
+            expect(validator.calls).toEqual([
+                { host: 'cli-host.example.com', apiBasePath: '/rest/api/2', token: 'kept-token' },
+            ]);
+            expect(keychain.writeCalls).toBe(0);
+            expect(keychain.store).toBe('kept-token');
+            const tokenWrites = home.writes.filter(([, k]) => k === 'token');
+            expect(tokenWrites).toHaveLength(0);
+        });
+        it('exits 1 with a format error when --default-page-size is not a positive integer', async () => {
+            const exitFn = jest.fn();
+            const registry = makeRegistry(keychain, home);
+            await runSetup(JIRA, {
+                registry,
+                log: (m) => logs.push(m),
+                exit: exitFn,
+                prompts: nonInteractivePrompts(),
+                args: makeArgs({
+                    host: 'cli-host.example.com',
+                    token: 'cli-token',
+                    defaultPageSize: 'abc',
+                    nonInteractive: true,
+                }),
+            });
+            expect(exitFn).toHaveBeenCalledWith(1);
+            expect(home.writes).toHaveLength(0);
+            expect(keychain.writeCalls).toBe(0);
+            expect(logs.some((l) => l.includes('default page size'))).toBe(true);
+        });
+        it('exits 1 on credential rejection without retrying or asking to save anyway', async () => {
+            const validator = new StubCredentialValidator().reject('401 Unauthorized');
+            const exitFn = jest.fn();
+            const confirmFn = jest.fn(async () => false);
+            const registry = makeRegistry(keychain, home);
+            await runSetup(JIRA, {
+                registry,
+                log: (m) => logs.push(m),
+                exit: exitFn,
+                prompts: { ...nonInteractivePrompts(), confirm: confirmFn },
+                validateCredentials: validator.asFn(),
+                args: makeArgs({
+                    host: 'cli-host.example.com',
+                    token: 'cli-token',
+                    nonInteractive: true,
+                }),
+            });
+            expect(validator.calls).toHaveLength(1);
+            expect(exitFn).toHaveBeenCalledWith(1);
+            expect(confirmFn).not.toHaveBeenCalled();
+            expect(keychain.writeCalls).toBe(0);
+            expect(home.writes).toHaveLength(0);
+        });
+        it('falls back to product.defaultApiBasePath and FALLBACK_PAGE_SIZE for unspecified optional fields', async () => {
+            const validator = new StubCredentialValidator();
+            const registry = makeRegistry(keychain, home);
+            await runSetup(JIRA, {
+                registry,
+                log: (m) => logs.push(m),
+                exit: () => undefined,
+                prompts: nonInteractivePrompts(),
+                validateCredentials: validator.asFn(),
+                args: makeArgs({
+                    host: 'cli-host.example.com',
+                    token: 'cli-token',
+                    nonInteractive: true,
+                }),
+            });
+            expect(home.values.jira.apiBasePath).toBe('/rest/api/2');
+            expect(home.values.jira.defaultPageSize).toBe('25');
+        });
+    });
 });
 //# sourceMappingURL=setup-cli.test.js.map