@guanwenai/high-tech-project-cli 0.1.0

package/scripts/services/product.mjs

@@ -0,0 +1,220 @@
+import { CliError } from '../core/errors.mjs';
+import {
+  createFileCommand,
+  idsInput as sharedIdsInput,
+  requiredString,
+  valueOf,
+  withJavaMethod,
+} from './shared.mjs';
+
+const REQUIRED_CONTEXT = ['gatewayUrl', 'uuid'];
+
+function objectInput(input) {
+  if (input === null || Array.isArray(input) || typeof input !== 'object') {
+    throw new CliError('ARGUMENT_INVALID', '命令输入必须是对象');
+  }
+  return input;
+}
+
+function positiveId(value, field) {
+  if (!Number.isSafeInteger(value) || value <= 0) {
+    throw new CliError('ARGUMENT_INVALID', `${field} 必须是正整数`);
+  }
+  return value;
+}
+
+function pageInput(input) {
+  const value = objectInput(input);
+  for (const field of ['pageNumber', 'pageSize']) {
+    if (value[field] !== undefined) positiveId(value[field], field);
+  }
+  return value;
+}
+
+function itemsInput(input) {
+  const value = objectInput(input);
+  if (!Array.isArray(value.items) || value.items.length === 0
+    || value.items.some((item) => item === null || Array.isArray(item) || typeof item !== 'object')) {
+    throw new CliError('ARGUMENT_INVALID', 'items 必须是非空对象数组');
+  }
+  return value;
+}
+
+function productInput(input) {
+  const value = objectInput(input);
+  value.psProductId = value.psProductId ?? value.ps_product_id;
+  positiveId(value.psProductId, 'ps_product_id');
+  return value;
+}
+
+function relationInput(field, exactLength) {
+  return (input) => {
+    const value = objectInput(input);
+    positiveId(value.id, 'id');
+    value[field] = value[field] ?? value[field.replace(/[A-Z]/g, (match) => `_${match.toLowerCase()}`)];
+    if (!Array.isArray(value[field])
+      || (exactLength && value[field].length !== exactLength)) {
+      throw new CliError('ARGUMENT_INVALID', `${field} 必须是有效的 ID 数组`);
+    }
+    value[field].forEach((id) => positiveId(id, field));
+    return value;
+  };
+}
+
+function command({ name, path, idempotent, validate = objectInput, handler, body, javaMethod }) {
+  return withJavaMethod({
+    name, method: 'POST', path, idempotent, requiredContext: REQUIRED_CONTEXT, validate,
+    handler: handler ?? (async ({ client, context, input }) => await client.request({
+      method: 'POST', path, body: body ? body(input, context) : { ...input, uuid: context.uuid }, idempotent,
+    })),
+  }, javaMethod);
+}
+
+function fileCreateInput(input) {
+  const value = objectInput(input);
+  value.psProductId = value.psProductId ?? value.ps_product_id;
+  positiveId(value.psProductId, 'ps_product_id');
+  requiredString(value.fileName ?? value.file_name, 'file_name');
+  requiredString(value.filePath ?? value.file_path, 'file_path');
+  return value;
+}
+
+function briefInput(input, idRequired = false) {
+  const value = objectInput(input);
+  value.psProductId = value.psProductId ?? value.ps_product_id;
+  if (idRequired) positiveId(value.id, 'id');
+  if (value.psProductId !== undefined) positiveId(value.psProductId, 'ps_product_id');
+  return value;
+}
+
+export const commands = [
+  command({
+    name: 'product.list', path: '/api/project-writing/ps-product/page', idempotent: true,
+    validate: pageInput,
+    handler: async ({ client, context, input }) => await client.request({
+      method: 'POST', path: '/api/project-writing/ps-product/page', idempotent: true,
+      body: { ...input, pageNumber: input.pageNumber ?? 1, pageSize: input.pageSize ?? 20, uuid: context.uuid },
+    }),
+  }),
+  command({
+    name: 'product.detail', path: '/api/project-writing/ps-product-brief/detail', idempotent: true,
+    validate: productInput,
+    handler: async ({ client, context, input }) => await client.request({
+      method: 'POST', path: '/api/project-writing/ps-product-brief/detail', idempotent: true,
+      body: {
+        psProductId: input.psProductId,
+        ...(context.tenantCode ? { tenantCode: context.tenantCode } : {}),
+      },
+    }),
+  }),
+  command({
+    name: 'product.save-batch', path: '/api/project-writing/ps-product/batch-save', idempotent: false,
+    validate: itemsInput, javaMethod: 'project_writing_ps_product_batch_save',
+    handler: async ({ client, context, input }) => await client.request({
+      method: 'POST', path: '/api/project-writing/ps-product/batch-save', idempotent: false,
+      body: input.items.map((item) => ({ ...item, uuid: item.uuid ?? context.uuid })),
+    }),
+  }),
+  command({
+    name: 'product.bind-rd-projects', path: '/api/project-writing/ps-product/bind-rd-projects', idempotent: false,
+    validate: relationInput('rdProjectIds'), javaMethod: 'project_writing_ps_product_bind_rd_projects',
+    handler: async ({ client, context, input }) => await client.request({
+      method: 'POST', path: '/api/project-writing/ps-product/bind-rd-projects', idempotent: false,
+      body: { id: input.id, rdProjectIds: input.rdProjectIds, uuid: context.uuid },
+    }),
+  }),
+  command({
+    name: 'product.bind-iprs', path: '/api/project-writing/ps-product/bind-iprs', idempotent: false,
+    validate: relationInput('iprIds'), javaMethod: 'project_writing_ps_product_bind_iprs',
+    handler: async ({ client, context, input }) => await client.request({
+      method: 'POST', path: '/api/project-writing/ps-product/bind-iprs', idempotent: false,
+      body: { id: input.id, iprIds: input.iprIds, uuid: context.uuid },
+    }),
+  }),
+  command({
+    name: 'product.bind-income', path: '/api/project-writing/ps-product/bind-income', idempotent: false,
+    validate: relationInput('incomeIds', 1),
+    handler: async ({ client, context, input }) => await client.request({
+      method: 'POST', path: '/api/project-writing/ps-product/bind-income', idempotent: false,
+      body: { id: input.id, operationStatusId: input.incomeIds[0], uuid: context.uuid },
+    }),
+  }),
+  command({
+    name: 'product.files', path: '/api/project-writing/ps-product-file/page', idempotent: true,
+    validate: productInput,
+    handler: async ({ client, context, input }) => await client.request({
+      method: 'POST', path: '/api/project-writing/ps-product-file/page', idempotent: true,
+      body: {
+        uuid: context.uuid, psProductId: input.psProductId,
+        pageNumber: input.pageNumber ?? 1, pageSize: input.pageSize ?? 20,
+      },
+    }),
+  }),
+  command({
+    name: 'product.submissions', path: '/api/project-writing/ps-product-submit/list', idempotent: true,
+    validate: productInput,
+    handler: async ({ client, context, input }) => await client.request({
+      method: 'POST', path: '/api/project-writing/ps-product-submit/list', idempotent: true,
+      body: { uuid: context.uuid, psProductId: input.psProductId },
+    }),
+  }),
+  command({
+    name: 'product.list-all', path: '/api/project-writing/ps-product/list', idempotent: true,
+    javaMethod: 'project_writing_ps_product_list',
+    body: (input, context) => ({ ...input, uuid: context.uuid }),
+  }),
+  command({
+    name: 'product.delete-batch', path: '/api/project-writing/ps-product/batch-delete', idempotent: false,
+    javaMethod: 'project_writing_ps_product_batch_delete', validate: sharedIdsInput,
+    body: (input) => input.ids,
+  }),
+  withJavaMethod(createFileCommand({
+    name: 'product.file-create', path: '/api/project-writing/ps-product-file/create',
+    idField: 'psProductId', validate: fileCreateInput,
+    extraFields: [
+      { snake: 'file_type', camel: 'fileType' },
+      { snake: 'file_code', camel: 'fileCode' },
+      { snake: 'file_format', camel: 'fileFormat' },
+    ],
+  }), 'project_writing_ps_product_file_create'),
+  command({
+    name: 'product.file-list', path: '/api/project-writing/ps-product-file/list', idempotent: true,
+    javaMethod: 'project_writing_ps_product_file_list',
+    body: (input, context) => ({
+      uuid: context.uuid,
+      ...(input.ids ? { ids: input.ids } : {}),
+      ...(input.psProductId !== undefined || input.ps_product_id !== undefined
+        ? { psProductId: input.psProductId ?? input.ps_product_id } : {}),
+      ...(input.fileType !== undefined || input.file_type !== undefined
+        ? { fileType: input.fileType ?? input.file_type } : {}),
+      ...(input.fileCode !== undefined || input.file_code !== undefined
+        ? { fileCode: input.fileCode ?? input.file_code } : {}),
+      ...(input.fileFormat !== undefined || input.file_format !== undefined
+        ? { fileFormat: input.fileFormat ?? input.file_format } : {}),
+    }),
+  }),
+  command({
+    name: 'product.file-delete-batch', path: '/api/project-writing/ps-product-file/delete-batch', idempotent: false,
+    javaMethod: 'project_writing_ps_product_file_delete_batch', validate: sharedIdsInput,
+    body: (input) => input.ids,
+  }),
+  command({
+    name: 'product.brief-create', path: '/api/project-writing/ps-product-brief/create', idempotent: false,
+    javaMethod: 'project_writing_ps_product_brief_create', validate: (input) => briefInput(input),
+    body: (input, context) => ({ ...input, uuid: context.uuid }),
+  }),
+  command({
+    name: 'product.brief-update', path: '/api/project-writing/ps-product-brief/update', idempotent: false,
+    javaMethod: 'project_writing_ps_product_brief_update', validate: (input) => briefInput(input, true),
+    body: (input, context) => ({ ...input, uuid: context.uuid }),
+  }),
+  command({
+    name: 'product.brief-detail', path: '/api/project-writing/ps-product-brief/detail', idempotent: true,
+    javaMethod: 'project_writing_ps_product_brief_detail', validate: objectInput,
+    body: (input, context) => ({
+      uuid: context.uuid,
+      ...(input.psProductId !== undefined || input.ps_product_id !== undefined
+        ? { psProductId: input.psProductId ?? input.ps_product_id } : {}),
+    }),
+  }),
+];

package/scripts/services/project.mjs

@@ -0,0 +1,99 @@
+import { CliError } from '../core/errors.mjs';
+import { withJavaMethod } from './shared.mjs';
+
+const BASE_CONTEXT = ['gatewayUrl'];
+const PROJECT_CONTEXT = [...BASE_CONTEXT, 'uuid'];
+
+function objectInput(input) {
+  if (input === null || Array.isArray(input) || typeof input !== 'object') {
+    throw new CliError('ARGUMENT_INVALID', '命令输入必须是对象');
+  }
+  return input;
+}
+
+function bindInput(input) {
+  const value = objectInput(input);
+  const projectId = Number(value.workId);
+  if (!Number.isSafeInteger(projectId) || projectId <= 0
+    || typeof value.workName !== 'string' || !value.workName.trim()
+    || typeof value.customerName !== 'string' || !value.customerName.trim()) {
+    throw new CliError('ARGUMENT_INVALID', '项目绑定需要有效的 workId、workName 和 customerName');
+  }
+  return value;
+}
+
+function requestCommand({ name, path, idempotent, requiredContext, validate = objectInput, body, javaMethod }) {
+  return withJavaMethod({
+    name,
+    method: 'POST',
+    path,
+    idempotent,
+    requiredContext,
+    validate,
+    handler: async ({ client, context, input }) => await client.request({
+      method: 'POST',
+      path,
+      body: body(input, context),
+      idempotent,
+    }),
+  }, javaMethod);
+}
+
+export const commands = [
+  requestCommand({
+    name: 'project.list',
+    path: '/api/project-writing/bind/list',
+    idempotent: true,
+    requiredContext: BASE_CONTEXT,
+    body: (input, context) => ({
+      ...input,
+      ...(context.tenantCode ? { tenantCode: context.tenantCode } : {}),
+    }),
+  }),
+  requestCommand({
+    name: 'project.detail',
+    path: '/api/project-writing/customer/detail',
+    idempotent: true,
+    requiredContext: PROJECT_CONTEXT,
+    body: (input, context) => ({
+      ...input,
+      ...(context.tenantCode ? { tenantCode: context.tenantCode } : {}),
+      uuid: context.uuid,
+    }),
+    javaMethod: 'project_writing_customer_detail',
+  }),
+  requestCommand({
+    name: 'project.save',
+    path: '/api/project-writing/customer/save',
+    idempotent: false,
+    requiredContext: PROJECT_CONTEXT,
+    body: (input, context) => ({
+      ...input,
+      ...(context.tenantCode ? { tenantCode: context.tenantCode } : {}),
+      uuid: context.uuid,
+    }),
+  }),
+  requestCommand({
+    name: 'project.bind',
+    path: '/api/project-writing/bind/create',
+    idempotent: false,
+    requiredContext: BASE_CONTEXT,
+    validate: bindInput,
+    body: (input) => ({
+      projectId: Number(input.workId),
+      projectName: input.workName.trim(),
+      customerName: input.customerName.trim(),
+    }),
+  }),
+  requestCommand({
+    name: 'project.overview',
+    path: '/api/project-writing/customer/list',
+    idempotent: true,
+    requiredContext: PROJECT_CONTEXT,
+    body: (input, context) => ({
+      ...input,
+      ...(context.tenantCode ? { tenantCode: context.tenantCode } : {}),
+      uuid: context.uuid,
+    }),
+  }),
+];

package/scripts/services/rd.mjs

@@ -0,0 +1,225 @@
+import { CliError } from '../core/errors.mjs';
+import {
+  createFileCommand,
+  idsInput as sharedIdsInput,
+  requiredString,
+  valueOf,
+  withJavaMethod,
+} from './shared.mjs';
+
+const REQUIRED_CONTEXT = ['gatewayUrl', 'uuid'];
+
+function objectInput(input) {
+  if (input === null || Array.isArray(input) || typeof input !== 'object') {
+    throw new CliError('ARGUMENT_INVALID', '命令输入必须是对象');
+  }
+  return input;
+}
+
+function positiveId(value, field) {
+  if (!Number.isSafeInteger(value) || value <= 0) {
+    throw new CliError('ARGUMENT_INVALID', `${field} 必须是正整数`);
+  }
+  return value;
+}
+
+function pageInput(input) {
+  const value = objectInput(input);
+  for (const field of ['pageNumber', 'pageSize']) {
+    if (value[field] !== undefined) positiveId(value[field], field);
+  }
+  return value;
+}
+
+function itemsInput(input) {
+  const value = objectInput(input);
+  if (!Array.isArray(value.items) || value.items.length === 0
+    || value.items.some((item) => item === null || Array.isArray(item) || typeof item !== 'object')) {
+    throw new CliError('ARGUMENT_INVALID', 'items 必须是非空对象数组');
+  }
+  return value;
+}
+
+function projectInput(input) {
+  const value = objectInput(input);
+  const rdProjectId = value.rdProjectId ?? value.rd_project_id;
+  positiveId(rdProjectId, 'rd_project_id');
+  value.rdProjectId = rdProjectId;
+  return value;
+}
+
+function relationInput(field) {
+  return (input) => {
+    const value = objectInput(input);
+    const snakeField = field.replace(/[A-Z]/g, (match) => `_${match.toLowerCase()}`);
+    value[field] = value[field] ?? value[snakeField];
+    positiveId(value.id, 'id');
+    if (!Array.isArray(value[field]) || value[field].length === 0) {
+      throw new CliError('ARGUMENT_INVALID', `${field} 必须是非空 ID 数组`);
+    }
+    value[field].forEach((id) => positiveId(id, field));
+    return value;
+  };
+}
+
+function fileCreateInput(input) {
+  const value = objectInput(input);
+  positiveId(value.rdProjectId ?? value.rd_project_id, 'rd_project_id');
+  requiredString(value.fileName ?? value.file_name, 'file_name');
+  requiredString(value.filePath ?? value.file_path, 'file_path');
+  return value;
+}
+
+function briefInput(input, idRequired = false) {
+  const value = objectInput(input);
+  const id = value.id;
+  const rdProjectId = value.rdProjectId ?? value.rd_project_id;
+  if (idRequired) positiveId(id, 'id');
+  if (rdProjectId !== undefined) positiveId(rdProjectId, 'rd_project_id');
+  return value;
+}
+
+function command({ name, path, idempotent, validate = objectInput, handler, body, javaMethod }) {
+  return withJavaMethod({
+    name, method: 'POST', path, idempotent, requiredContext: REQUIRED_CONTEXT, validate,
+    handler: handler ?? (async ({ client, context, input }) => await client.request({
+      method: 'POST', path, body: body ? body(input, context) : { ...input, uuid: context.uuid }, idempotent,
+    })),
+  }, javaMethod);
+}
+
+export const commands = [
+  command({
+    name: 'rd.list', path: '/api/project-writing/rd-project/page', idempotent: true,
+    validate: pageInput,
+    handler: async ({ client, context, input }) => await client.request({
+      method: 'POST', path: '/api/project-writing/rd-project/page', idempotent: true,
+      body: { ...input, pageNumber: input.pageNumber ?? 1, pageSize: input.pageSize ?? 20, uuid: context.uuid },
+    }),
+  }),
+  command({
+    name: 'rd.list-all', path: '/api/project-writing/rd-project/list', idempotent: true,
+    javaMethod: 'project_writing_rd_project_list',
+    body: (input, context) => ({ ...input, uuid: context.uuid }),
+  }),
+  command({
+    name: 'rd.detail', path: '/api/project-writing/rd-project/detail', idempotent: true,
+    validate: projectInput,
+  }),
+  command({
+    name: 'rd.save-batch', path: '/api/project-writing/rd-project/batch-save', idempotent: false,
+    validate: itemsInput, javaMethod: 'project_writing_rd_project_batch_save',
+    handler: async ({ client, context, input }) => await client.request({
+      method: 'POST', path: '/api/project-writing/rd-project/batch-save', idempotent: false,
+      body: input.items.map((item) => ({ ...item, uuid: item.uuid ?? context.uuid })),
+    }),
+  }),
+  command({
+    name: 'rd.bind-person', path: '/api/project-writing/rd-project/bind-person', idempotent: false,
+    validate: relationInput('personIds'), javaMethod: 'project_writing_rd_project_bind_person',
+    handler: async ({ client, context, input }) => {
+      const results = [];
+      for (const personId of input.personIds) {
+        results.push(await client.request({
+          method: 'POST', path: '/api/project-writing/rd-project/bind-person', idempotent: false,
+          body: { id: input.id, personId, uuid: context.uuid },
+        }));
+      }
+      return results;
+    },
+  }),
+  command({
+    name: 'rd.bind-iprs', path: '/api/project-writing/rd-project/bind-iprs', idempotent: false,
+    validate: relationInput('iprIds'), javaMethod: 'project_writing_rd_project_bind_iprs',
+    handler: async ({ client, context, input }) => await client.request({
+      method: 'POST', path: '/api/project-writing/rd-project/bind-iprs', idempotent: false,
+      body: { id: input.id, iprIds: input.iprIds, uuid: context.uuid },
+    }),
+  }),
+  command({
+    name: 'rd.files', path: '/api/project-writing/rd-project-file/page', idempotent: true,
+    validate: projectInput,
+    handler: async ({ client, context, input }) => await client.request({
+      method: 'POST', path: '/api/project-writing/rd-project-file/page', idempotent: true,
+      body: {
+        uuid: context.uuid, rdProjectId: input.rdProjectId,
+        pageNumber: input.pageNumber ?? 1, pageSize: input.pageSize ?? 20,
+      },
+    }),
+  }),
+  command({
+    name: 'rd.submissions', path: '/api/project-writing/rd-project-submit/list', idempotent: true,
+    validate: projectInput,
+    handler: async ({ client, context, input }) => await client.request({
+      method: 'POST', path: '/api/project-writing/rd-project-submit/list', idempotent: true,
+      body: { uuid: context.uuid, rdProjectId: input.rdProjectId },
+    }),
+  }),
+  command({
+    name: 'rd.bind-fee', path: '/api/project-writing/rd-project/bind-fee', idempotent: false,
+    javaMethod: 'project_writing_rd_project_bind_fee', validate: projectInput,
+    body: (input, context) => ({
+      id: input.rdProjectId,
+      feeDetailId: input.rdFundSituationId ?? input.feeDetailId,
+      uuid: context.uuid,
+    }),
+  }),
+  command({
+    name: 'rd.delete-batch', path: '/api/project-writing/rd-project/batch-delete', idempotent: false,
+    javaMethod: 'project_writing_rd_project_batch_delete', validate: sharedIdsInput,
+    body: (input) => input.ids,
+  }),
+  withJavaMethod(createFileCommand({
+    name: 'rd.file-create', path: '/api/project-writing/rd-project-file/create',
+    idField: 'rdProjectId', validate: fileCreateInput,
+    extraFields: [
+      { snake: 'file_type', camel: 'fileType' },
+      { snake: 'file_code', camel: 'fileCode' },
+      { snake: 'file_format', camel: 'fileFormat' },
+    ],
+  }), 'project_writing_rd_project_file_create'),
+  command({
+    name: 'rd.file-list', path: '/api/project-writing/rd-project-file/list', idempotent: true,
+    javaMethod: 'project_writing_rd_project_file_list',
+    body: (input, context) => ({
+      uuid: context.uuid,
+      ...(input.ids ? { ids: input.ids } : {}),
+      ...(input.rdProjectId !== undefined || input.rd_project_id !== undefined
+        ? { rdProjectId: input.rdProjectId ?? input.rd_project_id } : {}),
+      ...(input.fileType !== undefined || input.file_type !== undefined
+        ? { fileType: input.fileType ?? input.file_type } : {}),
+      ...(input.fileCode !== undefined || input.file_code !== undefined
+        ? { fileCode: input.fileCode ?? input.file_code } : {}),
+      ...(input.fileFormat !== undefined || input.file_format !== undefined
+        ? { fileFormat: input.fileFormat ?? input.file_format } : {}),
+    }),
+  }),
+  command({
+    name: 'rd.file-delete-batch', path: '/api/project-writing/rd-project-file/delete-batch', idempotent: false,
+    javaMethod: 'project_writing_rd_project_file_delete_batch', validate: sharedIdsInput,
+    body: (input) => input.ids,
+  }),
+  command({
+    name: 'rd.brief-create', path: '/api/project-writing/rd-project-brief/create', idempotent: false,
+    javaMethod: 'project_writing_rd_project_brief_create', validate: (input) => briefInput(input),
+    body: (input, context) => ({
+      ...input, rdProjectId: input.rdProjectId ?? input.rd_project_id, uuid: context.uuid,
+    }),
+  }),
+  command({
+    name: 'rd.brief-update', path: '/api/project-writing/rd-project-brief/update', idempotent: false,
+    javaMethod: 'project_writing_rd_project_brief_update', validate: (input) => briefInput(input, true),
+    body: (input, context) => ({
+      ...input, rdProjectId: input.rdProjectId ?? input.rd_project_id, uuid: context.uuid,
+    }),
+  }),
+  command({
+    name: 'rd.brief-detail', path: '/api/project-writing/rd-project-brief/detail', idempotent: true,
+    javaMethod: 'project_writing_rd_project_brief_detail', validate: objectInput,
+    body: (input, context) => ({
+      uuid: context.uuid,
+      ...(input.rdProjectId !== undefined || input.rd_project_id !== undefined
+        ? { rdProjectId: input.rdProjectId ?? input.rd_project_id } : {}),
+    }),
+  }),
+];

package/scripts/services/report.mjs

@@ -0,0 +1,117 @@
+import { CliError } from '../core/errors.mjs';
+import { downloadAtomically } from './material.mjs';
+
+const REQUIRED_CONTEXT = ['gatewayUrl', 'uuid'];
+const COMPLETENESS_QUERIES = [
+  ['customer', '/api/project-writing/customer/list', {}],
+  ['people', '/api/project-writing/person/page', { pageNumber: 1, pageSize: 200, chooseFlag: true }],
+  ['ipr', '/api/project-writing/ipr/page', { pageNumber: 1, pageSize: 200, chooseFlag: true }],
+  ['rd', '/api/project-writing/rd-project/page', { pageNumber: 1, pageSize: 200 }],
+  ['product', '/api/project-writing/ps-product/page', { pageNumber: 1, pageSize: 200 }],
+  ['achievement', '/api/project-writing/tech-achievement/page', { pageNumber: 1, pageSize: 200 }],
+  ['policy', '/api/project-writing/system-manage-situation/detail', {}],
+  ['materials', '/api/project-writing/supplement-file/list', {}],
+];
+const SUMMARY_QUERIES = [
+  ['project', '/api/project-writing/bind/list', {}],
+  ...COMPLETENESS_QUERIES,
+];
+const GENERATE_ROUTES = {
+  people: '/api/project-writing/person-submit/generate',
+  ipr: '/api/project-writing/ipr-submit/generate',
+  rd: '/api/project-writing/rd-project-submit/generate',
+  product: '/api/project-writing/ps-product-submit/generate',
+  achievement: '/api/project-writing/tech-achievement-submit/generate',
+  policy: '/api/project-writing/system-manage-submit/generate',
+};
+
+function objectInput(input) {
+  if (input === null || Array.isArray(input) || typeof input !== 'object') {
+    throw new CliError('ARGUMENT_INVALID', '命令输入必须是对象');
+  }
+  return input;
+}
+
+function idArray(value) {
+  return Array.isArray(value) && value.length > 0
+    && value.every((id) => Number.isSafeInteger(id) && id > 0);
+}
+
+function generateInput(input) {
+  const value = objectInput(input);
+  if (!Array.isArray(value.jobs) || value.jobs.length === 0) {
+    throw new CliError('ARGUMENT_INVALID', 'jobs 必须是非空数组');
+  }
+  for (const job of value.jobs) {
+    if (job === null || typeof job !== 'object' || !Object.hasOwn(GENERATE_ROUTES, job.type)
+      || !idArray(job.fileIds)) {
+      throw new CliError('ARGUMENT_INVALID', '报告生成任务类型或 fileIds 无效');
+    }
+  }
+  return value;
+}
+
+function downloadInput(input) {
+  const value = objectInput(input);
+  if (typeof value.fileUrl !== 'string' || !value.fileUrl.trim()
+    || typeof value.fileName !== 'string' || !value.fileName.trim()
+    || typeof value.target !== 'string' || !value.target.trim()) {
+    throw new CliError('ARGUMENT_INVALID', '报告下载需要 fileUrl、fileName 和 target');
+  }
+  return value;
+}
+
+async function aggregate(client, context, queries) {
+  const sections = {};
+  const failed = [];
+  for (let offset = 0; offset < queries.length; offset += 4) {
+    const batch = queries.slice(offset, offset + 4);
+    await Promise.all(batch.map(async ([section, path, body]) => {
+      try {
+        sections[section] = await client.request({
+          method: 'POST', path, idempotent: true, body: { uuid: context.uuid, ...body },
+        });
+      } catch (error) {
+        failed.push({
+          section,
+          code: error?.code ?? 'BUSINESS_ERROR',
+          message: error instanceof Error ? error.message : '查询失败',
+        });
+      }
+    }));
+  }
+  return { complete: failed.length === 0, sections, failed };
+}
+
+export const commands = [
+  {
+    name: 'report.completeness', method: 'POST', path: '/api/project-writing/customer/list',
+    idempotent: true, multipart: false, requiredContext: REQUIRED_CONTEXT, validate: objectInput,
+    handler: async ({ client, context }) => await aggregate(client, context, COMPLETENESS_QUERIES),
+  },
+  {
+    name: 'report.summary', method: 'POST', path: '/api/project-writing/bind/list',
+    idempotent: true, multipart: false, requiredContext: REQUIRED_CONTEXT, validate: objectInput,
+    handler: async ({ client, context }) => await aggregate(client, context, SUMMARY_QUERIES),
+  },
+  {
+    name: 'report.generate', method: 'POST', path: GENERATE_ROUTES.people,
+    idempotent: false, multipart: false, requiredContext: REQUIRED_CONTEXT, validate: generateInput,
+    handler: async ({ client, context, input }) => {
+      const results = [];
+      for (const job of input.jobs) {
+        const { type, ...payload } = job;
+        results.push(await client.request({
+          method: 'POST', path: GENERATE_ROUTES[type], idempotent: false,
+          body: { uuid: context.uuid, ...payload },
+        }));
+      }
+      return results;
+    },
+  },
+  {
+    name: 'report.download', method: 'POST', path: '/api/project-writing/file/download',
+    idempotent: false, multipart: false, requiredContext: REQUIRED_CONTEXT, validate: downloadInput,
+    handler: downloadAtomically,
+  },
+];