@phnx-labs/agents-cli 1.22.41 → 1.22.43

package/dist/lib/version.js

@@ -91,14 +91,18 @@ export function resolveInstalledLayout() {
  * binary can't read its own bundled package.json), fall back to the on-disk
  * install found via the launcher symlink so callers like the menu bar don't see
  * a bogus `unknown`.
+ *
+ * `pkgJsonPath` is an optional override of the shipping package.json path,
+ * accepted by both this function and {@link getCliVersionFresh}. Every
+ * production call site uses the zero-argument form and gets the real on-disk
+ * path below; the parameter exists only so a unit test can point both
+ * functions at a fixture package.json instead of the real one shared by every
+ * parallel test fork.
  */
-export function getCliVersion() {
+export function getCliVersion(pkgJsonPath = path.join(__dirname, '..', '..', 'package.json')) {
     if (cached)
         return cached;
-    cached =
-        readVersionAt(path.join(__dirname, '..', '..', 'package.json')) ??
-            readInstalledPackageVersion() ??
-            'unknown';
+    cached = readVersionAt(pkgJsonPath) ?? readInstalledPackageVersion() ?? 'unknown';
     return cached;
 }
 /** Version from the on-disk install (Bun-binary fallback). */
@@ -116,8 +120,6 @@ function readInstalledPackageVersion() {
  * is now stale and should reload onto the new code (self-healing). Returns
  * 'unknown' on any error.
  */
-export function getCliVersionFresh() {
-    return (readVersionAt(path.join(__dirname, '..', '..', 'package.json')) ??
-        readInstalledPackageVersion() ??
-        'unknown');
+export function getCliVersionFresh(pkgJsonPath = path.join(__dirname, '..', '..', 'package.json')) {
+    return readVersionAt(pkgJsonPath) ?? readInstalledPackageVersion() ?? 'unknown';
 }

package/dist/lib/view-types.d.ts

@@ -24,6 +24,10 @@ export interface ViewJsonVersion {
         usedPercent: number;
         resetsAt: string | null;
     }>;
+    unavailable?: {
+        reason: 'session_limit';
+        resetsAt: string;
+    };
     lastActive: string | null;
     path: string;
     configuredModel?: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phnx-labs/agents-cli",
-  "version": "1.22.41",
+  "version": "1.22.43",
   "description": "One CLI for all your AI coding agents - versions, config, cloud dispatch, sessions, and teams (now with first-class Grok Build CLI support)",
   "type": "module",
   "main": "dist/index.js",

package/dist/commands/tickets.d.ts

@@ -1,2 +0,0 @@
-import type { Command } from 'commander';
-export declare function registerTicketsCommand(program: Command): void;

package/dist/commands/tickets.js

@@ -1,43 +0,0 @@
-import { setHelpSections } from '../lib/help.js';
-import { listTickets } from '../lib/tickets/list.js';
-export function registerTicketsCommand(program) {
-    const tickets = program
-        .command('tickets')
-        .description('Read work items from the trackers linked to this workspace.');
-    setHelpSections(tickets, {
-        examples: `
-      agents tickets list --json
-      agents tickets list --github-assigned-only --json
-    `,
-        notes: `
-      The response reports each source's availability explicitly. A failed tracker
-      never makes another tracker's rows disappear.
-    `,
-    });
-    tickets
-        .command('list')
-        .description('List workspace tickets from Linear and GitHub.')
-        .option('--cwd <path>', 'Workspace used to resolve tracker context')
-        .option('--no-linear', 'Exclude Linear tickets')
-        .option('--no-github', 'Exclude GitHub issues')
-        .option('--github-assigned-only', 'Only include GitHub issues assigned to the current user')
-        .option('--json', 'Output machine-readable tickets, cycle metadata, and source availability')
-        .action(async (options) => {
-        const result = await listTickets({
-            cwd: options.cwd ?? process.cwd(),
-            linear: options.linear,
-            github: options.github,
-            githubAssignedOnly: options.githubAssignedOnly === true,
-        });
-        if (options.json) {
-            console.log(JSON.stringify(result, null, 2));
-            return;
-        }
-        console.log(`${result.tickets.length} ticket${result.tickets.length === 1 ? '' : 's'}`);
-        for (const source of ['linear', 'github']) {
-            const status = result.sources[source];
-            if (!status.available && status.error)
-                console.error(`${source}: ${status.error}`);
-        }
-    });
-}

package/dist/lib/observe-aliases.d.ts

@@ -1,30 +0,0 @@
-/**
- * Observe-umbrella aliases (Phase 3 surface consolidation).
- *
- * Thin name → real command expansion. No store merge — feed / sessions / events
- * remain the stores; these are doors that point at the right reader.
- *
- *   inbox    → feed                  (needs-you default)
- *
- * `roster` was removed — use `agents sessions --active`.
- * `timeline` was removed — use `agents feed --filter updates` (RUSH-2692).
- * `audit` is NOT an alias here — `agents audit` is already the tamper-evident
- * run-dispatch log. Ops trail = `agents events` (optionally `--audit`).
- */
-export type ObserveAlias = 'inbox';
-export declare const OBSERVE_ALIASES: readonly ObserveAlias[];
-export interface ObserveExpandResult {
-    /** argv for the real command (no program name): e.g. ['feed', '--filter', 'updates'] */
-    argv: string[];
-    /** One-line note for stderr (optional); empty when silent. */
-    note: string;
-}
-/** True when `rest` already carries a `--filter` / `--filter=…` flag. */
-export declare function hasFilterFlag(rest: readonly string[]): boolean;
-/** True when `rest` already carries `--active`. */
-export declare function hasActiveFlag(rest: readonly string[]): boolean;
-/**
- * Expand an observe alias + remaining user args into the real command argv.
- * Returns null when `alias` is not an observe alias.
- */
-export declare function expandObserveAlias(alias: string, rest?: readonly string[]): ObserveExpandResult | null;

package/dist/lib/observe-aliases.js

@@ -1,38 +0,0 @@
-/**
- * Observe-umbrella aliases (Phase 3 surface consolidation).
- *
- * Thin name → real command expansion. No store merge — feed / sessions / events
- * remain the stores; these are doors that point at the right reader.
- *
- *   inbox    → feed                  (needs-you default)
- *
- * `roster` was removed — use `agents sessions --active`.
- * `timeline` was removed — use `agents feed --filter updates` (RUSH-2692).
- * `audit` is NOT an alias here — `agents audit` is already the tamper-evident
- * run-dispatch log. Ops trail = `agents events` (optionally `--audit`).
- */
-export const OBSERVE_ALIASES = ['inbox'];
-/** True when `rest` already carries a `--filter` / `--filter=…` flag. */
-export function hasFilterFlag(rest) {
-    return rest.some((a) => a === '--filter' || a.startsWith('--filter='));
-}
-/** True when `rest` already carries `--active`. */
-export function hasActiveFlag(rest) {
-    return rest.some((a) => a === '--active');
-}
-/**
- * Expand an observe alias + remaining user args into the real command argv.
- * Returns null when `alias` is not an observe alias.
- */
-export function expandObserveAlias(alias, rest = []) {
-    const tail = [...rest];
-    switch (alias) {
-        case 'inbox':
-            return {
-                argv: ['feed', ...tail],
-                note: 'agents inbox → agents feed (needs-you inbox)',
-            };
-        default:
-            return null;
-    }
-}

package/dist/lib/tickets/list.d.ts

@@ -1,53 +0,0 @@
-export type TicketSource = 'linear' | 'github';
-export interface TicketComment {
-    body: string;
-    createdAt?: string;
-    author?: string;
-}
-export interface TicketRow {
-    id: string;
-    source: TicketSource;
-    title: string;
-    description?: string;
-    status: 'todo' | 'in_progress' | 'done';
-    priority?: 'urgent' | 'high' | 'medium' | 'low';
-    metadata: {
-        identifier?: string;
-        url?: string;
-        labels?: string[];
-        assignee?: string;
-        assigneeKind?: 'user' | 'agent';
-        state?: string;
-        createdAt?: string;
-        dueDate?: string;
-        project?: string;
-        repo?: string;
-        comments?: TicketComment[];
-        images?: string[];
-    };
-}
-export interface TicketListResult {
-    tickets: TicketRow[];
-    cycleInfo: {
-        name: string;
-        startsAt: string;
-        endsAt: string;
-    } | null;
-    sources: {
-        linear: {
-            available: boolean;
-            error?: string;
-        };
-        github: {
-            available: boolean;
-            error?: string;
-        };
-    };
-}
-export interface TicketListOptions {
-    cwd: string;
-    linear: boolean;
-    github: boolean;
-    githubAssignedOnly: boolean;
-}
-export declare function listTickets(options: TicketListOptions): Promise<TicketListResult>;

package/dist/lib/tickets/list.js

@@ -1,153 +0,0 @@
-import { execFile } from 'node:child_process';
-import { promisify } from 'node:util';
-const run = promisify(execFile);
-const AGENT_ASSIGNEE = /^(claude|codex|gemini|cursor|opencode|antigravity|grok|kimi|droid)$/i;
-function assigneeKind(name) {
-    if (!name)
-        return undefined;
-    return AGENT_ASSIGNEE.test(name.trim()) ? 'agent' : 'user';
-}
-function imageUrls(...bodies) {
-    const urls = new Set();
-    const pattern = /!\[[^\]]*\]\(\s*(https?:\/\/[^)\s]+)|<img\b[^>]*?\bsrc\s*=\s*["'](https?:\/\/[^"']+)/gi;
-    for (const body of bodies) {
-        if (typeof body !== 'string')
-            continue;
-        let match;
-        while ((match = pattern.exec(body)))
-            urls.add(match[1] || match[2]);
-    }
-    return urls.size > 0 ? [...urls] : undefined;
-}
-function errorMessage(error) {
-    if (error instanceof Error)
-        return error.message;
-    return String(error);
-}
-async function readLinear(cwd) {
-    const { stdout } = await run('linear', ['tasks', '--json'], {
-        cwd,
-        timeout: 15_000,
-        maxBuffer: 16 * 1024 * 1024,
-    });
-    const data = JSON.parse(stdout);
-    const cycle = data?.cycle;
-    const cycleInfo = cycle?.startsAt && cycle?.endsAt
-        ? { name: String(cycle.name ?? ''), startsAt: String(cycle.startsAt), endsAt: String(cycle.endsAt) }
-        : null;
-    const priority = {
-        1: 'urgent',
-        2: 'high',
-        3: 'medium',
-        4: 'low',
-    };
-    const tickets = (Array.isArray(data?.issues) ? data.issues : []).map((issue) => {
-        const labels = (issue.labels?.nodes ?? []).map((label) => String(label.name));
-        const comments = (issue.comments?.nodes ?? []).map((comment) => ({
-            body: String(comment.body ?? ''),
-            createdAt: comment.createdAt ? String(comment.createdAt) : undefined,
-            author: comment.user?.name ? String(comment.user.name) : undefined,
-        }));
-        const stateType = String(issue.state?.type ?? '');
-        const status = stateType === 'started'
-            ? 'in_progress'
-            : stateType === 'completed' || stateType === 'canceled'
-                ? 'done'
-                : 'todo';
-        const identifier = String(issue.identifier ?? issue.id ?? '');
-        return {
-            id: `linear:${identifier}`,
-            source: 'linear',
-            title: String(issue.title ?? ''),
-            description: issue.description ? String(issue.description) : undefined,
-            status,
-            priority: priority[Number(issue.priority)],
-            metadata: {
-                identifier,
-                url: issue.url ? String(issue.url) : undefined,
-                labels,
-                assignee: issue.assignee?.name ? String(issue.assignee.name) : undefined,
-                assigneeKind: assigneeKind(issue.assignee?.name),
-                state: issue.state?.name ? String(issue.state.name) : undefined,
-                createdAt: issue.createdAt ? String(issue.createdAt) : undefined,
-                dueDate: issue.dueDate ? String(issue.dueDate) : undefined,
-                project: issue.project?.name ? String(issue.project.name) : undefined,
-                comments,
-                images: imageUrls(issue.description, ...comments.map(comment => comment.body)),
-            },
-        };
-    });
-    return { tickets, cycleInfo };
-}
-async function readGithub(cwd, assignedOnly) {
-    const repo = (await run('gh', ['repo', 'view', '--json', 'nameWithOwner', '-q', '.nameWithOwner'], {
-        cwd,
-        timeout: 5_000,
-    })).stdout.trim();
-    if (!repo)
-        throw new Error('No GitHub repository resolved for this workspace.');
-    const args = [
-        'issue', 'list', '--repo', repo, '--state', 'open', '--limit', '50',
-        '--json', 'number,title,state,labels,assignees,url,body,createdAt',
-    ];
-    if (assignedOnly)
-        args.push('--assignee', '@me');
-    const { stdout } = await run('gh', args, { cwd, timeout: 15_000, maxBuffer: 16 * 1024 * 1024 });
-    const issues = JSON.parse(stdout);
-    return issues.map((issue) => {
-        const assignee = issue.assignees?.[0]?.login ? String(issue.assignees[0].login) : undefined;
-        const number = Number(issue.number);
-        return {
-            id: `github:${number}`,
-            source: 'github',
-            title: String(issue.title ?? ''),
-            description: issue.body ? String(issue.body) : undefined,
-            status: String(issue.state ?? '').toLowerCase() === 'closed' ? 'done' : 'todo',
-            metadata: {
-                identifier: `#${number}`,
-                url: issue.url ? String(issue.url) : undefined,
-                labels: (issue.labels ?? []).map((label) => String(label.name)),
-                assignee,
-                assigneeKind: assigneeKind(assignee),
-                state: String(issue.state ?? '').toLowerCase(),
-                createdAt: issue.createdAt ? String(issue.createdAt) : undefined,
-                repo,
-                images: imageUrls(issue.body),
-            },
-        };
-    });
-}
-export async function listTickets(options) {
-    const result = {
-        tickets: [],
-        cycleInfo: null,
-        sources: {
-            linear: { available: false },
-            github: { available: false },
-        },
-    };
-    const [linear, github] = await Promise.all([
-        options.linear
-            ? readLinear(options.cwd).then(value => ({ ok: true, value })).catch(error => ({ ok: false, error }))
-            : Promise.resolve(null),
-        options.github
-            ? readGithub(options.cwd, options.githubAssignedOnly).then(value => ({ ok: true, value })).catch(error => ({ ok: false, error }))
-            : Promise.resolve(null),
-    ]);
-    if (linear?.ok) {
-        result.sources.linear.available = true;
-        result.tickets.push(...linear.value.tickets);
-        result.cycleInfo = linear.value.cycleInfo;
-    }
-    else if (linear) {
-        result.sources.linear.error = errorMessage(linear.error);
-    }
-    if (github?.ok) {
-        result.sources.github.available = true;
-        result.tickets.push(...github.value);
-    }
-    else if (github) {
-        result.sources.github.error = errorMessage(github.error);
-    }
-    return result;
-}