@ttctl/cli 0.0.0 → 0.1.0-rc.2

package/dist/commands/profile/visas/list.d.ts

@@ -0,0 +1,40 @@
+import { profile } from "@ttctl/core";
+import { emitAddSuccess, emitRemoveSuccess, emitUpdateSuccess, wrapListEnvelope } from "../../../lib/envelopes.js";
+import type { OutputFormat } from "../../../lib/output.js";
+/**
+ * Action handler for `ttctl profile visas list`. Reads the user's
+ * travel-visa records and emits via the cross-CLI output helper from #71,
+ * wrapped in the `{items, pageInfo?}` list envelope (#128) for json/yaml.
+ */
+export declare function runProfileVisasList(format: OutputFormat): Promise<void>;
+/** Format the visas list as a human-readable summary. */
+export declare function formatVisasText(visas: profile.visas.TravelVisa[]): string;
+/** Format the visas list as a `cli-table3`-rendered table. */
+export declare function formatVisasTable(visas: profile.visas.TravelVisa[], terminalWidth?: number): string;
+/**
+ * Emit the post-mutation visa list, wrapped in the v0.4 envelope ABI
+ * (#128). The visas core API returns the FULL post-mutation list rather
+ * than the single mutated entity, so the envelope's `created` /
+ * `updated` field carries the list (`TravelVisa[]`) rather than a
+ * single `TravelVisa`. The pretty rendering keeps the existing
+ * "success header + table" UX so users continue to see the post-state
+ * at a glance.
+ *
+ * `verb` selects which envelope shape to emit:
+ *
+ * - `add` → `emitAddSuccess` with `created: TravelVisa[]`
+ * - `update` → `emitUpdateSuccess` with `updated: TravelVisa[]`
+ * - `remove` → `emitRemoveSuccess` with `removed: {id}` (the removed
+ *   id is supplied by the caller; the post-state list is passed
+ *   through `notice` for human pretty rendering, NOT for json/yaml —
+ *   `removed` is a strict `{id}` shape per the AC)
+ *
+ * `id` is required for the `remove` verb; for `add`/`update` it may be
+ * omitted (or supplied for inclusion in the pretty header).
+ */
+export declare function emitVisaListResult(visas: profile.visas.TravelVisa[], format: OutputFormat, verb: "add" | "update" | "remove", options?: {
+    id?: string;
+    prettyHeader: string;
+}): void;
+export { emitAddSuccess, emitRemoveSuccess, emitUpdateSuccess, wrapListEnvelope };
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/profile/visas/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../../src/commands/profile/visas/list.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAEnH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG3D;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB7E;AAED,yDAAyD;AACzD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,GAAG,MAAM,CAQzE;AAED,8DAA8D;AAC9D,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,EACjC,aAAa,GAAE,MAAqC,GACnD,MAAM,CAcR;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,EACjC,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,EACjC,OAAO,GAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAyB,GACpE,IAAI,CAkCN;AAID,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/commands/profile/visas/list.js

@@ -0,0 +1,115 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import Table from "cli-table3";
+import { profile } from "@ttctl/core";
+import { emitAddSuccess, emitRemoveSuccess, emitUpdateSuccess, wrapListEnvelope } from "../../../lib/envelopes.js";
+import { emitResult } from "../../../lib/output.js";
+import { handleVisasError, loadAuthTokenOrExit } from "./shared.js";
+/**
+ * Action handler for `ttctl profile visas list`. Reads the user's
+ * travel-visa records and emits via the cross-CLI output helper from #71,
+ * wrapped in the `{items, pageInfo?}` list envelope (#128) for json/yaml.
+ */
+export async function runProfileVisasList(format) {
+    const token = await loadAuthTokenOrExit("visas list", format);
+    let visas;
+    try {
+        visas = await profile.visas.list(token);
+    }
+    catch (err) {
+        handleVisasError("visas list", err, format);
+        return;
+    }
+    emitResult(wrapListEnvelope(visas), format, {
+        pretty: (data) => formatVisasText(data.items),
+        table: (data) => formatVisasTable(data.items),
+        empty: { command: "profile.visas.list" },
+    });
+}
+/** Format the visas list as a human-readable summary. */
+export function formatVisasText(visas) {
+    if (visas.length === 0)
+        return "(no travel visas)";
+    const lines = [`${visas.length.toString()} travel visa${visas.length === 1 ? "" : "s"}:`];
+    for (const v of visas) {
+        const expiry = v.expiryDate !== null ? ` (expires ${v.expiryDate})` : "";
+        lines.push(`  ${v.id} ${v.countryName} — ${v.visaType}${expiry}`);
+    }
+    return lines.join("\n");
+}
+/** Format the visas list as a `cli-table3`-rendered table. */
+export function formatVisasTable(visas, terminalWidth = process.stdout.columns || 80) {
+    const idWidth = 14;
+    const countryWidth = Math.max(15, Math.floor((terminalWidth - idWidth - 8) / 3));
+    const typeWidth = Math.max(15, countryWidth);
+    const expiryWidth = Math.max(12, terminalWidth - idWidth - countryWidth - typeWidth - 8);
+    const table = new Table({
+        head: ["id", "country", "type", "expires"],
+        colWidths: [idWidth, countryWidth, typeWidth, expiryWidth],
+        wordWrap: true,
+    });
+    for (const v of visas) {
+        table.push([v.id, v.countryName, v.visaType, v.expiryDate ?? ""]);
+    }
+    return table.toString();
+}
+/**
+ * Emit the post-mutation visa list, wrapped in the v0.4 envelope ABI
+ * (#128). The visas core API returns the FULL post-mutation list rather
+ * than the single mutated entity, so the envelope's `created` /
+ * `updated` field carries the list (`TravelVisa[]`) rather than a
+ * single `TravelVisa`. The pretty rendering keeps the existing
+ * "success header + table" UX so users continue to see the post-state
+ * at a glance.
+ *
+ * `verb` selects which envelope shape to emit:
+ *
+ * - `add` → `emitAddSuccess` with `created: TravelVisa[]`
+ * - `update` → `emitUpdateSuccess` with `updated: TravelVisa[]`
+ * - `remove` → `emitRemoveSuccess` with `removed: {id}` (the removed
+ *   id is supplied by the caller; the post-state list is passed
+ *   through `notice` for human pretty rendering, NOT for json/yaml —
+ *   `removed` is a strict `{id}` shape per the AC)
+ *
+ * `id` is required for the `remove` verb; for `add`/`update` it may be
+ * omitted (or supplied for inclusion in the pretty header).
+ */
+export function emitVisaListResult(visas, format, verb, options = { prettyHeader: "" }) {
+    if (verb === "remove") {
+        const id = options.id;
+        if (id === undefined) {
+            throw new Error("emitVisaListResult: `id` is required for the `remove` verb");
+        }
+        emitRemoveSuccess({
+            operation: "profile.visas.remove",
+            format,
+            id,
+            prettySummary: options.prettyHeader,
+        });
+        if (format === "pretty" && visas.length > 0) {
+            process.stdout.write(`${formatVisasTable(visas)}\n`);
+        }
+        return;
+    }
+    if (verb === "add") {
+        emitAddSuccess({
+            operation: "profile.visas.add",
+            format,
+            created: visas,
+            prettySummary: options.prettyHeader,
+            prettyEntity: () => formatVisasTable(visas),
+        });
+        return;
+    }
+    emitUpdateSuccess({
+        operation: "profile.visas.update",
+        format,
+        updated: visas,
+        prettySummary: options.prettyHeader,
+        prettyEntity: () => formatVisasTable(visas),
+    });
+}
+// Re-export the success-emitter helpers so call sites within visas/* can
+// reach them via the same module they import `emitVisaListResult` from.
+export { emitAddSuccess, emitRemoveSuccess, emitUpdateSuccess, wrapListEnvelope };
+//# sourceMappingURL=list.js.map

package/dist/commands/profile/visas/list.js.map

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

package/dist/commands/profile/visas/remove.d.ts

@@ -0,0 +1,8 @@
+import type { OutputFormat } from "../../../lib/output.js";
+/**
+ * Action handler for `ttctl profile visas remove <id>` (alias `rm`).
+ * Emits the v0.4 envelope (#128); the post-mutation list still renders
+ * after the success line in pretty mode.
+ */
+export declare function runProfileVisasRemove(id: string, format: OutputFormat): Promise<void>;
+//# sourceMappingURL=remove.d.ts.map

package/dist/commands/profile/visas/remove.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../../../src/commands/profile/visas/remove.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAI3D;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAY3F"}

package/dist/commands/profile/visas/remove.js

@@ -0,0 +1,23 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { profile } from "@ttctl/core";
+import { emitVisaListResult } from "./list.js";
+import { handleVisasError, loadAuthTokenOrExit } from "./shared.js";
+/**
+ * Action handler for `ttctl profile visas remove <id>` (alias `rm`).
+ * Emits the v0.4 envelope (#128); the post-mutation list still renders
+ * after the success line in pretty mode.
+ */
+export async function runProfileVisasRemove(id, format) {
+    const token = await loadAuthTokenOrExit("visas remove", format);
+    let visas;
+    try {
+        visas = await profile.visas.remove(token, id);
+    }
+    catch (err) {
+        handleVisasError("visas remove", err, format);
+        return;
+    }
+    emitVisaListResult(visas, format, "remove", { id, prettyHeader: id });
+}
+//# sourceMappingURL=remove.js.map

package/dist/commands/profile/visas/remove.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.js","sourceRoot":"","sources":["../../../../src/commands/profile/visas/remove.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEpE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,EAAU,EAAE,MAAoB;IAC1E,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAEhE,IAAI,KAAiC,CAAC;IACtC,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,gBAAgB,CAAC,cAAc,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;QAC9C,OAAO;IACT,CAAC;IAED,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC;AACxE,CAAC"}

package/dist/commands/profile/visas/shared.d.ts

@@ -0,0 +1,11 @@
+import type { OutputFormat } from "../../../lib/output.js";
+export { loadAuthTokenOrExit } from "../shared.js";
+/**
+ * Thin wrapper around the shared CLI error router (#330) closed over
+ * `profile.visas.VisasError`. The router applies the envelope ABI
+ * (#128) branching uniformly across sub-domains. No per-code hint
+ * adapter — `VisasError` codes do not carry actionable next-step hints
+ * today.
+ */
+export declare function handleVisasError(commandLabel: string, err: unknown, format?: OutputFormat): never;
+//# sourceMappingURL=shared.d.ts.map

package/dist/commands/profile/visas/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../src/commands/profile/visas/shared.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,YAAuB,GAAG,KAAK,CAE3G"}

package/dist/commands/profile/visas/shared.js

@@ -0,0 +1,16 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { profile } from "@ttctl/core";
+import { handleDomainError } from "../../../lib/error-routing.js";
+export { loadAuthTokenOrExit } from "../shared.js";
+/**
+ * Thin wrapper around the shared CLI error router (#330) closed over
+ * `profile.visas.VisasError`. The router applies the envelope ABI
+ * (#128) branching uniformly across sub-domains. No per-code hint
+ * adapter — `VisasError` codes do not carry actionable next-step hints
+ * today.
+ */
+export function handleVisasError(commandLabel, err, format = "pretty") {
+    handleDomainError(commandLabel, err, profile.visas.VisasError, format);
+}
+//# sourceMappingURL=shared.js.map

package/dist/commands/profile/visas/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../../src/commands/profile/visas/shared.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAGlE,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,YAAoB,EAAE,GAAY,EAAE,SAAuB,QAAQ;IAClG,iBAAiB,CAAC,YAAY,EAAE,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;AACzE,CAAC"}

package/dist/commands/profile/visas/update.d.ts

@@ -0,0 +1,13 @@
+import type { OutputFormat } from "../../../lib/output.js";
+/**
+ * Action handler for `ttctl profile visas update <id>`. Updates only
+ * the fields supplied; rejects an empty update with `VALIDATION_ERROR`
+ * via the envelope ABI (#128).
+ */
+export declare function runProfileVisasUpdate(id: string, options: {
+    country?: string;
+    type?: string;
+    expires?: string;
+    output: OutputFormat;
+}): Promise<void>;
+//# sourceMappingURL=update.d.ts.map

package/dist/commands/profile/visas/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../../src/commands/profile/visas/update.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAI3D;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,EAAE,EAAE,MAAM,EACV,OAAO,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GACnF,OAAO,CAAC,IAAI,CAAC,CA+Bf"}

package/dist/commands/profile/visas/update.js

@@ -0,0 +1,44 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { profile } from "@ttctl/core";
+import { emitErrorAndExit } from "../../../lib/envelopes.js";
+import { emitVisaListResult } from "./list.js";
+import { handleVisasError, loadAuthTokenOrExit } from "./shared.js";
+/**
+ * Action handler for `ttctl profile visas update <id>`. Updates only
+ * the fields supplied; rejects an empty update with `VALIDATION_ERROR`
+ * via the envelope ABI (#128).
+ */
+export async function runProfileVisasUpdate(id, options) {
+    const changes = {};
+    if (options.country !== undefined)
+        changes.countryId = options.country;
+    if (options.type !== undefined)
+        changes.visaType = options.type;
+    if (options.expires !== undefined)
+        changes.expiryDate = options.expires;
+    if (Object.keys(changes).length === 0) {
+        emitErrorAndExit({
+            operation: "profile.visas.update",
+            format: options.output,
+            errors: [
+                {
+                    code: "VALIDATION_ERROR",
+                    message: "supply at least one field flag (--country, --type, or --expires).",
+                },
+            ],
+            prettySummary: "visas update failed (VALIDATION_ERROR): supply at least one field flag (--country, --type, or --expires).",
+        });
+    }
+    const token = await loadAuthTokenOrExit("visas update", options.output);
+    let visas;
+    try {
+        visas = await profile.visas.update(token, id, changes);
+    }
+    catch (err) {
+        handleVisasError("visas update", err, options.output);
+        return;
+    }
+    emitVisaListResult(visas, options.output, "update", { prettyHeader: `Travel visa ${id} updated.` });
+}
+//# sourceMappingURL=update.js.map

package/dist/commands/profile/visas/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../../src/commands/profile/visas/update.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEpE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,EAAU,EACV,OAAoF;IAEpF,MAAM,OAAO,GAAkC,EAAE,CAAC;IAClD,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,CAAC,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;IACvE,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAChE,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IAExE,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtC,gBAAgB,CAAC;YACf,SAAS,EAAE,sBAAsB;YACjC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,MAAM,EAAE;gBACN;oBACE,IAAI,EAAE,kBAAkB;oBACxB,OAAO,EAAE,mEAAmE;iBAC7E;aACF;YACD,aAAa,EACX,2GAA2G;SAC9G,CAAC,CAAC;IACL,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAExE,IAAI,KAAiC,CAAC;IACtC,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,gBAAgB,CAAC,cAAc,EAAE,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACtD,OAAO;IACT,CAAC;IAED,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,CAAC,CAAC;AACtG,CAAC"}

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

@@ -0,0 +1,24 @@
+import { Command } from "commander";
+/**
+ * Build the `ttctl timesheet` command tree (#13). Three leaves:
+ *
+ * | Leaf                             | Description                                       |
+ * |----------------------------------|---------------------------------------------------|
+ * | `list [--engagement <id>]`       | List timesheets (default: viewer-wide pending)    |
+ * | `show <id>`                      | One timesheet detail (id = BillingCycle.id)       |
+ * | `submit [id] [--confirm]`        | Submit timesheet for billing (destructive)        |
+ *
+ * **Wire identity model**:
+ *   - `BillingCycle.id` — the public "timesheet id" returned by
+ *     `list` and consumed by `show` / `submit`.
+ *   - `JobActivityItem.id` — the "engagement id" exposed by
+ *     `engagements list`. Passed via `--engagement <id>` to scope
+ *     `list` / `submit` auto-resolve to one engagement.
+ *
+ * **Out of scope for v1** (per #13 spec): editing timesheet records,
+ * uploading attachments, reminder settings, rejection/approval
+ * workflow. The web UI handles record entry; this CLI surfaces the
+ * read paths and the submit verb.
+ */
+export declare function buildTimesheetCommand(): Command;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/timesheet/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAgC,MAAM,WAAW,CAAC;AASlE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CA2D/C"}

package/dist/commands/timesheet/index.js

@@ -0,0 +1,98 @@
+// 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 { runTimesheetList } from "./list.js";
+import { runTimesheetShow } from "./show.js";
+import { runTimesheetSubmit } from "./submit.js";
+/**
+ * Build the `ttctl timesheet` command tree (#13). Three leaves:
+ *
+ * | Leaf                             | Description                                       |
+ * |----------------------------------|---------------------------------------------------|
+ * | `list [--engagement <id>]`       | List timesheets (default: viewer-wide pending)    |
+ * | `show <id>`                      | One timesheet detail (id = BillingCycle.id)       |
+ * | `submit [id] [--confirm]`        | Submit timesheet for billing (destructive)        |
+ *
+ * **Wire identity model**:
+ *   - `BillingCycle.id` — the public "timesheet id" returned by
+ *     `list` and consumed by `show` / `submit`.
+ *   - `JobActivityItem.id` — the "engagement id" exposed by
+ *     `engagements list`. Passed via `--engagement <id>` to scope
+ *     `list` / `submit` auto-resolve to one engagement.
+ *
+ * **Out of scope for v1** (per #13 spec): editing timesheet records,
+ * uploading attachments, reminder settings, rejection/approval
+ * workflow. The web UI handles record entry; this CLI surfaces the
+ * read paths and the submit verb.
+ */
+export function buildTimesheetCommand() {
+    const cmd = new Command("timesheet").description("View timesheet billing cycles and submit them for billing");
+    cmd
+        .command("list")
+        .description("List timesheet billing cycles (default: viewer-wide pending)")
+        .option("--engagement <id>", "scope to one engagement (jobActivityItem.id from `engagements list`)")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (options) => {
+        const listOpts = { output: options.output };
+        if (options.engagement !== undefined)
+            listOpts.engagement = options.engagement;
+        await runTimesheetList(listOpts);
+    });
+    cmd
+        .command("show")
+        .description("Show one timesheet by id (BillingCycle.id from `timesheet list`)")
+        .argument("<id>", "timesheet id (BillingCycle.id)", parseIdArg)
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (id, options) => {
+        await runTimesheetShow(id, options.output);
+    });
+    const submitCmd = cmd
+        .command("submit")
+        .description("Submit a timesheet for billing (DESTRUCTIVE — one-way)")
+        .argument("[id]", "timesheet id (BillingCycle.id); when omitted, the current pending cycle is auto-resolved", parseIdArgOptional)
+        .option("--engagement <id>", "scope auto-resolve to one engagement (jobActivityItem.id)")
+        .option("--confirm", "skip the interactive confirmation prompt (required for non-TTY stdin)", false)
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (id, options) => {
+        const submitOpts = {
+            confirm: options.confirm,
+            output: options.output,
+        };
+        if (options.engagement !== undefined)
+            submitOpts.engagement = options.engagement;
+        await runTimesheetSubmit(id, submitOpts);
+    });
+    markMutation(submitCmd);
+    return cmd;
+}
+/**
+ * Parse the positional `<id>` argument for `show`. Rejects empty /
+ * whitespace-only strings — Commander would otherwise pass them
+ * through. Mirrors the engagements group's `parseIdArg`.
+ */
+function parseIdArg(value) {
+    const trimmed = value.trim();
+    if (trimmed === "") {
+        throw new InvalidArgumentError("id must not be empty");
+    }
+    return trimmed;
+}
+/**
+ * Optional-positional variant for `submit`. `undefined` flows through
+ * (Commander hands us `undefined` when the positional was omitted);
+ * a present-but-blank id is rejected so we don't silently use `""`.
+ */
+function parseIdArgOptional(value) {
+    if (value === undefined)
+        return undefined;
+    return parseIdArg(value);
+}
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,40 @@
+import { timesheet } from "@ttctl/core";
+import type { OutputFormat } from "../../lib/output.js";
+/**
+ * Action handler for `ttctl timesheet list`. Default scope is
+ * viewer-wide pending timesheets (whatever the user owes Toptal right
+ * now); `--engagement <id>` switches to listing all billing cycles
+ * for one engagement.
+ *
+ * Pretty rendering: column-aligned table; pretty empty-state CTA via
+ * the `empty` opt-in in `emitResult` (#122 reframe).
+ *
+ * **Pagination not supported** — the captured wire ops have no
+ * pagination args (`PendingTimesheets` has a hard `limit: 50` inline
+ * in its document; `Timesheets($jobActivityItemId)` has none). Per
+ * #183, pagination flags are declared PER paginating leaf; this leaf
+ * does not declare `--page` / `--per-page`.
+ */
+export interface TimesheetListOptions {
+    engagement?: string;
+    output: OutputFormat;
+}
+export declare function runTimesheetList(opts: TimesheetListOptions): Promise<void>;
+/**
+ * Render the timesheet list as a `cli-table3` table sized to the
+ * current terminal width. Columns:
+ *
+ *   id | engagement | job | week | hours | submitted | overdue
+ *
+ * `week` shows the cycle's date range (`YYYY-MM-DD → YYYY-MM-DD`).
+ * `submitted` is `✓` / `·` for visual scanning; `overdue` is
+ * `!` only when overdue (otherwise blank) so non-overdue rows are
+ * visually quiet.
+ */
+export declare function formatTimesheetsTable(items: timesheet.TimesheetListItem[], terminalWidth?: number): string;
+/**
+ * Render the cycle's date range. Wire dates are already ISO `YYYY-MM-DD`
+ * strings — render verbatim with a separator.
+ */
+export declare function formatWeek(startDate: string, endDate: string): string;
+//# sourceMappingURL=list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/timesheet/list.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAIxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,oBAAoB;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBhF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,SAAS,CAAC,iBAAiB,EAAE,EACpC,aAAa,GAAE,MAAsC,GACpD,MAAM,CAqCR;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAErE"}

package/dist/commands/timesheet/list.js

@@ -0,0 +1,79 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import Table from "cli-table3";
+import { timesheet } from "@ttctl/core";
+import { wrapListEnvelope } from "../../lib/envelopes.js";
+import { emitResult } from "../../lib/output.js";
+import { handleTimesheetError, loadAuthTokenOrExit } from "./shared.js";
+export async function runTimesheetList(opts) {
+    const token = await loadAuthTokenOrExit("timesheet list", opts.output);
+    const listOpts = {};
+    if (opts.engagement !== undefined)
+        listOpts.engagement = opts.engagement;
+    let items;
+    try {
+        items = await timesheet.list(token, listOpts);
+    }
+    catch (err) {
+        handleTimesheetError("timesheet list", err, opts.output);
+    }
+    emitResult(wrapListEnvelope(items), opts.output, {
+        pretty: (data) => formatTimesheetsTable(data.items),
+        table: (data) => formatTimesheetsTable(data.items),
+        empty: { command: "timesheet.list" },
+    });
+}
+/**
+ * Render the timesheet list as a `cli-table3` table sized to the
+ * current terminal width. Columns:
+ *
+ *   id | engagement | job | week | hours | submitted | overdue
+ *
+ * `week` shows the cycle's date range (`YYYY-MM-DD → YYYY-MM-DD`).
+ * `submitted` is `✓` / `·` for visual scanning; `overdue` is
+ * `!` only when overdue (otherwise blank) so non-overdue rows are
+ * visually quiet.
+ */
+export function formatTimesheetsTable(items, terminalWidth = process.stdout.columns || 100) {
+    if (items.length === 0) {
+        const empty = new Table({ head: ["id", "engagement", "job", "week", "hours", "submitted", "overdue"] });
+        return empty.toString();
+    }
+    const idWidth = 22;
+    const engagementWidth = 14;
+    const weekWidth = 24;
+    const hoursWidth = 7;
+    const submittedWidth = 10;
+    const overdueWidth = 8;
+    // 7 columns × 2 padding-char + 8 borders ≈ 22
+    const remaining = Math.max(20, terminalWidth - idWidth - engagementWidth - weekWidth - hoursWidth - submittedWidth - overdueWidth - 22);
+    const jobWidth = Math.max(20, remaining);
+    const table = new Table({
+        head: ["id", "engagement", "job", "week", "hours", "submitted", "overdue"],
+        colWidths: [idWidth, engagementWidth, jobWidth, weekWidth, hoursWidth, submittedWidth, overdueWidth],
+        colAligns: ["left", "left", "left", "left", "right", "center", "center"],
+        wordWrap: true,
+    });
+    for (const it of items) {
+        const client = it.engagement.job.client?.fullName ?? "(no client)";
+        const title = it.engagement.job.title ?? "(untitled)";
+        table.push([
+            it.id,
+            client,
+            title,
+            formatWeek(it.startDate, it.endDate),
+            it.hours,
+            it.timesheetSubmitted ? "✓" : "·",
+            it.timesheetOverdue ? "!" : "",
+        ]);
+    }
+    return table.toString();
+}
+/**
+ * Render the cycle's date range. Wire dates are already ISO `YYYY-MM-DD`
+ * strings — render verbatim with a separator.
+ */
+export function formatWeek(startDate, endDate) {
+    return `${startDate} → ${endDate}`;
+}
+//# sourceMappingURL=list.js.map

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

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

package/dist/commands/timesheet/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
+ * `timesheet.TimesheetError` and {@link hintForTimesheetCode}. The
+ * router applies the envelope ABI (#128) branching uniformly across
+ * sub-domains.
+ */
+export declare function handleTimesheetError(commandLabel: string, err: unknown, format?: OutputFormat): never;
+//# sourceMappingURL=shared.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/commands/timesheet/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,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,YAAuB,GAAG,KAAK,CAE/G"}

package/dist/commands/timesheet/shared.js

@@ -0,0 +1,35 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { timesheet } 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
+ * `timesheet.TimesheetError` and {@link hintForTimesheetCode}. The
+ * router applies the envelope ABI (#128) branching uniformly across
+ * sub-domains.
+ */
+export function handleTimesheetError(commandLabel, err, format = "pretty") {
+    handleDomainError(commandLabel, err, timesheet.TimesheetError, format, hintForTimesheetCode);
+}
+/**
+ * Per-code recovery hints. Only codes with a clearly actionable next
+ * step carry one.
+ */
+function hintForTimesheetCode(code) {
+    switch (code) {
+        case "NOT_FOUND":
+            return "Verify the id (use `ttctl timesheet list` to discover billing-cycle ids).";
+        case "NO_ENGAGEMENT":
+            return "The activity item exists but isn't an engagement — only engagement-bearing rows have timesheets.";
+        case "NO_CURRENT_CYCLE":
+            return "No billing cycle is currently in its submission window. Run `ttctl timesheet list` to see what's pending.";
+        case "MULTIPLE_CURRENT_CYCLES":
+            return "Multiple cycles are simultaneously in their submission window — specify the cycle id explicitly: `ttctl timesheet submit <id> --confirm`.";
+        case "MUTATION_ERROR":
+            return "The server rejected the submission (often: missing required hours, deadline passed, or already submitted). Inspect the message above and fix in the web UI.";
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=shared.js.map