huly-mcp-selfhost 2.1.0 → 3.2.0

package/dist/tools/milestones.d.ts

@@ -1,9 +1,9 @@
 export declare const listMilestones: (args: {
-    projectIdentifier: string;
     workspace?: string | undefined;
+    projectIdentifier: string;
 }) => Promise<{
     content: Array<{
-        type: "text";
+        type: 'text';
         text: string;
     }>;
 }>;
@@ -12,20 +12,20 @@ export declare const createMilestone: (args: {
     projectIdentifier: string;
     label: string;
     targetDate: string;
-    status: "Planned" | "InProgress" | "Completed" | "Canceled";
+    status: "Canceled" | "Completed" | "InProgress" | "Planned";
 }) => Promise<{
     content: Array<{
-        type: "text";
+        type: 'text';
         text: string;
     }>;
 }>;
 export declare const getMilestone: (args: {
+    workspace?: string | undefined;
     projectIdentifier: string;
     label: string;
-    workspace?: string | undefined;
 }) => Promise<{
     content: Array<{
-        type: "text";
+        type: 'text';
         text: string;
     }>;
 }>;
@@ -35,11 +35,11 @@ export declare const updateMilestone: (args: {
     label: string;
     newLabel?: string | undefined;
     targetDate?: string | undefined;
-    status?: "Planned" | "InProgress" | "Completed" | "Canceled" | undefined;
+    status?: "Canceled" | "Completed" | "InProgress" | "Planned" | undefined;
     description?: string | null | undefined;
 }) => Promise<{
     content: Array<{
-        type: "text";
+        type: 'text';
         text: string;
     }>;
 }>;
@@ -50,7 +50,7 @@ export declare const deleteMilestone: (args: {
     moveIssuesTo?: string | undefined;
 }) => Promise<{
     content: Array<{
-        type: "text";
+        type: 'text';
         text: string;
     }>;
 }>;

package/dist/tools/organizations.d.ts

@@ -2,16 +2,16 @@ export declare const listOrganizations: (args: {
     workspace?: string | undefined;
 }) => Promise<{
     content: Array<{
-        type: "text";
+        type: 'text';
         text: string;
     }>;
 }>;
 export declare const getOrganization: (args: {
-    organizationId: string;
     workspace?: string | undefined;
+    organizationId: string;
 }) => Promise<{
     content: Array<{
-        type: "text";
+        type: 'text';
         text: string;
     }>;
 }>;
@@ -21,7 +21,7 @@ export declare const createOrganization: (args: {
     city?: string | undefined;
 }) => Promise<{
     content: Array<{
-        type: "text";
+        type: 'text';
         text: string;
     }>;
 }>;
@@ -31,7 +31,7 @@ export declare const updateOrganization: (args: {
     description: string;
 }) => Promise<{
     content: Array<{
-        type: "text";
+        type: 'text';
         text: string;
     }>;
 }>;

package/dist/tools/organizations.js

@@ -10,6 +10,7 @@ const connection_1 = require("../connection");
 const errors_1 = require("../utils/errors");
 const markdown_1 = require("../utils/markdown");
 const storage_1 = require("../utils/storage");
+const content_1 = require("../utils/content");
 exports.listOrganizations = (0, errors_1.wrapToolHandler)(async (args) => {
     const client = await (0, connection_1.getConnection)(args.workspace);
     const orgs = await client.findAll(contact_1.default.class.Organization, {});
@@ -34,7 +35,7 @@ exports.getOrganization = (0, errors_1.wrapToolHandler)(async (args) => {
             // Token goes in the Authorization header only — never in the URL (see get_document).
             const blobUrl = `${frontUrl}/files?file=${encodeURIComponent(org.description)}&workspace=${workspaceUuid}`;
             try {
-                const res = await fetch(blobUrl, { headers: { Authorization: `Bearer ${wsToken}` } });
+                const res = await (0, content_1.fetchBlob)(blobUrl, wsToken);
                 if (res.ok) {
                     const text = await res.text();
                     try {

package/dist/tools/organizations.js.map

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

package/dist/tools/overview.d.ts

@@ -0,0 +1,55 @@
+/** Start of the given day (UTC, like the calendar tools) or of today. */
+export declare function dayStart(date?: string): number;
+export declare const myDay: (args: {
+    workspace?: string | undefined;
+    date?: string | undefined;
+    limit: number;
+}) => Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+export declare function myDayText(client: any, date: string | undefined, limit: number): Promise<string>;
+export declare const projectReport: (args: {
+    workspace?: string | undefined;
+    projectIdentifier: string;
+    since?: string | undefined;
+}) => Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+/** Start of the previous working day (Monday → Friday), UTC. */
+export declare function lastWorkingDay(now?: number): number;
+export declare const standup: (args: {
+    workspace?: string | undefined;
+    since?: string | undefined;
+}) => Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+/** One-line plain text of a comment: no HTML (bot comments), no entities, collapsed whitespace. */
+export declare const plain: (markup: string) => string;
+export declare const triageInbox: (args: {
+    workspace?: string | undefined;
+    limit: number;
+}) => Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
+export declare const releaseNotes: (args: {
+    workspace?: string | undefined;
+    projectIdentifier: string;
+    milestoneLabel: string;
+}) => Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;

package/dist/tools/overview.js

@@ -0,0 +1,395 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.releaseNotes = exports.triageInbox = exports.plain = exports.standup = exports.projectReport = exports.myDay = void 0;
+exports.dayStart = dayStart;
+exports.myDayText = myDayText;
+exports.lastWorkingDay = lastWorkingDay;
+// Overviews that combine several modules in one call: "my day" (calendar, to-dos, my issues,
+// reviews, inbox) so Claude can answer "what's on today?" without five round trips, and a
+// project report for a period (weekly report).
+const tracker_1 = __importDefault(require("@hcengineering/tracker"));
+const task_1 = __importDefault(require("@hcengineering/task"));
+const core_1 = require("@hcengineering/core");
+const connection_1 = require("../connection");
+const errors_1 = require("../utils/errors");
+const classes_1 = require("../utils/classes");
+const format_1 = require("../utils/format");
+const people_1 = require("../utils/people");
+const agent_1 = require("./agent");
+const resolve_1 = require("../utils/resolve");
+const DAY = 86_400_000;
+const day = (ts) => new Date(ts).toISOString().slice(0, 10);
+const hm = (ts) => new Date(ts).toISOString().slice(11, 16);
+/** Start of the given day (UTC, like the calendar tools) or of today. */
+function dayStart(date) {
+    if (date == null)
+        return Date.parse(new Date().toISOString().slice(0, 10));
+    const t = Date.parse(date.slice(0, 10));
+    if (Number.isNaN(t))
+        throw new Error(`date must be YYYY-MM-DD, got '${date}'.`);
+    return t;
+}
+const due = (ts, from) => {
+    if (ts == null)
+        return '';
+    if (ts < from)
+        return ` · ⚠️ overdue (${day(ts)})`;
+    if (ts < from + DAY)
+        return ' · due today';
+    return ` · due ${day(ts)}`;
+};
+exports.myDay = (0, errors_1.wrapToolHandler)(async (args) => await myDayText(await (0, connection_1.getConnection)(args.workspace), args.date, args.limit ?? 10));
+async function myDayText(client, date, limit) {
+    const from = dayStart(date);
+    const to = from + DAY - 1;
+    const [me, uuid] = await Promise.all([(0, people_1.currentPerson)(client), (0, people_1.currentAccountUuid)(client)]);
+    const [events, todos, issues, prs, unread] = await Promise.all([
+        client.findAll(classes_1.C.Event, { date: { $lte: to }, dueDate: { $gte: from } }, { sort: { date: core_1.SortingOrder.Ascending } }),
+        client.findAll(classes_1.C.ToDo, { user: me._id, doneOn: null }, { sort: { rank: core_1.SortingOrder.Ascending } }),
+        client.findAll(tracker_1.default.class.Issue, { assignee: me._id }),
+        client.findAll(classes_1.C.PullRequest, { state: 0 }),
+        client.findAll(classes_1.C.InboxNotification, { user: uuid, isViewed: false, archived: false }, { sort: { createdOn: core_1.SortingOrder.Descending }, limit: 500 })
+    ]);
+    const out = [`# My day — ${day(from)} (times UTC)`];
+    // Calendar: own events and work slots (the query also returns other people's public events).
+    const mine = events.filter((e) => (e.participants ?? []).includes(me._id) || String(e.calendar ?? '').startsWith(uuid) || e.user === me._id);
+    out.push('', `## Calendar (${mine.length})`);
+    if (mine.length === 0)
+        out.push('Nothing scheduled.');
+    for (const e of mine.slice(0, limit)) {
+        const when = e.allDay === true ? 'all day' : `${hm(Math.max(e.date, from))}–${hm(Math.min(e.dueDate, to))}`;
+        const slot = e._class === classes_1.C.WorkSlot ? ` · work slot for ${await (0, resolve_1.loadLabel)(client, e.attachedToClass, e.attachedTo)}` : '';
+        out.push(`- ${when} **${String(e.title)}**${e.location != null && e.location !== '' ? ` · 📍 ${String(e.location)}` : ''}${slot}`);
+    }
+    // To-dos: overdue and due today first, then the top of the planner.
+    const urgency = (t) => t.dueDate == null ? 2 : t.dueDate <= to ? 0 : 1;
+    const sortedTodos = [...todos].sort((a, b) => urgency(a) - urgency(b));
+    const dueNow = todos.filter((t) => t.dueDate != null && t.dueDate <= to).length;
+    out.push('', `## To-dos (${todos.length} open${dueNow > 0 ? `, ${dueNow} due by today` : ''})`);
+    if (todos.length === 0)
+        out.push('No open to-dos.');
+    for (const t of sortedTodos.slice(0, limit)) {
+        const prio = t.priority != null && t.priority !== classes_1.TODO_PRIORITY.NoPriority ? ` · ${String(classes_1.TODO_PRIORITY_LABEL[t.priority] ?? t.priority)}` : '';
+        out.push(`- [ ] **${String(t.title)}**${prio}${due(t.dueDate, from)} — \`${String(t._id)}\``);
+    }
+    // My issues: open ones, in progress first, then by due date and priority.
+    const statuses = issues.length > 0 ? await client.findAll('core:class:Status', { _id: { $in: [...new Set(issues.map((i) => i.status))] } }) : [];
+    const st = new Map(statuses.map((s) => [s._id, s]));
+    const closed = new Set([task_1.default.statusCategory.Won, task_1.default.statusCategory.Lost]);
+    // PRs are issues too (github:class:GithubPullRequest); they belong to the reviews section.
+    const open = issues.filter((i) => i._class !== classes_1.C.PullRequest && !closed.has(st.get(i.status)?.category));
+    const active = (i) => st.get(i.status)?.category === task_1.default.statusCategory.Active ? 0 : 1;
+    open.sort((a, b) => active(a) - active(b) || (a.dueDate ?? Infinity) - (b.dueDate ?? Infinity) || (a.priority || 9) - (b.priority || 9));
+    out.push('', `## My issues (${open.length} open, ${open.filter((i) => active(i) === 0).length} in progress)`);
+    if (open.length === 0)
+        out.push('No open issues assigned to you.');
+    for (const i of open.slice(0, limit)) {
+        const prio = i.priority != null && i.priority !== 0 ? ` · ${(0, format_1.priorityLabel)(i.priority)}` : '';
+        out.push(`- **${String(i.identifier)}** ${String(i.title)} — ${String(st.get(i.status)?.name ?? '?')}${prio}${due(i.dueDate, from)}`);
+    }
+    // Reviews: open PRs that ask me to review, and my own open PRs with their review state.
+    const DECISION = ['changes requested', 'approved', 'review required'];
+    const toReview = prs.filter((p) => (p.reviewers ?? []).includes(me._id));
+    const own = prs.filter((p) => p.assignee === me._id && !toReview.includes(p));
+    out.push('', `## Reviews (${toReview.length} for you, ${own.length} of yours open)`);
+    if (toReview.length + own.length === 0)
+        out.push('No open pull requests for you.');
+    for (const p of toReview.slice(0, limit))
+        out.push(`- 👀 **${String(p.identifier)}** ${String(p.title)}${p.draft === true ? ' · draft' : ''}`);
+    for (const p of own.slice(0, limit))
+        out.push(`- **${String(p.identifier)}** ${String(p.title)} · ${p.reviewDecision != null ? DECISION[p.reviewDecision] ?? p.reviewDecision : 'no review yet'}${p.draft === true ? ' · draft' : ''}`);
+    // Inbox: unread notifications grouped by object, newest first.
+    const groups = new Map();
+    for (const n of unread)
+        groups.set(n.docNotifyContext, [...(groups.get(n.docNotifyContext) ?? []), n]);
+    out.push('', `## Inbox (${unread.length}${unread.length === 500 ? '+' : ''} unread on ${groups.size} item(s))`);
+    if (unread.length === 0)
+        out.push('Inbox zero.');
+    const ctxs = groups.size > 0 ? await client.findAll(classes_1.C.DocNotifyContext, { _id: { $in: [...groups.keys()].slice(0, limit) } }) : [];
+    for (const [ctxId, notes] of [...groups.entries()].slice(0, limit)) {
+        const ctx = ctxs.find((c) => c._id === ctxId);
+        const cls = ctx?.objectClass ?? notes[0].objectClass;
+        const label = cls != null ? await (0, resolve_1.loadLabel)(client, cls, ctx?.objectId ?? notes[0].objectId) : '(unknown)';
+        out.push(`- **${label}** — ${notes.length} unread`);
+    }
+    if (unread.length > 0)
+        out.push(`_${groups.size > limit ? `${groups.size - limit} more. ` : ''}Work through them: triage_inbox._`);
+    return out.join('\n');
+}
+// ── Project report: what happened in a project over a period (default: last 7 days) ──
+const pct = (part, total) => total === 0 ? '—' : `${Math.round(100 * part / total)}%`;
+exports.projectReport = (0, errors_1.wrapToolHandler)(async (args) => {
+    const client = await (0, connection_1.getConnection)(args.workspace);
+    const project = await client.findOne(tracker_1.default.class.Project, { identifier: args.projectIdentifier });
+    if (project == null)
+        throw new Error(`Project '${args.projectIdentifier}' not found.`);
+    const since = (0, agent_1.parseSince)(args.since ?? '7d');
+    const now = Date.now();
+    const all = await client.findAll(tracker_1.default.class.Issue, { space: project._id });
+    const issues = all.filter((i) => i._class !== classes_1.C.PullRequest);
+    const prs = all.filter((i) => i._class === classes_1.C.PullRequest);
+    const ids = issues.map((i) => i._id);
+    const [statuses, milestones, reports, statusMsgs] = await Promise.all([
+        client.findAll('core:class:Status', { _id: { $in: [...new Set(all.map((i) => i.status))] } }),
+        client.findAll(tracker_1.default.class.Milestone, { space: project._id }),
+        ids.length > 0 ? client.findAll(tracker_1.default.class.TimeSpendReport, { attachedTo: { $in: ids } }) : [],
+        ids.length > 0 ? client.findAll(classes_1.C.DocUpdateMessage, { attachedTo: { $in: ids }, createdOn: { $gte: since } }) : []
+    ]);
+    const names = await (0, people_1.peopleNames)(client);
+    const st = new Map(statuses.map((s) => [s._id, s]));
+    const cat = (i) => st.get(i.status)?.category;
+    const won = (i) => cat(i) === task_1.default.statusCategory.Won;
+    const isOpen = (i) => !won(i) && cat(i) !== task_1.default.statusCategory.Lost;
+    const who = (i) => i.assignee != null ? ` · ${names.get(i.assignee) ?? '?'}` : '';
+    const line = (i, extra = '') => `- **${String(i.identifier)}** ${String(i.title)}${extra}${who(i)}`;
+    // Done in the period: done now and its status changed in the period. modifiedOn is no use here —
+    // GitHub sync touches closed issues long after they were finished.
+    const statusChanged = new Set(statusMsgs.filter((m) => m.attributeUpdates?.attrKey === 'status').map((m) => m.attachedTo));
+    const done = issues.filter((i) => won(i) && statusChanged.has(i._id));
+    const created = issues.filter((i) => (i.createdOn ?? 0) >= since);
+    const open = issues.filter(isOpen);
+    const active = open.filter((i) => cat(i) === task_1.default.statusCategory.Active);
+    const openIds = new Set(open.map((i) => i._id));
+    const blocked = open.filter((i) => (i.blockedBy ?? []).some((b) => openIds.has(b._id ?? b)));
+    const overdue = open.filter((i) => i.dueDate != null && i.dueDate < now);
+    const stale = active.filter((i) => (i.modifiedOn ?? 0) < since);
+    const merged = prs.filter((p) => p.state === 2 && (p.mergedAt ?? p.modifiedOn ?? 0) >= since);
+    const openPrs = prs.filter((p) => p.state === 0);
+    const time = reports.filter((r) => (r.date ?? 0) >= since);
+    const hours = time.reduce((s, r) => s + (r.value ?? 0), 0);
+    const L = 15;
+    const section = (title, list, render = (i) => line(i)) => {
+        if (list.length === 0)
+            return;
+        out.push('', `## ${title} (${list.length})`, ...list.slice(0, L).map(render));
+        if (list.length > L)
+            out.push(`_…${list.length - L} more_`);
+    };
+    const out = [
+        `# ${String(project.name)} (${String(project.identifier)}) — ${day(since)} to ${day(now)}`,
+        '',
+        `**${done.length} done · ${created.length} new · ${open.length} open (${active.length} in progress) · ${blocked.length} blocked · ${overdue.length} overdue · ${merged.length} PRs merged · ${Math.round(hours * 10) / 10}h logged**`
+    ];
+    section('Done', done);
+    section('New', created, (i) => line(i, ` — ${String(st.get(i.status)?.name ?? '?')}`));
+    section('In progress', active, (i) => line(i, stale.includes(i) ? ' · ⚠️ no change in this period' : ''));
+    section('Blocked', blocked, (i) => line(i, ` — by ${i.blockedBy.map((b) => String(all.find((x) => x._id === (b._id ?? b))?.identifier ?? '?')).join(', ')}`));
+    section('Overdue', overdue, (i) => line(i, ` — due ${day(i.dueDate)}`));
+    section('Pull requests merged', merged);
+    section('Pull requests open', openPrs, (p) => line(p, p.reviewDecision != null ? ` · ${['changes requested', 'approved', 'review required'][p.reviewDecision] ?? ''}` : ''));
+    const ms = milestones.filter((m) => m.status !== 2 && m.status !== 3).sort((a, b) => (a.targetDate ?? Infinity) - (b.targetDate ?? Infinity));
+    section('Milestones', ms, (m) => {
+        const of = issues.filter((i) => i.milestone === m._id);
+        const late = m.targetDate != null && m.targetDate < now ? ' ⚠️ past target' : '';
+        return `- **${String(m.label)}** — ${of.filter(won).length}/${of.length} done (${pct(of.filter(won).length, of.length)})${m.targetDate != null ? `, target ${day(m.targetDate)}${late}` : ''}`;
+    });
+    if (time.length > 0) {
+        const per = new Map();
+        for (const r of time) {
+            const n = names.get(r.employee) ?? '?';
+            per.set(n, (per.get(n) ?? 0) + (r.value ?? 0));
+        }
+        out.push('', '## Time logged', ...[...per].sort((a, b) => b[1] - a[1]).map(([n, h]) => `- ${n}: ${Math.round(h * 10) / 10}h`));
+    }
+    return out.join('\n');
+});
+// ── Standup: what I did since the last working day, what's on today, what blocks me ──
+/** Start of the previous working day (Monday → Friday), UTC. */
+function lastWorkingDay(now = Date.now()) {
+    const today = dayStart(new Date(now).toISOString());
+    const dow = new Date(today).getUTCDay(); // 0 Sun … 6 Sat
+    const back = dow === 1 ? 3 : dow === 0 ? 2 : 1;
+    return today - back * DAY;
+}
+/** Sections of a markdown text by "## " heading. */
+const sections = (md) => new Map(md.split(/\n(?=## )/).filter((s) => s.startsWith('## ')).map((s) => [s.split('\n')[0].replace(/^## | \(.*$/g, ''), s.trim()]));
+exports.standup = (0, errors_1.wrapToolHandler)(async (args) => {
+    const client = await (0, connection_1.getConnection)(args.workspace);
+    const since = args.since != null ? (0, agent_1.parseSince)(args.since) : lastWorkingDay();
+    const me = await (0, people_1.currentPerson)(client);
+    const idents = await client.findAll('contact:class:SocialIdentity', { attachedTo: me._id });
+    const mine = [...new Set([client.user, ...idents.map((i) => i._id)])];
+    const [updates, comments, reports, doneTodos] = await Promise.all([
+        client.findAll(classes_1.C.DocUpdateMessage, { createdBy: { $in: mine }, createdOn: { $gte: since } }, { limit: 1000, sort: { createdOn: core_1.SortingOrder.Descending } }),
+        client.findAll('chunter:class:ChatMessage', { createdBy: { $in: mine }, createdOn: { $gte: since }, attachedToClass: { $in: [tracker_1.default.class.Issue, classes_1.C.PullRequest] } }, { limit: 200 }),
+        client.findAll(tracker_1.default.class.TimeSpendReport, { employee: me._id, date: { $gte: since } }),
+        client.findAll(classes_1.C.ToDo, { user: me._id, doneOn: { $gte: since } })
+    ]);
+    // What I did, per issue: created, status changes, other fields, comments, time.
+    const per = new Map();
+    const entry = (id) => per.get(id) ?? per.set(id, { created: false, status: [], fields: new Set(), comments: 0, hours: 0 }).get(id);
+    const statusIds = new Set();
+    updates.sort((a, b) => (a.createdOn ?? 0) - (b.createdOn ?? 0));
+    for (const u of updates) {
+        if (u.objectClass != null && u.objectClass !== tracker_1.default.class.Issue && u.objectClass !== classes_1.C.PullRequest && u.attachedToClass !== tracker_1.default.class.Issue)
+            continue;
+        const e = entry(u.attachedTo);
+        if (u.action === 'create')
+            e.created = true;
+        else if (u.attributeUpdates?.attrKey === 'status') {
+            for (const s of u.attributeUpdates.set ?? []) {
+                e.status.push(s);
+                statusIds.add(s);
+            }
+        }
+        else if (u.attributeUpdates?.attrKey != null && !['rank', 'subIssues', 'comments', 'reports', 'reportedTime', 'remainingTime', 'modifiedOn'].includes(u.attributeUpdates.attrKey))
+            e.fields.add(u.attributeUpdates.attrKey === 'attachedTo' ? 'parent' : u.attributeUpdates.attrKey);
+    }
+    for (const c of comments)
+        entry(c.attachedTo).comments++;
+    for (const r of reports)
+        entry(r.attachedTo).hours += r.value ?? 0;
+    const issues = per.size > 0 ? await client.findAll(tracker_1.default.class.Issue, { _id: { $in: [...per.keys()] } }) : [];
+    const stNames = new Map((statusIds.size > 0 ? await client.findAll('core:class:Status', { _id: { $in: [...statusIds] } }) : []).map((s) => [s._id, s.name]));
+    const out = [`# Standup — since ${new Date(since).toISOString().slice(0, 16).replace('T', ' ')} UTC`, '', '## Done / worked on'];
+    if (updates.length === 1000)
+        out.push('_Very busy period: only the latest 1000 changes are counted._');
+    // Most telling first: status changes and new issues, then comments/time, then field edits.
+    const weight = (i) => { const e = per.get(i._id); return e.status.length > 0 || e.created ? 0 : e.comments > 0 || e.hours > 0 ? 1 : 2; };
+    issues.sort((a, b) => weight(a) - weight(b));
+    const did = issues.slice(0, 15).map((i) => {
+        const e = per.get(i._id);
+        const parts = [
+            e.created ? 'created' : undefined,
+            e.status.length > 0 ? `→ ${e.status.map((s) => stNames.get(s) ?? '?').filter((n, k, a) => k === 0 || n !== a[k - 1]).join(' → ')}` : undefined,
+            e.fields.size > 0 ? `changed ${[...e.fields].join(', ')}` : undefined,
+            e.comments > 0 ? `${e.comments} comment(s)` : undefined,
+            e.hours > 0 ? `${Math.round(e.hours * 10) / 10}h` : undefined
+        ].filter((p) => p != null);
+        return `- **${String(i.identifier)}** ${String(i.title)} — ${parts.join(' · ')}`;
+    });
+    if (issues.length > 15)
+        did.push(`_…${issues.length - 15} more issues touched — changes_since for all._`);
+    for (const t of doneTodos)
+        did.push(`- [x] ${String(t.title)}`);
+    out.push(...(did.length > 0 ? did : ['Nothing recorded in Huly.']));
+    // Today and blockers: reuse my_day (calendar, to-dos, my issues).
+    const day = sections(await myDayText(client, undefined, 5));
+    out.push('', '## Today');
+    for (const key of ['Calendar', 'To-dos', 'My issues']) {
+        const s = day.get(key);
+        if (s != null)
+            out.push(s.replace(/^## /, '### '));
+    }
+    const blocked = await myBlockedIssues(client, me._id);
+    out.push('', '## Blockers', ...(blocked.length > 0 ? blocked : ['None in Huly.']));
+    return out.join('\n');
+});
+/** My open issues that wait for another open issue. */
+async function myBlockedIssues(client, me) {
+    const mineOpen = (await client.findAll(tracker_1.default.class.Issue, { assignee: me })).filter((i) => (i.blockedBy ?? []).length > 0);
+    if (mineOpen.length === 0)
+        return [];
+    const blockerIds = [...new Set(mineOpen.flatMap((i) => i.blockedBy.map((b) => b._id ?? b)))];
+    const [blockers, statuses] = await Promise.all([
+        client.findAll(tracker_1.default.class.Issue, { _id: { $in: blockerIds } }),
+        client.findAll('core:class:Status', {})
+    ]);
+    const closed = new Set(statuses.filter((s) => s.category === task_1.default.statusCategory.Won || s.category === task_1.default.statusCategory.Lost).map((s) => s._id));
+    const out = [];
+    for (const i of mineOpen) {
+        if (closed.has(i.status))
+            continue;
+        const open = i.blockedBy.map((b) => blockers.find((x) => x._id === (b._id ?? b))).filter((b) => b != null && !closed.has(b.status));
+        if (open.length > 0)
+            out.push(`- **${String(i.identifier)}** ${String(i.title)} — waits for ${open.map((b) => `${String(b.identifier)}`).join(', ')}`);
+    }
+    return out;
+}
+// ── Inbox triage: per unread object, what happened since I last looked ──
+/** One-line plain text of a comment: no HTML (bot comments), no entities, collapsed whitespace. */
+const plain = (markup) => (0, format_1.markupToText)(markup).replace(/<[^>]+>/g, ' ').replace(/&nbsp;|&#160;/g, ' ').replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&amp;/g, '&').replace(/\s+/g, ' ').trim();
+exports.plain = plain;
+exports.triageInbox = (0, errors_1.wrapToolHandler)(async (args) => {
+    const client = await (0, connection_1.getConnection)(args.workspace);
+    const uuid = await (0, people_1.currentAccountUuid)(client);
+    const limit = args.limit ?? 10;
+    const unread = await client.findAll(classes_1.C.InboxNotification, { user: uuid, isViewed: false, archived: false }, { sort: { createdOn: core_1.SortingOrder.Descending }, limit: 500 });
+    if (unread.length === 0)
+        return 'Inbox zero — nothing unread.';
+    const groups = new Map();
+    for (const n of unread)
+        groups.set(n.docNotifyContext, [...(groups.get(n.docNotifyContext) ?? []), n]);
+    const ctxIds = [...groups.keys()].slice(0, limit);
+    const ctxs = await client.findAll(classes_1.C.DocNotifyContext, { _id: { $in: ctxIds } });
+    const statuses = new Map((await client.findAll('core:class:Status', {})).map((s) => [s._id, s.name]));
+    const names = await (0, people_1.peopleNames)(client);
+    const out = [`# Inbox triage — ${unread.length}${unread.length === 500 ? '+' : ''} unread on ${groups.size} item(s)${groups.size > limit ? `, newest ${limit} shown` : ''}`];
+    for (const ctxId of ctxIds) {
+        const notes = groups.get(ctxId);
+        const ctx = ctxs.find((c) => c._id === ctxId);
+        const objectId = ctx?.objectId ?? notes[0].objectId;
+        const objectClass = ctx?.objectClass ?? notes[0].objectClass;
+        // Since I last looked: the context's lastViewedTimestamp, else just before the oldest unread.
+        const since = ctx?.lastViewedTimestamp ?? Math.min(...notes.map((n) => n.createdOn ?? Date.now())) - 1;
+        const [doc, found] = await Promise.all([
+            objectClass != null ? client.findOne(objectClass, { _id: objectId }) : undefined,
+            client.findAll(classes_1.C.ActivityMessage, { attachedTo: objectId, createdOn: { $gt: since } }, { sort: { createdOn: core_1.SortingOrder.Descending }, limit: 50 })
+        ]);
+        const msgs = found.filter((m) => (m.createdOn ?? 0) > since).sort((a, b) => (b.createdOn ?? 0) - (a.createdOn ?? 0));
+        const label = objectClass != null ? await (0, resolve_1.loadLabel)(client, objectClass, objectId) : '(unknown)';
+        const state = doc?.status != null ? ` — ${String(statuses.get(doc.status) ?? '?')}${doc.assignee != null ? ` · ${names.get(doc.assignee) ?? '?'}` : ''}` : '';
+        out.push('', `## ${label}${state} (${notes.length} unread)`);
+        const who = await (0, people_1.socialIdNames)(client, [...new Set(msgs.map((m) => m.createdBy).filter((x) => x != null))]);
+        // Only real comments (ChatMessage and derived); activity-info messages carry a label id as "message".
+        const h = client.getHierarchy();
+        const comments = msgs.filter((m) => typeof m.message === 'string' && (m._class === 'chunter:class:ChatMessage' || h.isDerived(m._class, 'chunter:class:ChatMessage')));
+        const fields = [...new Set(msgs.filter((m) => m._class === classes_1.C.DocUpdateMessage).map((m) => m.action === 'create' ? 'created' : m.attributeUpdates?.attrKey === 'attachedTo' ? 'parent' : m.attributeUpdates?.attrKey).filter((k) => k != null && !['rank', 'subIssues', 'comments', 'modifiedOn'].includes(k)))];
+        if (fields.length > 0)
+            out.push(`- changed: ${fields.join(', ')}`);
+        for (const m of comments.slice(0, 3).reverse())
+            out.push(`- 💬 **${who.get(m.createdBy) ?? '?'}**: ${(0, format_1.clip)((0, exports.plain)(m.message), 200, 'list_comments')}`);
+        if (comments.length > 3)
+            out.push(`- _${comments.length - 3} older new comment(s)_`);
+        if (fields.length === 0 && comments.length === 0)
+            out.push('- (no details recorded)');
+    }
+    out.push('', '_Done with an item? mark_notifications_read with its id (e.g. PROJ-12)._');
+    return out.join('\n');
+});
+// ── Release notes from a milestone ──
+const FIX = /\b(bug|fix|fixes|fixed|hotfix|regression|crash|security|fehler|bugfix|absturz|stürzt|behoben|reparier\w*|sicherheit)\b/i;
+exports.releaseNotes = (0, errors_1.wrapToolHandler)(async (args) => {
+    const client = await (0, connection_1.getConnection)(args.workspace);
+    const project = await client.findOne(tracker_1.default.class.Project, { identifier: args.projectIdentifier });
+    if (project == null)
+        throw new Error(`Project '${args.projectIdentifier}' not found.`);
+    const milestones = await client.findAll(tracker_1.default.class.Milestone, { space: project._id });
+    const ms = milestones.find((m) => String(m.label).toLowerCase() === args.milestoneLabel.trim().toLowerCase());
+    if (ms == null)
+        throw new Error(`Milestone '${args.milestoneLabel}' not found. Milestones: ${milestones.map((m) => m.label).join(', ') || 'none'}.`);
+    const all = await client.findAll(tracker_1.default.class.Issue, { space: project._id, milestone: ms._id });
+    const issues = all.filter((i) => i._class !== classes_1.C.PullRequest);
+    const ids = issues.map((i) => i._id);
+    const [statuses, labels, prs] = await Promise.all([
+        client.findAll('core:class:Status', {}),
+        ids.length > 0 ? client.findAll('tags:class:TagReference', { attachedTo: { $in: ids } }) : [],
+        ids.length > 0 ? client.findAll(classes_1.C.PullRequest, { attachedTo: { $in: ids } }) : []
+    ]);
+    const cat = new Map(statuses.map((s) => [s._id, s.category]));
+    // Epics (issues with sub-issues) are containers; their children are listed instead.
+    const done = issues.filter((i) => cat.get(i.status) === task_1.default.statusCategory.Won && (i.subIssues ?? 0) === 0);
+    const open = issues.filter((i) => cat.get(i.status) !== task_1.default.statusCategory.Won && cat.get(i.status) !== task_1.default.statusCategory.Lost);
+    const isFix = (i) => FIX.test(String(i.title)) || labels.some((l) => l.attachedTo === i._id && FIX.test(String(l.title)));
+    const pr = (i) => {
+        const nums = prs.filter((p) => p.attachedTo === i._id && p.state === 2).map((p) => `#${String(p['github:mixin:GithubIssue']?.githubNumber ?? p.identifier)}`);
+        return nums.length > 0 ? ` (${nums.join(', ')})` : '';
+    };
+    const line = (i) => `- ${String(i.title)} — ${String(i.identifier)}${pr(i)}`;
+    const out = [`# ${String(ms.label)}${ms.targetDate != null ? ` — ${day(ms.targetDate)}` : ''}`];
+    const features = done.filter((i) => !isFix(i));
+    const fixes = done.filter(isFix);
+    if (features.length > 0)
+        out.push('', '## New and changed', ...features.map(line));
+    if (fixes.length > 0)
+        out.push('', '## Fixes', ...fixes.map(line));
+    if (done.length === 0)
+        out.push('', 'Nothing done in this milestone yet.');
+    if (open.length > 0)
+        out.push('', `## Still open (${open.length}) — not part of the notes`, ...open.slice(0, 15).map((i) => `- ${String(i.identifier)} ${String(i.title)}`));
+    return out.join('\n');
+});
+//# sourceMappingURL=overview.js.map