@ttctl/cli 0.0.0 → 0.1.0-rc.1

package/dist/commands/contracts/index.js

@@ -0,0 +1,198 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import Table from "cli-table3";
+import { Command, Option } from "commander";
+import { contracts } from "@ttctl/core";
+import { wrapListEnvelope } from "../../lib/envelopes.js";
+import { handleDomainError } from "../../lib/error-routing.js";
+import { emitResult } from "../../lib/output.js";
+import { OUTPUT_FORMATS } from "../../lib/output.js";
+import { loadAuthTokenOrExit } from "../profile/shared.js";
+/**
+ * Build the `ttctl contracts` command tree (#195). Two read-only leaves:
+ *
+ * | Leaf                          | Description                                |
+ * |-------------------------------|--------------------------------------------|
+ * | `list`                        | List talent-level contracts                |
+ * | `show <id>`                   | Show one contract by id                    |
+ *
+ * `<id>` is the `Contract.id` from the `list` output.
+ *
+ * **Domain distinction**: this group surfaces *talent-level legal
+ * documents* (Toptal Direct, Master Service Agreement) reachable via
+ * `viewer.contracts` on the portal surface. Engagement-attached
+ * commercial agreements (rates, hours, period for one project) live on
+ * a different surface — use `ttctl engagements show <engagement-id>`.
+ *
+ * **Out of scope for v1** (per issue #195):
+ *
+ *   - Contract negotiation / mutation (read-only group).
+ *   - Document download (no API surface exposes a PDF URL today).
+ */
+export function buildContractsCommand() {
+    const cmd = new Command("contracts").description("Manage talent-level contracts (Toptal Direct, MSA, etc.).\n\n" +
+        "For engagement-attached agreements (rates, hours, period for a specific project), see: `ttctl engagements show <id>`");
+    cmd
+        .command("list")
+        .description("List talent-level contracts (Toptal Direct, MSA, etc.)")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (options) => {
+        await runContractsList(options.output);
+    });
+    cmd
+        .command("show")
+        .description("Show one contract by id.\n\n" +
+        "Printed fields: id, kind, provider, status, billingType, signedAt, sentAt, isActive, verificationDeadline, title.")
+        .argument("<id>", "contract id (the row id from `contracts list`)")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (id, options) => {
+        await runContractsShow(id, options.output);
+    });
+    return cmd;
+}
+/**
+ * Action handler for `ttctl contracts list`. Returns the contracts in
+ * the v1.0 list envelope on `--json` / `--yaml`; renders a
+ * `cli-table3` table on `--output=pretty`. An empty list is a
+ * legitimate return value.
+ */
+export async function runContractsList(output) {
+    const token = await loadAuthTokenOrExit("contracts list", output);
+    let items;
+    try {
+        items = await contracts.list(token);
+    }
+    catch (err) {
+        handleContractsError("contracts list", err, output);
+    }
+    emitResult(wrapListEnvelope(items), output, {
+        pretty: (data) => formatContractsTable(data.items),
+        table: (data) => formatContractsTable(data.items),
+        empty: { command: "contracts.list" },
+    });
+}
+/**
+ * Action handler for `ttctl contracts show <id>`. Returns the bare
+ * `Contract` detail shape on `--json` / `--yaml`; renders a
+ * multi-line key:value layout on `--output=pretty`.
+ */
+export async function runContractsShow(id, output) {
+    const token = await loadAuthTokenOrExit("contracts show", output);
+    let item;
+    try {
+        item = await contracts.show(token, id);
+    }
+    catch (err) {
+        handleContractsError("contracts show", err, output);
+    }
+    emitResult(item, output, {
+        pretty: (data) => formatContractDetail(data),
+    });
+}
+/**
+ * Render the contracts list as a `cli-table3` table. Columns: id,
+ * kind, provider, status, signedAt, active. `title` is intentionally
+ * NOT a column (often long and redundant with kind/provider) — it
+ * surfaces in `show <id>` and in `--json`/`--yaml`.
+ */
+export function formatContractsTable(items, terminalWidth = process.stdout.columns || 100) {
+    if (items.length === 0) {
+        const empty = new Table({ head: ["id", "kind", "provider", "status", "signed", "active"] });
+        return empty.toString();
+    }
+    const idWidth = 22;
+    const kindWidth = 22;
+    const statusWidth = 12;
+    const signedWidth = 12;
+    const activeWidth = 8;
+    // 6 columns × 2 padding + 7 borders ≈ 19
+    const remaining = Math.max(15, terminalWidth - idWidth - kindWidth - statusWidth - signedWidth - activeWidth - 19);
+    const providerWidth = Math.max(12, remaining);
+    const table = new Table({
+        head: ["id", "kind", "provider", "status", "signed", "active"],
+        colWidths: [idWidth, kindWidth, providerWidth, statusWidth, signedWidth, activeWidth],
+        colAligns: ["left", "left", "left", "left", "left", "center"],
+        wordWrap: true,
+    });
+    for (const c of items) {
+        table.push([
+            c.id,
+            c.kind ?? "—",
+            c.provider ?? "—",
+            c.status ?? "—",
+            formatDate(c.signedAt),
+            activeMarker(c.isActive),
+        ]);
+    }
+    return table.toString();
+}
+/**
+ * Render a single contract as a sectioned multi-line block. Pure
+ * — directly unit-testable.
+ */
+export function formatContractDetail(c) {
+    const lines = [];
+    lines.push(`Contract ${c.id}`);
+    if (c.title !== null)
+        lines.push(`  Title: ${c.title}`);
+    if (c.kind !== null)
+        lines.push(`  Kind: ${c.kind}`);
+    if (c.provider !== null)
+        lines.push(`  Provider: ${c.provider}`);
+    if (c.status !== null)
+        lines.push(`  Status: ${c.status}`);
+    if (c.billingType !== null)
+        lines.push(`  Billing type: ${c.billingType}`);
+    if (c.isActive !== null)
+        lines.push(`  Active: ${c.isActive ? "yes" : "no"}`);
+    if (c.sentAt !== null)
+        lines.push(`  Sent at: ${c.sentAt}`);
+    if (c.signedAt !== null)
+        lines.push(`  Signed at: ${c.signedAt}`);
+    if (c.verificationDeadline !== null)
+        lines.push(`  Verification deadline: ${c.verificationDeadline}`);
+    return lines.join("\n");
+}
+/**
+ * Trim an ISO 8601 timestamp to its `YYYY-MM-DD` prefix for table
+ * rendering. Returns the input unchanged when it doesn't start with a
+ * date.
+ */
+export function formatDate(value) {
+    if (value === null || value === "")
+        return "—";
+    if (/^\d{4}-\d{2}-\d{2}/.test(value))
+        return value.slice(0, 10);
+    return value;
+}
+/**
+ * Map `isActive` to a compact table-cell marker: `★` for active,
+ * empty for inactive, `?` for null (forward-compat).
+ */
+export function activeMarker(isActive) {
+    if (isActive === null)
+        return "?";
+    return isActive ? "★" : "";
+}
+/**
+ * Thin wrapper around the shared CLI error router (#330) closed over
+ * `contracts.ContractsError` and {@link hintForContractsCode}. The
+ * router applies the envelope ABI (#128) branching uniformly across
+ * sub-domains.
+ */
+export function handleContractsError(commandLabel, err, format = "pretty") {
+    handleDomainError(commandLabel, err, contracts.ContractsError, format, hintForContractsCode);
+}
+function hintForContractsCode(code) {
+    switch (code) {
+        case "NOT_FOUND":
+            return "Verify the contract id (use `ttctl contracts list` to discover ids).";
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,81 @@
+import { engagements } from "@ttctl/core";
+import type { OutputFormat } from "../../lib/output.js";
+/**
+ * Action handler for `ttctl engagements breaks list <id>`. Lists
+ * scheduled breaks on a single engagement (by `jobActivityItem.id` —
+ * matches the row id from `engagements list`).
+ *
+ * Reuses the captured `EngagementBreaks` operation. Returns the
+ * breaks array wrapped in the v0.4 list envelope.
+ */
+export declare function runEngagementsBreaksList(id: string, output: OutputFormat): Promise<void>;
+/**
+ * Action handler for `ttctl engagements breaks add <id> --from <date>
+ * --to <date> [--reason-id <id>] [--comment <text>]`. Schedules a new
+ * break window. Internal flow:
+ *   1. resolve `engagement.id` from `jobActivityItem.id` (one query)
+ *   2. issue `CreateEngagementBreak` mutation
+ *
+ * Returns the new break wrapped in the success-add envelope.
+ */
+export interface EngagementsBreaksAddOptions {
+    from: string;
+    to: string;
+    reasonId: string;
+    comment?: string;
+    output: OutputFormat;
+}
+export declare function runEngagementsBreaksAdd(id: string, opts: EngagementsBreaksAddOptions): Promise<void>;
+/**
+ * Action handler for `ttctl engagements breaks remove <break-id>`.
+ * Cancels a previously-scheduled break by `engagementBreak.id` (the
+ * id returned by `breaks list`).
+ *
+ * Returns the cancelled break id wrapped in the success-remove
+ * envelope.
+ */
+export declare function runEngagementsBreaksRemove(breakId: string, output: OutputFormat): Promise<void>;
+/**
+ * Action handler for `ttctl engagements breaks reschedule <break-id>
+ * --from <date> --to <date>` (#155). Moves an existing break to a new
+ * date window. The break's `comment` and `reasonIdentifier` are
+ * preserved server-side — the wire mutation
+ * (`RescheduleEngagementBreak`) only carries `startDate` + `endDate`.
+ *
+ * Uses `emitUpdateSuccess` (envelope `updated: ...`) because the
+ * reschedule modifies an existing record; neither `created` nor
+ * `removed` would carry the right semantics.
+ */
+export interface EngagementsBreaksRescheduleOptions {
+    from: string;
+    to: string;
+    output: OutputFormat;
+}
+export declare function runEngagementsBreaksReschedule(breakId: string, opts: EngagementsBreaksRescheduleOptions): Promise<void>;
+/**
+ * Action handler for `ttctl engagements breaks reasons list`. Lists
+ * the server-side catalog of valid `--reason-id` values for
+ * `breaks add` (issue #156).
+ *
+ * Reads `platformConfiguration.engagementBreakReasons` via a hand-
+ * authored `PlatformConfiguration` query (NOT in `codegen.config.ts`
+ * — see core service for the trigger note). Output goes through the
+ * v0.4 list envelope on json/yaml.
+ */
+export declare function runEngagementsBreaksReasonsList(output: OutputFormat): Promise<void>;
+/**
+ * Render the breaks-reasons catalog as a `cli-table3` table. Columns:
+ * id, label. Pure — directly unit-testable.
+ */
+export declare function formatReasonsTable(items: engagements.EngagementBreakReason[], terminalWidth?: number): string;
+/**
+ * Render the breaks list as a `cli-table3` table. Columns: id,
+ * starts, ends, comment.
+ */
+export declare function formatBreaksTable(items: engagements.EngagementBreak[], terminalWidth?: number): string;
+/**
+ * Render a single break as a multi-line key:value entity. Used inside
+ * the success-add envelope's `prettyEntity` slot.
+ */
+export declare function formatBreakEntity(br: engagements.EngagementBreak): string;
+//# sourceMappingURL=breaks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"breaks.d.ts","sourceRoot":"","sources":["../../../src/commands/engagements/breaks.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAW1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAqBxD;;;;;;;GAOG;AACH,wBAAsB,wBAAwB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAe9F;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,wBAAsB,uBAAuB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,CAoC1G;AAED;;;;;;;GAOG;AACH,wBAAsB,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BrG;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,kCAAkC;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,kCAAkC,GACvC,OAAO,CAAC,IAAI,CAAC,CAiCf;AAED;;;;;;;;;GASG;AACH,wBAAsB,+BAA+B,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAezF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,CAAC,qBAAqB,EAAE,EAC1C,aAAa,GAAE,MAAsC,GACpD,MAAM,CAmBR;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,WAAW,CAAC,eAAe,EAAE,EACpC,aAAa,GAAE,MAAsC,GACpD,MAAM,CAkBR;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,WAAW,CAAC,eAAe,GAAG,MAAM,CASzE"}

package/dist/commands/engagements/breaks.js

@@ -0,0 +1,229 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import Table from "cli-table3";
+import { engagements } from "@ttctl/core";
+import { getCliDryRun } from "../../lib/dry-run.js";
+import { emitAddSuccess, emitDryRunSuccess, emitRemoveSuccess, emitUpdateSuccess, wrapListEnvelope, } from "../../lib/envelopes.js";
+import { emitResult } from "../../lib/output.js";
+import { formatDate } from "./list.js";
+import { handleEngagementsError, loadAuthTokenOrExit } from "./shared.js";
+/**
+ * Notice text emitted on the dry-run envelope for `breaks.add`. The
+ * mutation's apply path resolves the underlying `engagement.id` via a
+ * separate `EngagementBreaks` query (one extra round-trip) before
+ * issuing `CreateEngagementBreak`. The dry-run path SKIPS that
+ * prefetch entirely (per the AC's "no GraphQL request is sent"
+ * requirement), so the preview's `variables.engagementId` carries the
+ * caller-supplied `jobActivityItemId` as a placeholder — the real
+ * `engagement.id` would be resolved at apply time.
+ *
+ * Surfaced as the `notice` field on the dry-run envelope so consumers
+ * (CLI users reading `pretty` output AND machine consumers parsing
+ * `json` / `yaml`) see the caveat without ambiguity.
+ */
+const ADD_BREAK_DRY_RUN_NOTICE = "engagementId in the preview is a placeholder (the caller's jobActivityItem.id); the apply path resolves the real engagement.id via an EngagementBreaks query before issuing the mutation — this read is skipped on dry-run.";
+/**
+ * Action handler for `ttctl engagements breaks list <id>`. Lists
+ * scheduled breaks on a single engagement (by `jobActivityItem.id` —
+ * matches the row id from `engagements list`).
+ *
+ * Reuses the captured `EngagementBreaks` operation. Returns the
+ * breaks array wrapped in the v0.4 list envelope.
+ */
+export async function runEngagementsBreaksList(id, output) {
+    const token = await loadAuthTokenOrExit("engagements breaks list", output);
+    let items;
+    try {
+        items = await engagements.breaks.list(token, id);
+    }
+    catch (err) {
+        handleEngagementsError("engagements breaks list", err, output);
+    }
+    emitResult(wrapListEnvelope(items), output, {
+        pretty: (data) => formatBreaksTable(data.items),
+        table: (data) => formatBreaksTable(data.items),
+        empty: { command: "engagements.breaks.list" },
+    });
+}
+export async function runEngagementsBreaksAdd(id, opts) {
+    const token = await loadAuthTokenOrExit("engagements breaks add", opts.output);
+    const dryRun = getCliDryRun();
+    const addOpts = {
+        startDate: opts.from,
+        endDate: opts.to,
+        reasonIdentifier: opts.reasonId,
+    };
+    if (opts.comment !== undefined)
+        addOpts.comment = opts.comment;
+    let outcome;
+    try {
+        outcome = await engagements.breaks.add(token, id, addOpts, { dryRun });
+    }
+    catch (err) {
+        handleEngagementsError("engagements breaks add", err, opts.output);
+    }
+    if (outcome.kind === "preview") {
+        emitDryRunSuccess({
+            operation: "engagements.breaks.add",
+            format: opts.output,
+            preview: outcome.preview,
+            notice: ADD_BREAK_DRY_RUN_NOTICE,
+        });
+        return;
+    }
+    const { result: created } = outcome;
+    emitAddSuccess({
+        operation: "engagements.breaks.add",
+        format: opts.output,
+        created,
+        prettySummary: `engagement break ${created.id} (${formatDate(created.startDate)} → ${formatDate(created.endDate)})`,
+        prettyEntity: (br) => formatBreakEntity(br),
+    });
+}
+/**
+ * Action handler for `ttctl engagements breaks remove <break-id>`.
+ * Cancels a previously-scheduled break by `engagementBreak.id` (the
+ * id returned by `breaks list`).
+ *
+ * Returns the cancelled break id wrapped in the success-remove
+ * envelope.
+ */
+export async function runEngagementsBreaksRemove(breakId, output) {
+    const token = await loadAuthTokenOrExit("engagements breaks remove", output);
+    const dryRun = getCliDryRun();
+    let outcome;
+    try {
+        outcome = await engagements.breaks.remove(token, breakId, { dryRun });
+    }
+    catch (err) {
+        handleEngagementsError("engagements breaks remove", err, output);
+    }
+    if (outcome.kind === "preview") {
+        emitDryRunSuccess({
+            operation: "engagements.breaks.remove",
+            format: output,
+            preview: outcome.preview,
+        });
+        return;
+    }
+    emitRemoveSuccess({
+        operation: "engagements.breaks.remove",
+        format: output,
+        id: breakId,
+        prettySummary: `engagement break ${breakId}`,
+    });
+}
+export async function runEngagementsBreaksReschedule(breakId, opts) {
+    const token = await loadAuthTokenOrExit("engagements breaks reschedule", opts.output);
+    const dryRun = getCliDryRun();
+    let outcome;
+    try {
+        outcome = await engagements.breaks.reschedule(token, breakId, { startDate: opts.from, endDate: opts.to }, { dryRun });
+    }
+    catch (err) {
+        handleEngagementsError("engagements breaks reschedule", err, opts.output);
+    }
+    if (outcome.kind === "preview") {
+        emitDryRunSuccess({
+            operation: "engagements.breaks.reschedule",
+            format: opts.output,
+            preview: outcome.preview,
+        });
+        return;
+    }
+    const { result: updated } = outcome;
+    emitUpdateSuccess({
+        operation: "engagements.breaks.reschedule",
+        format: opts.output,
+        updated,
+        prettySummary: `engagement break ${updated.id} (${formatDate(updated.startDate)} → ${formatDate(updated.endDate)})`,
+        prettyEntity: (br) => formatBreakEntity(br),
+    });
+}
+/**
+ * Action handler for `ttctl engagements breaks reasons list`. Lists
+ * the server-side catalog of valid `--reason-id` values for
+ * `breaks add` (issue #156).
+ *
+ * Reads `platformConfiguration.engagementBreakReasons` via a hand-
+ * authored `PlatformConfiguration` query (NOT in `codegen.config.ts`
+ * — see core service for the trigger note). Output goes through the
+ * v0.4 list envelope on json/yaml.
+ */
+export async function runEngagementsBreaksReasonsList(output) {
+    const token = await loadAuthTokenOrExit("engagements breaks reasons list", output);
+    let items;
+    try {
+        items = await engagements.breaks.reasonsList(token);
+    }
+    catch (err) {
+        handleEngagementsError("engagements breaks reasons list", err, output);
+    }
+    emitResult(wrapListEnvelope(items), output, {
+        pretty: (data) => formatReasonsTable(data.items),
+        table: (data) => formatReasonsTable(data.items),
+        empty: { command: "engagements.breaks.reasons.list" },
+    });
+}
+/**
+ * Render the breaks-reasons catalog as a `cli-table3` table. Columns:
+ * id, label. Pure — directly unit-testable.
+ */
+export function formatReasonsTable(items, terminalWidth = process.stdout.columns || 100) {
+    if (items.length === 0) {
+        const empty = new Table({ head: ["id", "label"] });
+        return empty.toString();
+    }
+    // Find longest identifier to size the id column; cap so the label
+    // column always has at least 20 visible columns to render.
+    const widestId = items.reduce((max, r) => Math.max(max, r.identifier.length), "id".length);
+    const idWidth = Math.min(Math.max(widestId + 2, 12), 40);
+    const labelWidth = Math.max(20, terminalWidth - idWidth - 8);
+    const table = new Table({
+        head: ["id", "label"],
+        colWidths: [idWidth, labelWidth],
+        wordWrap: true,
+    });
+    for (const r of items) {
+        table.push([r.identifier, r.nameForRole]);
+    }
+    return table.toString();
+}
+/**
+ * Render the breaks list as a `cli-table3` table. Columns: id,
+ * starts, ends, comment.
+ */
+export function formatBreaksTable(items, terminalWidth = process.stdout.columns || 100) {
+    if (items.length === 0) {
+        const empty = new Table({ head: ["id", "starts", "ends", "comment"] });
+        return empty.toString();
+    }
+    const idWidth = 22;
+    const dateWidth = 12;
+    const remaining = Math.max(20, terminalWidth - idWidth - dateWidth - dateWidth - 12);
+    const commentWidth = Math.max(20, remaining);
+    const table = new Table({
+        head: ["id", "starts", "ends", "comment"],
+        colWidths: [idWidth, dateWidth, dateWidth, commentWidth],
+        wordWrap: true,
+    });
+    for (const br of items) {
+        table.push([br.id, formatDate(br.startDate), formatDate(br.endDate), br.comment ?? ""]);
+    }
+    return table.toString();
+}
+/**
+ * Render a single break as a multi-line key:value entity. Used inside
+ * the success-add envelope's `prettyEntity` slot.
+ */
+export function formatBreakEntity(br) {
+    const lines = [];
+    lines.push(`Id: ${br.id}`);
+    lines.push(`Starts: ${formatDate(br.startDate)}`);
+    lines.push(`Ends: ${formatDate(br.endDate)}`);
+    if (br.comment != null && br.comment !== "") {
+        lines.push(`Comment: ${br.comment}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=breaks.js.map

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

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

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

@@ -0,0 +1,29 @@
+import { Command } from "commander";
+/**
+ * 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 declare function buildEngagementsCommand(): Command;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/engagements/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAgC,MAAM,WAAW,CAAC;AAkBlE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,CA4KjD"}