dsh-plugin-t-expert 0.3.88 → 0.3.89

package/lib/teams/snapshot.js

@@ -1,184 +0,0 @@
-/**
- * Team activity snapshot assembly for the activity panel.
- *
- * Server-side assembly mirrors the Claude Code desktop teamWatcher: read the
- * durable team files (the truth source) and enrich with live subagent
- * activity, so the panel always reflects the on-disk state even when a model
- * skipped a tool "ritual" (e.g. not calling update_task on completion).
- * @module t-team/snapshot
- */
-import { readdir } from 'node:fs/promises';
-import { join } from 'node:path';
-import { memberActivity } from "./members.js";
-import { CAPTAIN_KEY, listArchivedTeamIds, readArchivedTeam, readUnreadMailbox, readTeam, taskDepthsById, taskVisualState, } from "./state.js";
-/** The current task of a member: its first unfinished owned task. */
-function currentTaskOf(memberName, tasks) {
-    for (const task of tasks) {
-        if (task.status === 'in_progress' && task.assignee === memberName)
-            return task.id;
-    }
-    return '';
-}
-/** Compact `provider/model` route for the activity panel, or just the model. */
-export function memberModelRoute(member) {
-    if (member === undefined)
-        return '';
-    const provider = member.provider?.trim() ?? '';
-    const model = member.model?.trim() ?? '';
-    if (provider !== '' && model !== '')
-        return `${provider}/${model}`;
-    return model;
-}
-/**
- * Assemble one team snapshot from its durable files plus live activity.
- * @param ctx - the plugin context (injects `subagents`, used for activity).
- * @param stateRoot - resolved absolute state root of the owning workspace.
- * @param workspace - display name of the owning workspace.
- * @param state - the durable team record.
- * @returns the panel snapshot.
- */
-export async function assembleTeamSnapshot(ctx, stateRoot, workspace, state, options = {}) {
-    const tasks = state.tasks;
-    const depths = taskDepthsById(tasks);
-    const roster = options.includeRemoved === true
-        ? state.members
-        : state.members.filter((member) => member.status !== 'removed');
-    const activity = options.historic === true
-        ? new Map()
-        : memberActivity(ctx, roster.map((member) => member.id));
-    const unreadByMember = new Map();
-    for (const member of roster) {
-        try {
-            unreadByMember.set(member.name, (await readUnreadMailbox(stateRoot, state.id, member.name)).length);
-        }
-        catch (error) {
-            ctx.logger.warn(`t-team: mailbox read failed for ${member.name}: ${String(error)}`);
-            unreadByMember.set(member.name, 0);
-        }
-    }
-    const members = roster.map((member) => {
-        const owned = tasks.filter((task) => task.assignee === member.name);
-        const done = owned.filter((task) => task.status === 'completed').length;
-        return {
-            id: member.id,
-            name: member.name,
-            role: member.role ?? '',
-            provider: member.provider?.trim() ?? '',
-            model: member.model?.trim() ?? '',
-            reasoningEffort: member.reasoningEffort?.trim() ?? '',
-            executionPrompt: member.executionPrompt ?? '',
-            status: member.status,
-            activity: options.historic === true
-                ? 'idle'
-                : member.id !== ''
-                    ? (activity.get(member.id) === 'running'
-                        ? 'working'
-                        : activity.get(member.id) === 'idle' || activity.get(member.id) === 'ready'
-                            ? 'idle'
-                            : 'unknown')
-                    : state.phase === 'staged' ? 'idle' : 'unknown',
-            progress: owned.length === 0 ? 0 : Math.round((done / owned.length) * 100),
-            done,
-            total: owned.length,
-            currentTask: currentTaskOf(member.name, tasks),
-            unread: unreadByMember.get(member.name) ?? 0,
-        };
-    });
-    const captainInbox = await readUnreadMailbox(stateRoot, state.id, CAPTAIN_KEY);
-    return {
-        workspace,
-        teamId: state.id,
-        name: state.name,
-        ...state.description !== undefined ? { description: state.description } : {},
-        captainSessionId: state.captainSessionId,
-        phase: state.phase ?? 'running',
-        ...state.phase === 'staged'
-            ? { planReviewState: state.planReviewState ?? 'awaiting_review' }
-            : {},
-        ...state.halted === true ? { halted: true } : {},
-        members,
-        tasks: tasks.map((task) => ({
-            id: task.id,
-            subject: task.subject,
-            description: task.description ?? '',
-            status: task.status,
-            state: taskVisualState(task.status, task.dependencies, tasks),
-            assignee: task.assignee ?? '',
-            model: memberModelRoute(roster.find((member) => member.name === task.assignee)),
-            dependencies: task.dependencies,
-            depth: depths.get(task.id) ?? 0,
-            ...task.kind === undefined ? {} : { kind: task.kind },
-            ...task.round === undefined ? {} : { round: task.round },
-            ...task.verdict === undefined ? {} : { verdict: task.verdict },
-        })),
-        messageCount: captainInbox.length
-            + members.reduce((count, member) => count + member.unread, 0),
-        captainInbox: captainInbox.slice(-5).map((message) => ({
-            from: message.from,
-            content: message.content,
-        })),
-    };
-}
-/**
- * Collect every team under the given workspace state roots.
- * @param ctx - the plugin context.
- * @param roots - `{ workspace, stateRoot }` pairs (resolved absolute roots).
- * @returns the snapshots in stable order (workspace, then team id).
- */
-export async function collectTeamsActivity(ctx, roots) {
-    const snapshots = [];
-    for (const root of roots) {
-        let entries;
-        try {
-            entries = await readdir(root.stateRoot, { withFileTypes: true });
-        }
-        catch (error) {
-            if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
-                continue;
-            }
-            throw error;
-        }
-        for (const entry of entries) {
-            if (!entry.isDirectory())
-                continue;
-            try {
-                const state = await readTeam(root.stateRoot, entry.name);
-                if (state === undefined)
-                    continue;
-                snapshots.push(await assembleTeamSnapshot(ctx, root.stateRoot, root.workspace, state));
-            }
-            catch (error) {
-                // 必须带上根因：裸 `catch {` 只留一句「unreadable」，解析失败、权限、服务缺失、
-                // 并发读全都会变成同一句无法诊断的告警（2026-09-13 在真实宿主日志里就撞上一条
-                // 谁也没法解释的 "skipped unreadable team state"，根因正是被这里吞掉的）。
-                ctx.logger.warn(`t-team: skipped unreadable team state "${entry.name}" in workspace "${root.workspace}": ${String(error)}`);
-            }
-        }
-    }
-    return snapshots;
-}
-/**
- * Collect every archived team under the given workspace state roots (the
- * `archive/` subdirectory of each state root). Used by the historic panel
- * path to restore full team detail after deletion.
- * @param ctx - the plugin context.
- * @param roots - `{ workspace, stateRoot }` pairs.
- * @returns the archived snapshots in stable order.
- */
-export async function collectArchivedTeamsActivity(ctx, roots) {
-    const snapshots = [];
-    for (const root of roots) {
-        for (const teamId of await listArchivedTeamIds(root.stateRoot)) {
-            try {
-                const state = await readArchivedTeam(root.stateRoot, teamId);
-                if (state === undefined)
-                    continue;
-                snapshots.push(await assembleTeamSnapshot(ctx, join(root.stateRoot, 'archive'), root.workspace, state, { includeRemoved: true, historic: true }));
-            }
-            catch (error) {
-                ctx.logger.warn(`t-team: skipped unreadable archived team "${teamId}" in workspace "${root.workspace}": ${String(error)}`);
-            }
-        }
-    }
-    return snapshots;
-}