ticketlens 0.9.15 → 0.9.17

package/bin/ticketlens.mjs

@@ -34,15 +34,26 @@ 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 { checkForUpdate, getUpdateHint } from '../skills/jtb/scripts/lib/update-check.mjs';
-import { incrementInvocation } from '../skills/jtb/scripts/lib/activity-counter.mjs';
+import { incrementInvocation, incrementCommand } from '../skills/jtb/scripts/lib/activity-counter.mjs';
 import { DEFAULT_CONFIG_DIR } from '../skills/jtb/scripts/lib/config.mjs';
 
+const TRACKED_COMMANDS = new Set([
+  'triage', 'fetch', 'get', 'compliance', 'review', 'standup',
+  'pr', 'ledger', 'stats', 'collisions', 'history', 'schedule',
+  'brief', 'sync',
+]);
+
 const args = process.argv.slice(2);
 const { command, args: cmdArgs } = parseCommand(args);
 
 // Best-effort invocation counter — non-fatal
 try { incrementInvocation(DEFAULT_CONFIG_DIR); } catch { /* non-fatal */ }
 
+// Per-command + per-flag tracking — non-fatal
+if (TRACKED_COMMANDS.has(command)) {
+  try { incrementCommand(DEFAULT_CONFIG_DIR, command, cmdArgs); } catch { /* non-fatal */ }
+}
+
 // Fire-and-forget: silently refresh license.json at startup if >7 days since last validation
 revalidateIfStale();
 // Fire-and-forget: refresh the cached latest npm version once per 24h

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ticketlens",
-  "version": "0.9.15",
+  "version": "0.9.17",
   "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/SKILL.md

@@ -1,4 +1,4 @@
-<!-- jtb-skill-version: 0.9.14 -->
+<!-- jtb-skill-version: 0.9.16 -->
 ---
 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.

package/skills/jtb/scripts/fetch-my-tickets.mjs

@@ -11,6 +11,7 @@ import { styleTriageSummary } from './lib/styled-assembler.mjs';
 import { resolveConnection, loadProfiles, saveProfile } from './lib/profile-resolver.mjs';
 import { resolveAdapter } from './lib/resolve-adapter.mjs';
 import { incrementTriageRun, readAndResetActivity } from './lib/activity-counter.mjs';
+import { DEFAULT_CONFIG_DIR } from './lib/config.mjs';
 import { writeFileSync, mkdirSync, statSync } from 'node:fs';
 import { resolve as resolvePath, dirname } from 'node:path';
 import { createSpinner } from './lib/spinner.mjs';
@@ -485,7 +486,7 @@ export async function run(args, envOrOpts = process.env, fetcher = globalThis.fe
     const cliToken = opts.cliToken ?? readCliToken(configDir) ?? null;
     const printFn = opts.print ?? ((s) => process.stdout.write(s));
     let cliActivity = null;
-    try { cliActivity = readAndResetActivity(configDir); } catch { /* non-fatal */ }
+    try { cliActivity = readAndResetActivity(configDir ?? DEFAULT_CONFIG_DIR); } catch { /* non-fatal */ }
     await pushFn({
       sorted,
       rawTicketMap,

package/skills/jtb/scripts/fetch-ticket.mjs

@@ -12,7 +12,7 @@ import { extractCodeReferences } from './lib/code-ref-parser.mjs';
 import { assembleBrief } from './lib/brief-assembler.mjs';
 import { styleBrief } from './lib/styled-assembler.mjs';
 import { resolveConnection, loadProfiles, loadCredentials, saveProfile } from './lib/profile-resolver.mjs';
-import { buildJiraEnv } from './lib/config.mjs';
+import { buildJiraEnv, DEFAULT_CONFIG_DIR } from './lib/config.mjs';
 import { resolveAdapter } from './lib/resolve-adapter.mjs';
 import { createSession } from './lib/banner.mjs';
 import { classifyError } from './lib/error-classifier.mjs';
@@ -24,6 +24,7 @@ import { handleUnknownFlags } from './lib/arg-validator.mjs';
 import { TICKET_KEY_PATTERN } from './lib/cli.mjs';
 import { downloadAttachments } from './lib/attachment-downloader.mjs';
 import { readBriefCache, writeBriefCache, readSummaryCache, writeSummaryCache, briefCacheAge, BRIEF_TTL_MS } from './lib/brief-cache.mjs';
+import { recordTokensSaved } from './lib/activity-counter.mjs';
 import { readCliToken } from './lib/cli-auth.mjs';
 import { resolveTemplate } from './lib/template-resolver.mjs';
 import { parseAge } from './lib/cache-manager.mjs';
@@ -1054,6 +1055,7 @@ export async function run(args, envOrOpts = process.env, fetcher = globalThis.fe
         }
       }
 
+      recordTokensSaved(configDir ?? DEFAULT_CONFIG_DIR, 'fetch', Math.round(brief.length / 4));
       printFn(brief + '\n');
       return;
     }
@@ -1241,6 +1243,7 @@ export async function run(args, envOrOpts = process.env, fetcher = globalThis.fe
     }
   }
 
+  recordTokensSaved(configDir ?? DEFAULT_CONFIG_DIR, 'fetch', Math.round(output.length / 4));
   printFn(output + '\n');
 
   // Contextual upsell: after a deep traversal with a substantial graph, nudge toward --summarize

package/skills/jtb/scripts/lib/activity-counter.mjs

@@ -24,7 +24,7 @@ function read(configDir) {
   try {
     return JSON.parse(fs.readFileSync(path.join(configDir, ACTIVITY_FILE), 'utf8'));
   } catch {
-    return { fetch_count: 0, triage_run_count: 0, invocations: 0 };
+    return { fetch_count: 0, triage_run_count: 0, invocations: 0, commands: {} };
   }
 }
 
@@ -59,12 +59,53 @@ export function incrementInvocation(configDir) {
   increment(configDir, 'invocations');
 }
 
+/**
+ * Records one invocation of a named command, plus each --flag present in
+ * flagArgs. Flag values are stripped so "--depth=2" tracks as "--depth".
+ *
+ * @param {string}   configDir
+ * @param {string}   command   - e.g. "triage", "fetch"
+ * @param {string[]} flagArgs  - the raw args passed to the command
+ */
+export function incrementCommand(configDir, command, flagArgs = []) {
+  const data = read(configDir);
+  if (!data.commands) data.commands = {};
+  if (!data.commands[command]) data.commands[command] = { count: 0 };
+
+  data.commands[command].count += 1;
+
+  for (const arg of flagArgs) {
+    if (!arg.startsWith('-')) continue;
+    const flag = arg.replace(/=.*$/, '');
+    data.commands[command][flag] = (data.commands[command][flag] ?? 0) + 1;
+  }
+
+  write(configDir, data);
+}
+
+/**
+ * Accumulates estimated tokens saved for a named command.
+ * Called from fetch-ticket.mjs after assembling the brief.
+ * Best-effort — swallows write errors like all other counters.
+ *
+ * @param {string} configDir
+ * @param {string} command   - e.g. "fetch"
+ * @param {number} tokens    - estimated tokens saved (brief.length / 4)
+ */
+export function recordTokensSaved(configDir, command, tokens) {
+  const data = read(configDir);
+  if (!data.commands) data.commands = {};
+  if (!data.commands[command]) data.commands[command] = { count: 0 };
+  data.commands[command].tokens_saved = (data.commands[command].tokens_saved ?? 0) + tokens;
+  write(configDir, data);
+}
+
 /**
  * Returns the current counters and resets them to zero.
  * Call only after a confirmed successful push.
  *
  * @param {string} configDir
- * @returns {{ fetch_count: number, triage_run_count: number, invocations: number }}
+ * @returns {{ fetch_count: number, triage_run_count: number, invocations: number, commands: object }}
  */
 export function readAndResetActivity(configDir) {
   const data = read(configDir);
@@ -72,7 +113,8 @@ export function readAndResetActivity(configDir) {
     fetch_count:      data.fetch_count      ?? 0,
     triage_run_count: data.triage_run_count ?? 0,
     invocations:      data.invocations      ?? 0,
+    commands:         data.commands         ?? {},
   };
-  write(configDir, { fetch_count: 0, triage_run_count: 0, invocations: 0 });
+  write(configDir, { fetch_count: 0, triage_run_count: 0, invocations: 0, commands: {} });
   return snapshot;
 }