@auto-ai/agent 2.1.98 → 2.1.101

package/skills-runtime/geelib/cli/commands/matter.ts

@@ -0,0 +1,167 @@
+import { geelibGet, geelibPost } from '../client.js'
+
+const PRIORITY_MAP: Record<string, number> = {
+  low: 1,
+  medium: 2,
+  high: 3,
+  urgent: 4,
+}
+
+export type ListMattersOpts = {
+  subId: number
+  typeId: number
+  page?: number
+  pageSize?: number
+  keyword?: string
+  statusId?: number
+  assigneeId?: number
+}
+
+/** 分页查询工作项列表 */
+export async function cmdListMatters(opts: ListMattersOpts): Promise<unknown> {
+  const customContent: Record<string, unknown> = {}
+  if (opts.statusId !== undefined) {
+    customContent.status = [opts.statusId]
+  }
+  if (opts.assigneeId !== undefined) {
+    customContent.executor = [opts.assigneeId]
+  }
+  const body: Record<string, unknown> = {
+    sub_id: opts.subId,
+    type_id: [opts.typeId],
+    page: opts.page ?? 1,
+    pageSize: opts.pageSize ?? 20,
+    title: opts.keyword ?? '',
+    order_by: [],
+    customContent,
+    is_favor: 0,
+    simple: 0,
+    from_v3: 1,
+    tree: 0,
+    need_user_name: 1,
+  }
+  return geelibPost('/matter/Matter/getMatterList', body)
+}
+
+export async function cmdGetMatter(
+  subId: number,
+  matterId: number,
+): Promise<unknown> {
+  return geelibGet('/matter/Matter/getMatterDetail', {
+    sub_id: subId,
+    id: matterId,
+    need_options: 1,
+  })
+}
+
+export type UpdateMatterOpts = {
+  subId: number
+  matterId: number
+  title?: string
+  description?: string
+  statusId?: number
+  assigneeId?: number
+  priority?: string
+  progress?: number
+  sprintId?: number
+}
+
+/** 更新工作项；状态变更后回查验证 */
+export async function cmdUpdateMatter(opts: UpdateMatterOpts): Promise<unknown> {
+  const results: unknown[] = []
+
+  const hasOtherFields =
+    opts.title !== undefined ||
+    opts.description !== undefined ||
+    opts.assigneeId !== undefined ||
+    opts.priority !== undefined ||
+    opts.progress !== undefined ||
+    opts.sprintId !== undefined
+
+  if (hasOtherFields) {
+    const body: Record<string, unknown> = {
+      sub_id: opts.subId,
+      id: opts.matterId,
+    }
+    if (opts.title !== undefined) body.title = opts.title
+    if (opts.description !== undefined) body.content = opts.description
+    if (opts.assigneeId !== undefined) body.executor = opts.assigneeId
+    if (opts.priority !== undefined) {
+      body.priority = PRIORITY_MAP[opts.priority] ?? opts.priority
+    }
+    if (opts.progress !== undefined) body.progress = opts.progress
+    if (opts.sprintId !== undefined) body.sprint_id = opts.sprintId
+    const r = await geelibPost<{ errno: number; errmsg?: string }>(
+      '/matter/Matter/editMatter',
+      body,
+    )
+    results.push({ fields: 'other', ...r })
+  }
+
+  if (opts.statusId !== undefined) {
+    const statusBody = {
+      sub_id: String(opts.subId),
+      id: opts.matterId,
+      data: { cf_id: '1', cf_value: String(opts.statusId) },
+      additional_attribute: [] as unknown[],
+      remark: '',
+      toUsers: [] as unknown[],
+    }
+    const sr = await geelibPost<{ errno: number; errmsg?: string }>(
+      '/matter/Matter/editMatter',
+      statusBody,
+    )
+
+    if (sr.errno === 2000) {
+      const detail = await geelibGet<{
+        errno: number
+        data?: {
+          matter_status?: number
+          status_name?: string
+          matterCustomAttributes?: Array<{
+            cf_key: string
+            cf_name: string
+            is_required: number
+            matterCustomAttributeValue: unknown
+          }>
+        }
+      }>('/matter/Matter/getMatterDetail', {
+        sub_id: opts.subId,
+        id: opts.matterId,
+        need_options: 1,
+      })
+      const actualStatus = detail.data?.matter_status
+      if (actualStatus !== opts.statusId) {
+        const missingFields = (detail.data?.matterCustomAttributes ?? [])
+          .filter(a => a.is_required && a.matterCustomAttributeValue === null)
+          .map(a => `「${a.cf_name}」(${a.cf_key})`)
+        const hint =
+          missingFields.length > 0
+            ? `原因：工作项存在未填的必填字段：${missingFields.join('、')}。请先在 Geelib 网页端补全后重试。`
+            : '状态未变更，可能存在未知的状态流转限制。'
+        results.push({
+          fields: 'status',
+          errno: sr.errno,
+          errmsg: `API 返回成功但状态实际未变更（当前状态：${detail.data?.status_name ?? actualStatus}）。${hint}`,
+        })
+      } else {
+        results.push({
+          fields: 'status',
+          errno: 2000,
+          errmsg: '状态变更成功',
+          actual_status: detail.data?.status_name,
+        })
+      }
+    } else {
+      results.push({ fields: 'status', ...sr })
+    }
+  }
+
+  if (results.length === 0) {
+    return { errno: 2000, errmsg: '无需更新（未提供任何修改字段）' }
+  }
+  if (results.length === 1) {
+    return results[0]
+  }
+  return results
+}

package/skills-runtime/geelib/cli/commands/poll.ts

@@ -0,0 +1,322 @@
+import { readFile, writeFile } from 'node:fs/promises'
+import { join } from 'node:path'
+import { cmdGetUserInfo } from './user.js'
+import {
+  cmdListMatterStatuses,
+  cmdListMatterTypes,
+  cmdListProjects,
+} from './project.js'
+import { cmdListMatters } from './matter.js'
+
+const STATE_FILENAME = 'geelib-poller-state.json'
+
+export type DiscoveredConfig = {
+  sub_id: number | null
+  type_id: number | null
+  pending_status_ids: number[]
+  done_status_id: number | null
+}
+
+export type PollerState = {
+  lastPollAt: number
+  processedMatterIds: number[]
+  discovered: DiscoveredConfig
+}
+
+export function stateFilePath(cwd: string): string {
+  return join(cwd, STATE_FILENAME)
+}
+
+/** 读取 agent 工作区下的巡检状态文件 */
+export async function readPollerState(cwd: string): Promise<PollerState> {
+  try {
+    const raw = await readFile(stateFilePath(cwd), 'utf8')
+    const parsed = JSON.parse(raw) as PollerState
+    return {
+      lastPollAt: parsed.lastPollAt ?? 0,
+      processedMatterIds: Array.isArray(parsed.processedMatterIds)
+        ? parsed.processedMatterIds.map(Number)
+        : [],
+      discovered: {
+        sub_id: parsed.discovered?.sub_id ?? null,
+        type_id: parsed.discovered?.type_id ?? null,
+        pending_status_ids: Array.isArray(
+          parsed.discovered?.pending_status_ids,
+        )
+          ? parsed.discovered.pending_status_ids.map(Number)
+          : [],
+        done_status_id: parsed.discovered?.done_status_id ?? null,
+      },
+    }
+  } catch {
+    return {
+      lastPollAt: 0,
+      processedMatterIds: [],
+      discovered: {
+        sub_id: null,
+        type_id: null,
+        pending_status_ids: [],
+        done_status_id: null,
+      },
+    }
+  }
+}
+
+export async function writePollerState(
+  cwd: string,
+  state: PollerState,
+): Promise<void> {
+  await writeFile(stateFilePath(cwd), `${JSON.stringify(state, null, 2)}\n`)
+}
+
+type MatterRow = {
+  id?: number
+  matter_id?: number
+  title?: string
+  create_time?: string
+  updated_at?: string
+}
+
+function extractMatterId(row: MatterRow): number | null {
+  const id = row.id ?? row.matter_id
+  if (typeof id === 'number' && Number.isFinite(id)) {
+    return id
+  }
+  return null
+}
+
+function isDoneStatusName(name: string, statusStage?: string): boolean {
+  const stage = (statusStage ?? '').trim()
+  if (stage.includes('已完成') || stage.includes('完成')) {
+    return true
+  }
+  const n = name.toLowerCase()
+  return (
+    n.includes('完成') ||
+    n.includes('关闭') ||
+    n.includes('done') ||
+    n.includes('closed')
+  )
+}
+
+function isPendingStatusName(name: string): boolean {
+  const n = name.toLowerCase()
+  if (isDoneStatusName(n)) {
+    return false
+  }
+  return (
+    n.includes('待') ||
+    n.includes('进行') ||
+    n.includes('处理') ||
+    n.includes('open') ||
+    n.includes('progress') ||
+    n.includes('todo')
+  )
+}
+
+/**
+ * 首次 poll 时自动发现 sub_id / type_id / 状态 ID。
+ * 选第一个可访问项目；类型优先名称含「任务」；状态按名称启发式分类。
+ */
+async function discoverConfig(
+  state: PollerState,
+  subIdOverride?: number,
+  typeIdOverride?: number,
+): Promise<DiscoveredConfig> {
+  if (
+    subIdOverride !== undefined &&
+    typeIdOverride !== undefined &&
+    state.discovered.pending_status_ids.length > 0
+  ) {
+    return {
+      sub_id: subIdOverride,
+      type_id: typeIdOverride,
+      pending_status_ids: state.discovered.pending_status_ids,
+      done_status_id: state.discovered.done_status_id,
+    }
+  }
+
+  let subId = subIdOverride ?? state.discovered.sub_id
+  if (subId === null) {
+    const projects = (await cmdListProjects()) as {
+      errno: number
+      data?: { list?: Array<{ id?: number; sub_id?: number }> } | Array<{ id?: number; sub_id?: number }>
+    }
+    const projectList = Array.isArray(projects.data)
+      ? projects.data
+      : projects.data?.list
+    if (projects.errno !== 2000 || !projectList?.length) {
+      throw new Error('list-projects 未返回可用项目')
+    }
+    const first = projectList[0]
+    subId = first.id ?? first.sub_id ?? null
+    if (subId === null) {
+      throw new Error('无法从项目列表解析 sub_id')
+    }
+  }
+
+  let typeId = typeIdOverride ?? state.discovered.type_id
+  if (typeId === null) {
+    const types = (await cmdListMatterTypes(subId)) as {
+      errno: number
+      data?: Array<{ id?: number; type_id?: number; name?: string; type_name?: string }>
+    }
+    if (types.errno !== 2000 || !types.data?.length) {
+      throw new Error(`list-matter-types(sub_id=${subId}) 无数据`)
+    }
+    const taskType =
+      types.data.find(t => (t.type_name ?? t.name ?? '').includes('任务')) ??
+      types.data[0]
+    typeId = taskType.id ?? taskType.type_id ?? null
+    if (typeId === null) {
+      throw new Error('无法从类型列表解析 type_id')
+    }
+  }
+
+  let pendingIds = state.discovered.pending_status_ids
+  let doneId = state.discovered.done_status_id
+  if (pendingIds.length === 0 || doneId === null) {
+    const statuses = (await cmdListMatterStatuses(subId, typeId)) as {
+      errno: number
+      data?: Array<{
+        id?: number
+        status_id?: number
+        name?: string
+        matterStatus?: { id?: number; status_name?: string; status_stage?: string }
+      }>
+    }
+    if (statuses.errno !== 2000 || !statuses.data?.length) {
+      throw new Error('list-matter-statuses 无数据')
+    }
+    pendingIds = []
+    for (const s of statuses.data) {
+      const sid = s.status_id ?? s.matterStatus?.id ?? s.id
+      const name = s.matterStatus?.status_name ?? s.name ?? ''
+      const stage = s.matterStatus?.status_stage ?? ''
+      if (sid === undefined) continue
+      if (isDoneStatusName(name, stage)) {
+        if (doneId === null) {
+          doneId = sid
+        }
+      } else if (isPendingStatusName(name)) {
+        pendingIds.push(sid)
+      }
+    }
+    if (pendingIds.length === 0) {
+      pendingIds = statuses.data
+        .filter(s => {
+          const name = s.matterStatus?.status_name ?? s.name ?? ''
+          const stage = s.matterStatus?.status_stage ?? ''
+          return !isDoneStatusName(name, stage)
+        })
+        .map(s => s.status_id ?? s.matterStatus?.id ?? s.id)
+        .filter((x): x is number => x !== undefined && x !== doneId)
+    }
+  }
+
+  return {
+    sub_id: subId,
+    type_id: typeId,
+    pending_status_ids: pendingIds,
+    done_status_id: doneId,
+  }
+}
+
+export type PollResult = {
+  hasNew: boolean
+  matter: MatterRow | null
+  mattersTotal: number
+  lastPollAt: number
+  discovered: DiscoveredConfig
+}
+
+export type PollOpts = {
+  cwd: string
+  subId?: number
+  typeId?: number
+}
+
+/**
+ * 定时巡检：拉取当前用户未处理工作项，返回 state 中尚未 mark 的最新一条。
+ * 只更新 lastPollAt，不自动 mark-processed。
+ */
+export async function cmdPoll(opts: PollOpts): Promise<PollResult> {
+  const state = await readPollerState(opts.cwd)
+  const discovered = await discoverConfig(state, opts.subId, opts.typeId)
+  state.discovered = discovered
+
+  const userInfo = (await cmdGetUserInfo()) as {
+    errno: number
+    data?: { id?: number; user_id?: number }
+  }
+  if (userInfo.errno !== 2000) {
+    throw new Error(`get-user-info 失败: ${JSON.stringify(userInfo)}`)
+  }
+  const assigneeId = userInfo.data?.id ?? userInfo.data?.user_id
+  if (assigneeId === undefined) {
+    throw new Error('无法从 get-user-info 解析当前用户 ID')
+  }
+
+  const subId = discovered.sub_id!
+  const typeId = discovered.type_id!
+
+  // 一次 list 拉取当前用户工作项，避免按状态多次请求
+  const listResp = (await cmdListMatters({
+    subId,
+    typeId,
+    page: 1,
+    pageSize: 50,
+    assigneeId,
+  })) as {
+    errno: number
+    data?: { list?: MatterRow[]; data?: MatterRow[] }
+  }
+  const allMatters: MatterRow[] =
+    listResp.errno === 2000
+      ? (listResp.data?.list ?? listResp.data?.data ?? [])
+      : []
+
+  const processedSet = new Set(state.processedMatterIds)
+  const seen = new Set<number>()
+  const candidates: MatterRow[] = []
+  for (const row of allMatters) {
+    const mid = extractMatterId(row)
+    if (mid === null || seen.has(mid) || processedSet.has(mid)) {
+      continue
+    }
+    seen.add(mid)
+    candidates.push(row)
+  }
+
+  candidates.sort((a, b) => {
+    const ta = a.create_time ?? a.updated_at ?? ''
+    const tb = b.create_time ?? b.updated_at ?? ''
+    return tb.localeCompare(ta)
+  })
+
+  const now = Date.now()
+  state.lastPollAt = now
+  await writePollerState(opts.cwd, state)
+
+  const matter = candidates.length > 0 ? candidates[0] : null
+  return {
+    hasNew: matter !== null,
+    matter,
+    mattersTotal: candidates.length,
+    lastPollAt: now,
+    discovered,
+  }
+}
+
+/** 开发+回写成功后，将 matter_id 记入 processedMatterIds */
+export async function cmdMarkProcessed(
+  cwd: string,
+  matterId: number,
+): Promise<PollerState> {
+  const state = await readPollerState(cwd)
+  if (!state.processedMatterIds.includes(matterId)) {
+    state.processedMatterIds.push(matterId)
+  }
+  await writePollerState(cwd, state)
+  return state
+}

package/skills-runtime/geelib/cli/commands/project.ts

@@ -0,0 +1,98 @@
+import { geelibGet } from '../client.js'
+
+/** list-projects 返回的单条项目（字段随 API 扩展，只读用到的） */
+type ProjectRow = {
+  id?: number
+  sub_id?: number
+  name?: string
+  is_archive?: number
+  sub_status_id?: number
+  update_time?: string
+}
+
+/** list-projects 响应体 */
+type ListProjectsResponse = {
+  errno?: number
+  errmsg?: string
+  data?: { list?: ProjectRow[] } | ProjectRow[]
+}
+
+export async function cmdListProjects(query = ''): Promise<unknown> {
+  return geelibGet('/projects/subBusMgr/getCanAccessSubList', {
+    query,
+    simple: 2,
+  })
+}
+
+/**
+ * 拉取进行中项目并格式化为纯文本，供 SKILL 加载时 !` 注入。
+ * 进行中：is_archive === 0（未归档）。
+ * 始终 exit 0，失败信息写入 stdout，避免 Skill 加载因 !` 失败而中断。
+ */
+export async function cmdListActiveProjectsText(): Promise<string> {
+  const resp = (await cmdListProjects('')) as ListProjectsResponse
+
+  if (resp.errno !== 2000) {
+    return `[geelib] 项目列表获取失败: errno=${resp.errno} ${resp.errmsg ?? ''}`
+  }
+
+  const rawList = Array.isArray(resp.data)
+    ? resp.data
+    : resp.data?.list
+  if (!rawList?.length) {
+    return '（无进行中项目）'
+  }
+
+  const active = rawList.filter(p => p.is_archive === 0)
+  if (active.length === 0) {
+    return '（无进行中项目）'
+  }
+
+  const lines = [
+    `共 ${active.length} 个进行中项目（is_archive=0）：`,
+    '',
+    '| sub_id | 项目名称 | sub_status_id | 更新时间 |',
+    '| --- | --- | --- | --- |',
+  ]
+
+  for (const p of active) {
+    const subId = p.id ?? p.sub_id
+    if (subId === undefined) {
+      continue
+    }
+    const name = (p.name ?? '').replace(/\|/g, '\\|')
+    lines.push(
+      `| ${subId} | ${name} | ${p.sub_status_id ?? '-'} | ${p.update_time ?? '-'} |`,
+    )
+  }
+
+  return lines.join('\n')
+}
+
+export async function cmdGetProjectDetail(subId: number): Promise<unknown> {
+  return geelibGet('/projects/subBusMgr/getSubDetail', { sub_id: subId })
+}
+
+export async function cmdListProjectMembers(subId: number): Promise<unknown> {
+  return geelibGet('/projects/subBusMgr/getSubUserListSortByInitial', {
+    sub_id: subId,
+  })
+}
+
+export async function cmdListMatterTypes(subId: number): Promise<unknown> {
+  return geelibGet('/matter/Matter/getMatterType', {
+    sub_id: subId,
+    page: 0,
+    pageSize: 9999,
+  })
+}
+
+export async function cmdListMatterStatuses(
+  subId: number,
+  typeId: number,
+): Promise<unknown> {
+  return geelibGet('/matter/matterType/getMatterTypeStatusList', {
+    sub_id: subId,
+    type_id: typeId,
+  })
+}

package/skills-runtime/geelib/cli/commands/user.ts

@@ -0,0 +1,5 @@
+import { geelibGet } from '../client.js'
+
+export async function cmdGetUserInfo(): Promise<unknown> {
+  return geelibGet('/ones/user/userInfo', { need_share: 0 })
+}