@ttctl/cli 0.0.0 → 0.1.0-rc.1

package/dist/commands/availability/index.js

@@ -0,0 +1,124 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { Command, InvalidArgumentError, Option } from "commander";
+import { markMutation } from "../../lib/dry-run.js";
+import { OUTPUT_FORMATS } from "../../lib/output.js";
+import { runAllocatedHoursSet, runAllocatedHoursShow } from "./allocated-hours.js";
+import { runAvailabilityShow } from "./show.js";
+import { runWorkingHoursSet, runWorkingHoursShow } from "./working-hours.js";
+/**
+ * Build the `ttctl availability` command tree (#146 amended spec). Five
+ * leaves across the top-level group and two nested sub-groups
+ * (`working-hours`, `allocated-hours`):
+ *
+ * | Leaf                                | Description                              |
+ * |-------------------------------------|------------------------------------------|
+ * | `show`                              | Full availability snapshot               |
+ * | `working-hours show`                | Just the time-zone + daily window subset |
+ * | `working-hours set [--start/--end/--time-zone/--flex-start/--flex-end]` | Partial-update working hours |
+ * | `allocated-hours show`              | Just the allocated-hours value           |
+ * | `allocated-hours set --hours <n>`   | Set allocated-hours                      |
+ *
+ * **Vocabulary note**: per-engagement "time off" is owned by
+ * `ttctl engagements breaks {list, add, remove}` — there is no parallel
+ * `ttctl availability time-off` surface (the underlying API would be
+ * identical to the engagement-break one). Booking-page "lead time" /
+ * "minimum scheduling notice" is a different surface and is not
+ * surfaced in v1.
+ *
+ * **Out of scope for v1** (per #146 amended spec from 2026-05-11):
+ *   - Time-off list/add/remove (use `engagements breaks` instead)
+ *   - Lead-time / minimum-scheduling-notice setting (booking-page
+ *     follow-up)
+ *   - Setting `meetingTimeFrom` / `meetingTimeTo` (read-only)
+ *   - Per-engagement availability overrides (no API support)
+ */
+export function buildAvailabilityCommand() {
+    const cmd = new Command("availability").description("View and manage availability: time zone, working hours, allocated hours");
+    cmd
+        .command("show")
+        .description("Show full availability snapshot")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (options) => {
+        await runAvailabilityShow(options.output);
+    });
+    // ----- working-hours sub-group ---------------------------------------
+    const workingHours = cmd
+        .command("working-hours")
+        .description("Manage daily working hours, time zone, and flexible shift range");
+    workingHours
+        .command("show")
+        .description("Show the working-hours subset")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (options) => {
+        await runWorkingHoursShow(options.output);
+    });
+    // Marked as a mutation (issue #164) so the global `--dry-run` flag
+    // routes through to `availability.workingHours.set()`'s `dryRun` option.
+    markMutation(workingHours
+        .command("set")
+        .description("Update working hours (at least one of the options below)")
+        .option("--start <HH:MM:SS>", "daily working-hours window start")
+        .option("--end <HH:MM:SS>", "daily working-hours window end")
+        .option("--time-zone <IANA>", "IANA time-zone identifier (e.g., Europe/Berlin)")
+        .option("--flex-start <HH:MM:SS>", "flexible shift-range start")
+        .option("--flex-end <HH:MM:SS>", "flexible shift-range end")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (options) => {
+        const setOpts = { output: options.output };
+        if (options.start !== undefined)
+            setOpts.start = options.start;
+        if (options.end !== undefined)
+            setOpts.end = options.end;
+        if (options.timeZone !== undefined)
+            setOpts.timeZone = options.timeZone;
+        if (options.flexStart !== undefined)
+            setOpts.flexStart = options.flexStart;
+        if (options.flexEnd !== undefined)
+            setOpts.flexEnd = options.flexEnd;
+        await runWorkingHoursSet(setOpts);
+    }));
+    // ----- allocated-hours sub-group -------------------------------------
+    const allocatedHours = cmd.command("allocated-hours").description("Manage viewer-scoped allocated hours per week");
+    allocatedHours
+        .command("show")
+        .description("Show the current allocated hours")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (options) => {
+        await runAllocatedHoursShow(options.output);
+    });
+    // Marked as a mutation (issue #164) so the global `--dry-run` flag
+    // routes through to `availability.allocatedHours.set()`'s `dryRun` option.
+    markMutation(allocatedHours
+        .command("set")
+        .description("Set allocated hours (non-negative integer; portal caps at 80)")
+        .requiredOption("--hours <n>", "hours per week (non-negative integer)", parseHoursArg)
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (options) => {
+        await runAllocatedHoursSet({ hours: options.hours, output: options.output });
+    }));
+    return cmd;
+}
+/**
+ * Parse a `--hours` argument as a non-negative integer. Rejects
+ * floating-point / negative / non-numeric / empty values at parse time
+ * so the handler receives a validated `number`.
+ */
+function parseHoursArg(value) {
+    const trimmed = value.trim();
+    if (!/^\d+$/.test(trimmed)) {
+        throw new InvalidArgumentError("--hours must be a non-negative integer (no decimals, no sign)");
+    }
+    return Number.parseInt(trimmed, 10);
+}
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,11 @@
+import type { OutputFormat } from "../../lib/output.js";
+export { loadAuthTokenOrExit } from "../profile/shared.js";
+/**
+ * Thin wrapper around the shared CLI error router (#330) closed over
+ * `availability.AvailabilityError` and {@link hintForAvailabilityCode}.
+ * The router applies the envelope ABI (#128) branching uniformly across
+ * sub-domains; the hint adapter is invoked on the domain-error branch
+ * to surface a per-code recovery suggestion when one is available.
+ */
+export declare function handleAvailabilityError(commandLabel: string, err: unknown, format?: OutputFormat): never;
+//# sourceMappingURL=shared.d.ts.map

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

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

package/dist/commands/availability/shared.js

@@ -0,0 +1,30 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { availability } 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
+ * `availability.AvailabilityError` and {@link hintForAvailabilityCode}.
+ * The router applies the envelope ABI (#128) branching uniformly across
+ * sub-domains; the hint adapter is invoked on the domain-error branch
+ * to surface a per-code recovery suggestion when one is available.
+ */
+export function handleAvailabilityError(commandLabel, err, format = "pretty") {
+    handleDomainError(commandLabel, err, availability.AvailabilityError, format, hintForAvailabilityCode);
+}
+/**
+ * Per-code recovery hints. Not every code carries one — only the ones
+ * where a concrete next step is clearly actionable for the user.
+ */
+function hintForAvailabilityCode(code) {
+    switch (code) {
+        case "NO_VIEWER_ROLE":
+            return "Sign in as a Toptal Talent (the availability surface is talent-side).";
+        case "MUTATION_ERROR":
+            return "The mutation was rejected by the server (often: malformed time string, unknown time-zone identifier, or out-of-range allocated hours). Check the message above.";
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=shared.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/commands/availability/shared.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAG/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,YAAoB,EAAE,GAAY,EAAE,SAAuB,QAAQ;IACzG,iBAAiB,CAAC,YAAY,EAAE,GAAG,EAAE,YAAY,CAAC,iBAAiB,EAAE,MAAM,EAAE,uBAAuB,CAAC,CAAC;AACxG,CAAC;AAED;;;GAGG;AACH,SAAS,uBAAuB,CAAC,IAAwC;IACvE,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,gBAAgB;YACnB,OAAO,uEAAuE,CAAC;QACjF,KAAK,gBAAgB;YACnB,OAAO,iKAAiK,CAAC;QAC3K;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,32 @@
+import { availability } from "@ttctl/core";
+import type { OutputFormat } from "../../lib/output.js";
+/**
+ * Action handler for `ttctl availability show`. Reads the full
+ * availability snapshot — time zone, working hours, flexible shift
+ * range, and allocated hours.
+ *
+ * Pretty rendering groups the snapshot into a sectioned multi-line
+ * block. `json` / `yaml` emit the full server payload.
+ *
+ * **What this does NOT show** (out of scope per #146 amended spec):
+ *   - Per-engagement time-off / engagement breaks (see
+ *     `ttctl engagements breaks list <id>`).
+ *   - Booking-page lead-time / "minimum scheduling notice" (different
+ *     surface; follow-up issue).
+ */
+export declare function runAvailabilityShow(output: OutputFormat): Promise<void>;
+/**
+ * Render the full availability snapshot as a sectioned multi-line
+ * block. Pure — directly unit-testable.
+ *
+ * Sections:
+ *   1. Identity (viewer id)
+ *   2. Time zone (name / IANA value / offsets)
+ *   3. Working hours (workingTimeFrom/To)
+ *   4. Flexible shift range (availableShiftRangeFrom/To)
+ *   5. Allocated hours
+ *
+ * Sections whose fields are all null/empty are omitted.
+ */
+export declare function formatAvailabilitySnapshot(snap: availability.AvailabilitySnapshot): string;
+//# sourceMappingURL=show.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"show.d.ts","sourceRoot":"","sources":["../../../src/commands/availability/show.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAa7E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,YAAY,CAAC,oBAAoB,GAAG,MAAM,CAyC1F"}

package/dist/commands/availability/show.js

@@ -0,0 +1,86 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { availability } from "@ttctl/core";
+import { emitResult } from "../../lib/output.js";
+import { handleAvailabilityError, loadAuthTokenOrExit } from "./shared.js";
+/**
+ * Action handler for `ttctl availability show`. Reads the full
+ * availability snapshot — time zone, working hours, flexible shift
+ * range, and allocated hours.
+ *
+ * Pretty rendering groups the snapshot into a sectioned multi-line
+ * block. `json` / `yaml` emit the full server payload.
+ *
+ * **What this does NOT show** (out of scope per #146 amended spec):
+ *   - Per-engagement time-off / engagement breaks (see
+ *     `ttctl engagements breaks list <id>`).
+ *   - Booking-page lead-time / "minimum scheduling notice" (different
+ *     surface; follow-up issue).
+ */
+export async function runAvailabilityShow(output) {
+    const token = await loadAuthTokenOrExit("availability show", output);
+    let snap;
+    try {
+        snap = await availability.show(token);
+    }
+    catch (err) {
+        handleAvailabilityError("availability show", err, output);
+    }
+    emitResult(snap, output, {
+        pretty: (data) => formatAvailabilitySnapshot(data),
+    });
+}
+/**
+ * Render the full availability snapshot as a sectioned multi-line
+ * block. Pure — directly unit-testable.
+ *
+ * Sections:
+ *   1. Identity (viewer id)
+ *   2. Time zone (name / IANA value / offsets)
+ *   3. Working hours (workingTimeFrom/To)
+ *   4. Flexible shift range (availableShiftRangeFrom/To)
+ *   5. Allocated hours
+ *
+ * Sections whose fields are all null/empty are omitted.
+ */
+export function formatAvailabilitySnapshot(snap) {
+    const lines = [];
+    lines.push(`Availability (viewer ${snap.viewerId})`);
+    if (snap.timeZone !== null) {
+        lines.push("");
+        lines.push("Time zone");
+        const tz = snap.timeZone;
+        lines.push(`  IANA: ${tz.value}`);
+        if (tz.name !== null && tz.name !== "")
+            lines.push(`  Name: ${tz.name}`);
+        if (tz.location !== null && tz.location !== "")
+            lines.push(`  Location: ${tz.location}`);
+        if (tz.utcOffset !== null && tz.utcOffset !== "")
+            lines.push(`  UTC offset: ${tz.utcOffset}`);
+        if (tz.stdOffset !== null && tz.stdOffset !== "" && tz.stdOffset !== tz.utcOffset) {
+            lines.push(`  Standard offset: ${tz.stdOffset}`);
+        }
+    }
+    if (snap.workingTimeFrom !== null || snap.workingTimeTo !== null) {
+        lines.push("");
+        lines.push("Working hours");
+        lines.push(`  From: ${snap.workingTimeFrom ?? "—"}`);
+        lines.push(`  To:   ${snap.workingTimeTo ?? "—"}`);
+    }
+    if (snap.availableShiftRangeFrom !== null || snap.availableShiftRangeTo !== null) {
+        lines.push("");
+        lines.push("Flexible shift range");
+        lines.push(`  From: ${snap.availableShiftRangeFrom ?? "—"}`);
+        lines.push(`  To:   ${snap.availableShiftRangeTo ?? "—"}`);
+    }
+    lines.push("");
+    lines.push("Allocated hours");
+    if (snap.allocatedHours === null) {
+        lines.push("  (unset)");
+    }
+    else {
+        lines.push(`  ${snap.allocatedHours.toString()} h/week`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=show.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"show.js","sourceRoot":"","sources":["../../../src/commands/availability/show.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE3E;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,MAAoB;IAC5D,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;IAErE,IAAI,IAAuC,CAAC;IAC5C,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,uBAAuB,CAAC,mBAAmB,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAC5D,CAAC;IAED,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE;QACvB,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,0BAA0B,CAAC,IAAI,CAAC;KACnD,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAAuC;IAChF,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,wBAAwB,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;IAErD,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxB,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;QAClC,IAAI,EAAE,CAAC,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC,IAAI,KAAK,EAAE;YAAE,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QACzE,IAAI,EAAE,CAAC,QAAQ,KAAK,IAAI,IAAI,EAAE,CAAC,QAAQ,KAAK,EAAE;YAAE,KAAK,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;QACzF,IAAI,EAAE,CAAC,SAAS,KAAK,IAAI,IAAI,EAAE,CAAC,SAAS,KAAK,EAAE;YAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC;QAC9F,IAAI,EAAE,CAAC,SAAS,KAAK,IAAI,IAAI,EAAE,CAAC,SAAS,KAAK,EAAE,IAAI,EAAE,CAAC,SAAS,KAAK,EAAE,CAAC,SAAS,EAAE,CAAC;YAClF,KAAK,CAAC,IAAI,CAAC,sBAAsB,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,IAAI,IAAI,CAAC,eAAe,KAAK,IAAI,IAAI,IAAI,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;QACjE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,eAAe,IAAI,GAAG,EAAE,CAAC,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,aAAa,IAAI,GAAG,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,IAAI,IAAI,CAAC,uBAAuB,KAAK,IAAI,IAAI,IAAI,CAAC,qBAAqB,KAAK,IAAI,EAAE,CAAC;QACjF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,uBAAuB,IAAI,GAAG,EAAE,CAAC,CAAC;QAC7D,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,qBAAqB,IAAI,GAAG,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC9B,IAAI,IAAI,CAAC,cAAc,KAAK,IAAI,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/commands/availability/working-hours.d.ts

@@ -0,0 +1,53 @@
+import { availability } from "@ttctl/core";
+import type { OutputFormat } from "../../lib/output.js";
+/**
+ * Action handler for `ttctl availability working-hours show`. Reads
+ * just the working-hours subset of the availability snapshot — time
+ * zone + daily working window + flexible shift range. Drops the
+ * `allocatedHours` field (separately surfaced under `allocated-hours`).
+ */
+export declare function runWorkingHoursShow(output: OutputFormat): Promise<void>;
+type WorkingHoursShow = Awaited<ReturnType<typeof availability.workingHours.show>>;
+/**
+ * Render the working-hours subset as a sectioned multi-line block.
+ * Pure — directly unit-testable.
+ */
+export declare function formatWorkingHoursShow(data: WorkingHoursShow): string;
+/**
+ * Options for `ttctl availability working-hours set`. All time fields
+ * are `"HH:MM:SS"` strings (the wire format the platform expects);
+ * `--time-zone` is an IANA zone identifier. At least one option must
+ * be provided — the action handler rejects an empty change set
+ * pre-flight.
+ */
+export interface WorkingHoursSetOptions {
+    start?: string;
+    end?: string;
+    timeZone?: string;
+    flexStart?: string;
+    flexEnd?: string;
+    output: OutputFormat;
+}
+/**
+ * Action handler for `ttctl availability working-hours set`. Updates
+ * any subset of (time-zone, daily window, flexible range) via the
+ * `UpdateWorkingHours` mutation.
+ *
+ * Validates each time string against `HH:MM:SS` (the wire format the
+ * platform expects). Pre-flight validation throws
+ * `AvailabilityError("MUTATION_ERROR")` BEFORE the mutation goes out
+ * — fail-fast instead of relying on the server to return
+ * `MUTATION_ERROR`.
+ */
+export declare function runWorkingHoursSet(opts: WorkingHoursSetOptions): Promise<void>;
+type WorkingHoursSetResult = Extract<availability.WorkingHoursSetOutcome, {
+    kind: "applied";
+}>["result"];
+/**
+ * Render the post-update working-hours payload as the indented entity
+ * preview inside the success-update envelope's pretty block. Pure —
+ * directly unit-testable.
+ */
+export declare function formatWorkingHoursSet(result: WorkingHoursSetResult): string;
+export {};
+//# sourceMappingURL=working-hours.d.ts.map

package/dist/commands/availability/working-hours.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"working-hours.d.ts","sourceRoot":"","sources":["../../../src/commands/availability/working-hours.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAIxD;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAa7E;AAED,KAAK,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;AAEnF;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAyBrE;AAED;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;CACtB;AAID;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsEpF;AAED,KAAK,qBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC,sBAAsB,EAAE;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;AAEzG;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAU3E"}

package/dist/commands/availability/working-hours.js

@@ -0,0 +1,151 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { availability } from "@ttctl/core";
+import { getCliDryRun } from "../../lib/dry-run.js";
+import { emitResult } from "../../lib/output.js";
+import { emitDryRunSuccess, emitUpdateSuccess } from "../../lib/envelopes.js";
+import { handleAvailabilityError, loadAuthTokenOrExit } from "./shared.js";
+/**
+ * Action handler for `ttctl availability working-hours show`. Reads
+ * just the working-hours subset of the availability snapshot — time
+ * zone + daily working window + flexible shift range. Drops the
+ * `allocatedHours` field (separately surfaced under `allocated-hours`).
+ */
+export async function runWorkingHoursShow(output) {
+    const token = await loadAuthTokenOrExit("availability working-hours show", output);
+    let snap;
+    try {
+        snap = await availability.workingHours.show(token);
+    }
+    catch (err) {
+        handleAvailabilityError("availability working-hours show", err, output);
+    }
+    emitResult(snap, output, {
+        pretty: (data) => formatWorkingHoursShow(data),
+    });
+}
+/**
+ * Render the working-hours subset as a sectioned multi-line block.
+ * Pure — directly unit-testable.
+ */
+export function formatWorkingHoursShow(data) {
+    const lines = [`Working hours (viewer ${data.viewerId})`];
+    if (data.timeZone !== null) {
+        const tz = data.timeZone;
+        lines.push("");
+        lines.push("Time zone");
+        lines.push(`  IANA: ${tz.value}`);
+        if (tz.name !== null && tz.name !== "")
+            lines.push(`  Name: ${tz.name}`);
+        if (tz.utcOffset !== null && tz.utcOffset !== "")
+            lines.push(`  UTC offset: ${tz.utcOffset}`);
+    }
+    lines.push("");
+    lines.push("Daily window");
+    lines.push(`  From: ${data.workingTimeFrom ?? "—"}`);
+    lines.push(`  To:   ${data.workingTimeTo ?? "—"}`);
+    if (data.availableShiftRangeFrom !== null || data.availableShiftRangeTo !== null) {
+        lines.push("");
+        lines.push("Flexible shift range");
+        lines.push(`  From: ${data.availableShiftRangeFrom ?? "—"}`);
+        lines.push(`  To:   ${data.availableShiftRangeTo ?? "—"}`);
+    }
+    return lines.join("\n");
+}
+const HHMMSS_PATTERN = /^([01]\d|2[0-3]):[0-5]\d:[0-5]\d$/;
+/**
+ * Action handler for `ttctl availability working-hours set`. Updates
+ * any subset of (time-zone, daily window, flexible range) via the
+ * `UpdateWorkingHours` mutation.
+ *
+ * Validates each time string against `HH:MM:SS` (the wire format the
+ * platform expects). Pre-flight validation throws
+ * `AvailabilityError("MUTATION_ERROR")` BEFORE the mutation goes out
+ * — fail-fast instead of relying on the server to return
+ * `MUTATION_ERROR`.
+ */
+export async function runWorkingHoursSet(opts) {
+    const token = await loadAuthTokenOrExit("availability working-hours set", opts.output);
+    const dryRun = getCliDryRun();
+    const input = {};
+    try {
+        if (opts.start !== undefined) {
+            assertHHMMSS("--start", opts.start);
+            input.workingTimeFrom = opts.start;
+        }
+        if (opts.end !== undefined) {
+            assertHHMMSS("--end", opts.end);
+            input.workingTimeTo = opts.end;
+        }
+        if (opts.timeZone !== undefined) {
+            input.timeZone = opts.timeZone;
+        }
+        if (opts.flexStart !== undefined) {
+            assertHHMMSS("--flex-start", opts.flexStart);
+            input.availableShiftRangeFrom = opts.flexStart;
+        }
+        if (opts.flexEnd !== undefined) {
+            assertHHMMSS("--flex-end", opts.flexEnd);
+            input.availableShiftRangeTo = opts.flexEnd;
+        }
+    }
+    catch (err) {
+        handleAvailabilityError("availability working-hours set", err, opts.output);
+    }
+    if (Object.keys(input).length === 0) {
+        handleAvailabilityError("availability working-hours set", new availability.AvailabilityError("MUTATION_ERROR", "No change supplied — pass at least one of --start, --end, --time-zone, --flex-start, --flex-end."), opts.output);
+    }
+    let outcome;
+    try {
+        outcome = await availability.workingHours.set(token, input, { dryRun });
+    }
+    catch (err) {
+        handleAvailabilityError("availability working-hours set", err, opts.output);
+    }
+    if (outcome.kind === "preview") {
+        emitDryRunSuccess({
+            operation: "availability.working-hours.set",
+            format: opts.output,
+            preview: outcome.preview,
+        });
+        return;
+    }
+    const updated = outcome.result;
+    const summaryParts = [];
+    if (updated.timeZone !== null)
+        summaryParts.push(`tz=${updated.timeZone.value}`);
+    if (updated.workingTimeFrom !== null)
+        summaryParts.push(`from=${updated.workingTimeFrom}`);
+    if (updated.workingTimeTo !== null)
+        summaryParts.push(`to=${updated.workingTimeTo}`);
+    emitUpdateSuccess({
+        operation: "availability.working-hours.set",
+        format: opts.output,
+        updated,
+        prettySummary: summaryParts.length > 0 ? `working hours (${summaryParts.join(", ")})` : "working hours",
+        prettyEntity: (data) => formatWorkingHoursSet(data),
+        notice: updated.notice ?? undefined,
+    });
+}
+/**
+ * Render the post-update working-hours payload as the indented entity
+ * preview inside the success-update envelope's pretty block. Pure —
+ * directly unit-testable.
+ */
+export function formatWorkingHoursSet(result) {
+    const lines = [];
+    if (result.timeZone !== null) {
+        lines.push(`Time zone: ${result.timeZone.value}`);
+    }
+    lines.push(`Working: ${result.workingTimeFrom ?? "—"} → ${result.workingTimeTo ?? "—"}`);
+    if (result.availableShiftRangeFrom !== null || result.availableShiftRangeTo !== null) {
+        lines.push(`Flex:    ${result.availableShiftRangeFrom ?? "—"} → ${result.availableShiftRangeTo ?? "—"}`);
+    }
+    return lines.join("\n");
+}
+function assertHHMMSS(flag, value) {
+    if (!HHMMSS_PATTERN.test(value)) {
+        throw new availability.AvailabilityError("MUTATION_ERROR", `${flag} expects a time in HH:MM:SS format (got "${value}").`);
+    }
+}
+//# sourceMappingURL=working-hours.js.map

package/dist/commands/availability/working-hours.js.map

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

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

@@ -0,0 +1,69 @@
+import { Command } from "commander";
+import { contracts } from "@ttctl/core";
+import type { OutputFormat } from "../../lib/output.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 declare function buildContractsCommand(): Command;
+/**
+ * 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 declare function runContractsList(output: OutputFormat): Promise<void>;
+/**
+ * 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 declare function runContractsShow(id: string, output: OutputFormat): Promise<void>;
+/**
+ * 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 declare function formatContractsTable(items: contracts.Contract[], terminalWidth?: number): string;
+/**
+ * Render a single contract as a sectioned multi-line block. Pure
+ * — directly unit-testable.
+ */
+export declare function formatContractDetail(c: contracts.Contract): string;
+/**
+ * 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 declare function formatDate(value: string | null): string;
+/**
+ * Map `isActive` to a compact table-cell marker: `★` for active,
+ * empty for inactive, `?` for null (forward-compat).
+ */
+export declare function activeMarker(isActive: boolean | null): string;
+/**
+ * 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 declare function handleContractsError(commandLabel: string, err: unknown, format?: OutputFormat): never;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/contracts/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAMxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAmC/C;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAe1E;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAatF;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,SAAS,CAAC,QAAQ,EAAE,EAC3B,aAAa,GAAE,MAAsC,GACpD,MAAM,CA8BR;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,SAAS,CAAC,QAAQ,GAAG,MAAM,CAalE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAIvD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,GAAG,MAAM,CAG7D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,YAAuB,GAAG,KAAK,CAE/G"}