ticketlens 0.10.3 → 0.10.18

package/README.md

@@ -55,6 +55,8 @@ npx ticketlens init
 npx ticketlens CNV1-2
 ```
 
+Tip: `tl` works everywhere `ticketlens` does — running `tl`/`ticketlens config` before anything is configured also launches guided setup, no dead end. Pass `--no-input` to force non-interactive behavior even in a terminal (scripts, CI).
+
 **Prerequisites:** Node.js >=20
 
 ---

package/bin/ticketlens.mjs

@@ -7,8 +7,8 @@
  *   ticketlens triage [--stale=N] [--status=X,Y] [--profile=NAME]
  */
 
-import { createRequire } from 'node:module';
 import { parseCommand } from '../skills/jtb/scripts/lib/cli.mjs';
+import { renderWordmark } from '../skills/jtb/scripts/lib/wordmark.mjs';
 import { run as runFetch } from '../skills/jtb/scripts/fetch-ticket.mjs';
 import { run as runTriage } from '../skills/jtb/scripts/fetch-my-tickets.mjs';
 import { run as runInit } from '../skills/jtb/scripts/lib/init-wizard.mjs';
@@ -29,14 +29,13 @@ import {
 } from '../skills/jtb/scripts/lib/help.mjs';
 import { runStats } from '../skills/jtb/scripts/lib/run-stats.mjs';
 import { createStyler } from '../skills/jtb/scripts/lib/ansi.mjs';
-import { readCliToken, saveCliToken, deleteCliToken } from '../skills/jtb/scripts/lib/cli-auth.mjs';
-import { browserLogin } from '../skills/jtb/scripts/lib/browser-login.mjs';
-import { syncProfiles, getApiBase, getConsoleBase } from '../skills/jtb/scripts/lib/sync.mjs';
-import { promptSecret, promptText } from '../skills/jtb/scripts/lib/prompt-helpers.mjs';
+import { readCliToken, deleteCliToken } from '../skills/jtb/scripts/lib/cli-auth.mjs';
+import { runLogin } from '../skills/jtb/scripts/lib/login-flow.mjs';
+import { syncProfiles, reportSyncResult, getApiBase } from '../skills/jtb/scripts/lib/sync.mjs';
 import { checkForUpdate, getUpdateHint } from '../skills/jtb/scripts/lib/update-check.mjs';
 import { incrementInvocation, incrementCommand } from '../skills/jtb/scripts/lib/activity-counter.mjs';
 import { DEFAULT_CONFIG_DIR } from '../skills/jtb/scripts/lib/config.mjs';
-import { applyTeamConfigOnLogin, checkTeamJiraConfigUpdate } from '../skills/jtb/scripts/lib/team-jira-sync.mjs';
+import { checkTeamJiraConfigUpdate } from '../skills/jtb/scripts/lib/team-jira-sync.mjs';
 
 const TRACKED_COMMANDS = new Set([
   'triage', 'fetch', 'get', 'compliance', 'review', 'standup',
@@ -184,7 +183,24 @@ switch (command) {
 
     const profileArg = cmdArgs.find(a => a.startsWith('--profile='));
     const profileName = profileArg ? profileArg.split('=')[1] : undefined;
-    runConfig({ profileName }).catch(err => {
+    const isInteractive = process.stdin.isTTY && process.stdout.isTTY && !process.env.CI && !cmdArgs.includes('--no-input');
+
+    (async () => {
+      if (isInteractive) {
+        const { detectSetupState } = await import('../skills/jtb/scripts/lib/setup-state.mjs');
+        // Ready + no explicit --profile= honors the hub's own "Exit" sublabel
+        // promise ("you can rerun this any time: ticketlens config"). An
+        // explicit --profile= is a targeted, scriptable invocation — bypass
+        // the hub and edit that profile directly, unchanged from today.
+        if (detectSetupState().status !== 'ready' || !profileName) {
+          const { run: runOnboarding } = await import('../skills/jtb/scripts/lib/onboarding.mjs');
+          await runOnboarding({ stream: process.stderr });
+          return;
+        }
+      }
+
+      await runConfig({ profileName });
+    })().catch(err => {
       process.stderr.write(`Error: ${err.message}\n`);
       process.exitCode = 1;
     });
@@ -329,12 +345,9 @@ switch (command) {
     });
     break;
 
-  case 'version': {
-    const require = createRequire(import.meta.url);
-    const pkg = require('../package.json');
-    process.stdout.write(`ticketlens v${pkg.version}\n`);
+  case 'version':
+    process.stdout.write(renderWordmark({ stream: process.stdout }));
     break;
-  }
 
   case 'schedule': {
     if (cmdArgs.includes('--help') || cmdArgs.includes('-h')) { printScheduleHelp(); break; }
@@ -430,78 +443,7 @@ switch (command) {
     const useManual = cmdArgs.includes('--manual');
 
     (async () => {
-      const s = createStyler({ isTTY: process.stderr.isTTY });
-
-      let token;
-
-      if (useManual) {
-        // ── manual paste flow (CI / headless environments) ──────────────────
-        process.stderr.write(`\n  ${s.bold('TicketLens Login')}\n`);
-        process.stderr.write(`  ${s.dim('─'.repeat(44))}\n`);
-        process.stderr.write(`  ${s.dim(`Generate a CLI token at ${s.cyan(`${getConsoleBase()}/console/account`)}`)}\n`);
-        process.stderr.write(`  ${s.dim('then paste it below.')}\n\n`);
-
-        token = await promptSecret(`CLI Token ${s.dim('(tl_…)')}:`, { stream: process.stderr });
-        if (!token.startsWith('tl_')) {
-          process.stderr.write(`  ${s.red('✖')} Token must start with ${s.dim('tl_')}\n`);
-          process.exitCode = 1;
-          return;
-        }
-      } else {
-        // ── browser flow (default) ────────────────────────────────────────
-        process.stderr.write(`\n  ${s.bold('TicketLens Login')}\n`);
-        process.stderr.write(`  ${s.dim('─'.repeat(44))}\n`);
-        process.stderr.write(`  Opening browser to authorize…\n\n`);
-        process.stderr.write(`  ${s.dim('○ Waiting for authorization (120s)…')}\n`);
-
-        try {
-          token = await browserLogin();
-        } catch (err) {
-          const cancelled = err.message === 'Authorization cancelled';
-          process.stderr.write(`\x1b[A\r\x1b[2K  ${s.red('✖')} ${cancelled ? 'Login cancelled.' : err.message}\n`);
-          if (!cancelled) {
-            process.stderr.write(`\n  ${s.dim(`Try ${s.cyan('ticketlens login --manual')} to paste a token instead.`)}\n\n`);
-          }
-          process.exitCode = cancelled ? 0 : 1;
-          return;
-        }
-      }
-
-      // ── verify token against API (both flows) ─────────────────────────
-      process.stderr.write(`\n  ${s.dim('○ Verifying token…')}\n`);
-      let res;
-      try {
-        res = await fetch(`${getApiBase()}/v1/profiles`, {
-          headers: { Authorization: `Bearer ${token}`, Accept: 'application/json' },
-          signal: AbortSignal.timeout(15000),
-        });
-      } catch {
-        process.stderr.write(`\x1b[A\r\x1b[2K  ${s.red('✖')} Could not reach ${getApiBase()} — check your connection.\n`);
-        process.exitCode = 1;
-        return;
-      }
-
-      if (res.status === 401) {
-        process.stderr.write(`\x1b[A\r\x1b[2K  ${s.red('✖')} Invalid token — check the value and try again.\n`);
-        process.exitCode = 1;
-        return;
-      }
-      if (!res.ok) {
-        process.stderr.write(`\x1b[A\r\x1b[2K  ${s.red('✖')} Server returned ${res.status}. Try again later.\n`);
-        process.exitCode = 1;
-        return;
-      }
-
-      saveCliToken(token);
-      process.stderr.write(`\x1b[A\r\x1b[2K  ${s.green('✔')} Logged in.\n`);
-
-      // Flow 1: pull team Jira config for Pro/Team members (silently skipped for Free)
-      const tcLogin = await applyTeamConfigOnLogin().catch(() => null);
-      if (tcLogin?.ok) {
-        process.stderr.write(`  ${s.dim(`○ Team Jira config applied for ${s.cyan(tcLogin.groupName)}.`)}\n`);
-      }
-
-      process.stderr.write(`\n  Run ${s.cyan('ticketlens sync')} to pull your connections.\n\n`);
+      await runLogin({ manual: useManual });
     })().catch(err => {
       process.stderr.write(`Error: ${err.message}\n`);
       process.exitCode = 1;
@@ -525,42 +467,14 @@ switch (command) {
 
       const result = await syncProfiles();
 
-      if (result.error === 'no-token') {
-        process.stderr.write(`\x1b[A\r\x1b[2K  ${s.red('✖')} Not logged in. Run ${s.cyan('ticketlens login')} first.\n\n`);
-        process.exitCode = 1;
-        return;
-      }
-      if (result.error === 'unauthorized') {
-        process.stderr.write(`\x1b[A\r\x1b[2K  ${s.red('✖')} Token expired or revoked. Run ${s.cyan('ticketlens login')} to re-authenticate.\n\n`);
-        process.exitCode = 1;
-        return;
-      }
+      process.stderr.write('\x1b[A\r\x1b[2K');
+      reportSyncResult(result, { stream: process.stderr });
       if (result.error) {
-        process.stderr.write(`\x1b[A\r\x1b[2K  ${s.red('✖')} Sync failed: ${result.error}\n\n`);
+        process.stderr.write('\n');
         process.exitCode = 1;
         return;
       }
 
-      const { added, updated, unchanged, needsCredentials } = result;
-      const total = added.length + updated.length + unchanged.length;
-
-      process.stderr.write(`\x1b[A\r\x1b[2K  ${s.green('✔')} Sync complete`);
-      if (total === 0) {
-        process.stderr.write(` — no profiles on console yet.\n`);
-      } else {
-        process.stderr.write(`\n`);
-        if (added.length)     process.stderr.write(`  ${s.dim('+')} ${added.length} added: ${added.map(n => s.cyan(n)).join(', ')}\n`);
-        if (updated.length)   process.stderr.write(`  ${s.dim('↑')} ${updated.length} updated: ${updated.map(n => s.cyan(n)).join(', ')}\n`);
-        if (unchanged.length) process.stderr.write(`  ${s.dim('○')} ${unchanged.length} unchanged\n`);
-      }
-
-      if (needsCredentials.length > 0) {
-        process.stderr.write(`\n  ${s.yellow('!')} These profiles need credentials before they can be used:\n`);
-        for (const name of needsCredentials) {
-          process.stderr.write(`    ${s.dim('○')} ${s.cyan(name)} — run: ${s.bold(`ticketlens config --profile=${name}`)}\n`);
-        }
-      }
-
       // Flow 3: also pull team Jira config update (Pro/Team); silently skipped for Free
       const tcSync = await checkTeamJiraConfigUpdate().catch(() => null);
       if (tcSync?.banner) {
@@ -694,7 +608,23 @@ switch (command) {
   }
 
   case 'help':
-  default:
-    printHelp();
+  default: {
+    const isInteractive = args.length === 0 && process.stdin.isTTY && process.stdout.isTTY && !process.env.CI;
+
+    (async () => {
+      if (isInteractive) {
+        const { detectSetupState } = await import('../skills/jtb/scripts/lib/setup-state.mjs');
+        if (detectSetupState().status !== 'ready') {
+          const { run: runOnboarding } = await import('../skills/jtb/scripts/lib/onboarding.mjs');
+          await runOnboarding({ stream: process.stderr });
+          return;
+        }
+      }
+      printHelp();
+    })().catch(err => {
+      process.stderr.write(`Error: ${err.message}\n`);
+      process.exitCode = 1;
+    });
     break;
+  }
 }

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "ticketlens",
-  "version": "0.10.3",
+  "version": "0.10.18",
   "description": "Jira CLI for developers — fetch ticket context, triage your queue, and stop tab-switching. Zero dependencies, all local.",
   "type": "module",
   "bin": {
-    "ticketlens": "bin/ticketlens.mjs"
+    "ticketlens": "bin/ticketlens.mjs",
+    "tl": "bin/ticketlens.mjs"
   },
   "files": [
     "bin/",

package/scripts/postinstall.mjs

@@ -12,6 +12,7 @@ import { homedir } from 'node:os';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const SKILL_SRC = join(__dirname, '..', 'skills', 'jtb', 'SKILL.md');
+const OWN_BIN = join(__dirname, '..', 'bin', 'ticketlens.mjs');
 
 if (!existsSync(SKILL_SRC)) process.exit(0);
 
@@ -60,3 +61,36 @@ if (updated === 0 && skipped === TARGETS.length) {
   console.log('  ℹ /jtb skill not installed in any known location.');
   console.log('    To install: ticketlens update-skill');
 }
+
+// First-run banner + tl-alias status. Best-effort: npm >=7 hides this output
+// unless the user passes --foreground-scripts, so the guaranteed channel is
+// the first bare `tl`/`ticketlens` run added in a later phase. Never throws —
+// a broken banner must not break the install.
+try {
+  const { renderWordmark } = await import('../skills/jtb/scripts/lib/wordmark.mjs');
+  const { checkAliasStatus } = await import('../skills/jtb/scripts/lib/alias-status.mjs');
+  const { loadProfiles } = await import('../skills/jtb/scripts/lib/profile-resolver.mjs');
+
+  console.log('\n' + renderWordmark({ stream: process.stdout }));
+
+  const profiles = loadProfiles();
+  const isConfigured = !!(profiles && Object.keys(profiles.profiles || {}).length > 0);
+
+  const alias = checkAliasStatus({ selfBinPath: OWN_BIN });
+  if (alias.status === 'active') {
+    console.log('  ✔ Also available as: tl');
+  } else if (alias.status === 'shadowed') {
+    console.log(`  ⚠ 'tl' on this machine points to ${alias.foreignPath} — use 'ticketlens' instead.`);
+  }
+  // alias.status === 'missing' → npm bin dir not on PATH is a broader problem
+  // this script can't fix; saying nothing avoids confusing the user further.
+
+  if (isConfigured) {
+    console.log('  → Try  tl triage');
+  } else {
+    console.log('  → New here? Run  tl  to launch the guided setup.');
+  }
+  console.log('');
+} catch {
+  // Silent on failure — never breaks the install.
+}

package/skills/jtb/SKILL.md

@@ -1,4 +1,4 @@
-<!-- jtb-skill-version: 0.10.3 -->
+<!-- jtb-skill-version: 0.10.18 -->
 ---
 name: jtb
 description: Fetch a Jira ticket's full context (description, comments, linked issues, code references) and assemble a structured TicketBrief for implementation planning. Use when user types /jtb, mentions a Jira ticket key, or wants to plan work from a Jira ticket.
@@ -59,7 +59,7 @@ TicketLens supports two connection methods — check in this order:
 
 **1. Profile config (recommended):** If `~/.ticketlens/profiles.json` exists, no env vars
 are needed. Profile resolution is automatic (by ticket prefix, project path, or `--profile`).
-Setup via `ticketlens init`.
+Setup via `ticketlens init` (`tl init` also works — `tl` is shorthand for `ticketlens`).
 
 **2. Env var fallback:** If no profile config exists, these must be set:
 - `JIRA_BASE_URL` — e.g. `https://yourteam.atlassian.net`

package/skills/jtb/scripts/lib/alias-status.mjs

@@ -0,0 +1,73 @@
+/**
+ * Detects whether the `tl` shorthand resolves to this package's own
+ * bin/ticketlens.mjs, a foreign binary shadowing it on PATH, or nothing.
+ * Pure filesystem checks only — no subprocess spawning, no network.
+ */
+
+import { existsSync, accessSync, realpathSync, constants as fsConstants } from 'node:fs';
+import { join, dirname } from 'node:path';
+
+const DEFAULT_PATHEXT = '.COM;.EXE;.BAT;.CMD';
+
+/**
+ * Scan PATH for the first executable matching binName. Never throws —
+ * an unreadable or missing directory is skipped, not fatal.
+ */
+export function findOnPath(binName, { env = process.env, platform = process.platform } = {}) {
+  const isWin = platform === 'win32';
+  // PATH delimiter depends on the target platform, not the host running this
+  // code — node:path's `delimiter` is host-bound and wrong when platform is
+  // passed explicitly (e.g. testing win32 logic from a POSIX host).
+  const dirs = (env.PATH || env.Path || '').split(isWin ? ';' : ':').filter(Boolean);
+  const candidates = isWin
+    ? [...(env.PATHEXT || DEFAULT_PATHEXT).split(';').map((ext) => binName + ext), binName]
+    : [binName];
+
+  for (const dir of dirs) {
+    for (const name of candidates) {
+      try {
+        const full = join(dir, name);
+        if (!existsSync(full)) continue;
+        // POSIX: skip non-executable matches (a shell would too). Windows PATHEXT
+        // already restricts candidates to executable extensions, so no check needed.
+        if (!isWin) accessSync(full, fsConstants.X_OK);
+        return full;
+      } catch {
+        continue;
+      }
+    }
+  }
+  return null;
+}
+
+/**
+ * Compare where `tl` resolves against our own installed ticketlens binary.
+ * POSIX: realpath comparison (npm bins are symlinks) against selfBinPath.
+ * Windows: npm .cmd/.ps1 shims aren't real symlinks, and selfBinPath (the
+ * package's internal target script under node_modules) lives in a different
+ * directory than the shims themselves — comparing against it always reads
+ * as foreign. Instead, npm always installs every bin entry from one package
+ * into the same shim directory together, so confirm ownership by checking
+ * whether a `ticketlens` shim sits alongside the found `tl` shim.
+ */
+export function checkAliasStatus({ selfBinPath, env = process.env, platform = process.platform } = {}) {
+  try {
+    const tlPath = findOnPath('tl', { env, platform });
+    if (!tlPath) return { status: 'missing' };
+
+    if (platform === 'win32') {
+      const ticketlensPath = findOnPath('ticketlens', { env, platform });
+      return ticketlensPath && dirname(tlPath) === dirname(ticketlensPath)
+        ? { status: 'active' }
+        : { status: 'shadowed', foreignPath: tlPath };
+    }
+
+    const resolvedTl = realpathSync(tlPath);
+    const resolvedSelf = realpathSync(selfBinPath);
+    return resolvedTl === resolvedSelf
+      ? { status: 'active' }
+      : { status: 'shadowed', foreignPath: tlPath };
+  } catch {
+    return { status: 'missing' };
+  }
+}

package/skills/jtb/scripts/lib/api-utils.mjs

@@ -4,7 +4,7 @@
  */
 
 export const DEFAULT_API_BASE = 'https://api.ticketlens.app';
-export const DEFAULT_SITE_BASE = 'https://ticketlens.dev';
+export const DEFAULT_SITE_BASE = 'https://ticketlens.app';
 
 // Matches localhost, 127.0.0.1, and any hostname ending in .test or .local,
 // with an optional port — all treated as local-only addresses.

package/skills/jtb/scripts/lib/cli.mjs

@@ -8,7 +8,7 @@ export const TICKET_KEY_PATTERN = /^[A-Z][A-Z0-9]+-\d+$/;
 export function parseCommand(args) {
   const first = args[0];
 
-  if (args.length === 0 || first === '--help' || first === '-h') {
+  if (args.length === 0 || first === '--help' || first === '-h' || first === '--no-input') {
     return { command: 'help', args: [] };
   }
 

package/skills/jtb/scripts/lib/config.mjs

@@ -11,21 +11,35 @@ import { homedir } from 'node:os';
 /** Canonical config directory: ~/.ticketlens */
 export const DEFAULT_CONFIG_DIR = join(homedir(), '.ticketlens');
 
-/** Read package.json version once per process, memoized.
+/** Read package.json once per process, memoized.
  * Uses realpathSync to resolve symlinks before navigating, so the correct
- * package.json is found whether the module is loaded via a symlink or directly.
+ * package.json is found whether the module is loaded via a symlink (e.g.
+ * the npm-managed `tl` bin) or directly.
  */
-let _version;
-export function getVersion() {
-  if (_version) return _version;
+let _pkg;
+function _readPkg() {
+  if (_pkg) return _pkg;
   try {
     const realDir = dirname(realpathSync(fileURLToPath(import.meta.url)));
-    const pkg = JSON.parse(readFileSync(join(realDir, '..', '..', '..', '..', 'package.json'), 'utf8'));
-    _version = pkg.version || '0.0.0';
+    _pkg = JSON.parse(readFileSync(join(realDir, '..', '..', '..', '..', 'package.json'), 'utf8'));
   } catch {
-    _version = '0.0.0';
+    _pkg = {};
   }
-  return _version;
+  return _pkg;
+}
+
+export function getVersion() {
+  return _readPkg().version || '0.0.0';
+}
+
+/** Metadata used by the first-run wordmark banner. */
+export function getPackageMeta() {
+  const pkg = _readPkg();
+  return {
+    version: pkg.version || '0.0.0',
+    author: pkg.author || 'unknown',
+    repository: typeof pkg.repository === 'string' ? pkg.repository : (pkg.repository?.url || ''),
+  };
 }
 
 /** Human-readable relative time from an ISO date string. */

package/skills/jtb/scripts/lib/connection-tester.mjs

@@ -0,0 +1,53 @@
+/**
+ * Tests every configured profile's connection, one at a time with a spinner
+ * per profile — the same pattern init-wizard.mjs/config-wizard.mjs already
+ * use for a single profile, just looped across all of them.
+ */
+
+import { createSession } from './banner.mjs';
+import { classifyError } from './error-classifier.mjs';
+import { resolveAdapter } from './resolve-adapter.mjs';
+import { loadProfiles, loadCredentials } from './profile-resolver.mjs';
+import { DEFAULT_CONFIG_DIR } from './config.mjs';
+
+export async function testConnections({
+  configDir = DEFAULT_CONFIG_DIR,
+  stream = process.stderr,
+  resolveAdapterFn = resolveAdapter,
+} = {}) {
+  const config = loadProfiles(configDir);
+  const names = config ? Object.keys(config.profiles) : [];
+  const creds = loadCredentials(configDir);
+  const results = [];
+
+  for (const name of names) {
+    const profile = config.profiles[name];
+    const profileCreds = creds[name] || {};
+    const conn = {
+      baseUrl: profile.baseUrl,
+      auth: profile.auth,
+      email: profile.email,
+      apiToken: profileCreds.apiToken,
+      pat: profileCreds.pat,
+    };
+
+    const session = createSession(
+      { baseUrl: conn.baseUrl, profileName: name, email: conn.email || undefined, pat: conn.auth === 'pat' ? conn.pat : undefined },
+      { stream },
+    );
+    session.spin('Testing connection...');
+
+    try {
+      await resolveAdapterFn(conn).fetchCurrentUser();
+      session.connected();
+      results.push({ name, ok: true });
+    } catch (err) {
+      session.failed();
+      const classified = classifyError(err, { baseUrl: conn.baseUrl, profileName: name });
+      session.footer(classified.message, 'error', classified.hint);
+      results.push({ name, ok: false, error: classified.message });
+    }
+  }
+
+  return { results, failedCount: results.filter(r => !r.ok).length };
+}

package/skills/jtb/scripts/lib/help.mjs

@@ -3,12 +3,11 @@
  */
 
 import { createStyler } from './ansi.mjs';
-import { getVersion } from './config.mjs';
+import { renderWordmark } from './wordmark.mjs';
 
 export function printHelp({ stream = process.stdout } = {}) {
   const isTTY = stream.isTTY;
   const s = createStyler({ isTTY });
-  const v = getVersion();
 
   // Column targets (visible chars):
   //   USAGE: command portion = 36, so descriptions always start at the same column
@@ -18,12 +17,11 @@ export function printHelp({ stream = process.stdout } = {}) {
   // ANSI codes (s.cyan, s.dim) add invisible bytes — they do NOT affect visible width.
 
   const lines = [
-    '',
-    `  ${s.bold(s.brand('◆ TicketLens'))} ${s.dim(`v${v}`)}`,
-    `  ${s.dim('Stop tab-switching. Start building.')}`,
     '',
     `  ${s.bold('USAGE')}`,
     '',
+    `    ${s.brand('tl')} ${s.dim('<anything>')}                       Shorthand for ${s.brand('ticketlens')}`,
+    '',
     // Alignment targets (visible chars before description):
     //   Groups 1–2 (auth/setup):          column 40  (command portion ≤ 24)
     //   Group 3 (daily use):              column 42  (longest: "review [--branch=BRANCH]" = 39)
@@ -56,6 +54,10 @@ export function printHelp({ stream = process.stdout } = {}) {
     `    ${s.brand('ticketlens')} cloud-keys ${s.dim('[add|remove|list|test]')}  Manage your encrypted AI provider keys  ${s.dim('[Pro]')}`,
     `    ${s.brand('ticketlens')} update-skill ${s.dim('[--dry-run]')}    Update /jtb skill in Claude Code and other AI assistants`,
     '',
+    `  ${s.bold('GLOBAL OPTIONS')}`,
+    '',
+    `    ${s.brand('--no-input')}          Force non-interactive behavior even in a terminal`,
+    '',
     `  ${s.bold('FETCH OPTIONS')}`,
     '',
     // visible widths: "--profile=NAME"=14, "--depth=N"=9, "--plain"=7, "--styled"=8,
@@ -125,7 +127,7 @@ export function printHelp({ stream = process.stdout } = {}) {
     '',
   ];
 
-  stream.write(lines.join('\n') + '\n');
+  stream.write(renderWordmark({ stream }) + lines.join('\n') + '\n');
 }
 
 export function printFetchHelp({ stream = process.stdout } = {}) {

package/skills/jtb/scripts/lib/init-wizard.mjs

@@ -14,8 +14,10 @@ import { loadProfiles, saveProfile, saveDefault } from './profile-resolver.mjs';
 import { resolveAdapter } from './resolve-adapter.mjs';
 import { promptSelect } from './select-prompt.mjs';
 import { runSwitch } from './profile-switcher.mjs';
+import { renderWordmark } from './wordmark.mjs';
+import { printQuickStart } from './quick-start-panel.mjs';
 import { DEFAULT_CONFIG_DIR } from './config.mjs';
-import { visLen, SERVER_AUTH_TYPES, promptText, promptSecret, promptYN } from './prompt-helpers.mjs';
+import { SERVER_AUTH_TYPES, promptText, promptSecret, promptYN } from './prompt-helpers.mjs';
 
 const RETRY_OPTIONS = [
   { label: 'Retry',             sublabel: 'Try again — same credentials (e.g. VPN just connected)', value: 'retry' },
@@ -51,7 +53,7 @@ async function probeProtocol(host, { stream, s }) {
 
 // ── Main wizard ───────────────────────────────────────────────────────────────
 
-export async function run({ configDir = DEFAULT_CONFIG_DIR } = {}) {
+export async function run({ configDir = DEFAULT_CONFIG_DIR, showBanner = true, showQuickStart = true } = {}) {
   const stream = process.stderr;
   const s = createStyler({ isTTY: stream.isTTY });
 
@@ -65,27 +67,22 @@ export async function run({ configDir = DEFAULT_CONFIG_DIR } = {}) {
   process.on('SIGINT', onSigint);
 
   try {
-    await _run({ configDir, stream, s });
+    await _run({ configDir, stream, s, showBanner, showQuickStart });
   } finally {
     process.removeListener('SIGINT', onSigint);
   }
 }
 
-async function _run({ configDir, stream, s }) {
-  // Welcome box
-  const headerLines = [
-    `${s.bold(s.cyan('◆ TicketLens'))} — Setup Wizard`,
-    `${s.dim("Let's configure your tracker connection.")}`,
-  ];
-  const innerWidth = headerLines.reduce((max, l) => Math.max(max, visLen(l)), 0) + 4;
-  const bc = s.cyan;
-  stream.write('\n');
-  stream.write(bc('╭' + '─'.repeat(innerWidth) + '╮') + '\n');
-  for (const line of headerLines) {
-    const pad = innerWidth - visLen(line) - 1;
-    stream.write(bc('│') + ' ' + line + ' '.repeat(Math.max(0, pad)) + bc('│') + '\n');
+async function _run({ configDir, stream, s, showBanner, showQuickStart }) {
+  // Welcome banner — same wordmark as --help/--version, so a brand-new user's
+  // very first output looks like the same product (Phase 1's renderWordmark()
+  // was built reusable for exactly this; not duplicating the art). Suppressed
+  // when invoked from the onboarding hub, which already showed its own banner
+  // — otherwise the user sees it twice in the fresh-install flow.
+  if (showBanner) {
+    stream.write(renderWordmark({ stream }));
+    stream.write(`\n${s.dim("Let's configure your tracker connection.")}\n`);
   }
-  stream.write(bc('╰' + '─'.repeat(innerWidth) + '╯') + '\n');
 
   let addedCount = 0;
   let addAnother = true;
@@ -575,25 +572,9 @@ async function _run({ configDir, stream, s }) {
   const profileWord = addedCount === 1 ? '1 profile' : `${addedCount} profiles`;
   stream.write(`\n  ${s.green('✔')} ${profileWord} configured.\n\n`);
 
-  // Quick-start panel
-  const cmds = [
-    ['ticketlens triage',   'Scan your assigned tickets'],
-    ['ticketlens <TICKET-KEY>', 'Fetch a specific ticket'],
-    ['ticketlens switch',   'Switch active profile'],
-    ['ticketlens --help',   'Full command reference'],
-  ];
-  const cmdWidth = cmds.reduce((max, [c]) => Math.max(max, c.length), 0);
-  const cmdRows = cmds.map(([cmd, desc]) =>
-    `  ${s.bold(s.cyan(cmd.padEnd(cmdWidth)))}   ${s.dim(desc)}`
-  );
-  const QTITLE = ' Quick start ';
-  const contentWidth = cmdRows.reduce((max, r) => Math.max(max, visLen(r)), 0);
-  const qWidth = Math.max(contentWidth + 2, QTITLE.length + 4);
-  const qPad = (r) => ' ' + r + ' '.repeat(Math.max(0, qWidth - visLen(r) - 1));
-  const qTitleFill = qWidth - 1 - QTITLE.length;
-  stream.write(bc('╭') + bc('─') + s.bold(s.cyan(QTITLE)) + bc('─'.repeat(Math.max(0, qTitleFill))) + bc('╮') + '\n');
-  stream.write(bc('│') + qPad('') + bc('│') + '\n');
-  for (const r of cmdRows) stream.write(bc('│') + qPad(r) + bc('│') + '\n');
-  stream.write(bc('│') + qPad('') + bc('│') + '\n');
-  stream.write(bc('╰') + bc('─'.repeat(qWidth)) + bc('╯') + '\n\n');
+  // Suppressed when invoked from the onboarding hub, which owns showing this
+  // exactly once after its own menu loop exits — otherwise the user sees it twice.
+  if (showQuickStart) {
+    printQuickStart({ stream, s });
+  }
 }