@jackwener/opencli 1.5.5 → 1.5.7

package/src/clis/ones/task-helpers.ts

@@ -0,0 +1,214 @@
+/**
+ * ONES filters/peek 响应解析（tasks / my-tasks 共用）
+ */
+
+import { CliError } from '../../errors.js';
+
+/** ONES task 里 field_values 常为 [{ field_uuid, value }, ...] */
+function pickTitleFromFieldValuesArray(fv: unknown): string {
+  if (!Array.isArray(fv)) return '';
+  for (const item of fv) {
+    if (!item || typeof item !== 'object') continue;
+    const row = item as Record<string, unknown>;
+    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: Record<string, unknown>): string {
+  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 as Record<string, unknown>;
+    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: string, max = 64): string {
+  const t = s.trim();
+  if (t.length <= max) return t;
+  return `${t.slice(0, max - 1)}…`;
+}
+
+/** 辅助列：长 uuid 缩略，完整值见 -f json */
+export function briefUuid(id: string, head = 6, tail = 4): string {
+  if (!id) return '';
+  if (id.length <= head + tail + 1) return id;
+  return `${id.slice(0, head)}…${id.slice(-tail)}`;
+}
+
+export function formatStamp(v: unknown): string {
+  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: Record<string, unknown>, limit: number): Record<string, unknown>[] {
+  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 as Record<string, unknown>[];
+  const rows: Record<string, unknown>[] = [];
+
+  for (const g of groups) {
+    const entries = Array.isArray(g.entries) ? (g.entries as Record<string, unknown>[]) : [];
+    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: unknown, fieldUuid: string): string {
+  if (!Array.isArray(fv)) return '';
+  for (const item of fv) {
+    if (!item || typeof item !== 'object') continue;
+    const row = item as Record<string, unknown>;
+    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: Record<string, unknown>): Record<string, unknown> | null {
+  const fv = e.field_values;
+  return fv && typeof fv === 'object' && !Array.isArray(fv) ? (fv as Record<string, unknown>) : null;
+}
+
+/** 工作项状态 uuid（用于查 task_statuses 得中文名） */
+export function getTaskStatusRawId(e: Record<string, unknown>): string {
+  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: Record<string, unknown>): string {
+  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(): number {
+  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: number): number {
+  if (!Number.isFinite(hours) || hours <= 0) return 0;
+  return Math.max(1, Math.round(hours * onesManhourScale()));
+}
+
+function formatHoursShort(hours: number): string {
+  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: string, v: unknown): string | null {
+  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: Record<string, unknown>): string {
+  const parts: string[] = [];
+  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 interface TaskLabelMaps {
+  statusByUuid?: Map<string, string>;
+  projectByUuid?: Map<string, string>;
+}
+
+export function mapTaskEntry(e: Record<string, unknown>, labels?: TaskLabelMaps): Record<string, string> {
+  const statusId = getTaskStatusRawId(e);
+  const projectId = getTaskProjectRawId(e);
+
+  const fullUuid = String(e.uuid ?? '');
+  const title = ellipsizeCell(pickTaskTitle(e));
+
+  const briefIfLong = (s: string) => (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: Record<string, unknown>): Record<string, unknown> {
+  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: unknown, fallback: number): number {
+  const parsed = Number.parseInt(String(value ?? ''), 10);
+  if (!Number.isFinite(parsed) || parsed <= 0) return fallback;
+  return Math.max(1, Math.min(500, parsed));
+}

package/src/clis/ones/task.ts

@@ -0,0 +1,79 @@
+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 as string | undefined)?.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' })) as Record<string, unknown>;
+
+    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/src/clis/ones/tasks.ts

@@ -0,0 +1,92 @@
+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?: string, assign?: string): Record<string, unknown> {
+  const must: unknown[] = [];
+  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 as string | undefined)?.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 as string | undefined)?.trim();
+    const assign = (kwargs.assign as string | undefined)?.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,
+    })) as Record<string, unknown>;
+
+    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/src/clis/ones/token-info.ts

@@ -0,0 +1,46 @@
+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')) as Record<string, unknown>;
+    const user = root.user && typeof root.user === 'object' ? (root.user as Record<string, unknown>) : 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 as Record<string, unknown>[]) : [];
+    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 as Record<string, unknown>) : null;
+
+    return [
+      {
+        uuid: String(user.uuid),
+        name: String(user.name ?? ''),
+        email: String(user.email ?? ''),
+        teams: teamsHint,
+        org_name: org ? String(org.name ?? '') : '',
+      },
+    ];
+  },
+});

package/src/clis/ones/worklog.test.ts

@@ -0,0 +1,24 @@
+import { describe, expect, it } from 'vitest';
+import { buildAddManhourGraphqlBody } from './worklog.js';
+
+describe('buildAddManhourGraphqlBody', () => {
+  it('inlines the addManhour arguments so the mutation is syntactically valid', () => {
+    const payload = JSON.parse(
+      buildAddManhourGraphqlBody({
+        ownerId: 'user-1',
+        taskId: 'task-1',
+        startTime: 1711411200,
+        rawManhour: 150000,
+        note: 'Backfill',
+      }),
+    ) as { query: string };
+
+    expect(payload.query).toContain('mutation AddManhour');
+    expect(payload.query).toContain('owner: "user-1"');
+    expect(payload.query).toContain('task: "task-1"');
+    expect(payload.query).toContain('start_time: 1711411200');
+    expect(payload.query).toContain('hours: 150000');
+    expect(payload.query).not.toContain('$owner');
+    expect(payload.query).not.toContain('$task');
+  });
+});