@lensmcp/protocol-types 1.25.38 → 1.25.39

package/lib/team.d.ts

@@ -8,7 +8,7 @@
  * What kind of work a task is: it names the role that takes it. `goal`: what a manager breaks into the others' tasks;
  * `marketing`: telling people about the product (launch posts, release notes, landing and store copy).
  */
-export declare const DASH_TEAM_KINDS: readonly ["goal", "build", "bug", "review", "test", "docs", "marketing", "research", "chore"];
+export declare const DASH_TEAM_KINDS: readonly ["goal", "build", "bug", "review", "test", "qa", "docs", "marketing", "research", "chore"];
 export type DashTeamKind = (typeof DASH_TEAM_KINDS)[number];
 export type DashTeamTaskState = 'open' | 'claimed' | 'recovery' | 'completed' | 'cancelled';
 export type DashTeamOutcome = 'done' | 'approved' | 'changes-requested' | 'passed' | 'failed' | 'wontfix';
@@ -66,6 +66,52 @@ export interface DashTeamTask {
     completedHead?: string | null;
     paths?: string[];
     tags?: string[];
+    /** A review's items, whole (the drawer): each point it checks and its verdict (planning/team/06-team-operations.md OP-D3). */
+    items?: DashTeamReviewItem[];
+    /** A review's items as counts (the board). */
+    itemStats?: {
+        total: number;
+        pass: number;
+        fail: number;
+        open: number;
+    };
+    /** What its holder's tool calls did in its newest claim, as the hooks saw them (the drawer). */
+    work?: DashTeamTaskWork;
+}
+/** One claim's work, from its holder's hooks: the files edited, commits, the checks and the whole suites run, workspace actions. */
+export interface DashTeamTaskWork {
+    sessionId: string;
+    at: number;
+    edits: number;
+    edited: string[];
+    outside?: string[];
+    commits?: number;
+    checks?: string[];
+    suites?: string[];
+    actions?: number;
+}
+/**
+ * «Are they doing the right things» (planning/team/06-team-operations.md O5): what a task's record and its holder's tool
+ * calls raise — a review or QA run that edited, a test author that ran a whole suite, edits outside the task's paths, a
+ * change completed with no commit or no check, a QA pass naming no run, a claim with no line in ten minutes, a holder
+ * whose process ended. Hints, never verdicts.
+ */
+export type DashTeamConductKind = 'checker-edited' | 'whole-suite' | 'outside-paths' | 'no-commit' | 'unchecked' | 'qa-unrun' | 'quiet-claim' | 'host-gone';
+export interface DashTeamFlag {
+    kind: DashTeamConductKind;
+    severity: 'info' | 'warn';
+    taskId: string;
+    /** The agent it is about: the task's holder. */
+    sessionId?: string;
+    text: string;
+}
+/** One point a review checks: from the work's «Done means», its tests, a review before it that sent it back, or the reviewer. */
+export interface DashTeamReviewItem {
+    id: string;
+    text: string;
+    from: 'done-means' | 'tests' | 'recheck' | 'reviewer';
+    verdict?: 'pass' | 'fail' | 'n/a';
+    note?: string;
 }
 /** A task named in another's chain: its parent, its children, a blocker. */
 export interface DashTeamTaskRef {
@@ -81,6 +127,25 @@ export interface DashTeamTaskRef {
 export interface DashTeamTreeNode extends DashTeamTaskRef {
     children: DashTeamTreeNode[];
 }
+/**
+ * The OS process agents run in (planning/team/06-team-operations.md OP-D2): a Claude Code or Codex CLI — the person's
+ * terminal or a launch. An in-process subagent has no process of its own: it runs in its parent's host. One process,
+ * not a reused pid: the pid with the time it started.
+ */
+export interface DashTeamHost {
+    /** `<pid>@<startedAt>`. */
+    key: string;
+    pid: number;
+    /** The client binary: `claude`, `codex`, or another's name. */
+    bin: string;
+    startedAt: number;
+    /** It runs now — the same binary, started then. Undefined: it could not be checked (no `ps`). */
+    alive?: boolean;
+    /** Its resident memory in MB, while it runs. */
+    rssMb?: number;
+}
+/** Why a session ended: closed by itself or the person, its CLI's SessionEnd, a subagent that stopped, its host process gone, a join never used, quiet past the lease with no host to vouch for it. */
+export type DashTeamClosedReason = 'closed' | 'session-end' | 'stopped' | 'host-gone' | 'unused' | 'lost';
 /** One coordination session: an agent on the team (a role), or one outside it (no role). */
 export interface DashTeamSession {
     id: string;
@@ -95,8 +160,17 @@ export interface DashTeamSession {
     listening?: boolean;
     objective?: string;
     step?: string;
-    /** `stale`: active, but not heard from within its lease. */
-    presence: 'active' | 'stale' | 'closed';
+    /**
+     * `active`: heard from within its lease. `idle`: not heard from within it, but its host process runs — a session at
+     * the prompt, waiting for the person. `stale`: not heard from within it and no host to vouch for it — lost; LensMCP
+     * closes it an hour after its lease. `closed`: ended (closedReason says how).
+     */
+    presence: 'active' | 'idle' | 'stale' | 'closed';
+    /** The process it runs in — a key of the board's `hosts`. None: unknown (an older LensMCP's session, or no `ps`). */
+    host?: string;
+    /** The session it is a subagent of: it runs inside that session's process. */
+    parent?: string;
+    closedReason?: DashTeamClosedReason;
     worktreeId: string;
     createdAt: number;
     lastSeenAt: number;
@@ -161,11 +235,15 @@ export interface DashTeamBoard {
     revision: number;
     observedAt: number;
     sessions: DashTeamSession[];
+    /** The processes the board's sessions run in — running ones first. */
+    hosts: DashTeamHost[];
     worktrees: DashTeamWorktree[];
     /** Live tasks first, then finished ones, newest first. */
     tasks: DashTeamTask[];
     notes: DashTeamNote[];
     roles: DashTeamRole[];
+    /** What the board's tasks raise about the agents that hold or held them. */
+    flags?: DashTeamFlag[];
     /** More sessions or tasks than the board carries. */
     truncated: boolean;
 }
@@ -440,7 +518,7 @@ export interface DashTeamReviewDelegation {
 }
 /** What the run says about the process — a hint for the person reviewing it, never a verdict. */
 export interface DashTeamReviewFlag {
-    kind: 'self-review' | 'manager-did-work' | 'same-model' | 'role-model-mismatch' | 'unjoined-agent' | 'long-wait' | 'silent-claim' | 'rework' | 'no-evidence' | 'recovery' | 'open-under-closed' | 'serial' | 'idle-agent';
+    kind: 'self-review' | 'manager-did-work' | 'same-model' | 'role-model-mismatch' | 'unjoined-agent' | 'long-wait' | 'silent-claim' | 'rework' | 'no-evidence' | 'recovery' | 'open-under-closed' | 'serial' | 'idle-agent' | DashTeamConductKind;
     severity: 'info' | 'warn';
     text: string;
     taskId?: string;

package/lib/team.js

@@ -1 +1 @@
-"use strict";export const DASH_TEAM_KINDS=["goal","build","bug","review","test","docs","marketing","research","chore"],DASH_TEAM_LINK_KINDS=["task","flow","error","suggestion","ai-call","review","page","route","commit","branch","worktree","file"];
+"use strict";export const DASH_TEAM_KINDS=["goal","build","bug","review","test","qa","docs","marketing","research","chore"],DASH_TEAM_LINK_KINDS=["task","flow","error","suggestion","ai-call","review","page","route","commit","branch","worktree","file"];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lensmcp/protocol-types",
-  "version": "1.25.38",
+  "version": "1.25.39",
   "type": "module",
   "main": "./index.js",
   "module": "./index.js",