@jackwener/opencli 1.5.5 → 1.5.6

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 {};

package/dist/clis/ones/tasks.js

@@ -0,0 +1,79 @@
+import { cli, Strategy } from '../../registry.js';
+import { CliError } from '../../errors.js';
+import { gotoOnesHome, onesFetchInPage } from './common.js';
+import { enrichPeekEntriesWithDetails } from './enrich-tasks.js';
+import { resolveTaskListLabels } from './resolve-labels.js';
+import { defaultPeekBody, flattenPeekGroups, mapTaskEntry, parsePeekLimit } from './task-helpers.js';
+function buildQuery(project, assign) {
+    const must = [];
+    if (project?.trim()) {
+        must.push({ in: { 'field_values.field006': [project.trim()] } });
+    }
+    if (assign?.trim()) {
+        must.push({ equal: { assign: assign.trim() } });
+    }
+    if (must.length === 0) {
+        return { must: [] };
+    }
+    return { must };
+}
+cli({
+    site: 'ones',
+    name: 'tasks',
+    description: 'ONES Project API — list work items (POST team/:team/filters/peek); use token-info -f json for team uuid',
+    domain: 'ones.cn',
+    strategy: Strategy.COOKIE,
+    browser: true,
+    navigateBefore: false,
+    args: [
+        {
+            name: 'team',
+            type: 'str',
+            required: false,
+            positional: true,
+            help: 'Team UUID (8 chars), or set ONES_TEAM_UUID',
+        },
+        {
+            name: 'project',
+            type: 'str',
+            required: false,
+            help: 'Filter by project UUID (field006 / 所属项目)',
+        },
+        {
+            name: 'assign',
+            type: 'str',
+            required: false,
+            help: 'Filter by assignee user UUID (负责人 assign)',
+        },
+        {
+            name: 'limit',
+            type: 'int',
+            default: 30,
+            help: 'Max rows after flattening groups (default 30)',
+        },
+    ],
+    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 as first argument or set ONES_TEAM_UUID (see `opencli ones token-info -f json` → teams[].uuid).');
+        }
+        const project = kwargs.project?.trim();
+        const assign = kwargs.assign?.trim();
+        const limit = parsePeekLimit(kwargs.limit, 30);
+        await gotoOnesHome(page);
+        const body = defaultPeekBody(buildQuery(project, assign));
+        const path = `team/${team}/filters/peek`;
+        const parsed = (await onesFetchInPage(page, path, {
+            method: 'POST',
+            body: JSON.stringify(body),
+            skipGoto: true,
+        }));
+        const entries = flattenPeekGroups(parsed, limit);
+        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/token-info.d.ts

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

package/dist/clis/ones/token-info.js

@@ -0,0 +1,42 @@
+import { cli, Strategy } from '../../registry.js';
+import { CliError } from '../../errors.js';
+import { onesFetchInPage } from './common.js';
+cli({
+    site: 'ones',
+    name: 'token-info',
+    description: 'ONES Project API — session detail (GET auth/token_info) via Chrome Bridge: user, teams, org',
+    domain: 'ones.cn',
+    strategy: Strategy.COOKIE,
+    browser: true,
+    navigateBefore: false,
+    args: [],
+    columns: ['uuid', 'name', 'email', 'teams', 'org_name'],
+    func: async (page) => {
+        const root = (await onesFetchInPage(page, 'auth/token_info'));
+        const user = root.user && typeof root.user === 'object' ? root.user : null;
+        if (!user?.uuid) {
+            throw new CliError('FETCH_ERROR', 'Unexpected auth/token_info response', 'Try `opencli ones me -f json` or check ONES_* env vars.');
+        }
+        const teamRows = Array.isArray(root.teams) ? root.teams : [];
+        const teamsHint = teamRows
+            .map((t) => {
+            const n = String(t.name ?? '').trim();
+            const u = String(t.uuid ?? '').trim();
+            if (n && u)
+                return `${n} (${u})`;
+            return u || n;
+        })
+            .filter(Boolean)
+            .join(', ');
+        const org = root.org && typeof root.org === 'object' ? root.org : null;
+        return [
+            {
+                uuid: String(user.uuid),
+                name: String(user.name ?? ''),
+                email: String(user.email ?? ''),
+                teams: teamsHint,
+                org_name: org ? String(org.name ?? '') : '',
+            },
+        ];
+    },
+});

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

@@ -0,0 +1,11 @@
+/**
+ * Log/backfill work hours. Project API paths vary by deployment,
+ * so we try common endpoints in sequence.
+ */
+export declare function buildAddManhourGraphqlBody(input: {
+    ownerId: string;
+    taskId: string;
+    startTime: number;
+    rawManhour: number;
+    note: string;
+}): string;