@dreamor/atlas-cli 0.7.22 → 0.7.24

package/dist/adapters/atlas/commands/_output_schema.js

@@ -1,379 +0,0 @@
-const schemas = {
-    'atlas auth login': {
-        jsonSchema: {
-            type: 'object',
-            properties: {
-                ok: { type: 'boolean', const: true },
-                data: {
-                    type: 'object',
-                    properties: {
-                        status: { type: 'string', enum: ['logged_in'] },
-                        via: { type: 'string', enum: ['daemon'] },
-                    },
-                },
-            },
-        },
-    },
-    'atlas auth status': {
-        jsonSchema: {
-            type: 'object',
-            properties: {
-                ok: { type: 'boolean' },
-                data: {
-                    type: 'object',
-                    properties: {
-                        loggedIn: { type: 'boolean' },
-                        expiresAt: { type: 'number' },
-                    },
-                },
-            },
-        },
-    },
-    'atlas auth refresh': {
-        jsonSchema: {
-            type: 'object',
-            properties: {
-                ok: { type: 'boolean', const: true },
-                data: {
-                    type: 'object',
-                    properties: {
-                        status: { type: 'string', enum: ['refreshed', 'still_valid'] },
-                        account: { type: 'string' },
-                    },
-                },
-            },
-        },
-    },
-    'atlas projects': {
-        jsonSchema: {
-            type: 'object',
-            properties: {
-                ok: { type: 'boolean' },
-                data: { type: 'array', items: { type: 'object' } },
-            },
-        },
-    },
-    'atlas find': {
-        jsonSchema: {
-            type: 'object',
-            properties: {
-                ok: { type: 'boolean' },
-                data: {
-                    type: 'array',
-                    items: { type: 'object' },
-                },
-                meta: {
-                    type: 'object',
-                    properties: {
-                        count: { type: 'number' },
-                        kind: { type: 'string' },
-                        query: { type: 'string' },
-                    },
-                },
-            },
-        },
-    },
-    'atlas link': {
-        jsonSchema: {
-            type: 'object',
-            properties: {
-                ok: { type: 'boolean' },
-                data: {
-                    type: 'object',
-                    properties: {
-                        projectId: { type: 'string' },
-                        projectName: { type: 'string' },
-                        linkedAt: { type: 'string' },
-                        linked: { type: 'object', description: '已绑定的项目信息（link 无参时）' },
-                        envProjectId: { type: 'string', description: 'BANMA_PROJECT_ID 环境变量值' },
-                        dryRun: { type: 'boolean' },
-                    },
-                },
-            },
-        },
-    },
-    'atlas unlink': {
-        jsonSchema: {
-            type: 'object',
-            properties: {
-                ok: { type: 'boolean' },
-                data: {
-                    type: 'object',
-                    properties: {
-                        unlinked: { type: 'boolean' },
-                        projectName: { type: 'string' },
-                    },
-                },
-            },
-        },
-    },
-    'atlas baseline month': {
-        jsonSchema: {
-            type: 'object',
-            properties: {
-                ok: { type: 'boolean' },
-                data: {
-                    type: 'object',
-                    properties: {
-                        projectId: { type: 'string' },
-                        months: { type: 'array', items: { type: 'string' }, description: 'YYYY-MM 格式月份列表' },
-                        entries: {
-                            type: 'array',
-                            items: {
-                                type: 'object',
-                                description: '单个月份的基线条目',
-                            },
-                        },
-                        totalManpower: { type: 'number', description: '单位：人月' },
-                    },
-                },
-            },
-        },
-    },
-    'atlas baseline summary': {
-        jsonSchema: {
-            type: 'object',
-            properties: {
-                ok: { type: 'boolean' },
-                data: {
-                    type: 'array',
-                    items: {
-                        type: 'object',
-                        properties: {
-                            month: { type: 'string', description: 'YYYY-MM' },
-                            manpower: { type: 'number', description: '单位：人月' },
-                        },
-                    },
-                },
-            },
-        },
-    },
-    'atlas baseline export': {
-        jsonSchema: {
-            type: 'object',
-            properties: {
-                ok: { type: 'boolean' },
-                data: {
-                    type: 'object',
-                    properties: {
-                        exported: { type: 'number', description: '导出行数' },
-                        format: { type: 'string', enum: ['csv', 'json'] },
-                        out: { type: 'string', description: '导出文件绝对路径（经过白名单校验）' },
-                    },
-                },
-            },
-        },
-    },
-    'atlas actual show': {
-        jsonSchema: {
-            type: 'object',
-            properties: {
-                ok: { type: 'boolean' },
-                data: {
-                    type: 'object',
-                    properties: {
-                        staffId: { type: 'string' },
-                        month: { type: 'string', description: 'YYYY-MM' },
-                        personnel: { type: 'array', items: { type: 'object' } },
-                    },
-                },
-            },
-        },
-    },
-    'atlas actual month': {
-        jsonSchema: {
-            type: 'object',
-            properties: {
-                ok: { type: 'boolean' },
-                data: {
-                    type: 'object',
-                    properties: {
-                        projectId: { type: 'string' },
-                        entries: { type: 'array', items: { type: 'object' } },
-                    },
-                },
-                meta: {
-                    type: 'object',
-                    properties: {
-                        failedMonths: { type: 'array', items: { type: 'string' } },
-                    },
-                },
-            },
-        },
-    },
-    'atlas actual summary': {
-        jsonSchema: {
-            type: 'object',
-            properties: {
-                ok: { type: 'boolean' },
-                data: {
-                    type: 'object',
-                    properties: {
-                        rows: { type: 'array', items: { type: 'object' } },
-                    },
-                },
-                meta: {
-                    type: 'object',
-                    properties: {
-                        failedMonths: { type: 'array', items: { type: 'string' } },
-                    },
-                },
-            },
-        },
-    },
-    'atlas actual export': {
-        jsonSchema: {
-            type: 'object',
-            properties: {
-                ok: { type: 'boolean' },
-                data: {
-                    type: 'object',
-                    properties: {
-                        exported: { type: 'number', description: '导出行数' },
-                        format: { type: 'string', enum: ['csv', 'json'] },
-                        out: { type: 'string', description: '导出文件绝对路径' },
-                    },
-                },
-                meta: {
-                    type: 'object',
-                    properties: {
-                        failedMonths: { type: 'array', items: { type: 'string' } },
-                    },
-                },
-            },
-        },
-    },
-    'atlas compare': {
-        jsonSchema: {
-            type: 'object',
-            properties: {
-                ok: { type: 'boolean' },
-                data: {
-                    type: 'object',
-                    properties: {
-                        rows: {
-                            type: 'array',
-                            items: {
-                                type: 'object',
-                                properties: {
-                                    month: { type: 'string', description: 'YYYY-MM' },
-                                    plan: { type: 'number', description: '基线人月' },
-                                    actual: { type: 'number', description: '实际人月' },
-                                    diff: { type: 'number', description: '实际 - 基线（人月）' },
-                                },
-                            },
-                        },
-                    },
-                },
-                meta: {
-                    type: 'object',
-                    properties: {
-                        failedMonths: { type: 'array', items: { type: 'string' } },
-                    },
-                },
-            },
-        },
-    },
-    'atlas schema commands': {
-        jsonSchema: {
-            type: 'object',
-            properties: {
-                ok: { type: 'boolean' },
-                data: {
-                    type: 'object',
-                    properties: {
-                        commands: { type: 'array', items: { type: 'string' } },
-                    },
-                },
-            },
-        },
-    },
-    'atlas exec': {
-        jsonSchema: {
-            type: 'object',
-            properties: {
-                ok: { type: 'boolean' },
-                data: {
-                    type: 'object',
-                    properties: {
-                        results: {
-                            type: 'array',
-                            items: {
-                                type: 'object',
-                                properties: {
-                                    step: { type: 'number' },
-                                    command: { type: 'string' },
-                                    status: { type: 'string', description: 'success | failed: <msg>' },
-                                },
-                            },
-                        },
-                    },
-                },
-            },
-        },
-    },
-    'atlas suggest': {
-        jsonSchema: {
-            type: 'object',
-            properties: {
-                ok: { type: 'boolean' },
-                data: {
-                    type: 'object',
-                    properties: {
-                        query: { type: 'string' },
-                        suggestions: {
-                            type: 'array',
-                            maxItems: 5,
-                            items: {
-                                type: 'object',
-                                properties: {
-                                    command: { type: 'string', description: 'atlas 子命令片段' },
-                                    description: { type: 'string' },
-                                    score: { type: 'number' },
-                                },
-                            },
-                        },
-                    },
-                },
-            },
-        },
-    },
-    'atlas update': {
-        jsonSchema: {
-            type: 'object',
-            properties: {
-                ok: { type: 'boolean' },
-                data: {
-                    type: 'object',
-                    properties: {
-                        mode: { type: 'string', enum: ['npm', 'other'] },
-                        disabled: { type: 'boolean' },
-                        current: { type: 'string', description: '当前版本号' },
-                        updateCommand: { type: 'string', description: 'npm 更新命令' },
-                        migrationCommand: { type: 'string', description: '迁移到 npm 安装的命令' },
-                    },
-                },
-            },
-        },
-    },
-    'atlas daemon': {
-        jsonSchema: {
-            type: 'object',
-            properties: {
-                ok: { type: 'boolean' },
-                data: { type: 'object' },
-            },
-        },
-    },
-};
-export function getOutputSchema(commandPath) {
-    return schemas[commandPath] ?? {
-        jsonSchema: {
-            type: 'object',
-            properties: {
-                ok: { type: 'boolean' },
-                data: {},
-            },
-        },
-    };
-}

package/dist/adapters/atlas/commands/actual/_logic.js

@@ -1,116 +0,0 @@
-/**
- * actual 命令的纯逻辑层。
- *
- * 与命令解析层（index.ts）分离：这里不做 IO、不调 API、不输出，
- * 只做数据变换。便于单元测试（参见 tests/actual_logic.test.ts）。
- *
- * 单位约定（关键）：
- * - API detail.manpower 字段单位为**人天**，不是人月。
- * - 网页"人力汇总"页显示的人月 = Σ(叶子节点 detail.manpower) ÷ WORK_DAYS_PER_MONTH。
- * - 经 2026-07-01 实测验证：BMW(2548) 2026-03 叶子节点合计 321.9 人天 ÷ 22 = 14.63 人月，
- *   与网页"各项目显示值:已确认"完全一致。
- */
-/** 每月工作日，用于把 API 返回的人天换算为人月（与网页口径一致） */
-export const WORK_DAYS_PER_MONTH = 22;
-/**
- * expandMonths 已移至 util/months.ts，此处不再导出。
- */
-/** 给每条记录标注 month 字段，返回新数组（不改原数据） */
-export function annotateWithMonth(entries, month) {
-    return entries.map((p) => ({ ...p, month }));
-}
-/** 将 CLI 字符串选项规范化为 StatusFilter，默认 approved（与网站默认视图对齐） */
-export function normalizeStatusFilter(raw) {
-    if (raw === 'all' || raw === 'pending' || raw === 'approved')
-        return raw;
-    return 'approved';
-}
-/** 判断单条 detail 记录是否通过状态筛选 */
-function passesStatusFilter(statusRaw, filter) {
-    const status = Number(statusRaw);
-    if (filter === 'approved')
-        return status === 2;
-    if (filter === 'pending')
-        return status !== 2;
-    return true;
-}
-/**
- * 按轴聚合人月。
- * - month：按月份分组（需先用 annotateWithMonth 打标）
- * - department：按 departmentName 分组，缺失归 "其他"
- * - role：按 role 分组，缺失归 "其他"
- * 返回 [{ [axis]: key, manpower }]，manpower 四舍五入到 2 位。
- */
-export function aggregateByAxis(rows, axis) {
-    const groups = new Map();
-    for (const p of rows) {
-        const k = axis === 'month' ? p.month
-            : axis === 'department' ? (p.departmentName ?? '其他')
-                : (p.role ?? '其他');
-        groups.set(k, (groups.get(k) ?? 0) + (p.manpower ?? 0));
-    }
-    return [...groups.entries()].map(([k, v]) => ({
-        [axis]: k,
-        manpower: Math.round(v * 100) / 100,
-    }));
-}
-/**
- * 过滤出指定人员的记录：staffId 精确匹配，或 staffName 包含匹配。
- */
-export function filterByStaff(entries, staffId) {
-    return entries.filter((p) => p.staffId === staffId || p.staffName?.includes(staffId));
-}
-/**
- * 走查 summaryByProject 返回的树结构，提取指定项目的实际工时条目（人月）。
- *
- * 关键口径（与网页"人力汇总"页一致，2026-07-01 实测验证）：
- * 1. **只在叶子节点累加**：manager 节点的 detail 是下属汇总的副本，
- *    若一并计入会把同一笔工时重复累加（实测会把 321.9 人天虚增到 440.6）。
- *    叶子 = children 为 null 或空数组的节点。
- * 2. **人天 ÷ 工作日 → 人月**：API detail.manpower 单位是人天，
- *    需除以 WORK_DAYS_PER_MONTH(22) 才是网页显示的人月。
- * 3. **状态筛选**：默认 approved 只统计 status===2（已确认），与网页默认视图对齐。
- *
- * 返回按员工去重的条目，manpower 为人月（四舍五入 2 位）。
- */
-export function flattenTree(nodes, targetPid, statusFilter = 'approved') {
-    const byStaffId = new Map();
-    function isLeaf(node) {
-        const kids = node.children;
-        return !Array.isArray(kids) || kids.length === 0;
-    }
-    function walk(items) {
-        for (const raw of items ?? []) {
-            const node = raw;
-            // 只在叶子节点累加 detail，避免 manager 层重复计入
-            if (isLeaf(node)) {
-                const details = (node.detail ?? []);
-                let personDays = 0;
-                for (const d of details) {
-                    if (String(d.projectId) === targetPid && passesStatusFilter(d.status, statusFilter)) {
-                        personDays += Number(d.manpower ?? 0);
-                    }
-                }
-                if (personDays > 0) {
-                    const sid = String(node.staffId ?? '');
-                    const manMonths = personDays / WORK_DAYS_PER_MONTH;
-                    // 同一叶子节点不可能重复出现；若员工跨多节点，按 manpower 累加
-                    const existing = byStaffId.get(sid);
-                    const total = (existing?.manpower ?? 0) + manMonths;
-                    byStaffId.set(sid, {
-                        staffId: sid,
-                        staffName: String(node.realname ?? ''),
-                        manpower: Math.round(total * 100) / 100,
-                        departmentName: String(node.department ?? ''),
-                        role: String(node.role ?? ''),
-                    });
-                }
-            }
-            else {
-                walk(node.children);
-            }
-        }
-    }
-    walk(nodes);
-    return [...byStaffId.values()];
-}

package/dist/adapters/atlas/commands/actual/index.js

@@ -1,138 +0,0 @@
-import { createClient } from '../../http/client.js';
-import { isJsonMode, jsonOk, log } from '../../util/output.js';
-import { enforceOutputLimit } from '../../util/output-limit.js';
-import { expandMonths, expandMonthsDefault } from '../../util/months.js';
-import { resolveSecureExportPath, secureWriteFile } from '../../util/secure-fs.js';
-import { annotateWithMonth, aggregateByAxis, filterByStaff, flattenTree, normalizeStatusFilter, } from './_logic.js';
-import { resolveProjectId } from '../../util/env.js';
-import { readBanmaIdentity } from '../../auth/session.js';
-function getProjectId(opts) {
-    return resolveProjectId(opts.projectId);
-}
-async function fetchActual(pid, month, statusFilter) {
-    const client = createClient();
-    const identity = await readBanmaIdentity();
-    const loginStaffId = identity?.staffId ?? '';
-    // 项目视图：使用 summaryByProject 获取全项目维度的实际工时。
-    // API 返回全部状态的数据，statusFilter 在客户端按 status 字段过滤（与网站一致）。
-    const raw = await client.post('/yuntu-service/manpower/weekly/summaryByProject.json', { month, staffIds: [], projectIds: [pid], isConfirm: false, loginStaffId });
-    const tree = (Array.isArray(raw) ? raw : []);
-    // 根节点为当前用户，children 为团队成员
-    if (tree.length > 0 && tree[0].children) {
-        return flattenTree(tree[0].children, pid, statusFilter);
-    }
-    return [];
-}
-export async function showCmd(staffId, opts) {
-    const pid = getProjectId(opts);
-    const m = opts.month ?? expandMonthsDefault()[0];
-    const data = await fetchActual(pid, m, normalizeStatusFilter(opts.status));
-    const filtered = filterByStaff(data, staffId);
-    if (opts.json || isJsonMode()) {
-        jsonOk({ staffId, month: m, personnel: filtered });
-        return;
-    }
-    if (filtered.length === 0) {
-        log(`${staffId} 在 ${m} 无实际工时数据`);
-        return;
-    }
-    for (const p of filtered) {
-        log(`  ${p.staffName} (${p.staffId}): ${p.manpower.toFixed(2)} 人月`);
-    }
-}
-export async function monthCmd(opts) {
-    const pid = getProjectId(opts);
-    // 不传月份时默认最近 12 个月，与 baseline month 行为一致
-    const months = opts.month ? [opts.month] : (opts.from || opts.to ? expandMonths(opts.from, opts.to) : expandMonthsDefault());
-    const statusFilter = normalizeStatusFilter(opts.status);
-    const all = [];
-    const failedMonths = [];
-    for (const m of months) {
-        try {
-            const data = await fetchActual(pid, m, statusFilter);
-            all.push(...annotateWithMonth(data, m));
-        }
-        catch (e) {
-            // 实际工时 API 对无数据月份也返回 501（"当前token已失效"），
-            // 不是真正的 token 过期。不 rethrow，只记录到 failedMonths。
-            failedMonths.push({ month: m, error: e instanceof Error ? e.message : String(e) });
-            log(`月 ${m} 无实际工时数据`);
-        }
-    }
-    // Apply --department / --role filter
-    const filtered = all.filter(p => (!opts.department || (p.departmentName && p.departmentName.includes(opts.department)))
-        && (!opts.role || (p.role && p.role.includes(opts.role))));
-    if (opts.json || isJsonMode()) {
-        jsonOk({ projectId: pid, entries: filtered }, { failedMonths });
-        return;
-    }
-    if (filtered.length === 0) {
-        log('无实际工时数据');
-        return;
-    }
-    for (const p of filtered) {
-        log(`  ${p.staffName}: ${p.manpower.toFixed(2)} (${p.role ?? ''})`);
-    }
-}
-export async function summaryCmd(opts) {
-    const pid = getProjectId(opts);
-    const months = opts.month ? [opts.month] : (opts.from || opts.to ? expandMonths(opts.from, opts.to) : expandMonthsDefault());
-    const statusFilter = normalizeStatusFilter(opts.status);
-    const all = [];
-    const failedMonths = [];
-    for (const m of months) {
-        try {
-            all.push(...annotateWithMonth(await fetchActual(pid, m, statusFilter), m));
-        }
-        catch (e) {
-            // 实际工时 API 对无数据月份也返回 501（"当前token已失效"），
-            // 不是真正的 token 过期。不 rethrow，只记录到 failedMonths。
-            failedMonths.push({ month: m, error: e instanceof Error ? e.message : String(e) });
-            log(`月 ${m} 无实际工时数据`);
-        }
-    }
-    // Apply --department / --role filter
-    const filtered = all.filter(p => (!opts.department || (p.departmentName && p.departmentName.includes(opts.department)))
-        && (!opts.role || (p.role && p.role.includes(opts.role))));
-    const axis = (opts.by ?? 'month');
-    const rows = aggregateByAxis(filtered, axis);
-    if (opts.json || isJsonMode()) {
-        jsonOk({ rows }, { failedMonths });
-        return;
-    }
-    for (const r of rows) {
-        log(`  ${r[axis]}: ${r.manpower.toFixed(2)} 人月`);
-    }
-}
-export async function exportCmd(opts) {
-    const pid = getProjectId(opts);
-    const months = expandMonths(opts.from, opts.to);
-    const statusFilter = normalizeStatusFilter(opts.status);
-    const rows = [];
-    const failedMonths = [];
-    for (const m of months) {
-        try {
-            const data = await fetchActual(pid, m, statusFilter);
-            rows.push(...annotateWithMonth(data, m));
-        }
-        catch (e) {
-            // 实际工时 API 对无数据月份也返回 501（"当前token已失效"），
-            // 不是真正的 token 过期。不 rethrow，只记录到 failedMonths。
-            failedMonths.push({ month: m, error: e instanceof Error ? e.message : String(e) });
-            log(`月 ${m} 无实际工时数据`);
-        }
-    }
-    // Apply --department / --role filter
-    const filteredRows = rows.filter(p => (!opts.department || (p.departmentName && p.departmentName.includes(opts.department)))
-        && (!opts.role || (p.role && p.role.includes(opts.role))));
-    const content = opts.format === 'csv'
-        ? (await import('papaparse')).default.unparse(filteredRows)
-        : JSON.stringify(filteredRows, null, 2);
-    enforceOutputLimit(content);
-    const safePath = resolveSecureExportPath(opts.out);
-    await secureWriteFile(safePath, content);
-    log(`已导出 ${filteredRows.length} 条记录`);
-    if (opts.json || isJsonMode()) {
-        jsonOk({ exported: filteredRows.length, format: opts.format, out: safePath }, { failedMonths });
-    }
-}

package/dist/adapters/atlas/commands/auth.js

@@ -1 +0,0 @@
-export { loginCmd as authLoginCmd, statusCmd as authStatusCmd, refreshCmd as authRefreshCmd, } from '../auth/index.js';