Files
jackwener__opencli/clis/ones/task.ts
jakevin 80eef46b4e refactor: monorepo adapter separation (clis/ at root) (#782)
* refactor: move adapters from src/clis/ to root clis/ for monorepo separation

Separates CLI adapters from the core runtime to prepare for independent
adapter distribution via postinstall fetch.

Key changes:
- Move src/clis/ → clis/ (adapters at repo root)
- Change tsconfig rootDir from "src" to "." so tsc compiles both
- Create root-level shim files (registry.ts, errors.ts, etc.) so adapter
  relative imports (../../registry.js) resolve correctly
- Update build-manifest.ts, main.ts paths for new dist/src/ structure
- Expand ensureUserCliCompatShims() to cover all adapter import targets
  (types, utils, logger, launcher, browser/*, download/*, pipeline/*)
- Add scripts/fetch-adapters.js postinstall for ~/.opencli/clis/ sync
- Update vitest.config.ts adapter test paths
- Add package.json files field to exclude adapters from npm package

Official adapter files are unconditionally overwritten on update;
user-created files not in the manifest are preserved.

* fix: add dist/clis/ and cli-manifest.json to npm files, harden fetch-adapters

- Add dist/clis/ and dist/cli-manifest.json to package.json files field
  so built-in adapters and manifest ship with the npm package
- Replace execSync with execFileSync to prevent command injection
- Add version check to skip redundant adapter fetches
- Track tmpRoot explicitly for reliable cleanup

* fix: address review blockers — manifest-based updates, global-only fetch, first-run fallback

1. Manifest-based update strategy:
   - Read old manifest to identify previously-official files
   - Clean up files removed upstream (in old manifest but not new)
   - User-created files (never in any manifest) remain untouched

2. Only run fetch-adapters on global install (npm_config_global=true)
   or explicit OPENCLI_FETCH=1, preventing heavy side effects for
   local/dev installs

3. First-run fallback in discovery.ts:
   - ensureUserAdapters() checks for adapter-manifest.json
   - If missing and ~/.opencli/clis/ is empty, spawns fetch-adapters.js
   - Guarantees adapters are available even with --ignore-scripts

* fix: remove OPENCLI_FETCH env var, use internal _OPENCLI_FIRST_RUN instead

* feat: also support OPENCLI_FETCH=1 for explicit adapter fetch trigger

* simplify: replace git clone with local copy from dist/clis/

Adapters already ship in the npm package (dist/clis/), so there's no
need to clone from GitHub. Copy directly from the installed package:

- Eliminates git, curl, tar dependencies
- No network calls in postinstall
- No timeout/offline issues
- Version always matches the installed CLI
- ~65 lines of clone/download code replaced by one cpSync loop
2026-04-05 01:46:36 +08:00

80 lines
2.5 KiB
TypeScript

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),
},
];
},
});