ticketlens 0.38.12 → 0.38.13

package/bin/ticketlens.mjs

@@ -13,6 +13,7 @@ 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';
 import { runSwitch } from '../skills/jtb/scripts/lib/profile-switcher.mjs';
+import { runProfilesSetTeam } from '../skills/jtb/scripts/lib/profile-set-team.mjs';
 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, saveCredentialKey } from '../skills/jtb/scripts/lib/profile-resolver.mjs';
@@ -360,6 +361,19 @@ switch (command) {
 
   case 'profiles': {
     if (cmdArgs.includes('--help') || cmdArgs.includes('-h')) { printProfilesHelp(); break; }
+
+    if (cmdArgs[0] === 'set-team') {
+      const [, profileName, ...teamNameParts] = cmdArgs;
+      const teamName = teamNameParts.join(' ');
+      if (!profileName || !teamName) {
+        process.stderr.write('Usage: ticketlens profiles set-team <profile> <team name>\n');
+        process.exitCode = 1;
+        break;
+      }
+      runProfilesSetTeam(profileName, teamName);
+      break;
+    }
+
     const plain = cmdArgs.includes('--plain');
     const config = loadProfiles();
     printProfiles({ config, plain });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ticketlens",
-  "version": "0.38.12",
+  "version": "0.38.13",
   "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

@@ -469,6 +469,13 @@ export function printProfilesHelp({ stream = process.stdout } = {}) {
     `  List all locally configured Jira profiles and their active status.`,
     `  Also available as ${s.cyan('ticketlens ls')}.`,
     '',
+    `  ${s.bold('SUBCOMMANDS')}`,
+    '',
+    `    ${s.brand('set-team')} ${s.dim('<profile> <team name>')}`,
+    `        Route this profile's Recall notes to a specific Console team —`,
+    `        for accounts that belong to more than one team. Validated against`,
+    `        teams synced by ${s.cyan('ticketlens login')}/${s.cyan('ticketlens sync')}, but never blocked by a stale list.`,
+    '',
     `  ${s.bold('OPTIONS')}`,
     '',
     `    ${s.brand('--plain')}          Tab-separated output ${s.dim('(for scripting)')}`,
@@ -479,6 +486,7 @@ export function printProfilesHelp({ stream = process.stdout } = {}) {
     `    ${s.dim('$')} ticketlens profiles`,
     `    ${s.dim('$')} ticketlens ls`,
     `    ${s.dim('$')} ticketlens profiles --plain`,
+    `    ${s.dim('$')} ticketlens profiles set-team advent "Team Manager's Team"`,
     '',
   ];
   stream.write(lines.join('\n') + '\n');

package/skills/jtb/scripts/lib/login-flow.mjs

@@ -10,6 +10,7 @@ import { browserLogin } from './browser-login.mjs';
 import { saveCliToken } from './cli-auth.mjs';
 import { getApiBase, getConsoleBase } from './sync.mjs';
 import { applyTeamConfigOnLogin } from './team-jira-sync.mjs';
+import { saveTeams } from './profile-resolver.mjs';
 
 export async function runLogin({
   manual = false,
@@ -19,6 +20,7 @@ export async function runLogin({
   fetchFn = globalThis.fetch,
   promptSecretFn = promptSecret,
   saveCliTokenFn = saveCliToken,
+  saveTeamsFn = saveTeams,
   applyTeamConfigOnLoginFn = applyTeamConfigOnLogin,
 } = {}) {
   const s = createStyler({ isTTY: stream.isTTY });
@@ -83,12 +85,15 @@ export async function runLogin({
     return;
   }
 
-  let tier;
+  let tier, teams;
   try {
-    tier = (await res.json())?.tier;
-  } catch { /* tier is best-effort — token is still valid */ }
+    const body = await res.json();
+    tier = body?.tier;
+    teams = body?.teams;
+  } catch { /* tier/teams are best-effort — token is still valid */ }
 
   saveCliTokenFn(token, undefined, tier);
+  saveTeamsFn(Array.isArray(teams) ? teams : []);
   stream.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)

package/skills/jtb/scripts/lib/note-command.mjs

@@ -13,6 +13,7 @@ import { scanForSecrets } from './secret-scanner.mjs';
 import { checkNoteStructure } from './note-structural-check.mjs';
 import { writeNote, patchNoteBody, deleteNote, deleteNoteAnyPrefix, rebuildIndex } from './recall-vault.mjs';
 import { readCliToken } from './cli-auth.mjs';
+import { resolveProfile } from './profile-resolver.mjs';
 import { pushNote } from './recall-sync.mjs';
 import { enqueueNote, isRetryableFailure, maybeAutoFlush } from './recall-queue.mjs';
 import { incrementDraftKept, incrementDraftDeleted } from './activity-counter.mjs';
@@ -73,6 +74,7 @@ export async function runNoteAdd(cmdArgs, {
   scanForSecretsFn = scanForSecrets,
   writeNoteFn = writeNote,
   readCliTokenFn = readCliToken,
+  resolveProfileFn = resolveProfile,
   pushNoteFn = pushNote,
   enqueueNoteFn = enqueueNote,
   isRetryableFailureFn = isRetryableFailure,
@@ -139,7 +141,9 @@ export async function runNoteAdd(cmdArgs, {
     const warn = (s) => stream.write(s);
     // Field names match PushRequest's validation rules (external_id, tickets) —
     // the backend wire contract, not the local vault's internal camelCase shape.
+    const profile = resolveProfileFn(ticketKey || null, { configDir, cwd: process.cwd() });
     const payload = { external_id: id, title, tickets: ticketKeys, tags, author, sources: [], body };
+    if (profile?.recallTeam) payload.group = profile.recallTeam;
     const result = await pushNoteFn(payload, { cliToken, configDir, warn });
     if (isRetryableFailureFn(result)) {
       await enqueueNoteFn(payload, { cliToken, configDir, warn });

package/skills/jtb/scripts/lib/profile-resolver.mjs

@@ -55,6 +55,21 @@ export function saveDefault(name, configDir = DEFAULT_CONFIG_DIR) {
   invalidateProfilesCache(configDir);
 }
 
+// Team list synced from /v1/profiles — used to validate `recallTeam` on a
+// profile without a live network call at push/pull time. Not credentials.
+export function saveTeams(teams, configDir = DEFAULT_CONFIG_DIR) {
+  mkdirSync(configDir, { recursive: true });
+  const profilesPath = join(configDir, 'profiles.json');
+  const config = loadProfiles(configDir) || { profiles: {} };
+  config.teams = teams;
+  writeFileSync(profilesPath, JSON.stringify(config, null, 2) + '\n', { encoding: 'utf8', mode: 0o600 });
+  invalidateProfilesCache(configDir);
+}
+
+export function loadTeams(configDir = DEFAULT_CONFIG_DIR) {
+  return loadProfiles(configDir)?.teams ?? [];
+}
+
 export function saveProfile(name, profileData, credData, configDir = DEFAULT_CONFIG_DIR) {
   mkdirSync(configDir, { recursive: true });
   const profilesPath = join(configDir, 'profiles.json');

package/skills/jtb/scripts/lib/profile-set-team.mjs

@@ -0,0 +1,41 @@
+/**
+ * ticketlens profiles set-team — maps a local Jira profile to the Console
+ * team its Recall notes should push/pull against. Validates the name
+ * against the locally synced team list (no live network call — that list
+ * is refreshed by `ticketlens login`/`ticketlens sync`), but never blocks
+ * the write on a stale/missing list or a name mismatch: the hard check is
+ * server-side at push/pull time (RecallTeamResolver), this is a local
+ * convenience check only.
+ */
+import { createStyler } from './ansi.mjs';
+import { loadProfiles, loadTeams, saveProfile } from './profile-resolver.mjs';
+import { DEFAULT_CONFIG_DIR } from './config.mjs';
+
+export function runProfilesSetTeam(profileName, teamName, {
+  configDir = DEFAULT_CONFIG_DIR,
+  stream = process.stderr,
+  loadProfilesFn = loadProfiles,
+  loadTeamsFn = loadTeams,
+  saveProfileFn = saveProfile,
+} = {}) {
+  const s = createStyler({ isTTY: stream.isTTY });
+  const config = loadProfilesFn(configDir);
+  const profile = config?.profiles?.[profileName];
+
+  if (!profile) {
+    stream.write(`  ${s.red('✖')} No profile named "${profileName}". Run ${s.cyan('ticketlens profiles')} to see available profiles.\n`);
+    process.exitCode = 1;
+    return;
+  }
+
+  const teams = loadTeamsFn(configDir);
+  if (teams.length === 0) {
+    stream.write(`  ${s.yellow('⚠')} No synced teams found — run ${s.cyan('ticketlens sync')} first to validate this name.\n`);
+  } else if (!teams.some(t => t.name === teamName)) {
+    stream.write(`  ${s.yellow('⚠')} "${teamName}" isn't one of your synced teams — check spelling, or run ${s.cyan('ticketlens sync')} to refresh.\n`);
+  }
+
+  // Must merge, not replace — saveProfile() overwrites the whole profile object.
+  saveProfileFn(profileName, { ...profile, recallTeam: teamName }, null, configDir);
+  stream.write(`  ${s.green('✔')} Recall notes captured under ${s.bold(s.cyan(profileName))} will target ${s.bold(s.cyan(teamName))}.\n`);
+}

package/skills/jtb/scripts/lib/recall-command.mjs

@@ -15,6 +15,7 @@ import { TICKET_KEY_PATTERN } from './cli.mjs';
 import { isLicensed, showUpgradePrompt } from './license.mjs';
 import { listNotes } from './recall-vault.mjs';
 import { readCliToken } from './cli-auth.mjs';
+import { resolveProfile } from './profile-resolver.mjs';
 import { pullNotes } from './recall-sync.mjs';
 import { maybeAutoFlush, flushQueue, readQueue } from './recall-queue.mjs';
 import { getEffectiveRecallSettingsWithSource } from './recall-settings-sync.mjs';
@@ -31,6 +32,7 @@ export async function runRecall(cmdArgs, {
   isLicensedFn = isLicensed,
   listNotesFn = listNotes,
   readCliTokenFn = readCliToken,
+  resolveProfileFn = resolveProfile,
   pullNotesFn = pullNotes,
   maybeAutoFlushFn = maybeAutoFlush,
 } = {}) {
@@ -45,13 +47,16 @@ export async function runRecall(cmdArgs, {
     return { ok: false };
   }
 
+  const isTicketKey = TICKET_KEY_PATTERN.test(arg);
+
   const cliToken = readCliTokenFn(configDir);
   if (cliToken) {
-    await pullNotesFn({ cliToken, configDir, ttlMs: 0 });
+    const profile = resolveProfileFn(isTicketKey ? arg : null, { configDir, cwd: process.cwd() });
+    await pullNotesFn({ cliToken, configDir, ttlMs: 0, group: profile?.recallTeam });
     await maybeAutoFlushFn({ cliToken, configDir });
   }
 
-  const filter = TICKET_KEY_PATTERN.test(arg) ? { ticketKey: arg } : { query: arg };
+  const filter = isTicketKey ? { ticketKey: arg } : { query: arg };
   const results = listNotesFn(filter, { configDir });
 
   const styled = !cmdArgs.includes('--plain') && !!stream.isTTY;

package/skills/jtb/scripts/lib/recall-sync.mjs

@@ -78,6 +78,20 @@ function writeEntitlementCheckedAt(configDir, isoTimestamp, cliToken) {
   }
 }
 
+// Shared by pushNote's and pullNotes' 422 handling — a profile's configured
+// recallTeam that doesn't match any of this account's Console teams
+// (renamed/removed/typo) must never silently drop a note or return zero
+// pull results; both retry once against the account's default team instead.
+async function isUnknownTeamRejection(res) {
+  let reason;
+  try { reason = (await res.json())?.error; } catch { /* not this case — fall through */ }
+  return reason === 'Unknown team';
+}
+
+function warnUnknownTeam(warn, groupName, fallbackAction) {
+  warn(`  ${yellow('⚠')} "${groupName}" isn't a team on your account — ${fallbackAction} instead.\n  ${dim('→ Run')} ${cyan('ticketlens profiles set-team')} ${dim('to fix this profile\'s team mapping.')}\n`);
+}
+
 /**
  * POSTs one locally-authored note to the team backend.
  *
@@ -116,23 +130,25 @@ export async function pushNote(note, {
 
   warnIfInsecure(apiBase(), warn);
 
+  const post = (payload) => fetcher(`${apiBase()}${PUSH_PATH}`, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      'Accept': 'application/json',
+      'Authorization': `Bearer ${cliToken}`,
+    },
+    body: JSON.stringify(payload),
+    // Without Accept: application/json, a Laravel validation failure 302-redirects
+    // instead of returning JSON, and fetch's default redirect:'follow' silently
+    // turns that into a followed 200 — a false "pushed" the user never sees fail.
+    // 'manual' makes any unexpected redirect surface as a non-ok response instead.
+    redirect: 'manual',
+    signal: AbortSignal.timeout(timeoutMs),
+  });
+
   let res;
   try {
-    res = await fetcher(`${apiBase()}${PUSH_PATH}`, {
-      method: 'POST',
-      headers: {
-        'Content-Type': 'application/json',
-        'Accept': 'application/json',
-        'Authorization': `Bearer ${cliToken}`,
-      },
-      body: JSON.stringify(note),
-      // Without Accept: application/json, a Laravel validation failure 302-redirects
-      // instead of returning JSON, and fetch's default redirect:'follow' silently
-      // turns that into a followed 200 — a false "pushed" the user never sees fail.
-      // 'manual' makes any unexpected redirect surface as a non-ok response instead.
-      redirect: 'manual',
-      signal: AbortSignal.timeout(timeoutMs),
-    });
+    res = await post(note);
   } catch {
     warn(`  ${yellow('⚠')} Could not sync note to your team (network error) — saved locally and queued to retry automatically.\n`);
     return { ok: false };
@@ -166,6 +182,19 @@ export async function pushNote(note, {
     return { ok: false, status: res.status };
   }
 
+  if (res.status === 422 && note.group !== undefined && await isUnknownTeamRejection(res)) {
+    warnUnknownTeam(warn, note.group, 'saved to your default team');
+    const { group: _omit, ...withoutGroup } = note;
+    let retryRes;
+    try {
+      retryRes = await post(withoutGroup);
+    } catch {
+      warn(`  ${yellow('⚠')} Could not sync note to your team (network error) — saved locally and queued to retry automatically.\n`);
+      return { ok: false };
+    }
+    return retryRes.ok ? { ok: true, status: retryRes.status } : { ok: false, status: retryRes.status };
+  }
+
   warn(`  ${yellow('⚠')} Could not sync note to your team (${res.status}) — saved locally only.\n`);
   return { ok: false, status: res.status };
 }
@@ -183,7 +212,9 @@ export async function pushNote(note, {
  * @param {string}   [opts.configDir]
  * @param {number}   [opts.ttlMs] - skip the network call if the last pull is more recent than this
  * @param {number}   [opts.timeoutMs] - request timeout; short for a passive/background pull, long for an explicit one
+ * @param {string}   [opts.group] - explicit target team name, for accounts on more than one team
  * @param {Function} [opts.fetcher]
+ * @param {Function} [opts.warn] - failure output (default: process.stderr.write)
  * @param {Function} [opts.upsertPulledNoteFn]
  * @param {Function} [opts.rebuildIndexFn]
  * @param {() => number} [opts.now]
@@ -194,7 +225,9 @@ export async function pullNotes({
   configDir = DEFAULT_CONFIG_DIR,
   ttlMs = RECALL_PULL_TTL_MS,
   timeoutMs = 15_000,
+  group,
   fetcher = globalThis.fetch,
+  warn = (s) => process.stderr.write(s),
   upsertPulledNoteFn = upsertPulledNote,
   rebuildIndexFn = rebuildIndex,
   deleteNoteFn = deleteNote,
@@ -209,20 +242,34 @@ export async function pullNotes({
     return { ok: true, skipped: true, count: 0 };
   }
 
-  const url = new URL(`${apiBase()}${PULL_PATH}`);
-  if (lastPulledAt) url.searchParams.set('since', lastPulledAt);
+  const buildUrl = (targetGroup) => {
+    const url = new URL(`${apiBase()}${PULL_PATH}`);
+    if (lastPulledAt) url.searchParams.set('since', lastPulledAt);
+    if (targetGroup) url.searchParams.set('group', targetGroup);
+    return url.toString();
+  };
+  const get = (targetGroup) => fetcher(buildUrl(targetGroup), {
+    headers: { 'Authorization': `Bearer ${cliToken}`, 'Accept': 'application/json' },
+    redirect: 'manual',
+    signal: AbortSignal.timeout(timeoutMs),
+  });
 
   let res;
   try {
-    res = await fetcher(url.toString(), {
-      headers: { 'Authorization': `Bearer ${cliToken}`, 'Accept': 'application/json' },
-      redirect: 'manual',
-      signal: AbortSignal.timeout(timeoutMs),
-    });
+    res = await get(group);
   } catch {
     return { ok: false, count: 0 };
   }
 
+  if (!res.ok && res.status === 422 && group !== undefined && await isUnknownTeamRejection(res)) {
+    warnUnknownTeam(warn, group, 'pulling from your default team');
+    try {
+      res = await get(undefined);
+    } catch {
+      return { ok: false, count: 0 };
+    }
+  }
+
   if (!res.ok) {
     return { ok: false, status: res.status, count: 0 };
   }

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

@@ -10,6 +10,7 @@ import {
   loadProfiles,
   loadCredentials,
   saveProfile,
+  saveTeams,
   invalidateProfilesCache,
 } from './profile-resolver.mjs';
 import { DEFAULT_CONFIG_DIR } from './config.mjs';
@@ -89,6 +90,7 @@ export async function syncProfiles({
   try { json = await res.json(); } catch { return { error: 'invalid-json' }; }
 
   if (typeof json?.tier === 'string') saveCliTokenTier(json.tier, configDir);
+  saveTeams(Array.isArray(json?.teams) ? json.teams : [], configDir);
 
   const remoteProfiles = Array.isArray(json?.profiles) ? json.profiles : [];
   const localConfig  = loadProfiles(configDir) || { profiles: {} };