@ttctl/cli 0.0.0 → 0.1.0-rc.1

package/dist/commands/profile/basic/show.d.ts

@@ -0,0 +1,95 @@
+import { profile } from "@ttctl/core";
+import type { ProfileShowQuery } from "@ttctl/core";
+import type { OutputFormat } from "../../../lib/output.js";
+/**
+ * Composite payload rendered by the `basic show` formatters: the
+ * mobile-gateway `ProfileShowQuery` (identity, role, viewer profile,
+ * skills) plus the talent-profile `BasicInfo` projection (`bio`,
+ * `headline`, `languages`) added in #127.
+ *
+ * The talent-profile-side fields are NOT on the wire `Profile` type
+ * surfaced by `mobile-gateway` (per the comment block in
+ * `services/profile/basic/index.ts`); the read surface dispatches a
+ * second call against `talent_profile/graphql` to fetch them. The
+ * formatter consumes the merged shape so the `pretty` rendering can
+ * surface every editable field (#129 closes the audit-confirmed
+ * field-dropping defects from #124).
+ *
+ * `basicInfo` is `null` when the second call failed in a way that
+ * shouldn't fail the whole show command (network blip on the secondary
+ * surface); the formatter degrades gracefully — bio/headline/languages
+ * render as `(unset)` rather than throwing. Hard failures (auth-revoked,
+ * 403) propagate verbatim via the action handler's error path.
+ */
+export interface BasicShowPayload {
+    profile: ProfileShowQuery;
+    basicInfo: profile.basic.BasicInfo | null;
+}
+/**
+ * Action handler for `ttctl profile basic show` (also reachable as the
+ * short-form `ttctl profile show`). Loads the persisted auth token, fetches
+ * the profile via `profile.basic.show()` from `@ttctl/core`, and emits the
+ * payload through the shared `emitResult` helper. Maps domain errors to
+ * actionable stderr messages and a non-zero exit code.
+ *
+ * Two-call read surface (post-#129): in addition to the mobile-gateway
+ * `ProfileShow` query, the handler dispatches `getBasicInfo()` against
+ * `talent_profile/graphql` to fetch `bio` / `headline` / `languages`
+ * (the audit-confirmed query-root-cause fields from #124, fixed in #127).
+ * The two payloads merge into {@link BasicShowPayload} for the
+ * formatter / JSON / YAML branches.
+ *
+ * Errors from the secondary `getBasicInfo()` call are non-fatal: the
+ * handler swallows transport-level / GraphQL failures and renders
+ * `basicInfo: null`, so a glitch on the secondary surface doesn't blank
+ * the whole show. Auth-revoked + Cloudflare-403 still propagate (those
+ * indicate the user's session is no longer valid; the primary call would
+ * have hit them too).
+ *
+ * No-token case: surface as `UNAUTHENTICATED` with the same hint as a
+ * gateway 401, so the user-visible message ("run `ttctl auth signin`") is
+ * uniform across "never signed in" and "signed in but expired".
+ */
+export declare function runProfileBasicShow(format: OutputFormat): Promise<void>;
+/**
+ * Format the merged `basic show` payload as the post-#129 `pretty`
+ * summary. Pure function — no I/O — directly unit-testable.
+ *
+ * Field ordering reflects the audit's recommendation: identity (name,
+ * email, phone, city) first, then user-narrative fields (headline, bio,
+ * languages — the audit-confirmed previously-dropped fields from
+ * #127), then role metadata (vertical, specializations, availability,
+ * rate, time zone, public skills), then server-side metadata (photo URL).
+ *
+ * Null convention: fields the user CAN set but hasn't render as
+ * `(unset)` (per the audit's standardisation rec); the bio gets the
+ * CTA-style hint to nudge the user toward `update --bio`. Skip-if-null
+ * is reserved for fields that aren't user-editable from this CLI
+ * (`phoneNumber` empty, no public skills, …).
+ *
+ * Pretty does NOT truncate to 80 columns (per the issue AC: "For long
+ * URLs / IDs: don't truncate (this is `pretty`, not `table`)"); the
+ * terminal wraps if the user's window is narrow. The `table` format
+ * keeps width discipline (`cli-table3` `wordWrap: true`).
+ */
+export declare function formatProfilePretty(payload: BasicShowPayload): string;
+/**
+ * Format the merged `basic show` payload as a `cli-table3`-rendered
+ * key/value table. Pure function — no I/O — directly unit-testable. The
+ * table sizes itself to `terminalWidth` (defaulting to
+ * `process.stdout.columns || 80`) with `wordWrap` enabled.
+ *
+ * The table representation is internal-only post-#126 — the user-visible
+ * `--output=pretty` shape-dispatches to `pretty` for show verbs and to
+ * `table` for list verbs; `basic show` is a show verb. The table slot
+ * remains for the rare narrow-terminal use case where the curated
+ * key:value pretty layout overflows; the dispatcher's fallback path
+ * uses it.
+ *
+ * `terminalWidth` is parameterised so tests can verify width adaptation
+ * without monkey-patching `process.stdout.columns`.
+ */
+export declare function formatProfileTable(payload: BasicShowPayload, terminalWidth?: number): string;
+declare function truncate(s: string, width: number): string;
+export { truncate };
+//# sourceMappingURL=show.d.ts.map

package/dist/commands/profile/basic/show.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.d.ts","sourceRoot":"","sources":["../../../../src/commands/profile/basic/show.ts"],"names":[],"mappings":"AAIA,OAAO,EAAc,OAAO,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAOpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG3D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAwC7E;AA+GD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAgDrE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,gBAAgB,EACzB,aAAa,GAAE,MAAqC,GACnD,MAAM,CAsDR;AAED,iBAAS,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGlD;AAID,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/commands/profile/basic/show.js

@@ -0,0 +1,310 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import Table from "cli-table3";
+import { TtctlError, profile } from "@ttctl/core";
+import { presentTtctlError } from "../../../errors.js";
+import { emitErrorAndExit } from "../../../lib/envelopes.js";
+import { renderMultiParagraph, unsetOr } from "../../../lib/format-helpers.js";
+import { emitResult } from "../../../lib/output.js";
+import { loadAuthTokenOrExit } from "../shared.js";
+/**
+ * Action handler for `ttctl profile basic show` (also reachable as the
+ * short-form `ttctl profile show`). Loads the persisted auth token, fetches
+ * the profile via `profile.basic.show()` from `@ttctl/core`, and emits the
+ * payload through the shared `emitResult` helper. Maps domain errors to
+ * actionable stderr messages and a non-zero exit code.
+ *
+ * Two-call read surface (post-#129): in addition to the mobile-gateway
+ * `ProfileShow` query, the handler dispatches `getBasicInfo()` against
+ * `talent_profile/graphql` to fetch `bio` / `headline` / `languages`
+ * (the audit-confirmed query-root-cause fields from #124, fixed in #127).
+ * The two payloads merge into {@link BasicShowPayload} for the
+ * formatter / JSON / YAML branches.
+ *
+ * Errors from the secondary `getBasicInfo()` call are non-fatal: the
+ * handler swallows transport-level / GraphQL failures and renders
+ * `basicInfo: null`, so a glitch on the secondary surface doesn't blank
+ * the whole show. Auth-revoked + Cloudflare-403 still propagate (those
+ * indicate the user's session is no longer valid; the primary call would
+ * have hit them too).
+ *
+ * No-token case: surface as `UNAUTHENTICATED` with the same hint as a
+ * gateway 401, so the user-visible message ("run `ttctl auth signin`") is
+ * uniform across "never signed in" and "signed in but expired".
+ */
+export async function runProfileBasicShow(format) {
+    const token = await loadAuthTokenOrExit("profile show", format);
+    let profilePayload;
+    try {
+        profilePayload = await profile.basic.show(token);
+    }
+    catch (err) {
+        handleProfileShowError(err, format);
+        return;
+    }
+    let basicInfo = null;
+    try {
+        basicInfo = await profile.basic.getBasicInfo(token);
+    }
+    catch (err) {
+        // Auth-revoked / Cloudflare-403 are session-level failures — let them
+        // surface so the user knows to re-authenticate. The primary `show()`
+        // would have hit the same issue, so we shouldn't be here unless the
+        // talent-profile surface specifically is rejecting; either way, the
+        // user needs to act on it.
+        if (err instanceof TtctlError) {
+            handleProfileShowError(err, format);
+            return;
+        }
+        // Anything else (NETWORK_ERROR, GRAPHQL_ERROR on the talent-profile
+        // surface) is non-fatal: the primary payload landed, so render the
+        // partial result with `(unset)` placeholders for the talent-profile
+        // fields. A diagnostic on stderr keeps the failure visible without
+        // breaking the user's `--output json` pipe.
+        process.stderr.write(`note: failed to fetch talent_profile basic info; rendering without bio/headline/languages: ${err instanceof Error ? err.message : String(err)}\n`);
+    }
+    emitResult({ profile: profilePayload, basicInfo }, format, {
+        pretty: formatProfilePretty,
+        table: formatProfileTable,
+    });
+}
+/**
+ * Map `profile.basic.show()` errors to actionable stderr messages and a
+ * non-zero exit.
+ *
+ * `TtctlError` subclasses (`Cf403Error`, `Cf403PersistentError`,
+ * `AuthRevokedError`, `SchedulerBearerExpired`) render in the uniform
+ * `Error: ... / Recovery: ... / (Code: ...)` format defined in #77.
+ * Domain `ProfileError` codes (NO_VIEWER, GRAPHQL_ERROR, USER_ERROR, …)
+ * keep the existing "(CODE): message" rendering. Anything else gets a
+ * generic prefix.
+ */
+function handleProfileShowError(err, format) {
+    if (err instanceof TtctlError) {
+        if (format === "pretty")
+            presentTtctlError(err);
+        const errors = [{ code: err.code, message: err.message, hint: err.recovery }];
+        emitErrorAndExit({
+            operation: "profile.basic.show",
+            format,
+            errors,
+            exitCode: err.code === "CF_403_CLEARANCE" || err.code === "CF_403_PERSISTENT" ? 2 : 1,
+        });
+    }
+    if (err instanceof profile.basic.ProfileError) {
+        emitErrorAndExit({
+            operation: "profile.basic.show",
+            format,
+            errors: [{ code: err.code, message: err.message }],
+            prettySummary: `profile show failed (${err.code}): ${err.message}`,
+        });
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    emitErrorAndExit({
+        operation: "profile.basic.show",
+        format,
+        errors: [{ code: "INTERNAL_ERROR", message }],
+        prettySummary: `profile show failed: ${message}`,
+    });
+}
+function collectPublicSkills(viewerProfile) {
+    return viewerProfile.skillSets.nodes
+        .filter((n) => n !== null)
+        .filter((n) => n.public)
+        .slice(0, 5)
+        .map((n) => n.skill.name);
+}
+function collectSpecializations(role) {
+    return role.specializations
+        .filter((s) => s !== null)
+        .slice(0, 3)
+        .map((s) => s.title);
+}
+function formatHoursRatio(role) {
+    return `${role.hiredHours.toString()}/${role.allocatedHours.toString()}h`;
+}
+/**
+ * CTA-styled `(unset)` placeholder for the bio field — the audit-defined
+ * convention is to nudge the user toward the corresponding `update`
+ * command rather than leaving a bare `(unset)` on a field that's the
+ * primary value-add of the profile. Other fields get the bare placeholder.
+ */
+const BIO_UNSET_HINT = `(unset — set with: ttctl profile basic update --bio "<text>")`;
+/**
+ * Render the headline as a single line. Headlines are short by API
+ * contract (the talent-profile UI caps `Profile.quote` at ~120 chars);
+ * we don't truncate further — `pretty` doesn't truncate.
+ */
+function formatHeadlineLine(headline, indent) {
+    return `${indent}Headline: ${unsetOr(headline)}`;
+}
+/**
+ * Render the bio as either a CTA-style unset line or a multi-paragraph
+ * block. The block format puts `Bio:` on its own line and indents the
+ * body two further spaces so paragraph breaks (`\n\n` in source) survive
+ * as actual blank lines — required by the AC ("no `\n\n` literal escape
+ * leak").
+ */
+function formatBioBlock(bio, indent) {
+    if (bio === null || bio === undefined || bio === "") {
+        return `${indent}Bio: ${BIO_UNSET_HINT}`;
+    }
+    return renderMultiParagraph("Bio", bio, indent);
+}
+/**
+ * Render the languages list. ≤3 entries fit on a comma-separated line;
+ * >3 entries wrap onto a sub-list (one entry per line, indented one
+ * level deeper) for legibility.
+ */
+function formatLanguagesLine(languages, indent) {
+    if (languages.length === 0) {
+        return `${indent}Languages: ${unsetOr(null)}`;
+    }
+    const names = languages.map((l) => l.name);
+    if (names.length <= 3) {
+        return `${indent}Languages: ${names.join(", ")}`;
+    }
+    const sub = names.map((n) => `${indent}  - ${n}`).join("\n");
+    return `${indent}Languages:\n${sub}`;
+}
+/**
+ * Format the merged `basic show` payload as the post-#129 `pretty`
+ * summary. Pure function — no I/O — directly unit-testable.
+ *
+ * Field ordering reflects the audit's recommendation: identity (name,
+ * email, phone, city) first, then user-narrative fields (headline, bio,
+ * languages — the audit-confirmed previously-dropped fields from
+ * #127), then role metadata (vertical, specializations, availability,
+ * rate, time zone, public skills), then server-side metadata (photo URL).
+ *
+ * Null convention: fields the user CAN set but hasn't render as
+ * `(unset)` (per the audit's standardisation rec); the bio gets the
+ * CTA-style hint to nudge the user toward `update --bio`. Skip-if-null
+ * is reserved for fields that aren't user-editable from this CLI
+ * (`phoneNumber` empty, no public skills, …).
+ *
+ * Pretty does NOT truncate to 80 columns (per the issue AC: "For long
+ * URLs / IDs: don't truncate (this is `pretty`, not `table`)"); the
+ * terminal wraps if the user's window is narrow. The `table` format
+ * keeps width discipline (`cli-table3` `wordWrap: true`).
+ */
+export function formatProfilePretty(payload) {
+    const viewer = payload.profile.viewer;
+    if (viewer === null) {
+        return "(no viewer bound to this session)";
+    }
+    const role = viewer.viewerRole;
+    const viewerProfile = role.profile;
+    const skills = collectPublicSkills(viewerProfile);
+    const specializations = collectSpecializations(role);
+    const hoursRatio = formatHoursRatio(role);
+    const indent = "  ";
+    const lines = [role.fullName, `${indent}${role.email}`];
+    if (role.phoneNumber !== "") {
+        lines.push(`${indent}${role.phoneNumber}`);
+    }
+    if (viewerProfile.city !== "") {
+        lines.push(`${indent}${viewerProfile.city}`);
+    }
+    // User-narrative fields (post-#127 talent-profile reads). Always emit
+    // these — the (unset) placeholder is itself the user-visible signal
+    // that the field exists and can be edited.
+    lines.push(formatHeadlineLine(payload.basicInfo?.headline, indent));
+    lines.push(formatBioBlock(payload.basicInfo?.bio, indent));
+    lines.push(formatLanguagesLine(payload.basicInfo?.languages ?? [], indent));
+    // Role metadata. `Vertical` and `Availability` are not user-editable
+    // from this CLI; they render as-is (no `(unset)` for non-editable
+    // fields per the audit's skip-if-null escape hatch).
+    lines.push(`${indent}Vertical: ${role.vertical.name}`);
+    if (specializations.length > 0) {
+        lines.push(`${indent}Specializations: ${specializations.join(", ")}`);
+    }
+    lines.push(`${indent}Availability: ${role.availability} (${hoursRatio})`);
+    lines.push(`${indent}Rate: ${role.hourlyRate.verbose}/hr`);
+    lines.push(`${indent}TimeZone: ${role.timeZone.value}`);
+    if (skills.length > 0) {
+        lines.push(`${indent}Skills: ${skills.join(", ")}`);
+    }
+    // Server-side metadata last. `photo.large` may be empty when the user
+    // hasn't uploaded a photo — render `(unset)` so the field is visible
+    // (it's user-editable via `photo upload`).
+    lines.push(`${indent}Photo: ${unsetOr(role.photo.large)}`);
+    return lines.join("\n");
+}
+/**
+ * Format the merged `basic show` payload as a `cli-table3`-rendered
+ * key/value table. Pure function — no I/O — directly unit-testable. The
+ * table sizes itself to `terminalWidth` (defaulting to
+ * `process.stdout.columns || 80`) with `wordWrap` enabled.
+ *
+ * The table representation is internal-only post-#126 — the user-visible
+ * `--output=pretty` shape-dispatches to `pretty` for show verbs and to
+ * `table` for list verbs; `basic show` is a show verb. The table slot
+ * remains for the rare narrow-terminal use case where the curated
+ * key:value pretty layout overflows; the dispatcher's fallback path
+ * uses it.
+ *
+ * `terminalWidth` is parameterised so tests can verify width adaptation
+ * without monkey-patching `process.stdout.columns`.
+ */
+export function formatProfileTable(payload, terminalWidth = process.stdout.columns || 80) {
+    const viewer = payload.profile.viewer;
+    if (viewer === null) {
+        const table = new Table({ head: ["Field", "Value"] });
+        table.push(["name", "(no viewer)"]);
+        return table.toString();
+    }
+    const role = viewer.viewerRole;
+    const viewerProfile = role.profile;
+    const skills = collectPublicSkills(viewerProfile);
+    const specializations = collectSpecializations(role);
+    const hoursRatio = formatHoursRatio(role);
+    const info = payload.basicInfo;
+    const languageNames = (info?.languages ?? []).map((l) => l.name);
+    const rows = [
+        ["name", role.fullName],
+        ["email", role.email],
+        ["phone", role.phoneNumber],
+        ["city", unsetOr(viewerProfile.city)],
+        ["headline", unsetOr(info?.headline)],
+        ["bio", unsetOr(info?.bio)],
+        ["languages", languageNames.length > 0 ? languageNames.join(", ") : unsetOr(null)],
+        ["vertical", role.vertical.name],
+        ["specializations", specializations.join(",")],
+        ["availability", role.availability],
+        ["allocated_hours", role.allocatedHours.toString()],
+        ["hired_hours", role.hiredHours.toString()],
+        ["hours", hoursRatio],
+        ["hourly_rate", role.hourlyRate.verbose],
+        ["time_zone", role.timeZone.value],
+        ["public_resume_url", role.publicResumeUrl],
+        ["skills", skills.join(",")],
+        ["photo_url", unsetOr(role.photo.large)],
+    ];
+    // Allocate the field column at 20 cols. cli-table3 reserves 2 chars of
+    // each column for left+right cell padding, so the visible content area
+    // is 18 chars — enough for the longest key ("public_resume_url" at 17
+    // chars). The value column gets the rest minus ~5 for box drawing + the
+    // outer padding. Floor at 20 so the table stays readable on very narrow
+    // terminals.
+    const fieldWidth = 20;
+    const valueWidth = Math.max(20, terminalWidth - fieldWidth - 5);
+    const table = new Table({
+        head: ["Field", "Value"],
+        colWidths: [fieldWidth, valueWidth],
+        wordWrap: true,
+    });
+    for (const [k, v] of rows) {
+        table.push([k, v]);
+    }
+    return table.toString();
+}
+function truncate(s, width) {
+    if (s.length <= width)
+        return s;
+    return `${s.slice(0, width - 1)}…`;
+}
+// Helper re-export for sibling `set.ts` / `photo-show.ts` / `photo-upload.ts`.
+// Internal to this folder; not part of the package's public surface.
+export { truncate };
+//# sourceMappingURL=show.js.map

package/dist/commands/profile/basic/show.js.map

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

package/dist/commands/profile/certifications/index.d.ts

@@ -0,0 +1,31 @@
+import { profile } from "@ttctl/core";
+import { Command } from "commander";
+/**
+ * Build the `ttctl profile certifications` command tree.
+ *
+ * The canonical sub-domain name is `certifications`; the CLI registers
+ * `certs` as a Commander.js alias so users can type either form. Per
+ * project policy (see issue #72), aliases are CLI-only — MCP tool names
+ * use ONLY the canonical name.
+ *
+ * Five leaves:
+ *   - `add --name --issuer [--issued --expires]`
+ *   - `update <id> [field-flags]`
+ *   - `remove <id>`
+ *   - `show <id> [-o text|json|table]`
+ *   - `highlight <id>`
+ *
+ * Date input flags accept ISO-8601 (`2023-01-15`) or year-only (`2023`).
+ * Certifications store month + year (separate Int fields) so the helper
+ * preserves the month component and ignores any provided day.
+ */
+export declare function buildProfileCertificationsCommand(): Command;
+/**
+ * Pretty-print a Certification row. Pure — no I/O.
+ */
+export declare function formatCertificationText(c: profile.certifications.Certification): string;
+/**
+ * Pretty-print a Certification row as a key/value table.
+ */
+export declare function formatCertificationTable(c: profile.certifications.Certification): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/profile/certifications/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/profile/certifications/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAkC,OAAO,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAO5C;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iCAAiC,IAAI,OAAO,CAoF3D;AAmLD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,aAAa,GAAG,MAAM,CAQvF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,aAAa,GAAG,MAAM,CAWxF"}