ticketlens 0.1.3 → 0.1.5

package/bin/ticketlens.mjs

@@ -17,7 +17,13 @@ import { run as runConfig } from '../skills/jtb/scripts/lib/config-wizard.mjs';
 import { activateLicense, checkLicense, revalidateIfStale, isLicensed, showUpgradePrompt, readLicense } from '../skills/jtb/scripts/lib/license.mjs';
 import { deleteProfile, loadProfiles } from '../skills/jtb/scripts/lib/profile-resolver.mjs';
 import { run as runCache } from '../skills/jtb/scripts/lib/cache-manager.mjs';
-import { printHelp, printProfiles } from '../skills/jtb/scripts/lib/help.mjs';
+import {
+  printHelp, printProfiles,
+  printLoginHelp, printLogoutHelp, printSyncHelp,
+  printActivateHelp, printLicenseHelp, printDeleteHelp,
+  printProfilesHelp, printScheduleHelp,
+  printInitHelp, printSwitchHelp, printConfigHelp,
+} from '../skills/jtb/scripts/lib/help.mjs';
 import { createStyler } from '../skills/jtb/scripts/lib/ansi.mjs';
 import { readCliToken, saveCliToken, deleteCliToken } from '../skills/jtb/scripts/lib/cli-auth.mjs';
 import { syncProfiles, getApiBase, getConsoleBase } from '../skills/jtb/scripts/lib/sync.mjs';
@@ -45,6 +51,7 @@ switch (command) {
     break;
 
   case 'init':
+    if (cmdArgs.includes('--help') || cmdArgs.includes('-h')) { printInitHelp(); break; }
     runInit().catch(err => {
       process.stderr.write(`Error: ${err.message}\n`);
       process.exitCode = 1;
@@ -52,6 +59,7 @@ switch (command) {
     break;
 
   case 'switch':
+    if (cmdArgs.includes('--help') || cmdArgs.includes('-h')) { printSwitchHelp(); break; }
     runSwitch().catch(err => {
       process.stderr.write(`Error: ${err.message}\n`);
       process.exitCode = 1;
@@ -59,6 +67,7 @@ switch (command) {
     break;
 
   case 'config': {
+    if (cmdArgs.includes('--help') || cmdArgs.includes('-h')) { printConfigHelp(); break; }
     const profileArg = cmdArgs.find(a => a.startsWith('--profile='));
     const profileName = profileArg ? profileArg.split('=')[1] : undefined;
     runConfig({ profileName }).catch(err => {
@@ -69,6 +78,7 @@ switch (command) {
   }
 
   case 'activate': {
+    if (cmdArgs.includes('--help') || cmdArgs.includes('-h')) { printActivateHelp(); break; }
     const s = createStyler({ isTTY: process.stdout.isTTY });
     const key = cmdArgs.find(a => !a.startsWith('--'));
     if (!key) {
@@ -90,6 +100,7 @@ switch (command) {
   }
 
   case 'license': {
+    if (cmdArgs.includes('--help') || cmdArgs.includes('-h')) { printLicenseHelp(); break; }
     const s = createStyler({ isTTY: process.stdout.isTTY });
     const status = checkLicense();
     const daysSinceVal = status.validatedAt
@@ -131,6 +142,7 @@ switch (command) {
   }
 
   case 'delete': {
+    if (cmdArgs.includes('--help') || cmdArgs.includes('-h')) { printDeleteHelp(); break; }
     const s = createStyler({ isTTY: process.stderr.isTTY });
     const profileName = cmdArgs.find(a => !a.startsWith('--'));
     if (!profileName) {
@@ -182,6 +194,7 @@ switch (command) {
   }
 
   case 'profiles': {
+    if (cmdArgs.includes('--help') || cmdArgs.includes('-h')) { printProfilesHelp(); break; }
     const plain = cmdArgs.includes('--plain');
     const config = loadProfiles();
     printProfiles({ config, plain });
@@ -203,6 +216,7 @@ switch (command) {
   }
 
   case 'schedule': {
+    if (cmdArgs.includes('--help') || cmdArgs.includes('-h')) { printScheduleHelp(); break; }
     const subCmd = cmdArgs[0];
 
     if (subCmd === '--stop') {
@@ -262,6 +276,7 @@ switch (command) {
     break;
 
   case 'login': {
+    if (cmdArgs.includes('--help') || cmdArgs.includes('-h')) { printLoginHelp(); break; }
     (async () => {
       const s = createStyler({ isTTY: process.stderr.isTTY });
       process.stderr.write(`\n  ${s.bold('TicketLens Login')}\n`);
@@ -312,6 +327,7 @@ switch (command) {
   }
 
   case 'logout': {
+    if (cmdArgs.includes('--help') || cmdArgs.includes('-h')) { printLogoutHelp(); break; }
     const s = createStyler({ isTTY: process.stderr.isTTY });
     deleteCliToken();
     process.stderr.write(`  ${s.green('✔')} CLI token removed.\n`);
@@ -319,6 +335,7 @@ switch (command) {
   }
 
   case 'sync': {
+    if (cmdArgs.includes('--help') || cmdArgs.includes('-h')) { printSyncHelp(); break; }
     (async () => {
       const s = createStyler({ isTTY: process.stderr.isTTY });
       process.stderr.write(`\n  ${s.dim('Syncing from TicketLens console…')}\n`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ticketlens",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Jira CLI for developers — fetch ticket context, triage your queue, and stop tab-switching. Zero dependencies, all local.",
   "type": "module",
   "bin": {

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

@@ -24,11 +24,13 @@ export function printHelp({ stream = process.stdout } = {}) {
     '',
     `  ${s.bold('USAGE')}`,
     '',
-    // visible widths: "ticketlens init"=15, "switch"=17, "config [--profile=NAME]"=34,
-    // "profiles"=19, "<TICKET-KEY> [options]"=33, "triage [options]"=27,
-    // "activate <KEY>"=25, "license"=18, "cache [size|clear]"=29  →  target=36
-    // Groups: Setup ─── Daily use ─── Account / Maintenance
-    `    ${s.brand('ticketlens')} init                     Configure Jira connections`,
+    // visible widths — target column = 36 visible chars for the command portion
+    // Groups: Console sync ─── Setup ─── Daily use ─── Account / Maintenance
+    `    ${s.brand('ticketlens')} login                    Connect CLI to your TicketLens account`,
+    `    ${s.brand('ticketlens')} logout                   Remove stored credentials`,
+    `    ${s.brand('ticketlens')} sync                     Pull tracker profiles from the console`,
+    '',
+    `    ${s.brand('ticketlens')} init                     Configure connections locally`,
     `    ${s.brand('ticketlens')} switch                   Switch active profile`,
     `    ${s.brand('ticketlens')} config ${s.dim('[--profile=NAME]')}  Edit profile settings`,
     `    ${s.brand('ticketlens')} profiles                 List all configured profiles  ${s.dim('(alias: ls)')}`,
@@ -75,6 +77,8 @@ export function printHelp({ stream = process.stdout } = {}) {
     '',
     `  ${s.bold('EXAMPLES')}`,
     '',
+    `    ${s.dim('$')} ticketlens login                   ${s.dim('# first-time setup')}`,
+    `    ${s.dim('$')} ticketlens sync                    ${s.dim('# pull connections from console')}`,
     `    ${s.dim('$')} ticketlens PROJ-123`,
     `    ${s.dim('$')} ticketlens get PROJ-123 --depth=0 --profile=myteam`,
     `    ${s.dim('$')} ticketlens triage`,
@@ -83,11 +87,13 @@ export function printHelp({ stream = process.stdout } = {}) {
     '',
     `  ${s.bold('CONFIGURATION')}`,
     '',
+    `    ${s.dim('CLI token:')}    ~/.ticketlens/cli-token  ${s.dim('(written by ticketlens login)')}`,
     `    ${s.dim('Profiles:')}     ~/.ticketlens/profiles.json`,
     `    ${s.dim('Credentials:')}  ~/.ticketlens/credentials.json`,
     `    ${s.dim('License:')}      ~/.ticketlens/license.json`,
     '',
     `    ${s.dim('Or use env vars:')} JIRA_BASE_URL, JIRA_EMAIL, JIRA_API_TOKEN`,
+    `    ${s.dim('               ')} TICKETLENS_API_URL  ${s.dim('(override API host for local dev)')}`,
     '',
     '',
   ];
@@ -209,6 +215,283 @@ export function printProfiles({ stream = process.stdout, config, plain = false }
   stream.write(lines.join('\n') + '\n');
 }
 
+export function printLoginHelp({ stream = process.stdout } = {}) {
+  const s = createStyler({ isTTY: stream.isTTY });
+  const lines = [
+    '',
+    `  ${s.bold(s.brand('ticketlens'))} ${s.bold('login')}`,
+    '',
+    `  Connect the CLI to your TicketLens account using a CLI token.`,
+    `  Validates the token against the API before saving it locally.`,
+    '',
+    `  ${s.bold('HOW IT WORKS')}`,
+    '',
+    `    1. Generate a CLI token at ${s.cyan(`${s.dim('<console-url>')}/console/account`)}`,
+    `    2. Run ${s.cyan('ticketlens login')} and paste the token when prompted`,
+    `    3. Run ${s.cyan('ticketlens sync')} to pull your tracker connections`,
+    '',
+    `  ${s.bold('OPTIONS')}`,
+    '',
+    `    ${s.brand('-h')}, ${s.brand('--help')}   Show this help`,
+    '',
+    `  ${s.bold('EXAMPLES')}`,
+    '',
+    `    ${s.dim('$')} ticketlens login`,
+    `    ${s.dim('$')} ticketlens sync        ${s.dim('# after login, pull connections')}`,
+    '',
+    `  ${s.bold('FILES')}`,
+    '',
+    `    ${s.dim('Token saved to:')}  ~/.ticketlens/cli-token`,
+    '',
+  ];
+  stream.write(lines.join('\n') + '\n');
+}
+
+export function printLogoutHelp({ stream = process.stdout } = {}) {
+  const s = createStyler({ isTTY: stream.isTTY });
+  const lines = [
+    '',
+    `  ${s.bold(s.brand('ticketlens'))} ${s.bold('logout')}`,
+    '',
+    `  Remove the stored CLI token, disconnecting this machine from your`,
+    `  TicketLens account. Local profiles and credentials are kept intact.`,
+    '',
+    `  ${s.bold('OPTIONS')}`,
+    '',
+    `    ${s.brand('-h')}, ${s.brand('--help')}   Show this help`,
+    '',
+    `  ${s.bold('EXAMPLES')}`,
+    '',
+    `    ${s.dim('$')} ticketlens logout`,
+    `    ${s.dim('$')} ticketlens login   ${s.dim('# re-authenticate')}`,
+    '',
+  ];
+  stream.write(lines.join('\n') + '\n');
+}
+
+export function printSyncHelp({ stream = process.stdout } = {}) {
+  const s = createStyler({ isTTY: stream.isTTY });
+  const lines = [
+    '',
+    `  ${s.bold(s.brand('ticketlens'))} ${s.bold('sync')}`,
+    '',
+    `  Pull tracker connections from the TicketLens console and write them`,
+    `  to ${s.dim('~/.ticketlens/profiles.json')}. Requires ${s.cyan('ticketlens login')} first.`,
+    '',
+    `  Profiles that need credentials will be listed with a reminder to`,
+    `  run ${s.cyan('ticketlens config --profile=NAME')} to add them.`,
+    '',
+    `  ${s.bold('OPTIONS')}`,
+    '',
+    `    ${s.brand('-h')}, ${s.brand('--help')}   Show this help`,
+    '',
+    `  ${s.bold('EXAMPLES')}`,
+    '',
+    `    ${s.dim('$')} ticketlens login`,
+    `    ${s.dim('$')} ticketlens sync`,
+    `    ${s.dim('$')} ticketlens profiles   ${s.dim('# verify pulled connections')}`,
+    '',
+  ];
+  stream.write(lines.join('\n') + '\n');
+}
+
+export function printActivateHelp({ stream = process.stdout } = {}) {
+  const s = createStyler({ isTTY: stream.isTTY });
+  const lines = [
+    '',
+    `  ${s.bold(s.brand('ticketlens'))} ${s.bold('activate')} ${s.dim('<LICENSE-KEY>')}`,
+    '',
+    `  Activate a Pro or Team license key to unlock paid features.`,
+    `  Validates the key online and writes the result to ${s.dim('~/.ticketlens/license.json')}.`,
+    '',
+    `  ${s.bold('ARGUMENTS')}`,
+    '',
+    `    ${s.brand('<LICENSE-KEY>')}   Your LemonSqueezy license key`,
+    '',
+    `  ${s.bold('OPTIONS')}`,
+    '',
+    `    ${s.brand('-h')}, ${s.brand('--help')}      Show this help`,
+    '',
+    `  ${s.bold('EXAMPLES')}`,
+    '',
+    `    ${s.dim('$')} ticketlens activate tl_abc123xxxx`,
+    `    ${s.dim('$')} ticketlens license             ${s.dim('# verify activation')}`,
+    '',
+  ];
+  stream.write(lines.join('\n') + '\n');
+}
+
+export function printLicenseHelp({ stream = process.stdout } = {}) {
+  const s = createStyler({ isTTY: stream.isTTY });
+  const lines = [
+    '',
+    `  ${s.bold(s.brand('ticketlens'))} ${s.bold('license')}`,
+    '',
+    `  Show current license status: tier, email, and last validation date.`,
+    `  License is re-validated automatically in the background every 7 days.`,
+    '',
+    `  ${s.bold('OPTIONS')}`,
+    '',
+    `    ${s.brand('-h')}, ${s.brand('--help')}   Show this help`,
+    '',
+    `  ${s.bold('EXAMPLES')}`,
+    '',
+    `    ${s.dim('$')} ticketlens license`,
+    `    ${s.dim('$')} ticketlens activate ${s.dim('<KEY>')}   ${s.dim('# activate or renew')}`,
+    '',
+  ];
+  stream.write(lines.join('\n') + '\n');
+}
+
+export function printDeleteHelp({ stream = process.stdout } = {}) {
+  const s = createStyler({ isTTY: stream.isTTY });
+  const lines = [
+    '',
+    `  ${s.bold(s.brand('ticketlens'))} ${s.bold('delete')} ${s.dim('<PROFILE-NAME>')}`,
+    '',
+    `  Permanently remove a locally configured profile. In TTY mode, prompts`,
+    `  for confirmation before deleting. Pass ${s.cyan('--yes')} to skip the prompt.`,
+    '',
+    `  ${s.bold('ARGUMENTS')}`,
+    '',
+    `    ${s.brand('<PROFILE-NAME>')}   Name of the profile to remove`,
+    '',
+    `  ${s.bold('OPTIONS')}`,
+    '',
+    `    ${s.brand('--yes')}, ${s.brand('-y')}     Skip confirmation prompt`,
+    `    ${s.brand('-h')}, ${s.brand('--help')}    Show this help`,
+    '',
+    `  ${s.bold('EXAMPLES')}`,
+    '',
+    `    ${s.dim('$')} ticketlens delete myprofile`,
+    `    ${s.dim('$')} ticketlens delete myprofile --yes`,
+    `    ${s.dim('$')} ticketlens profiles                ${s.dim('# list remaining profiles')}`,
+    '',
+  ];
+  stream.write(lines.join('\n') + '\n');
+}
+
+export function printProfilesHelp({ stream = process.stdout } = {}) {
+  const s = createStyler({ isTTY: stream.isTTY });
+  const lines = [
+    '',
+    `  ${s.bold(s.brand('ticketlens'))} ${s.bold('profiles')} ${s.dim('[--plain]')}`,
+    '',
+    `  List all locally configured Jira profiles and their active status.`,
+    `  Also available as ${s.cyan('ticketlens ls')}.`,
+    '',
+    `  ${s.bold('OPTIONS')}`,
+    '',
+    `    ${s.brand('--plain')}          Tab-separated output ${s.dim('(for scripting)')}`,
+    `    ${s.brand('-h')}, ${s.brand('--help')}     Show this help`,
+    '',
+    `  ${s.bold('EXAMPLES')}`,
+    '',
+    `    ${s.dim('$')} ticketlens profiles`,
+    `    ${s.dim('$')} ticketlens ls`,
+    `    ${s.dim('$')} ticketlens profiles --plain`,
+    '',
+  ];
+  stream.write(lines.join('\n') + '\n');
+}
+
+export function printScheduleHelp({ stream = process.stdout } = {}) {
+  const s = createStyler({ isTTY: stream.isTTY });
+  const lines = [
+    '',
+    `  ${s.bold(s.brand('ticketlens'))} ${s.bold('schedule')} ${s.dim('[--stop|--status]')}  ${s.dim('[Pro]')}`,
+    '',
+    `  Set up a recurring digest email with your triage results. ${s.dim('[Pro]')}`,
+    `  Runs an interactive wizard to configure day, time, and timezone.`,
+    '',
+    `  ${s.bold('OPTIONS')}`,
+    '',
+    `    ${s.brand('--stop')}        Cancel the active digest schedule`,
+    `    ${s.brand('--status')}      Show current schedule configuration`,
+    `    ${s.brand('-h')}, ${s.brand('--help')}   Show this help`,
+    '',
+    `  ${s.bold('EXAMPLES')}`,
+    '',
+    `    ${s.dim('$')} ticketlens schedule`,
+    `    ${s.dim('$')} ticketlens schedule --status`,
+    `    ${s.dim('$')} ticketlens schedule --stop`,
+    '',
+  ];
+  stream.write(lines.join('\n') + '\n');
+}
+
+export function printInitHelp({ stream = process.stdout } = {}) {
+  const s = createStyler({ isTTY: stream.isTTY });
+  const lines = [
+    '',
+    `  ${s.bold(s.brand('ticketlens'))} ${s.bold('init')}`,
+    '',
+    `  Configure a new Jira connection locally using an interactive wizard.`,
+    `  Supports Jira Cloud ${s.dim('(Basic auth)')} and Jira Server/DC ${s.dim('(Bearer PAT or Basic)')}`,
+    '',
+    `  After setup, run ${s.cyan('ticketlens PROJ-123')} to fetch your first ticket.`,
+    '',
+    `  ${s.bold('OPTIONS')}`,
+    '',
+    `    ${s.brand('-h')}, ${s.brand('--help')}   Show this help`,
+    '',
+    `  ${s.bold('EXAMPLES')}`,
+    '',
+    `    ${s.dim('$')} ticketlens init`,
+    `    ${s.dim('$')} ticketlens profiles   ${s.dim('# verify the new profile')}`,
+    '',
+    `  ${s.dim('Tip: use')} ${s.cyan('ticketlens sync')} ${s.dim('instead to pull connections from the console.')}`,
+    '',
+  ];
+  stream.write(lines.join('\n') + '\n');
+}
+
+export function printSwitchHelp({ stream = process.stdout } = {}) {
+  const s = createStyler({ isTTY: stream.isTTY });
+  const lines = [
+    '',
+    `  ${s.bold(s.brand('ticketlens'))} ${s.bold('switch')}`,
+    '',
+    `  Interactively select which profile is active by default.`,
+    `  The chosen profile is used when no ${s.cyan('--profile')} flag is given.`,
+    '',
+    `  ${s.bold('OPTIONS')}`,
+    '',
+    `    ${s.brand('-h')}, ${s.brand('--help')}   Show this help`,
+    '',
+    `  ${s.bold('EXAMPLES')}`,
+    '',
+    `    ${s.dim('$')} ticketlens switch`,
+    `    ${s.dim('$')} ticketlens profiles   ${s.dim('# confirm new active profile')}`,
+    '',
+  ];
+  stream.write(lines.join('\n') + '\n');
+}
+
+export function printConfigHelp({ stream = process.stdout } = {}) {
+  const s = createStyler({ isTTY: stream.isTTY });
+  const lines = [
+    '',
+    `  ${s.bold(s.brand('ticketlens'))} ${s.bold('config')} ${s.dim('[--profile=NAME]')}`,
+    '',
+    `  Edit settings for an existing profile using an interactive wizard.`,
+    `  Without ${s.cyan('--profile')}, edits the currently active profile.`,
+    '',
+    `  ${s.bold('OPTIONS')}`,
+    '',
+    `    ${s.brand('--profile')}=${s.dim('NAME')}   Profile to configure`,
+    `    ${s.brand('-h')}, ${s.brand('--help')}      Show this help`,
+    '',
+    `  ${s.bold('EXAMPLES')}`,
+    '',
+    `    ${s.dim('$')} ticketlens config`,
+    `    ${s.dim('$')} ticketlens config --profile=work`,
+    `    ${s.dim('$')} ticketlens config --profile=acme`,
+    '',
+  ];
+  stream.write(lines.join('\n') + '\n');
+}
+
 export function printTriageHelp({ stream = process.stdout } = {}) {
   const s = createStyler({ isTTY: stream.isTTY });
   const lines = [