@ttctl/cli 0.0.0 → 0.1.0-rc.2

package/dist/commands/engagements/index.js

@@ -0,0 +1,172 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { Command, InvalidArgumentError, Option } from "commander";
+import { engagements } from "@ttctl/core";
+import { markMutation } from "../../lib/dry-run.js";
+import { OUTPUT_FORMATS } from "../../lib/output.js";
+import { runEngagementsBreaksAdd, runEngagementsBreaksList, runEngagementsBreaksRemove, runEngagementsBreaksReschedule, runEngagementsBreaksReasonsList, } from "./breaks.js";
+import { runEngagementsList } from "./list.js";
+import { runEngagementsShow } from "./show.js";
+import { runEngagementsStats } from "./stats.js";
+/**
+ * Build the `ttctl engagements` command tree (#147, extended by #155).
+ * Seven leaves across the top-level group and one nested sub-group
+ * (`breaks`):
+ *
+ * | Leaf                                              | Description                              |
+ * |---------------------------------------------------|------------------------------------------|
+ * | `list [--status active|past|all]`                 | List engagements (active by default)     |
+ * | `show <id>`                                       | Engagement detail                        |
+ * | `stats`                                           | Per-engagement-status counts             |
+ * | `breaks list <id>`                                | List breaks on an engagement             |
+ * | `breaks add <id> --from <date> --to <date>`       | Schedule a break                         |
+ * | `breaks remove <break-id>`                        | Cancel a break                           |
+ * | `breaks reschedule <break-id> --from <date> --to <date>` | Move an existing break to a new window |
+ *
+ * `<id>` is always the `jobActivityItem.id` (the row id from
+ * `engagements list`); `<break-id>` is the `engagementBreak.id` (from
+ * `breaks list`).
+ *
+ * **Out of scope for v1** (per #147 spec):
+ *   - Engagement creation / acceptance / rejection (lives in
+ *     `applications` group).
+ *   - Allocated-hours management — moved to `availability` (#146)
+ *     after the #147 scope amendment (2026-05-10), since the wire
+ *     mutation operates on `viewerRole`, not per-engagement.
+ */
+export function buildEngagementsCommand() {
+    const cmd = new Command("engagements").description("View current and past engagements; manage engagement breaks");
+    cmd
+        .command("list")
+        .description("List engagements (active by default)")
+        .addOption(new Option("--status <status>", "filter by engagement status")
+        .choices([...engagements.ENGAGEMENT_LIST_STATUSES])
+        .default("active"))
+        .option("--keywords <keyword...>", "free-text keyword filter (repeatable; AND across keywords)")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (options) => {
+        const listOpts = {
+            status: options.status,
+            output: options.output,
+        };
+        if (options.keywords !== undefined)
+            listOpts.keywords = options.keywords;
+        await runEngagementsList(listOpts);
+    });
+    cmd
+        .command("show")
+        .description("Show one engagement by id (jobActivityItem.id)")
+        .argument("<id>", "engagement id (the row id from `engagements list`)", parseIdArg)
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (id, options) => {
+        await runEngagementsShow(id, options.output);
+    });
+    cmd
+        .command("stats")
+        .description("Per-engagement-status counts (issues 2 server calls in parallel)")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (options) => {
+        await runEngagementsStats(options.output);
+    });
+    // ----- Breaks sub-group ------------------------------------------------
+    const breaks = cmd.command("breaks").description("Manage engagement breaks (scheduled time-off windows)");
+    breaks
+        .command("list")
+        .description("List breaks on an engagement")
+        .argument("<id>", "engagement id (the row id from `engagements list`)", parseIdArg)
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (id, options) => {
+        await runEngagementsBreaksList(id, options.output);
+    });
+    // Marked as a mutation (issue #163) so the global `--dry-run` flag
+    // routes through to `engagements.breaks.add()`'s `dryRun` option.
+    markMutation(breaks
+        .command("add")
+        .description("Schedule a new break on an engagement")
+        .argument("<id>", "engagement id (the row id from `engagements list`)", parseIdArg)
+        .requiredOption("--from <date>", "start date (YYYY-MM-DD)")
+        .requiredOption("--to <date>", "end date (YYYY-MM-DD)")
+        .requiredOption("--reason-id <id>", "server-side reason identifier (run `ttctl engagements breaks reasons list` for the live catalog; examples: `talent_on_vacation`, `client_needs_preparation`, `client_on_vacation`, `other`)")
+        .option("--comment <text>", "optional free-text comment")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (id, options) => {
+        const addOpts = {
+            from: options.from,
+            to: options.to,
+            reasonId: options.reasonId,
+            output: options.output,
+        };
+        if (options.comment !== undefined)
+            addOpts.comment = options.comment;
+        await runEngagementsBreaksAdd(id, addOpts);
+    }));
+    // Marked as a mutation (issue #163) so the global `--dry-run` flag
+    // routes through to `engagements.breaks.remove()`'s `dryRun` option.
+    markMutation(breaks
+        .command("remove")
+        .description("Cancel a scheduled break by id")
+        .argument("<break-id>", "engagementBreak id (from `breaks list`)", parseIdArg)
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (breakId, options) => {
+        await runEngagementsBreaksRemove(breakId, options.output);
+    }));
+    // Marked as a mutation (#155 inherits the #163 dry-run wiring) so the
+    // global `--dry-run` flag routes through to
+    // `engagements.breaks.reschedule()`'s `dryRun` option.
+    markMutation(breaks
+        .command("reschedule")
+        .description("Move an existing break to a new date window (in-place; preserves reason and comment)")
+        .argument("<break-id>", "engagementBreak id (from `breaks list`)", parseIdArg)
+        .requiredOption("--from <date>", "new start date (YYYY-MM-DD)")
+        .requiredOption("--to <date>", "new end date (YYYY-MM-DD)")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (breakId, options) => {
+        await runEngagementsBreaksReschedule(breakId, {
+            from: options.from,
+            to: options.to,
+            output: options.output,
+        });
+    }));
+    // ----- Reasons sub-group (issue #156) ----------------------------------
+    // Discovery surface for valid `--reason-id` values. Only read-only,
+    // so no mutation marking needed.
+    const reasons = breaks
+        .command("reasons")
+        .description("Discovery: list the valid `--reason-id` values for `breaks add`");
+    reasons
+        .command("list")
+        .description("List the server-side catalog of valid `breaks add --reason-id` values, sorted by id")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (options) => {
+        await runEngagementsBreaksReasonsList(options.output);
+    });
+    return cmd;
+}
+/**
+ * Reject empty or whitespace-only id arguments at parse time. Mirrors
+ * the applications group's `parseIdArg`.
+ */
+function parseIdArg(value) {
+    const trimmed = value.trim();
+    if (trimmed.length === 0) {
+        throw new InvalidArgumentError("id must not be empty");
+    }
+    return trimmed;
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/engagements/index.js.map

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

package/dist/commands/engagements/list.d.ts

@@ -0,0 +1,49 @@
+import { engagements } from "@ttctl/core";
+import type { OutputFormat } from "../../lib/output.js";
+/**
+ * Action handler for `ttctl engagements list`. Lists the user's
+ * engagements (active by default), filtered to the engagement-bearing
+ * status groups.
+ *
+ * Filters: `--status active|past|all` (default `active`) and
+ * `--keywords` (free-text, repeatable; passed through to the gateway).
+ *
+ * **Pagination not supported** — the captured `JobActivityItems`
+ * operation has no `page` / `pageSize` args. Per #183, pagination
+ * flags are declared PER paginating leaf; this leaf does not declare
+ * `--page` / `--per-page`, so Commander emits its standard
+ * `error: unknown option '--page'` (exit 1) when a user passes
+ * either flag. If the wire ever gains pagination args, declare the
+ * flags on this leaf and extend `engagements.list()` to accept
+ * `{page?, perPage?}`.
+ */
+export interface EngagementsListOptions {
+    status?: engagements.EngagementListStatus;
+    keywords?: string[];
+    output: OutputFormat;
+}
+export declare function runEngagementsList(opts: EngagementsListOptions): Promise<void>;
+/**
+ * Render the engagements list as a `cli-table3` table sized to the
+ * current terminal width. Columns: id, status, client, job title,
+ * starts, hours.
+ *
+ * `client` and `job title` together carry the engagement identity for
+ * the human reader; `starts` (engagement start date) and `hours`
+ * (expected hours per week) are the most diagnostic fields for
+ * day-to-day use.
+ */
+export declare function formatEngagementsTable(items: engagements.EngagementListItem[], terminalWidth?: number): string;
+/**
+ * Shorten the engagement-bearing status group for column display.
+ * Other status groups (which the engagements service shouldn't return,
+ * but defend against) fall through with the full enum value.
+ */
+export declare function shortenEngagementStatus(value: string): string;
+/**
+ * Render an ISO 8601 timestamp or `Date` string as just the date
+ * portion (YYYY-MM-DD) for table compactness. Returns `"—"` for
+ * `null` and the input as-is when it doesn't parse.
+ */
+export declare function formatDate(value: string | null): string;
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/engagements/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/engagements/list.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,WAAW,CAAC,oBAAoB,CAAC;IAC1C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBpF;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,WAAW,CAAC,kBAAkB,EAAE,EACvC,aAAa,GAAE,MAAsC,GACpD,MAAM,CA8BR;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAS7D;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAIvD"}

package/dist/commands/engagements/list.js

@@ -0,0 +1,95 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import Table from "cli-table3";
+import { engagements } from "@ttctl/core";
+import { wrapListEnvelope } from "../../lib/envelopes.js";
+import { emitResult } from "../../lib/output.js";
+import { handleEngagementsError, loadAuthTokenOrExit } from "./shared.js";
+export async function runEngagementsList(opts) {
+    const token = await loadAuthTokenOrExit("engagements list", opts.output);
+    const listOpts = {};
+    if (opts.status !== undefined)
+        listOpts.status = opts.status;
+    if (opts.keywords !== undefined)
+        listOpts.keywords = opts.keywords;
+    let items;
+    try {
+        items = await engagements.list(token, listOpts);
+    }
+    catch (err) {
+        handleEngagementsError("engagements list", err, opts.output);
+    }
+    emitResult(wrapListEnvelope(items), opts.output, {
+        pretty: (data) => formatEngagementsTable(data.items),
+        table: (data) => formatEngagementsTable(data.items),
+        empty: { command: "engagements.list" },
+    });
+}
+/**
+ * Render the engagements list as a `cli-table3` table sized to the
+ * current terminal width. Columns: id, status, client, job title,
+ * starts, hours.
+ *
+ * `client` and `job title` together carry the engagement identity for
+ * the human reader; `starts` (engagement start date) and `hours`
+ * (expected hours per week) are the most diagnostic fields for
+ * day-to-day use.
+ */
+export function formatEngagementsTable(items, terminalWidth = process.stdout.columns || 100) {
+    if (items.length === 0) {
+        const empty = new Table({ head: ["id", "status", "client", "job", "starts", "hours"] });
+        return empty.toString();
+    }
+    const idWidth = 22;
+    const statusWidth = 12;
+    const clientWidth = 18;
+    const startsWidth = 12;
+    const hoursWidth = 7;
+    // 6 columns × 2 padding-char + 7 borders ≈ 19
+    const remaining = Math.max(20, terminalWidth - idWidth - statusWidth - clientWidth - startsWidth - hoursWidth - 19);
+    const titleWidth = Math.max(20, remaining);
+    const table = new Table({
+        head: ["id", "status", "client", "job", "starts", "hours"],
+        colWidths: [idWidth, statusWidth, clientWidth, titleWidth, startsWidth, hoursWidth],
+        colAligns: ["left", "left", "left", "left", "left", "right"],
+        wordWrap: true,
+    });
+    for (const it of items) {
+        table.push([
+            it.id,
+            shortenEngagementStatus(it.statusGroupV2.value),
+            it.job.client?.fullName ?? "(no client)",
+            it.job.title ?? "(untitled)",
+            formatDate(it.startDate),
+            it.expectedHours !== null ? it.expectedHours.toString() : "—",
+        ]);
+    }
+    return table.toString();
+}
+/**
+ * Shorten the engagement-bearing status group for column display.
+ * Other status groups (which the engagements service shouldn't return,
+ * but defend against) fall through with the full enum value.
+ */
+export function shortenEngagementStatus(value) {
+    switch (value) {
+        case "ACTIVE_ENGAGEMENT":
+            return "Active";
+        case "CLOSED_ENGAGEMENT":
+            return "Closed";
+        default:
+            return value;
+    }
+}
+/**
+ * Render an ISO 8601 timestamp or `Date` string as just the date
+ * portion (YYYY-MM-DD) for table compactness. Returns `"—"` for
+ * `null` and the input as-is when it doesn't parse.
+ */
+export function formatDate(value) {
+    if (value === null || value === "")
+        return "—";
+    const m = /^(\d{4}-\d{2}-\d{2})/.exec(value);
+    return m?.[1] ?? value;
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/engagements/list.js.map

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

package/dist/commands/engagements/shared.d.ts

@@ -0,0 +1,10 @@
+import type { OutputFormat } from "../../lib/output.js";
+export { loadAuthTokenOrExit } from "../profile/shared.js";
+/**
+ * Thin wrapper around the shared CLI error router (#330) closed over
+ * `engagements.EngagementsError` and {@link hintForEngagementsCode}.
+ * The router applies the envelope ABI (#128) branching uniformly across
+ * sub-domains.
+ */
+export declare function handleEngagementsError(commandLabel: string, err: unknown, format?: OutputFormat): never;
+//# sourceMappingURL=shared.d.ts.map

package/dist/commands/engagements/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/commands/engagements/shared.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,YAAuB,GAAG,KAAK,CAEjH"}

package/dist/commands/engagements/shared.js

@@ -0,0 +1,31 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { engagements } from "@ttctl/core";
+import { handleDomainError } from "../../lib/error-routing.js";
+export { loadAuthTokenOrExit } from "../profile/shared.js";
+/**
+ * Thin wrapper around the shared CLI error router (#330) closed over
+ * `engagements.EngagementsError` and {@link hintForEngagementsCode}.
+ * The router applies the envelope ABI (#128) branching uniformly across
+ * sub-domains.
+ */
+export function handleEngagementsError(commandLabel, err, format = "pretty") {
+    handleDomainError(commandLabel, err, engagements.EngagementsError, format, hintForEngagementsCode);
+}
+/**
+ * Per-code recovery hints. Not every code carries one — only the ones
+ * where a concrete next step is clearly actionable for the user.
+ */
+function hintForEngagementsCode(code) {
+    switch (code) {
+        case "NOT_FOUND":
+            return "Verify the engagement id (use `ttctl engagements list` to discover it).";
+        case "NO_ENGAGEMENT":
+            return "This activity item is not an engagement (likely an application or interview). Use `ttctl applications show` instead.";
+        case "MUTATION_ERROR":
+            return "The mutation was rejected by the server (often: overlapping break dates or validation). Check the message above.";
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=shared.js.map

package/dist/commands/engagements/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/commands/engagements/shared.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAG/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,YAAoB,EAAE,GAAY,EAAE,SAAuB,QAAQ;IACxG,iBAAiB,CAAC,YAAY,EAAE,GAAG,EAAE,WAAW,CAAC,gBAAgB,EAAE,MAAM,EAAE,sBAAsB,CAAC,CAAC;AACrG,CAAC;AAED;;;GAGG;AACH,SAAS,sBAAsB,CAAC,IAAsC;IACpE,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,WAAW;YACd,OAAO,yEAAyE,CAAC;QACnF,KAAK,eAAe;YAClB,OAAO,sHAAsH,CAAC;QAChI,KAAK,gBAAgB;YACnB,OAAO,kHAAkH,CAAC;QAC5H;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/commands/engagements/show.d.ts

@@ -0,0 +1,19 @@
+import { engagements } from "@ttctl/core";
+import type { OutputFormat } from "../../lib/output.js";
+/**
+ * Action handler for `ttctl engagements show <id>`. Reads a single
+ * engagement detail by `jobActivityItem.id` (the row id from
+ * `engagements list`).
+ *
+ * Pretty rendering is a multi-line key:value layout grouped into
+ * sections (Status, Client/Job, Engagement, Agreement, Earnings,
+ * Breaks). Sections with no data are omitted. `json` / `yaml` always
+ * emit the full server payload.
+ */
+export declare function runEngagementsShow(id: string, output: OutputFormat): Promise<void>;
+/**
+ * Render the engagement detail as a sectioned multi-line block. Pure —
+ * directly unit-testable.
+ */
+export declare function formatEngagementDetail(item: engagements.EngagementDetail): string;
+//# sourceMappingURL=show.d.ts.map

package/dist/commands/engagements/show.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.d.ts","sourceRoot":"","sources":["../../../src/commands/engagements/show.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAaxD;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAaxF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,WAAW,CAAC,gBAAgB,GAAG,MAAM,CAyGjF"}

package/dist/commands/engagements/show.js

@@ -0,0 +1,150 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { engagements } from "@ttctl/core";
+import { emitResult } from "../../lib/output.js";
+import { formatDate } from "./list.js";
+import { handleEngagementsError, loadAuthTokenOrExit } from "./shared.js";
+/**
+ * Toptal's mobile-gateway `Money` type carries only `decimal` + `verbose`
+ * — no currency code. Empirically Toptal pays talents in USD across the
+ * platform, so the pretty formatter labels the earning with this
+ * hardcoded default. JSON / YAML output remains the raw `{decimal}`
+ * shape — currency is a presentation-only assumption, not a wire field.
+ */
+const DEFAULT_CURRENCY = "USD";
+/**
+ * Action handler for `ttctl engagements show <id>`. Reads a single
+ * engagement detail by `jobActivityItem.id` (the row id from
+ * `engagements list`).
+ *
+ * Pretty rendering is a multi-line key:value layout grouped into
+ * sections (Status, Client/Job, Engagement, Agreement, Earnings,
+ * Breaks). Sections with no data are omitted. `json` / `yaml` always
+ * emit the full server payload.
+ */
+export async function runEngagementsShow(id, output) {
+    const token = await loadAuthTokenOrExit("engagements show", output);
+    let item;
+    try {
+        item = await engagements.show(token, id);
+    }
+    catch (err) {
+        handleEngagementsError("engagements show", err, output);
+    }
+    emitResult(item, output, {
+        pretty: (data) => formatEngagementDetail(data),
+    });
+}
+/**
+ * Render the engagement detail as a sectioned multi-line block. Pure —
+ * directly unit-testable.
+ */
+export function formatEngagementDetail(item) {
+    const lines = [];
+    lines.push(`Engagement ${item.id}`);
+    if (item.engagementId !== null) {
+        lines.push(`  Engagement-ID: ${item.engagementId}`);
+    }
+    lines.push(`  Status: ${item.statusV2.verbose} (${item.statusV2.value})`);
+    lines.push(`  Group:  ${item.statusGroupV2.verbose} (${item.statusGroupV2.value})`);
+    lines.push(`  Updated: ${item.lastUpdatedAt}`);
+    lines.push("");
+    lines.push("Job");
+    if (item.job.title !== null)
+        lines.push(`  ${item.job.title}`);
+    if (item.job.url !== null)
+        lines.push(`  ${item.job.url}`);
+    if (item.job.client?.fullName != null) {
+        lines.push(`  Client: ${item.job.client.fullName}`);
+    }
+    if (item.job.commitment?.slug != null) {
+        lines.push(`  Commitment: ${item.job.commitment.slug}`);
+    }
+    if (item.job.workType?.slug != null) {
+        lines.push(`  Work type: ${item.job.workType.slug}`);
+    }
+    if (item.job.specialization?.title != null) {
+        lines.push(`  Specialization: ${item.job.specialization.title}`);
+    }
+    if (item.job.expectedHours !== null) {
+        lines.push(`  Hours: ${item.job.expectedHours.toString()}`);
+    }
+    if (item.job.startDate !== null) {
+        lines.push(`  Starts: ${item.job.startDate}`);
+    }
+    if (item.job.isCoaching === true) {
+        lines.push(`  Type: coaching`);
+    }
+    if (item.job.isToptalProject === true) {
+        lines.push(`  Type: toptal-project`);
+    }
+    if (item.job.descriptionMd !== null && item.job.descriptionMd !== "") {
+        lines.push(`  Description:`);
+        for (const para of item.job.descriptionMd.split(/\n+/)) {
+            if (para.trim().length > 0)
+                lines.push(`    ${para}`);
+        }
+    }
+    lines.push("");
+    lines.push("Engagement");
+    if (item.startDate !== null)
+        lines.push(`  Started: ${item.startDate}`);
+    if (item.endDate !== null)
+        lines.push(`  Ended: ${item.endDate}`);
+    if (item.commitment?.slug != null)
+        lines.push(`  Commitment: ${item.commitment.slug}`);
+    if (item.expectedHours !== null)
+        lines.push(`  Hours/week: ${item.expectedHours.toString()}`);
+    if (item.billCycle?.verbose != null)
+        lines.push(`  Bill cycle: ${item.billCycle.verbose}`);
+    if (item.eligibleForPayment !== null)
+        lines.push(`  Eligible for payment: ${String(item.eligibleForPayment)}`);
+    if (item.eligibleToViewTimesheets !== null) {
+        lines.push(`  Timesheets enabled: ${String(item.eligibleToViewTimesheets)}`);
+    }
+    if (item.eligibleToViewTimeOffs !== null) {
+        lines.push(`  Time-offs enabled: ${String(item.eligibleToViewTimeOffs)}`);
+    }
+    if (item.proposedEnd?.endDate != null) {
+        lines.push(`  Proposed end: ${item.proposedEnd.endDate} (${item.proposedEnd.status ?? "—"})`);
+    }
+    if (item.currentAgreement !== null) {
+        lines.push("");
+        lines.push("Agreement");
+        if (item.currentAgreement.applicationRate !== null) {
+            lines.push(`  Application rate: ${item.currentAgreement.applicationRate}`);
+        }
+        if (item.currentAgreement.talentHourlyRate !== null) {
+            lines.push(`  Hourly rate: ${item.currentAgreement.talentHourlyRate}`);
+        }
+        if (item.currentAgreement.talentRate !== null) {
+            lines.push(`  Talent rate: ${item.currentAgreement.talentRate}`);
+        }
+        if (item.currentAgreement.marketplaceMargin !== null) {
+            lines.push(`  Marketplace margin: ${item.currentAgreement.marketplaceMargin}`);
+        }
+        if (item.currentAgreement.timePeriod !== null) {
+            lines.push(`  Time period: ${item.currentAgreement.timePeriod}`);
+        }
+        if (item.currentAgreement.commitment?.slug != null) {
+            lines.push(`  Commitment: ${item.currentAgreement.commitment.slug}`);
+        }
+    }
+    if (item.earning?.paid != null) {
+        lines.push("");
+        lines.push("Earnings");
+        const decimal = item.earning.paid.decimal;
+        lines.push(`  Paid: ${decimal} ${DEFAULT_CURRENCY}`);
+    }
+    if (item.breaks.length > 0) {
+        lines.push("");
+        lines.push(`Breaks (${item.breaks.length.toString()})`);
+        for (const br of item.breaks) {
+            const range = `${formatDate(br.startDate)} → ${formatDate(br.endDate)}`;
+            const comment = br.comment != null && br.comment !== "" ? ` — ${br.comment}` : "";
+            lines.push(`  ${br.id}: ${range}${comment}`);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=show.js.map

package/dist/commands/engagements/show.js.map

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

package/dist/commands/engagements/stats.d.ts

@@ -0,0 +1,24 @@
+import { engagements } from "@ttctl/core";
+import type { OutputFormat } from "../../lib/output.js";
+/**
+ * Action handler for `ttctl engagements stats`. Issues 2 calls (one
+ * per engagement-status-group) in parallel via the core service,
+ * surfaces a `{ total, groups: [{name, count}] }` shape.
+ *
+ * Each `count` is server-provided (`totalCount`); no client-side
+ * synthesis. The `<group> stats` sub-command absorbs the role of the
+ * top-level `ttctl stats engagements` (per the project's "stats folds
+ * into per-group sub-commands" decision).
+ *
+ * **JSON shape rationale** (mirrors `applications stats`): emits a
+ * BARE `{total, groups}` payload, NOT the v0.4 list envelope. `stats`
+ * is an aggregate scalar grouping; the envelope is for collection
+ * payloads.
+ */
+export declare function runEngagementsStats(output: OutputFormat): Promise<void>;
+/**
+ * Render the stats payload as a small table plus a total line. Pure —
+ * directly unit-testable.
+ */
+export declare function formatStatsPretty(stats: engagements.EngagementsStats): string;
+//# sourceMappingURL=stats.d.ts.map

package/dist/commands/engagements/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../../src/commands/engagements/stats.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAIxD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAa7E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,CAAC,gBAAgB,GAAG,MAAM,CAU7E"}