@jackwener/opencli 1.5.5 → 1.5.7

package/dist/clis/ones/login.js

@@ -0,0 +1,80 @@
+import { cli, Strategy } from '../../registry.js';
+import { CliError } from '../../errors.js';
+import { getOnesBaseUrl, onesFetchInPage } from './common.js';
+cli({
+    site: 'ones',
+    name: 'login',
+    description: 'ONES Project API — login via Chrome Bridge (POST auth/login); stderr prints export hints for ONES_USER_ID / TOKEN',
+    domain: 'ones.cn',
+    strategy: Strategy.COOKIE,
+    browser: true,
+    navigateBefore: false,
+    args: [
+        {
+            name: 'email',
+            type: 'str',
+            required: false,
+            help: 'Account email (or set ONES_EMAIL)',
+        },
+        {
+            name: 'phone',
+            type: 'str',
+            required: false,
+            help: 'Account phone (or set ONES_PHONE); ignored if email is set',
+        },
+        {
+            name: 'password',
+            type: 'str',
+            required: false,
+            help: 'Password (or set ONES_PASSWORD)',
+        },
+    ],
+    columns: ['uuid', 'name', 'email', 'token_preview'],
+    func: async (page, kwargs) => {
+        const email = kwargs.email?.trim() || process.env.ONES_EMAIL?.trim();
+        const phone = kwargs.phone?.trim() || process.env.ONES_PHONE?.trim();
+        const password = kwargs.password || process.env.ONES_PASSWORD || '';
+        if (!password) {
+            throw new CliError('CONFIG', 'Password required', 'Pass --password or set ONES_PASSWORD for non-interactive use.');
+        }
+        if (!email && !phone) {
+            throw new CliError('CONFIG', 'email or phone required', 'Pass --email or --phone (or set ONES_EMAIL / ONES_PHONE).');
+        }
+        getOnesBaseUrl();
+        const bodyObj = { password };
+        if (email)
+            bodyObj.email = email;
+        else
+            bodyObj.phone = phone;
+        const parsed = (await onesFetchInPage(page, 'auth/login', {
+            method: 'POST',
+            body: JSON.stringify(bodyObj),
+            auth: false,
+        }));
+        const user = parsed.user;
+        if (!user?.uuid || !user?.token) {
+            throw new CliError('FETCH_ERROR', 'ONES login response missing user.uuid or user.token', 'Your server build may differ from documented Project API.');
+        }
+        const uuid = String(user.uuid);
+        const token = String(user.token);
+        const name = String(user.name ?? '');
+        const em = String(user.email ?? '');
+        const base = getOnesBaseUrl();
+        console.error([
+            '',
+            '后续请求会优先使用当前 Chrome 会话 Cookie；若接口仍要求 Header，可 export：',
+            `  export ONES_BASE_URL=${JSON.stringify(base)}`,
+            `  export ONES_USER_ID=${JSON.stringify(uuid)}`,
+            `  export ONES_AUTH_TOKEN=${JSON.stringify(token)}`,
+            '',
+        ].join('\n'));
+        return [
+            {
+                uuid,
+                name,
+                email: em,
+                token_preview: token.length > 12 ? `${token.slice(0, 6)}…${token.slice(-4)}` : '***',
+            },
+        ];
+    },
+});

package/dist/clis/ones/logout.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/clis/ones/logout.js

@@ -0,0 +1,17 @@
+import { cli, Strategy } from '../../registry.js';
+import { onesFetchInPage } from './common.js';
+cli({
+    site: 'ones',
+    name: 'logout',
+    description: 'ONES Project API — invalidate current token (GET auth/logout) via Chrome Bridge',
+    domain: 'ones.cn',
+    strategy: Strategy.COOKIE,
+    browser: true,
+    navigateBefore: false,
+    args: [],
+    columns: ['ok', 'detail'],
+    func: async (page) => {
+        await onesFetchInPage(page, 'auth/logout', { method: 'GET' });
+        return [{ ok: 'true', detail: 'Server logout ok; clear local ONES_AUTH_TOKEN if set.' }];
+    },
+});

package/dist/clis/ones/me.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/clis/ones/me.js

@@ -0,0 +1,30 @@
+import { cli, Strategy } from '../../registry.js';
+import { CliError } from '../../errors.js';
+import { onesFetchInPage } from './common.js';
+cli({
+    site: 'ones',
+    name: 'me',
+    description: 'ONES Project API — current user (GET users/me) via Chrome Bridge',
+    domain: 'ones.cn',
+    strategy: Strategy.COOKIE,
+    browser: true,
+    navigateBefore: false,
+    args: [],
+    columns: ['uuid', 'name', 'email', 'phone', 'status'],
+    func: async (page) => {
+        const data = (await onesFetchInPage(page, 'users/me'));
+        const u = data.user && typeof data.user === 'object' ? data.user : data;
+        if (!u || typeof u.uuid !== 'string') {
+            throw new CliError('FETCH_ERROR', 'Unexpected users/me response', 'See raw JSON with: opencli ones me -f json');
+        }
+        return [
+            {
+                uuid: String(u.uuid),
+                name: String(u.name ?? ''),
+                email: String(u.email ?? ''),
+                phone: String(u.phone ?? ''),
+                status: u.status != null ? String(u.status) : '',
+            },
+        ];
+    },
+});

package/dist/clis/ones/my-tasks.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/clis/ones/my-tasks.js

@@ -0,0 +1,120 @@
+import { cli, Strategy } from '../../registry.js';
+import { CliError } from '../../errors.js';
+import { gotoOnesHome, onesFetchInPage, resolveOnesUserUuid } from './common.js';
+import { enrichPeekEntriesWithDetails } from './enrich-tasks.js';
+import { resolveTaskListLabels } from './resolve-labels.js';
+import { defaultPeekBody, flattenPeekGroups, mapTaskEntry, parsePeekLimit, } from './task-helpers.js';
+/** 文档示例里「负责人」常用 field004；与顶层 assign 在不同部署上二选一有效 */
+function queryAssign(userUuid) {
+    return { must: [{ equal: { assign: userUuid } }] };
+}
+function queryAssignField004(userUuid) {
+    return { must: [{ in: { 'field_values.field004': [userUuid] } }] };
+}
+function queryOwner(userUuid) {
+    return { must: [{ equal: { owner: userUuid } }] };
+}
+function dedupeByUuid(entries) {
+    const seen = new Set();
+    const out = [];
+    for (const e of entries) {
+        const id = String(e.uuid ?? '');
+        if (!id || seen.has(id))
+            continue;
+        seen.add(id);
+        out.push(e);
+    }
+    return out;
+}
+async function peekTasks(page, team, query, cap) {
+    const path = `team/${team}/filters/peek`;
+    const body = defaultPeekBody(query);
+    const parsed = (await onesFetchInPage(page, path, {
+        method: 'POST',
+        body: JSON.stringify(body),
+        skipGoto: true,
+    }));
+    return flattenPeekGroups(parsed, cap);
+}
+cli({
+    site: 'ones',
+    name: 'my-tasks',
+    description: 'ONES — my work items (filters/peek + strict must query). Default: assignee=me. Use --mode if your site uses field004 for assignee.',
+    domain: 'ones.cn',
+    strategy: Strategy.COOKIE,
+    browser: true,
+    navigateBefore: false,
+    args: [
+        {
+            name: 'team',
+            type: 'str',
+            required: false,
+            positional: true,
+            help: 'Team UUID from URL …/team/<uuid>/…, or set ONES_TEAM_UUID',
+        },
+        {
+            name: 'limit',
+            type: 'int',
+            default: 100,
+            help: 'Max rows (default 100, max 500)',
+        },
+        {
+            name: 'mode',
+            type: 'str',
+            default: 'assign',
+            choices: ['assign', 'field004', 'owner', 'both'],
+            help: 'assign=负责人(顶层 assign)；field004=负责人(筛选器示例里的 field004)；owner=创建者；both=负责人∪创建者(两次 peek 去重)',
+        },
+    ],
+    columns: ['title', 'status', 'project', 'uuid', 'updated', '工时'],
+    func: async (page, kwargs) => {
+        const team = kwargs.team?.trim() ||
+            process.env.ONES_TEAM_UUID?.trim() ||
+            process.env.ONES_TEAM_ID?.trim();
+        if (!team) {
+            throw new CliError('CONFIG', 'team UUID required', 'Pass team from URL …/team/<team>/… or set ONES_TEAM_UUID.');
+        }
+        const limit = parsePeekLimit(kwargs.limit, 100);
+        const mode = String(kwargs.mode ?? 'assign');
+        await gotoOnesHome(page);
+        const userUuid = await resolveOnesUserUuid(page, { skipGoto: true });
+        let entries = [];
+        if (mode === 'both') {
+            const cap = Math.min(500, limit * 2);
+            const asAssign = await peekTasks(page, team, queryAssign(userUuid), cap);
+            const asOwner = await peekTasks(page, team, queryOwner(userUuid), cap);
+            entries = dedupeByUuid([...asAssign, ...asOwner]).slice(0, limit);
+        }
+        else {
+            const queryByMode = () => {
+                switch (mode) {
+                    case 'field004':
+                        return queryAssignField004(userUuid);
+                    case 'owner':
+                        return queryOwner(userUuid);
+                    case 'assign':
+                    default:
+                        return queryAssign(userUuid);
+                }
+            };
+            const primary = queryByMode();
+            try {
+                entries = await peekTasks(page, team, primary, limit);
+            }
+            catch (e) {
+                const msg = e instanceof Error ? e.message : '';
+                const canFallback = mode === 'assign' &&
+                    (msg.includes('ServerError') || msg.includes('801') || msg.includes('Params is invalid'));
+                if (canFallback) {
+                    entries = await peekTasks(page, team, queryAssignField004(userUuid), limit);
+                }
+                else {
+                    throw e;
+                }
+            }
+        }
+        const enriched = await enrichPeekEntriesWithDetails(page, team, entries, true);
+        const labels = await resolveTaskListLabels(page, team, enriched, true);
+        return enriched.map((e) => mapTaskEntry(e, labels));
+    },
+});

package/dist/clis/ones/resolve-labels.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 把 status / project 的 uuid 解析为中文名（团队级接口各查一次或按批）
+ */
+import type { IPage } from '../../types.js';
+export declare function loadTaskStatusLabels(page: IPage, team: string, skipGoto: boolean): Promise<Map<string, string>>;
+export declare function loadProjectLabels(page: IPage, team: string, projectUuids: string[], skipGoto: boolean): Promise<Map<string, string>>;
+export declare function resolveTaskListLabels(page: IPage, team: string, entries: Record<string, unknown>[], skipGoto: boolean): Promise<{
+    statusByUuid: Map<string, string>;
+    projectByUuid: Map<string, string>;
+}>;

package/dist/clis/ones/resolve-labels.js

@@ -0,0 +1,64 @@
+/**
+ * 把 status / project 的 uuid 解析为中文名（团队级接口各查一次或按批）
+ */
+import { onesFetchInPage } from './common.js';
+import { getTaskProjectRawId } from './task-helpers.js';
+export async function loadTaskStatusLabels(page, team, skipGoto) {
+    const map = new Map();
+    try {
+        const parsed = (await onesFetchInPage(page, `team/${team}/task_statuses`, {
+            method: 'GET',
+            skipGoto,
+        }));
+        const list = Array.isArray(parsed.task_statuses)
+            ? parsed.task_statuses
+            : [];
+        for (const s of list) {
+            const id = String(s.uuid ?? '');
+            const name = String(s.name ?? '');
+            if (id && name)
+                map.set(id, name);
+        }
+    }
+    catch {
+        /* 降级为仅显示 uuid */
+    }
+    return map;
+}
+const PROJECT_INFO_CHUNK = 25;
+export async function loadProjectLabels(page, team, projectUuids, skipGoto) {
+    const map = new Map();
+    const ids = [...new Set(projectUuids.filter(Boolean))];
+    if (ids.length === 0)
+        return map;
+    try {
+        for (let i = 0; i < ids.length; i += PROJECT_INFO_CHUNK) {
+            const slice = ids.slice(i, i + PROJECT_INFO_CHUNK);
+            const q = slice.map(encodeURIComponent).join(',');
+            const path = `team/${team}/projects/info?ids=${q}`;
+            const parsed = (await onesFetchInPage(page, path, {
+                method: 'GET',
+                skipGoto,
+            }));
+            const projects = Array.isArray(parsed.projects) ? parsed.projects : [];
+            for (const p of projects) {
+                const id = String(p.uuid ?? '');
+                const name = String(p.name ?? '');
+                if (id && name)
+                    map.set(id, name);
+            }
+        }
+    }
+    catch {
+        /* 降级 */
+    }
+    return map;
+}
+export async function resolveTaskListLabels(page, team, entries, skipGoto) {
+    const projectUuids = entries.map((e) => getTaskProjectRawId(e)).filter(Boolean);
+    const [statusByUuid, projectByUuid] = await Promise.all([
+        loadTaskStatusLabels(page, team, skipGoto),
+        loadProjectLabels(page, team, projectUuids, skipGoto),
+    ]);
+    return { statusByUuid, projectByUuid };
+}

package/dist/clis/ones/task-helpers.d.ts

@@ -0,0 +1,29 @@
+/**
+ * ONES filters/peek 响应解析（tasks / my-tasks 共用）
+ */
+export declare function pickTaskTitle(e: Record<string, unknown>): string;
+/** 表格里标题别撑爆终端 */
+export declare function ellipsizeCell(s: string, max?: number): string;
+/** 辅助列：长 uuid 缩略，完整值见 -f json */
+export declare function briefUuid(id: string, head?: number, tail?: number): string;
+export declare function formatStamp(v: unknown): string;
+export declare function flattenPeekGroups(parsed: Record<string, unknown>, limit: number): Record<string, unknown>[];
+/** 工作项状态 uuid（用于查 task_statuses 得中文名） */
+export declare function getTaskStatusRawId(e: Record<string, unknown>): string;
+/** 项目 uuid */
+export declare function getTaskProjectRawId(e: Record<string, unknown>): string;
+/**
+ * Project API 里 assess/total/remaining_manhour 多为**定点整数**（与 Web 上「小时」不一致）；
+ * 常见换算：raw / 1e5 ≈ 小时。若你方实例不同，可设 `ONES_MANHOUR_SCALE`（默认 100000）。
+ */
+export declare function onesManhourScale(): number;
+/** 界面/h 小数 → API 内 manhour 整数（与列表「工时」列同一刻度） */
+export declare function hoursToOnesManhourRaw(hours: number): number;
+export declare function formatTaskManhourSummary(e: Record<string, unknown>): string;
+export interface TaskLabelMaps {
+    statusByUuid?: Map<string, string>;
+    projectByUuid?: Map<string, string>;
+}
+export declare function mapTaskEntry(e: Record<string, unknown>, labels?: TaskLabelMaps): Record<string, string>;
+export declare function defaultPeekBody(query: Record<string, unknown>): Record<string, unknown>;
+export declare function parsePeekLimit(value: unknown, fallback: number): number;

package/dist/clis/ones/task-helpers.js

@@ -0,0 +1,212 @@
+/**
+ * ONES filters/peek 响应解析（tasks / my-tasks 共用）
+ */
+import { CliError } from '../../errors.js';
+/** ONES task 里 field_values 常为 [{ field_uuid, value }, ...] */
+function pickTitleFromFieldValuesArray(fv) {
+    if (!Array.isArray(fv))
+        return '';
+    for (const item of fv) {
+        if (!item || typeof item !== 'object')
+            continue;
+        const row = item;
+        const fu = String(row.field_uuid ?? '');
+        if (!fu.startsWith('field'))
+            continue;
+        const v = row.value;
+        if (typeof v === 'string' && v.trim())
+            return v.trim();
+        if (Array.isArray(v) && v.length && typeof v[0] === 'string' && v[0].trim())
+            return v[0].trim();
+    }
+    return '';
+}
+export function pickTaskTitle(e) {
+    for (const k of ['summary', 'name', 'title', 'subject']) {
+        const v = e[k];
+        if (typeof v === 'string' && v.trim())
+            return v.trim();
+    }
+    const fromArr = pickTitleFromFieldValuesArray(e.field_values);
+    if (fromArr)
+        return fromArr;
+    const fv = e.field_values;
+    if (fv && typeof fv === 'object' && !Array.isArray(fv)) {
+        const o = fv;
+        for (const k of ['field001', 'field002', 'field003']) {
+            const v = o[k];
+            if (typeof v === 'string' && v.trim())
+                return v.trim();
+        }
+    }
+    return '';
+}
+/** 表格里标题别撑爆终端 */
+export function ellipsizeCell(s, max = 64) {
+    const t = s.trim();
+    if (t.length <= max)
+        return t;
+    return `${t.slice(0, max - 1)}…`;
+}
+/** 辅助列：长 uuid 缩略，完整值见 -f json */
+export function briefUuid(id, head = 6, tail = 4) {
+    if (!id)
+        return '';
+    if (id.length <= head + tail + 1)
+        return id;
+    return `${id.slice(0, head)}…${id.slice(-tail)}`;
+}
+export function formatStamp(v) {
+    if (v == null || v === '')
+        return '';
+    const n = Number(v);
+    if (Number.isNaN(n))
+        return String(v);
+    const ms = n > 1e14 ? Math.floor(n / 1000) : n > 1e12 ? n : n * 1000;
+    try {
+        return new Date(ms).toISOString().replace('T', ' ').slice(0, 19);
+    }
+    catch {
+        return String(v);
+    }
+}
+export function flattenPeekGroups(parsed, limit) {
+    if (!Array.isArray(parsed.groups)) {
+        throw new CliError('FETCH_ERROR', 'Unexpected filters/peek response (missing groups)', 'Try -f json; check team UUID and API version.');
+    }
+    const groups = parsed.groups;
+    const rows = [];
+    for (const g of groups) {
+        const entries = Array.isArray(g.entries) ? g.entries : [];
+        for (const e of entries) {
+            rows.push(e);
+            if (rows.length >= limit)
+                break;
+        }
+        if (rows.length >= limit)
+            break;
+    }
+    return rows.slice(0, limit);
+}
+function fieldArrayFirstString(fv, fieldUuid) {
+    if (!Array.isArray(fv))
+        return '';
+    for (const item of fv) {
+        if (!item || typeof item !== 'object')
+            continue;
+        const row = item;
+        if (String(row.field_uuid ?? '') !== fieldUuid)
+            continue;
+        const v = row.value;
+        if (typeof v === 'string')
+            return v;
+        if (Array.isArray(v) && v[0] != null)
+            return String(v[0]);
+    }
+    return '';
+}
+function fvRecord(e) {
+    const fv = e.field_values;
+    return fv && typeof fv === 'object' && !Array.isArray(fv) ? fv : null;
+}
+/** 工作项状态 uuid（用于查 task_statuses 得中文名） */
+export function getTaskStatusRawId(e) {
+    const fv = e.field_values;
+    const fvObj = fvRecord(e);
+    if (typeof e.status_uuid === 'string')
+        return e.status_uuid;
+    return fieldArrayFirstString(fv, 'field016') || (fvObj ? String(fvObj.field016 ?? '') : '');
+}
+/** 项目 uuid */
+export function getTaskProjectRawId(e) {
+    const fv = e.field_values;
+    const fvObj = fvRecord(e);
+    if (typeof e.project_uuid === 'string')
+        return e.project_uuid;
+    return fieldArrayFirstString(fv, 'field006') || (fvObj ? String(fvObj.field006 ?? '') : '');
+}
+/**
+ * Project API 里 assess/total/remaining_manhour 多为**定点整数**（与 Web 上「小时」不一致）；
+ * 常见换算：raw / 1e5 ≈ 小时。若你方实例不同，可设 `ONES_MANHOUR_SCALE`（默认 100000）。
+ */
+export function onesManhourScale() {
+    const raw = Number(process.env.ONES_MANHOUR_SCALE?.trim());
+    if (Number.isFinite(raw) && raw > 0)
+        return raw;
+    return 1e5;
+}
+/** 界面/h 小数 → API 内 manhour 整数（与列表「工时」列同一刻度） */
+export function hoursToOnesManhourRaw(hours) {
+    if (!Number.isFinite(hours) || hours <= 0)
+        return 0;
+    return Math.max(1, Math.round(hours * onesManhourScale()));
+}
+function formatHoursShort(hours) {
+    if (!Number.isFinite(hours))
+        return '';
+    const snapped = Math.round(hours * 1e6) / 1e6;
+    const near = Math.round(snapped);
+    if (Math.abs(snapped - near) < 1e-5)
+        return `${near}h`;
+    const t = Math.round(snapped * 10) / 10;
+    return Number.isInteger(t) ? `${t}h` : `${t.toFixed(1)}h`;
+}
+function formatManhourSegment(label, v) {
+    if (v == null || v === '')
+        return null;
+    const n = Number(v);
+    if (!Number.isFinite(n))
+        return null;
+    const hours = n / onesManhourScale();
+    return `${label}${formatHoursShort(hours)}`;
+}
+export function formatTaskManhourSummary(e) {
+    const parts = [];
+    const a = formatManhourSegment('估', e.assess_manhour);
+    const t = formatManhourSegment('登', e.total_manhour);
+    const r = formatManhourSegment('余', e.remaining_manhour);
+    if (a)
+        parts.push(a);
+    if (t)
+        parts.push(t);
+    if (r)
+        parts.push(r);
+    return parts.length ? parts.join(' ') : '—';
+}
+export function mapTaskEntry(e, labels) {
+    const statusId = getTaskStatusRawId(e);
+    const projectId = getTaskProjectRawId(e);
+    const fullUuid = String(e.uuid ?? '');
+    const title = ellipsizeCell(pickTaskTitle(e));
+    const briefIfLong = (s) => (s.length > 14 ? briefUuid(s) : s);
+    const statusLabel = labels?.statusByUuid?.get(statusId) ?? briefIfLong(statusId);
+    const projectLabel = labels?.projectByUuid?.get(projectId) ?? briefIfLong(projectId);
+    return {
+        title,
+        status: ellipsizeCell(statusLabel, 20),
+        project: ellipsizeCell(projectLabel, 40),
+        uuid: fullUuid,
+        updated: formatStamp(e.server_update_stamp),
+        工时: ellipsizeCell(formatTaskManhourSummary(e), 36),
+    };
+}
+export function defaultPeekBody(query) {
+    return {
+        with_boards: false,
+        boards: null,
+        query,
+        group_by: '',
+        sort: [{ create_time: { order: 'desc' } }],
+        include_subtasks: false,
+        include_status_uuid: true,
+        include_issue_type: false,
+        include_project_uuid: true,
+        is_show_derive: false,
+    };
+}
+export function parsePeekLimit(value, fallback) {
+    const parsed = Number.parseInt(String(value ?? ''), 10);
+    if (!Number.isFinite(parsed) || parsed <= 0)
+        return fallback;
+    return Math.max(1, Math.min(500, parsed));
+}

package/dist/clis/ones/task-helpers.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/clis/ones/task-helpers.test.js

@@ -0,0 +1,12 @@
+import { describe, expect, it } from 'vitest';
+import { parsePeekLimit } from './task-helpers.js';
+describe('parsePeekLimit', () => {
+    it('returns the fallback when the input is not numeric', () => {
+        expect(parsePeekLimit('abc', 30)).toBe(30);
+    });
+    it('clamps the input into the supported range', () => {
+        expect(parsePeekLimit('0', 30)).toBe(30);
+        expect(parsePeekLimit('999', 30)).toBe(500);
+        expect(parsePeekLimit('42', 30)).toBe(42);
+    });
+});

package/dist/clis/ones/task.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/clis/ones/task.js

@@ -0,0 +1,66 @@
+import { cli, Strategy } from '../../registry.js';
+import { CliError } from '../../errors.js';
+import { onesFetchInPage } from './common.js';
+import { formatStamp } from './task-helpers.js';
+/**
+ * 工作项详情 — 对应前端路由 …/team/<team>/filter/view/…/task/<uuid>
+ * API: GET team/:teamUUID/task/:taskUUIDOrNumber/info
+ * @see https://docs.ones.cn/project/open-api-doc/project/task.html
+ */
+cli({
+    site: 'ones',
+    name: 'task',
+    description: 'ONES — work item detail (GET team/:team/task/:id/info); id is URL segment after …/task/',
+    domain: 'ones.cn',
+    strategy: Strategy.COOKIE,
+    browser: true,
+    navigateBefore: false,
+    args: [
+        {
+            name: 'id',
+            type: 'str',
+            required: true,
+            positional: true,
+            help: 'Work item UUID (often 16 chars) from …/task/<id>',
+        },
+        {
+            name: 'team',
+            type: 'str',
+            required: false,
+            help: 'Team UUID (8 chars from …/team/<team>/…), or set ONES_TEAM_UUID',
+        },
+    ],
+    columns: ['uuid', 'summary', 'number', 'status_uuid', 'assign', 'owner', 'project_uuid', 'updated'],
+    func: async (page, kwargs) => {
+        const id = String(kwargs.id ?? '').trim();
+        if (!id) {
+            throw new CliError('CONFIG', 'task id required', 'Pass the work item uuid from the URL path …/task/<id>');
+        }
+        const team = kwargs.team?.trim() ||
+            process.env.ONES_TEAM_UUID?.trim() ||
+            process.env.ONES_TEAM_ID?.trim();
+        if (!team) {
+            throw new CliError('CONFIG', 'team UUID required', 'Use --team <teamUUID> or set ONES_TEAM_UUID (from …/team/<team>/…).');
+        }
+        const path = `team/${team}/task/${encodeURIComponent(id)}/info`;
+        const data = (await onesFetchInPage(page, path, { method: 'GET' }));
+        if (typeof data.uuid !== 'string') {
+            const hint = typeof data.reason === 'string'
+                ? data.reason
+                : 'Use -f json to inspect response; check id length (often 16) and team.';
+            throw new CliError('FETCH_ERROR', `ONES task info: ${hint}`, 'Confirm task uuid and team match the browser URL.');
+        }
+        return [
+            {
+                uuid: String(data.uuid),
+                summary: String(data.summary ?? ''),
+                number: data.number != null ? String(data.number) : '',
+                status_uuid: String(data.status_uuid ?? ''),
+                assign: String(data.assign ?? ''),
+                owner: String(data.owner ?? ''),
+                project_uuid: String(data.project_uuid ?? ''),
+                updated: formatStamp(data.server_update_stamp),
+            },
+        ];
+    },
+});

package/dist/clis/ones/tasks.d.ts

@@ -0,0 +1 @@
+export {};