@parhelia/core 0.3.12831 → 0.3.12833

package/dist/task-board/components/SubgoalFindings.d.ts

@@ -0,0 +1,40 @@
+import type { GoalData } from "../types";
+import type { IssueSummary } from "../services/issueService";
+import { type GoalSeverity } from "./GoalDataView";
+export type SubgoalFindings = {
+    /** Non-zero severity buckets in severity order (critical first). */
+    counts: Array<{
+        severity: GoalSeverity;
+        count: number;
+    }>;
+    /** Findings that carry a severity, info included. */
+    total: number;
+    /** Checks with status "fail"; 0 when the data has no checks. */
+    failedChecks: number;
+    /** Where the numbers come from: the typed issue summary or legacy report data. */
+    source: "issues" | "legacy";
+};
+/**
+ * Condenses a subgoal's findings into what a list row needs: how many findings
+ * each severity has and how many checks failed.
+ *
+ * The data source is an explicit choice, not a guess from the numbers: when the
+ * goal has Issues enabled the typed summary is authoritative, a missing summary
+ * meaning zero unresolved issues. Otherwise the legacy report data is read and
+ * null is returned when it carries neither severity counts nor checks, so
+ * callers can leave the row blank instead of claiming "no findings". When
+ * `issuesEnabled` is not given, the presence of a summary decides.
+ */
+export declare function readSubgoalFindings(data: GoalData, summary?: IssueSummary, issuesEnabled?: boolean): SubgoalFindings | null;
+export declare function describeSubgoalFindings(findings: SubgoalFindings): string;
+type FindingsProps = {
+    data: GoalData;
+    summary?: IssueSummary;
+    /** The owning goal's Issues flag; decides the data source (see readSubgoalFindings). */
+    issuesEnabled?: boolean;
+};
+/** Inline severity chips for a subgoal row; "No findings" when the data is clean. */
+export declare function SubgoalFindingsChips({ data, summary, issuesEnabled, }: FindingsProps): import("react").JSX.Element | null;
+/** Compact count for a matrix cell, coloured by the worst severity present. */
+export declare function SubgoalFindingsBadge({ data, summary, issuesEnabled, }: FindingsProps): import("react").JSX.Element | null;
+export {};

package/dist/task-board/components/SubgoalFindings.js

@@ -0,0 +1,88 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from "../../lib/utils";
+import { SEVERITIES, asRecord, asSeverityCounts, readGoalChecks, severityStyles, } from "./GoalDataView";
+const EMPTY_SUMMARY = {
+    total: 0,
+    open: 0,
+    awaitingConfirmation: 0,
+    resolved: 0,
+    dismissed: 0,
+    needsHumanReview: 0,
+    subjectsWithUnresolvedIssues: 0,
+    unresolvedBySeverity: {},
+};
+/**
+ * Condenses a subgoal's findings into what a list row needs: how many findings
+ * each severity has and how many checks failed.
+ *
+ * The data source is an explicit choice, not a guess from the numbers: when the
+ * goal has Issues enabled the typed summary is authoritative, a missing summary
+ * meaning zero unresolved issues. Otherwise the legacy report data is read and
+ * null is returned when it carries neither severity counts nor checks, so
+ * callers can leave the row blank instead of claiming "no findings". When
+ * `issuesEnabled` is not given, the presence of a summary decides.
+ */
+export function readSubgoalFindings(data, summary, issuesEnabled) {
+    const useIssues = issuesEnabled ?? summary !== undefined;
+    if (useIssues) {
+        const s = summary ?? EMPTY_SUMMARY;
+        return {
+            counts: SEVERITIES.flatMap((severity) => s.unresolvedBySeverity[severity]
+                ? [{ severity, count: s.unresolvedBySeverity[severity] }]
+                : []),
+            total: s.open + s.awaitingConfirmation,
+            failedChecks: 0,
+            source: "issues",
+        };
+    }
+    const record = asRecord(data);
+    if (!record)
+        return null;
+    const severityCounts = asSeverityCounts(record.severityCounts);
+    const checks = readGoalChecks(data);
+    if (!severityCounts && !checks)
+        return null;
+    const counts = SEVERITIES.flatMap((severity) => {
+        const count = severityCounts?.[severity] ?? 0;
+        return count > 0 ? [{ severity, count }] : [];
+    });
+    return {
+        counts,
+        total: counts.reduce((sum, entry) => sum + entry.count, 0),
+        failedChecks: checks?.filter((check) => check.status === "fail").length ?? 0,
+        source: "legacy",
+    };
+}
+export function describeSubgoalFindings(findings) {
+    if (findings.counts.length > 0) {
+        return findings.counts
+            .map((entry) => `${entry.count} ${entry.severity}`)
+            .join(", ");
+    }
+    if (findings.failedChecks > 0) {
+        return `${findings.failedChecks} ${findings.failedChecks === 1 ? "check" : "checks"} failed`;
+    }
+    return findings.source === "issues" ? "No unresolved issues" : "No findings";
+}
+/** Inline severity chips for a subgoal row; "No findings" when the data is clean. */
+export function SubgoalFindingsChips({ data, summary, issuesEnabled, }) {
+    const findings = readSubgoalFindings(data, summary, issuesEnabled);
+    if (!findings)
+        return null;
+    const clean = findings.counts.length === 0 && findings.failedChecks === 0;
+    return (_jsxs("span", { "data-testid": "taskboard-subgoal-findings", "data-total": findings.total, "data-failed-checks": findings.failedChecks, "data-source": findings.source, className: "flex shrink-0 flex-wrap items-center gap-1", title: describeSubgoalFindings(findings), children: [findings.counts.map((entry) => (_jsxs("span", { className: cn("rounded px-1.5 py-0.5 text-[10px] leading-none font-medium tabular-nums", severityStyles[entry.severity].chip), children: [entry.count, " ", entry.severity] }, entry.severity))), findings.counts.length === 0 && findings.failedChecks > 0 ? (_jsxs("span", { className: "bg-feedback-red-light text-feedback-red rounded px-1.5 py-0.5 text-[10px] leading-none font-medium tabular-nums", children: [findings.failedChecks, " failed"] })) : null, clean ? (_jsx("span", { className: "text-neutral-grey-50 text-[10px] leading-none", children: describeSubgoalFindings(findings) })) : null] }));
+}
+/** Compact count for a matrix cell, coloured by the worst severity present. */
+export function SubgoalFindingsBadge({ data, summary, issuesEnabled, }) {
+    const findings = readSubgoalFindings(data, summary, issuesEnabled);
+    if (!findings)
+        return null;
+    const worst = findings.counts[0]?.severity;
+    const count = findings.total > 0 ? findings.total : findings.failedChecks;
+    if (count === 0)
+        return null;
+    return (_jsx("span", { "data-testid": "taskboard-subgoal-findings-badge", className: cn("rounded px-1 py-0.5 text-[10px] leading-none font-medium tabular-nums", worst
+            ? severityStyles[worst].chip
+            : "bg-feedback-red-light text-feedback-red"), title: describeSubgoalFindings(findings), children: count }));
+}
+//# sourceMappingURL=SubgoalFindings.js.map

package/dist/task-board/components/SubgoalFindings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubgoalFindings.js","sourceRoot":"","sources":["../../../src/task-board/components/SubgoalFindings.tsx"],"names":[],"mappings":"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"}

package/dist/task-board/components/commentAuthor.d.ts

@@ -0,0 +1,14 @@
+import type { TaskComment } from "../types";
+export type CommentAuthorPresentation = {
+    /** The comment was written by an agent on behalf of the execution user. */
+    isAgent: boolean;
+    /** A human comment written by the viewer. Never true for agent comments. */
+    isCurrentUser: boolean;
+    /** The name shown in the comment header. */
+    label: string;
+    /** The viewer owns the row (execution user) and may delete it, agent comments included. */
+    canDelete: boolean;
+};
+export declare function normalizeUserName(value: string | null | undefined): string;
+export declare function isAgentComment(comment: Pick<TaskComment, "authorType">): boolean;
+export declare function resolveCommentAuthorPresentation(comment: TaskComment, currentUsername: string | null | undefined, resolvedDisplayName: string): CommentAuthorPresentation;

package/dist/task-board/components/commentAuthor.js

@@ -0,0 +1,25 @@
+export function normalizeUserName(value) {
+    return (value || "").trim().toLowerCase();
+}
+export function isAgentComment(comment) {
+    return (comment.authorType ?? "").trim().toLowerCase() === "agent";
+}
+export function resolveCommentAuthorPresentation(comment, currentUsername, resolvedDisplayName) {
+    const isAgent = isAgentComment(comment);
+    const normalizedCurrentUser = normalizeUserName(currentUsername);
+    const authorMatchesViewer = !!normalizedCurrentUser &&
+        normalizeUserName(comment.author) === normalizedCurrentUser;
+    const isCurrentUser = !isAgent && authorMatchesViewer;
+    const label = isAgent
+        ? comment.authorDisplayName?.trim() || "Agent"
+        : isCurrentUser
+            ? "You"
+            : resolvedDisplayName;
+    return {
+        isAgent,
+        isCurrentUser,
+        label,
+        canDelete: authorMatchesViewer,
+    };
+}
+//# sourceMappingURL=commentAuthor.js.map

package/dist/task-board/components/commentAuthor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commentAuthor.js","sourceRoot":"","sources":["../../../src/task-board/components/commentAuthor.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,iBAAiB,CAAC,KAAgC;IAChE,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,OAAwC;IAExC,OAAO,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,OAAoB,EACpB,eAA0C,EAC1C,mBAA2B;IAE3B,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,qBAAqB,GAAG,iBAAiB,CAAC,eAAe,CAAC,CAAC;IACjE,MAAM,mBAAmB,GACvB,CAAC,CAAC,qBAAqB;QACvB,iBAAiB,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,qBAAqB,CAAC;IAC9D,MAAM,aAAa,GAAG,CAAC,OAAO,IAAI,mBAAmB,CAAC;IAEtD,MAAM,KAAK,GAAG,OAAO;QACnB,CAAC,CAAC,OAAO,CAAC,iBAAiB,EAAE,IAAI,EAAE,IAAI,OAAO;QAC9C,CAAC,CAAC,aAAa;YACb,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,mBAAmB,CAAC;IAE1B,OAAO;QACL,OAAO;QACP,aAAa;QACb,KAAK;QACL,SAAS,EAAE,mBAAmB;KAC/B,CAAC;AACJ,CAAC"}

package/dist/task-board/services/issueService.d.ts

@@ -0,0 +1,193 @@
+export type Issue = {
+    issueId: string;
+    goalId: string;
+    subgoalId?: string;
+    version: string;
+    title: string;
+    suggestion?: string;
+    subjectType: string;
+    subjectKey: string;
+    subjectLabel?: string;
+    targetItemId?: string;
+    language?: string;
+    categoryKey: string;
+    categoryTitle?: string;
+    severity: string;
+    disposition: string;
+    resolutionMode: string;
+    closureBasis?: string;
+    closureReason?: string;
+    needsHumanReview: boolean;
+    reviewReason?: string;
+    evidence?: unknown;
+    location?: unknown;
+    taskLinks: {
+        taskId?: string;
+        originalTaskId: string;
+        taskTitle: string;
+        taskStatus?: string;
+        active: boolean;
+    }[];
+};
+export type IssueSummary = {
+    total: number;
+    open: number;
+    awaitingConfirmation: number;
+    resolved: number;
+    dismissed: number;
+    needsHumanReview: number;
+    subjectsWithUnresolvedIssues: number;
+    unresolvedBySeverity: Record<string, number>;
+};
+export type IssueList = {
+    issues: Issue[];
+    totals: IssueSummary;
+    filteredTotals: IssueSummary;
+    issueRevision: number;
+    hasMore: boolean;
+    /**
+     * SQL read consistency. `false` means the rows and totals may come from
+     * different revisions because issues were changing during the read; the
+     * service already retried with backoff before handing such a result out.
+     */
+    consistent?: boolean;
+};
+export type IssueFilter = {
+    goalId: string;
+    disposition?: string;
+    severity?: string;
+    categoryKey?: string;
+    search?: string;
+    page?: number;
+    limit?: number;
+};
+export type IssueSelection = {
+    issueId: string;
+    version: string;
+};
+export type IssueTaskBundle = {
+    title: string;
+    description?: string;
+    priority: string;
+    issues: IssueSelection[];
+};
+export type IssueHistory = {
+    historyId: string;
+    action: string;
+    disposition: string;
+    basis?: string;
+    reason?: string;
+    actor: string;
+    createdAt: string;
+};
+/** Fields accepted by createIssues (server: NewIssue). */
+export type NewIssue = {
+    subgoalId?: string;
+    subjectType: "Local" | "SitecoreItem";
+    subjectKey?: string;
+    subjectLabel?: string;
+    targetItemId?: string;
+    language?: string;
+    categoryKey?: string;
+    categoryTitle?: string;
+    occurrenceKey?: string;
+    severity?: string;
+    title: string;
+    suggestion?: string;
+    needsHumanReview?: boolean;
+    reviewReason?: string;
+};
+export type QaDomain = {
+    checkKey: string;
+    subgoalId?: string;
+};
+export type QaCheck = {
+    checkKey: string;
+    subgoalId?: string;
+    domainKey: string;
+    generation: number;
+    fingerprint: string;
+    state: string;
+    outcome?: string;
+    reason?: string;
+    definitionStatus: string;
+    diagnostics?: string[];
+    subjectLabel: string;
+    inputs?: {
+        rootId?: string;
+        language?: string;
+        sourceLanguage?: string;
+    };
+    beganAt?: string;
+    beganBy?: string;
+    beganByAgentId?: string;
+    reportedAt?: string;
+    reportedBy?: string;
+    abandonedAt?: string;
+    abandonedBy?: string;
+    abandonReason?: string;
+    definition: {
+        title: string;
+        kind: string;
+    };
+};
+export type QaCheckList = {
+    checks: QaCheck[];
+    hasMore: boolean;
+    configurationFingerprint?: string;
+    warnings?: string[];
+    consistent?: boolean;
+    issueRevision?: number;
+};
+export type IssueConflict = {
+    code: string;
+    message?: string;
+    issues: Issue[];
+    currentGeneration?: number;
+    domain?: QaDomain;
+    domainKey?: string;
+};
+export declare class IssueRequestError extends Error {
+    conflict?: IssueConflict | undefined;
+    status?: number | undefined;
+    constructor(message: string, conflict?: IssueConflict | undefined, status?: number | undefined);
+}
+/**
+ * Backoff for reads that report `consistent=false` and for exports refused
+ * with 503. Tests shorten it; production keeps 500 ms, 1 s, 2 s.
+ */
+export declare let consistencyBackoffMs: number[];
+export declare const setConsistencyBackoff: (delays: number[]) => void;
+export declare const issueQuery: (query: IssueFilter) => string;
+export declare const listIssues: (query: IssueFilter) => Promise<IssueList>;
+export declare const createIssues: (goalId: string, issues: NewIssue[]) => Promise<{
+    issues: Issue[];
+}>;
+export declare const updateIssues: (issues: IssueSelection[], action: string, reason?: string) => Promise<{
+    issues: Issue[];
+}>;
+export declare const issueHistory: (issueId: string) => Promise<{
+    history: IssueHistory[];
+}>;
+export declare const createIssueTasks: (goalId: string, operationKey: string, bundles: IssueTaskBundle[], dryRun: boolean) => Promise<{
+    tasks: {
+        taskId: string;
+        title: string;
+    }[];
+    bundles: IssueTaskBundle[];
+}>;
+export declare const listQaChecks: (goalId: string, page?: number) => Promise<QaCheckList>;
+/**
+ * Marks a running generation as abandoned (terminal; no new generation is
+ * started). Only the current generation can be abandoned and a later report
+ * against it is refused with GenerationAbandoned.
+ */
+export declare const abandonQaCheck: (goalId: string, domain: QaDomain, generation: number, reason: string) => Promise<{
+    check: QaCheck;
+}>;
+/**
+ * Downloads the CSV export. The server refuses to emit mixed data with 503
+ * while issues are changing; the download is retried three times before the
+ * error reaches the caller.
+ */
+export declare const exportIssues: (query: IssueFilter) => Promise<string>;

package/dist/task-board/services/issueService.js

@@ -0,0 +1,97 @@
+import { get, post, } from "../../editor/services/serviceHelper";
+export class IssueRequestError extends Error {
+    conflict;
+    status;
+    constructor(message, conflict, status) {
+        super(message);
+        this.conflict = conflict;
+        this.status = status;
+    }
+}
+async function unwrap(result) {
+    if (result.type === "success" && result.data !== undefined)
+        return result.data;
+    let conflict;
+    try {
+        conflict = JSON.parse(result.rawDetails || result.details || "{}").conflict;
+    }
+    catch {
+        /* Non-JSON server errors retain their message. */
+    }
+    throw new IssueRequestError(conflict?.message || result.summary || "Issue request failed", conflict, result.response?.status);
+}
+/**
+ * Backoff for reads that report `consistent=false` and for exports refused
+ * with 503. Tests shorten it; production keeps 500 ms, 1 s, 2 s.
+ */
+export let consistencyBackoffMs = [500, 1000, 2000];
+export const setConsistencyBackoff = (delays) => {
+    consistencyBackoffMs = delays;
+};
+const wait = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/**
+ * Reads again while the server reports an inconsistent result, then returns
+ * the last result as is (still flagged) so the caller can say that counts are
+ * changing. A later goal:changed is never relied on to repair the view.
+ */
+async function consistentRead(read) {
+    let result = await read();
+    for (const delay of consistencyBackoffMs) {
+        if (result.consistent !== false)
+            break;
+        await wait(delay);
+        result = await read();
+    }
+    return result;
+}
+export const issueQuery = (query) => new URLSearchParams(Object.entries(query)
+    .filter(([, value]) => value !== undefined && value !== "")
+    .map(([key, value]) => [key, String(value)])).toString();
+export const listIssues = (query) => consistentRead(async () => unwrap(await get(`/parhelia/tasks/listIssues?${issueQuery(query)}`)));
+export const createIssues = async (goalId, issues) => unwrap(await post("/parhelia/tasks/createIssues", {
+    goalId,
+    issues,
+}));
+export const updateIssues = async (issues, action, reason) => unwrap(await post("/parhelia/tasks/updateIssues", {
+    issues,
+    action,
+    reason,
+}));
+export const issueHistory = async (issueId) => unwrap(await get(`/parhelia/tasks/issueHistory?issueId=${encodeURIComponent(issueId)}`));
+export const createIssueTasks = async (goalId, operationKey, bundles, dryRun) => unwrap(await post("/parhelia/tasks/createIssueTasks", {
+    goalId,
+    operationKey,
+    bundles,
+    dryRun,
+}));
+export const listQaChecks = (goalId, page = 1) => consistentRead(async () => unwrap(await get(`/parhelia/tasks/listQaChecks?goalId=${encodeURIComponent(goalId)}&page=${page}&limit=100`)));
+/**
+ * Marks a running generation as abandoned (terminal; no new generation is
+ * started). Only the current generation can be abandoned and a later report
+ * against it is refused with GenerationAbandoned.
+ */
+export const abandonQaCheck = async (goalId, domain, generation, reason) => unwrap(await post("/parhelia/tasks/abandonQaCheck", {
+    goalId,
+    domain,
+    generation,
+    reason,
+}));
+/**
+ * Downloads the CSV export. The server refuses to emit mixed data with 503
+ * while issues are changing; the download is retried three times before the
+ * error reaches the caller.
+ */
+export const exportIssues = async (query) => {
+    const url = `/parhelia/tasks/exportIssues?${issueQuery(query)}`;
+    let attempt = 0;
+    for (;;) {
+        const result = await get(url);
+        if (result.type === "success")
+            return result.response.text();
+        if (result.response?.status !== 503 || attempt >= 3)
+            throw new IssueRequestError(result.details || result.summary || "Export failed", undefined, result.response?.status);
+        await wait(consistencyBackoffMs[attempt] ?? 2000);
+        attempt++;
+    }
+};
+//# sourceMappingURL=issueService.js.map

package/dist/task-board/services/issueService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issueService.js","sourceRoot":"","sources":["../../../src/task-board/services/issueService.ts"],"names":[],"mappings":"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"}

package/dist/task-board/taskBlockers.d.ts

@@ -0,0 +1,10 @@
+import type { TaskDependency, TaskItem } from "./types";
+/**
+ * Unfinished BlockedBy blockers per task. A subtask also waits for the blockers of
+ * every ancestor, except blockers inside that ancestor's own subtask tree (a parent
+ * waiting for one of its subtasks). Mirrors TaskBlockerResolver on the server.
+ *
+ * Own blockers come first, then inherited ones from the nearest ancestor outwards.
+ * A blocker that is not loaded counts as open. Tasks without open blockers are absent.
+ */
+export declare function collectOpenBlockerIdsByTaskId(tasks: readonly TaskItem[], dependencies: readonly TaskDependency[]): Map<string, string[]>;

package/dist/task-board/taskBlockers.js

@@ -0,0 +1,66 @@
+import { normalizeTaskStatus } from "./taskStatus";
+/**
+ * Unfinished BlockedBy blockers per task. A subtask also waits for the blockers of
+ * every ancestor, except blockers inside that ancestor's own subtask tree (a parent
+ * waiting for one of its subtasks). Mirrors TaskBlockerResolver on the server.
+ *
+ * Own blockers come first, then inherited ones from the nearest ancestor outwards.
+ * A blocker that is not loaded counts as open. Tasks without open blockers are absent.
+ */
+export function collectOpenBlockerIdsByTaskId(tasks, dependencies) {
+    const taskById = new Map(tasks.map((task) => [task.taskId, task]));
+    const blockerIdsByTaskId = new Map();
+    for (const dependency of dependencies) {
+        if (dependency.dependencyType !== "BlockedBy")
+            continue;
+        const blockerIds = blockerIdsByTaskId.get(dependency.taskId) ?? [];
+        if (!blockerIds.includes(dependency.dependsOnTaskId)) {
+            blockerIds.push(dependency.dependsOnTaskId);
+        }
+        blockerIdsByTaskId.set(dependency.taskId, blockerIds);
+    }
+    const getParentId = (taskId) => taskById.get(taskId)?.parentTaskId || null;
+    const isOpen = (blockerId) => {
+        const blocker = taskById.get(blockerId);
+        return (!blocker ||
+            normalizeTaskStatus(blocker.status, blocker.executionState) !== "Done");
+    };
+    const isDescendantOf = (taskId, ancestorId) => {
+        const visited = new Set([taskId]);
+        let currentId = getParentId(taskId);
+        while (currentId && !visited.has(currentId)) {
+            if (currentId === ancestorId)
+                return true;
+            visited.add(currentId);
+            currentId = getParentId(currentId);
+        }
+        return false;
+    };
+    const result = new Map();
+    for (const task of tasks) {
+        const openBlockerIds = [];
+        const addOpenBlockers = (ownerId, inherited) => {
+            for (const blockerId of blockerIdsByTaskId.get(ownerId) ?? []) {
+                if (blockerId === task.taskId || openBlockerIds.includes(blockerId)) {
+                    continue;
+                }
+                if (inherited && isDescendantOf(blockerId, ownerId))
+                    continue;
+                if (isOpen(blockerId))
+                    openBlockerIds.push(blockerId);
+            }
+        };
+        addOpenBlockers(task.taskId, false);
+        const visited = new Set([task.taskId]);
+        let ancestorId = getParentId(task.taskId);
+        while (ancestorId && !visited.has(ancestorId)) {
+            visited.add(ancestorId);
+            addOpenBlockers(ancestorId, true);
+            ancestorId = getParentId(ancestorId);
+        }
+        if (openBlockerIds.length > 0)
+            result.set(task.taskId, openBlockerIds);
+    }
+    return result;
+}
+//# sourceMappingURL=taskBlockers.js.map

package/dist/task-board/taskBlockers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"taskBlockers.js","sourceRoot":"","sources":["../../src/task-board/taskBlockers.ts"],"names":[],"mappings":"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"}

package/dist/task-board/utils/projectDashboardModel.d.ts

@@ -0,0 +1,68 @@
+import type { GoalDisplaySpec } from "../components/goalDisplaySpec";
+import type { Goal, TaskItem } from "../types";
+/**
+ * The dashboard reduces the fifteen execution states to four buckets that a
+ * project owner acts on differently: nothing (done), watch (running), act
+ * (attention) or wait (open, which includes blocked and unassigned work).
+ */
+export type DashboardTaskBucket = "done" | "running" | "attention" | "open";
+export declare function getDashboardTaskBucket(task: TaskItem): DashboardTaskBucket;
+export declare function isFailedTask(task: TaskItem): boolean;
+export type DashboardPhase = "empty" | "finished" | "running" | "attention" | "idle";
+export type DashboardStatusSummary = {
+    total: number;
+    done: number;
+    running: number;
+    attention: number;
+    failed: number;
+    open: number;
+    phase: DashboardPhase;
+    /** Short lead ("Running.") shown in bold. */
+    headline: string;
+    /** Plain-language sentence(s) after the headline. */
+    detail: string;
+};
+export declare function buildDashboardStatusSummary(tasks: TaskItem[]): DashboardStatusSummary;
+export type DashboardAttentionAction = "Review" | "Answer" | "Open";
+export type DashboardAttentionEntry = {
+    task: TaskItem;
+    /** What the task needs from the user, in plain words. */
+    description: string;
+    action: DashboardAttentionAction;
+};
+export declare function describeAttention(task: TaskItem): {
+    description: string;
+    action: DashboardAttentionAction;
+};
+export declare function listAttentionTasks(tasks: TaskItem[]): DashboardAttentionEntry[];
+export declare function listRunningTasks(tasks: TaskItem[]): TaskItem[];
+/** Row label for the pipeline; null means the row shows no status text. */
+export declare function getDashboardTaskStatusLabel(task: TaskItem, isBlocked: boolean): string | null;
+/** Wall-clock duration of a finished execution, or null when unknown. */
+export declare function getTaskDurationMs(task: TaskItem): number | null;
+/** Time since the execution started, or null when the task never started. */
+export declare function getTaskElapsedMs(task: TaskItem, now: number): number | null;
+export declare function formatDurationShort(ms: number): string;
+/** Earliest execution start across the run, or null when nothing started. */
+export declare function getRunStartedAt(tasks: TaskItem[]): number | null;
+export type DashboardTile = {
+    key: string;
+    label: string;
+    value: string;
+    suffix?: string;
+    /** Muted trailing text under the value. */
+    detail?: string;
+    /** Emphasised (red) lead-in for `detail`, e.g. "9 high". */
+    emphasis?: string;
+    /** 0..100 progress bar under the value. */
+    progress?: number | null;
+    tone?: "ok" | "neutral";
+};
+export declare const MAX_GOAL_TILES = 4;
+export declare function readGoalSummary(goal: Goal): string | null;
+/**
+ * Turns the generic goal widgets (coverage, score, severity counts, metrics)
+ * into at most four figures. The goal template's display spec decides the
+ * order, so no project type needs its own dashboard code.
+ */
+export declare function buildGoalTiles(goal: Goal, spec: GoalDisplaySpec | null): DashboardTile[];