@ttctl/cli 0.0.0 → 0.1.0-rc.1

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

@@ -0,0 +1,40 @@
+import { profile } from "@ttctl/core";
+import { Command } from "commander";
+/**
+ * Build the `ttctl profile employment` command tree.
+ *
+ * The canonical sub-domain name is `employment`; the CLI registers
+ * `experience` 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.
+ *
+ * Six leaves:
+ *   - `add --company --role [--from --to --current]`
+ *   - `update <id> [field-flags] [--description --edit]`
+ *   - `remove <id>`
+ *   - `show <id> [-o text|json|table]`
+ *   - `highlight <id>`
+ *   - `employer-autocomplete <query>` — looks up known employer names
+ *
+ * Date input flags accept ISO-8601 (`2023-01-15`) or year-only (`2023`).
+ * Employment stores year only (Int field), so the helper drops month/day.
+ *
+ * `update --description` is multi-paragraph free-text via the four-mode
+ * helper from `lib/freetext.ts` (#70): inline, stdin (`-`), file (`@path`),
+ * editor (`--edit`).
+ */
+export declare function buildProfileEmploymentCommand(): Command;
+/**
+ * Pretty-print an Employment row.
+ */
+export declare function formatEmploymentText(e: profile.employment.Employment): string;
+/**
+ * Pretty-print an Employment row as a key/value table.
+ */
+export declare function formatEmploymentTable(e: profile.employment.Employment): string;
+/**
+ * Pretty-print employer-autocomplete suggestions.
+ */
+export declare function formatEmployersText(suggestions: profile.employment.EmployerSuggestion[]): string;
+export declare function formatEmployersTable(suggestions: profile.employment.EmployerSuggestion[]): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/profile/employment/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAkC,OAAO,EAAmB,MAAM,aAAa,CAAC;AACvF,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAc5C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,6BAA6B,IAAI,OAAO,CAuGvD;AAqND;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,UAAU,GAAG,MAAM,CAY7E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,UAAU,GAAG,MAAM,CAW9E;AASD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,GAAG,MAAM,CAUhG;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,GAAG,MAAM,CAKjG"}

package/dist/commands/profile/employment/index.js

@@ -0,0 +1,364 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { DateInputError, parseDateInput, profile, splitParagraphs } from "@ttctl/core";
+import { Command, Option } from "commander";
+import { emitAddSuccess, emitErrorAndExit, emitRemoveSuccess, emitUpdateSuccess, wrapListEnvelope, } from "../../../lib/envelopes.js";
+import { FreeTextError, resolveFreeText } from "../../../lib/freetext.js";
+import { OUTPUT_FORMATS, emitResult } from "../../../lib/output.js";
+import { loadAuthTokenOrExit, parseLimitOrExit, presentSubDomainError } from "../shared.js";
+/**
+ * Build the `ttctl profile employment` command tree.
+ *
+ * The canonical sub-domain name is `employment`; the CLI registers
+ * `experience` 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.
+ *
+ * Six leaves:
+ *   - `add --company --role [--from --to --current]`
+ *   - `update <id> [field-flags] [--description --edit]`
+ *   - `remove <id>`
+ *   - `show <id> [-o text|json|table]`
+ *   - `highlight <id>`
+ *   - `employer-autocomplete <query>` — looks up known employer names
+ *
+ * Date input flags accept ISO-8601 (`2023-01-15`) or year-only (`2023`).
+ * Employment stores year only (Int field), so the helper drops month/day.
+ *
+ * `update --description` is multi-paragraph free-text via the four-mode
+ * helper from `lib/freetext.ts` (#70): inline, stdin (`-`), file (`@path`),
+ * editor (`--edit`).
+ */
+export function buildProfileEmploymentCommand() {
+    const employment = new Command("employment")
+        .alias("experience")
+        .description("View and update the employment history section of your profile");
+    employment
+        .command("add")
+        .description("Add a new employment entry to your profile")
+        .requiredOption("--company <name>", "company / employer name")
+        .requiredOption("--role <title>", "job title (mapped to position)")
+        .option("--from <date>", "start date — ISO-8601 (YYYY-MM-DD) or year (YYYY)")
+        .option("--to <date>", "end date — ISO-8601 or year")
+        .option("--current", "current position (no end date)", false)
+        .option("--website <url>", "company website (optional)")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (options) => {
+        await runAdd(options);
+    });
+    employment
+        .command("update")
+        .description("Update an existing employment entry by id")
+        .argument("<id>", "employment id (V1-Employment-NNN)")
+        .option("--company <name>", "company name")
+        .option("--role <title>", "job title")
+        .option("--from <date>", "start date — ISO-8601 or year")
+        .option("--to <date>", "end date — ISO-8601 or year")
+        .option("--current", "mark as current position (clears end date)", false)
+        .option("--website <url>", "company website")
+        .option("--description <text>", 'multi-paragraph description (inline text, "-" for stdin, or "@path" to read from file)')
+        .option("--edit", "open $EDITOR to compose the description (cannot be combined with --description)", false)
+        .option("--highlight <bool>", "set highlight flag (true|false)")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (id, options) => {
+        await runUpdate(id, options);
+    });
+    employment
+        .command("remove")
+        .description("Remove an employment entry by id")
+        .argument("<id>", "employment id")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (id, options) => {
+        await runRemove(id, options.output);
+    });
+    employment
+        .command("show")
+        .description("Show a single employment entry by id")
+        .argument("<id>", "employment id")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (id, options) => {
+        await runShow(id, options.output);
+    });
+    employment
+        .command("highlight")
+        .description("Toggle highlight on an employment entry")
+        .argument("<id>", "employment id")
+        .option("--off", "un-highlight (default is to highlight)", false)
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (id, options) => {
+        await runHighlight(id, !options.off, options.output);
+    });
+    employment
+        .command("employer-autocomplete")
+        .description('Search the known-employer catalog for a name (e.g. "Google")')
+        .argument("<query>", "search term")
+        .option("--limit <n>", "max results (default 10)", "10")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (query, options) => {
+        await runEmployerAutocomplete(query, options);
+    });
+    return employment;
+}
+async function runAdd(options) {
+    const fields = {
+        company: options.company,
+        position: options.role,
+    };
+    if (options.website !== undefined) {
+        fields.companyWebsite = options.website;
+        fields.noWebsite = false;
+    }
+    applyDateFlags(fields, options, "profile employment add", options.output);
+    if (options.current)
+        fields.endDate = null;
+    const token = await loadAuthTokenOrExit("profile employment add", options.output);
+    let result;
+    try {
+        result = await profile.employment.add(token, fields);
+    }
+    catch (err) {
+        presentSubDomainError("profile employment add", err, options.output);
+    }
+    emitAddSuccess({
+        operation: "profile.employment.add",
+        format: options.output,
+        created: result,
+        prettySummary: `${result.position} — ${result.company} (id ${result.id})`,
+        prettyEntity: formatEmploymentText,
+    });
+}
+async function runUpdate(id, options) {
+    const fields = {};
+    if (options.company !== undefined)
+        fields.company = options.company;
+    if (options.role !== undefined)
+        fields.position = options.role;
+    if (options.website !== undefined) {
+        fields.companyWebsite = options.website;
+        fields.noWebsite = false;
+    }
+    if (options.highlight !== undefined) {
+        if (options.highlight !== "true" && options.highlight !== "false") {
+            emitErrorAndExit({
+                operation: "profile.employment.update",
+                format: options.output,
+                errors: [
+                    {
+                        code: "VALIDATION_ERROR",
+                        field: "highlight",
+                        message: '--highlight expects "true" or "false"',
+                    },
+                ],
+                prettySummary: 'profile employment update failed (VALIDATION_ERROR): --highlight expects "true" or "false"',
+            });
+        }
+        fields.highlight = options.highlight === "true";
+    }
+    applyDateFlags(fields, options, "profile employment update", options.output);
+    if (options.current)
+        fields.endDate = null;
+    // Resolve --description / --edit through the four-mode free-text helper
+    // (inline, stdin "-", "@path", $EDITOR). The helper rejects mode
+    // combinations (e.g. --description with --edit) before any network I/O.
+    let description;
+    try {
+        description = await resolveFreeText(options.description, {
+            flagName: "description",
+            enableEditor: options.edit,
+        });
+    }
+    catch (err) {
+        if (err instanceof FreeTextError) {
+            emitErrorAndExit({
+                operation: "profile.employment.update",
+                format: options.output,
+                errors: [{ code: err.code, message: err.message }],
+                prettySummary: `profile employment update failed (${err.code}): ${err.message}`,
+            });
+        }
+        throw err;
+    }
+    if (description !== undefined) {
+        // Multi-paragraph descriptions split on blank lines into experienceItems
+        // (the API stores each paragraph as a separate row, per the
+        // UpdateEmploymentInput capture's `experienceItems: 3-10 items`).
+        fields.experienceItems = splitParagraphs(description);
+    }
+    if (Object.keys(fields).length === 0) {
+        emitErrorAndExit({
+            operation: "profile.employment.update",
+            format: options.output,
+            errors: [{ code: "VALIDATION_ERROR", message: "at least one field flag is required" }],
+            prettySummary: "profile employment update failed (VALIDATION_ERROR): at least one field flag is required",
+        });
+    }
+    const token = await loadAuthTokenOrExit("profile employment update", options.output);
+    let result;
+    try {
+        result = await profile.employment.update(token, id, fields);
+    }
+    catch (err) {
+        presentSubDomainError("profile employment update", err, options.output);
+    }
+    emitUpdateSuccess({
+        operation: "profile.employment.update",
+        format: options.output,
+        updated: result,
+        prettySummary: `${result.position} — ${result.company} (id ${result.id})`,
+        prettyEntity: formatEmploymentText,
+    });
+}
+async function runRemove(id, format) {
+    const token = await loadAuthTokenOrExit("profile employment remove", format);
+    let removedId;
+    try {
+        removedId = await profile.employment.remove(token, id);
+    }
+    catch (err) {
+        presentSubDomainError("profile employment remove", err, format);
+    }
+    emitRemoveSuccess({
+        operation: "profile.employment.remove",
+        format,
+        id: removedId,
+    });
+}
+async function runShow(id, format) {
+    const token = await loadAuthTokenOrExit("profile employment show", format);
+    let result;
+    try {
+        result = await profile.employment.show(token, id);
+    }
+    catch (err) {
+        presentSubDomainError("profile employment show", err, format);
+    }
+    emitResult(result, format, { pretty: formatEmploymentText, table: formatEmploymentTable });
+}
+async function runHighlight(id, value, format) {
+    const token = await loadAuthTokenOrExit("profile employment highlight", format);
+    let result;
+    try {
+        result = await profile.employment.highlight(token, id, value);
+    }
+    catch (err) {
+        presentSubDomainError("profile employment highlight", err, format);
+    }
+    emitUpdateSuccess({
+        operation: "profile.employment.highlight",
+        format,
+        updated: result,
+        prettySummary: `${result.id} highlight set to ${result.highlight.toString()}`,
+        prettyEntity: (entity) => `highlight: ${entity.highlight.toString()}`,
+    });
+}
+async function runEmployerAutocomplete(query, options) {
+    const limit = parseLimitOrExit(options.limit, "profile employment employer-autocomplete", options.output);
+    const token = await loadAuthTokenOrExit("profile employment employer-autocomplete", options.output);
+    let suggestions;
+    try {
+        suggestions = await profile.employment.employerAutocomplete(token, query, limit);
+    }
+    catch (err) {
+        presentSubDomainError("profile employment employer-autocomplete", err, options.output);
+    }
+    emitResult(wrapListEnvelope(suggestions), options.output, {
+        pretty: (data) => formatEmployersText(data.items),
+        table: (data) => formatEmployersTable(data.items),
+    });
+}
+function applyDateFlags(fields, options, commandLabel, format) {
+    try {
+        if (options.from !== undefined)
+            fields.startDate = parseDateInput(options.from, "from").year;
+        if (options.to !== undefined)
+            fields.endDate = parseDateInput(options.to, "to").year;
+    }
+    catch (err) {
+        if (err instanceof DateInputError) {
+            emitErrorAndExit({
+                operation: commandLabel.replace(/ /g, "."),
+                format,
+                errors: [{ code: err.code, message: err.message }],
+                prettySummary: `${commandLabel} failed (${err.code}): ${err.message}`,
+            });
+        }
+        throw err;
+    }
+}
+/**
+ * Pretty-print an Employment row.
+ */
+export function formatEmploymentText(e) {
+    const lines = [`${e.position} — ${e.company}`];
+    if (e.companyWebsite && !e.noWebsite)
+        lines.push(`  ${e.companyWebsite}`);
+    lines.push(`  ${formatYearRange(e.startDate, e.endDate)}`);
+    if (e.experienceItems && e.experienceItems.length > 0) {
+        for (const item of e.experienceItems) {
+            lines.push(`  • ${item}`);
+        }
+    }
+    if (e.highlight)
+        lines.push(`  highlighted`);
+    lines.push(`  id: ${e.id}`);
+    return lines.join("\n");
+}
+/**
+ * Pretty-print an Employment row as a key/value table.
+ */
+export function formatEmploymentTable(e) {
+    const rows = [
+        ["id", e.id],
+        ["company", e.company],
+        ["position", e.position],
+        ["website", e.companyWebsite ?? ""],
+        ["years", formatYearRange(e.startDate, e.endDate)],
+        ["highlight", e.highlight.toString()],
+        ["paragraphs", (e.experienceItems?.length ?? 0).toString()],
+    ];
+    return rows.map(([k, v]) => `${k}\t${v}`).join("\n");
+}
+function formatYearRange(from, to) {
+    if (from === null && to === null)
+        return "—";
+    if (from !== null && to === null)
+        return `${from.toString()}–present`;
+    if (from === null && to !== null)
+        return `?–${to.toString()}`;
+    return `${(from ?? 0).toString()}–${(to ?? 0).toString()}`;
+}
+/**
+ * Pretty-print employer-autocomplete suggestions.
+ */
+export function formatEmployersText(suggestions) {
+    if (suggestions.length === 0)
+        return "(no matches)";
+    return suggestions
+        .map((e) => {
+        const loc = [e.city, e.country].filter((v) => v !== null && v !== "").join(", ");
+        return [`${e.name}${loc ? ` (${loc})` : ""}`, `  id: ${e.id}`, e.website ? `  ${e.website}` : null]
+            .filter((line) => line !== null)
+            .join("\n");
+    })
+        .join("\n\n");
+}
+export function formatEmployersTable(suggestions) {
+    if (suggestions.length === 0)
+        return "(no matches)";
+    return suggestions
+        .map((e) => `${e.id}\t${e.name}\t${e.city ?? ""}\t${e.country ?? ""}\t${e.website ?? ""}`)
+        .join("\n");
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/profile/employment/index.js.map

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

package/dist/commands/profile/external/_shared.d.ts

@@ -0,0 +1,35 @@
+import type { OutputFormat } from "../../../lib/output.js";
+/**
+ * Shared helpers for `ttctl profile external` leaves.
+ *
+ * Re-exports `loadAuthTokenOrExit` from the parent `../shared.ts` so the
+ * sub-tree leaves can keep their `from "./_shared.js"` import shape
+ * unchanged across the #107 refactor. (Pre-#107 each sub-tree had its own
+ * implementation; post-#107 the auth-token logic is centralised at
+ * profile/shared.ts to consume the in-memory `config.auth.token`.)
+ */
+export { loadAuthTokenOrExit } from "../shared.js";
+/**
+ * Truncate `s` to `width` characters with an ellipsis. Mirrors the helper
+ * exported by `profile/basic/show.ts`.
+ */
+export declare function truncate(s: string, width: number): string;
+/**
+ * Parse a `commander` boolean flag value into a TypeScript `boolean`.
+ *
+ * Commander's `--flag <value>` parses as a string; we convert
+ * `"true"`/`"false"` (and a couple of common shorthand forms) to booleans
+ * and exit through the v0.4 envelope ABI on unrecognised input. The
+ * `operation` argument is the command's canonical operation slug
+ * (`profile.external.custom-requirements.set`) so envelope consumers can
+ * branch on it; `format` controls whether the failure surfaces as a
+ * pretty stderr line or as a JSON/YAML error envelope on stdout.
+ *
+ * Why explicit string parsing instead of a `--flag` / `--no-flag` boolean?
+ * The custom-requirements set has THREE booleans, and Commander's no-flag
+ * negation would force the user to remember three negative-form flag names.
+ * `--background-check true|false` reads the same regardless of the value
+ * and matches the wire-shape (which is also `Boolean!`).
+ */
+export declare function parseBooleanFlag(commandLabel: string, operation: string, flagName: string, value: string, format: OutputFormat): boolean;
+//# sourceMappingURL=_shared.d.ts.map

package/dist/commands/profile/external/_shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_shared.d.ts","sourceRoot":"","sources":["../../../../src/commands/profile/external/_shared.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;;;;;;;GAQG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,YAAY,GACnB,OAAO,CAgBT"}

package/dist/commands/profile/external/_shared.js

@@ -0,0 +1,59 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { emitErrorAndExit } from "../../../lib/envelopes.js";
+/**
+ * Shared helpers for `ttctl profile external` leaves.
+ *
+ * Re-exports `loadAuthTokenOrExit` from the parent `../shared.ts` so the
+ * sub-tree leaves can keep their `from "./_shared.js"` import shape
+ * unchanged across the #107 refactor. (Pre-#107 each sub-tree had its own
+ * implementation; post-#107 the auth-token logic is centralised at
+ * profile/shared.ts to consume the in-memory `config.auth.token`.)
+ */
+export { loadAuthTokenOrExit } from "../shared.js";
+/**
+ * Truncate `s` to `width` characters with an ellipsis. Mirrors the helper
+ * exported by `profile/basic/show.ts`.
+ */
+export function truncate(s, width) {
+    if (s.length <= width)
+        return s;
+    return `${s.slice(0, width - 1)}…`;
+}
+/**
+ * Parse a `commander` boolean flag value into a TypeScript `boolean`.
+ *
+ * Commander's `--flag <value>` parses as a string; we convert
+ * `"true"`/`"false"` (and a couple of common shorthand forms) to booleans
+ * and exit through the v0.4 envelope ABI on unrecognised input. The
+ * `operation` argument is the command's canonical operation slug
+ * (`profile.external.custom-requirements.set`) so envelope consumers can
+ * branch on it; `format` controls whether the failure surfaces as a
+ * pretty stderr line or as a JSON/YAML error envelope on stdout.
+ *
+ * Why explicit string parsing instead of a `--flag` / `--no-flag` boolean?
+ * The custom-requirements set has THREE booleans, and Commander's no-flag
+ * negation would force the user to remember three negative-form flag names.
+ * `--background-check true|false` reads the same regardless of the value
+ * and matches the wire-shape (which is also `Boolean!`).
+ */
+export function parseBooleanFlag(commandLabel, operation, flagName, value, format) {
+    const normalised = value.trim().toLowerCase();
+    if (normalised === "true" || normalised === "1" || normalised === "yes")
+        return true;
+    if (normalised === "false" || normalised === "0" || normalised === "no")
+        return false;
+    emitErrorAndExit({
+        operation,
+        format,
+        errors: [
+            {
+                code: "VALIDATION_ERROR",
+                field: flagName,
+                message: `--${flagName} expects true|false (got: ${value})`,
+            },
+        ],
+        prettySummary: `${commandLabel} failed (VALIDATION_ERROR): --${flagName} expects true|false (got: ${value})`,
+    });
+}
+//# sourceMappingURL=_shared.js.map

package/dist/commands/profile/external/_shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_shared.js","sourceRoot":"","sources":["../../../../src/commands/profile/external/_shared.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAG7D;;;;;;;;GAQG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,CAAS,EAAE,KAAa;IAC/C,IAAI,CAAC,CAAC,MAAM,IAAI,KAAK;QAAE,OAAO,CAAC,CAAC;IAChC,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC;AACrC,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,gBAAgB,CAC9B,YAAoB,EACpB,SAAiB,EACjB,QAAgB,EAChB,KAAa,EACb,MAAoB;IAEpB,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,IAAI,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IACrF,IAAI,UAAU,KAAK,OAAO,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACtF,gBAAgB,CAAC;QACf,SAAS;QACT,MAAM;QACN,MAAM,EAAE;YACN;gBACE,IAAI,EAAE,kBAAkB;gBACxB,KAAK,EAAE,QAAQ;gBACf,OAAO,EAAE,KAAK,QAAQ,6BAA6B,KAAK,GAAG;aAC5D;SACF;QACD,aAAa,EAAE,GAAG,YAAY,iCAAiC,QAAQ,6BAA6B,KAAK,GAAG;KAC7G,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/profile/external/advanced-wizard-show.d.ts

@@ -0,0 +1,15 @@
+import { profile } from "@ttctl/core";
+import type { OutputFormat } from "../../../lib/output.js";
+/**
+ * Action handler for `ttctl profile external advanced-wizard show`.
+ *
+ * Combines `getAdvancedProfileData` and the wizard-status read into one
+ * leaf — `getAdvancedProfileData` already exposes
+ * `advancedProfileWizardStatus`, so a single query suffices.
+ */
+export declare function runProfileExternalAdvancedWizardShow(format: OutputFormat): Promise<void>;
+/** Pure formatter — directly unit-testable. */
+export declare function formatAdvancedWizardText(data: profile.external.AdvancedProfileSnapshot): string;
+/** Pure formatter — directly unit-testable. */
+export declare function formatAdvancedWizardTable(data: profile.external.AdvancedProfileSnapshot): string;
+//# sourceMappingURL=advanced-wizard-show.d.ts.map

package/dist/commands/profile/external/advanced-wizard-show.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced-wizard-show.d.ts","sourceRoot":"","sources":["../../../../src/commands/profile/external/advanced-wizard-show.ts"],"names":[],"mappings":"AAGA,OAAO,EAAc,OAAO,EAAE,MAAM,aAAa,CAAC;AAMlD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAM3D;;;;;;GAMG;AACH,wBAAsB,oCAAoC,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAe9F;AA8BD,+CAA+C;AAC/C,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,uBAAuB,GAAG,MAAM,CAW/F;AAED,+CAA+C;AAC/C,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,uBAAuB,GAAG,MAAM,CAOhG"}

package/dist/commands/profile/external/advanced-wizard-show.js

@@ -0,0 +1,82 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { TtctlError, profile } from "@ttctl/core";
+import { presentTtctlError } from "../../../errors.js";
+import { emitErrorAndExit } from "../../../lib/envelopes.js";
+import { emitResult } from "../../../lib/output.js";
+import { loadAuthTokenOrExit } from "./_shared.js";
+const COMMAND_LABEL = "profile external advanced-wizard show";
+const OPERATION = "profile.external.advanced-wizard.show";
+/**
+ * Action handler for `ttctl profile external advanced-wizard show`.
+ *
+ * Combines `getAdvancedProfileData` and the wizard-status read into one
+ * leaf — `getAdvancedProfileData` already exposes
+ * `advancedProfileWizardStatus`, so a single query suffices.
+ */
+export async function runProfileExternalAdvancedWizardShow(format) {
+    const token = await loadAuthTokenOrExit(COMMAND_LABEL, format);
+    let result;
+    try {
+        result = await profile.external.advancedWizardShow(token);
+    }
+    catch (err) {
+        handleError(err, format);
+        return;
+    }
+    emitResult(result, format, {
+        pretty: formatAdvancedWizardText,
+        table: formatAdvancedWizardTable,
+    });
+}
+function handleError(err, format) {
+    if (err instanceof TtctlError) {
+        if (format === "pretty")
+            presentTtctlError(err);
+        const errors = [{ code: err.code, message: err.message, hint: err.recovery }];
+        emitErrorAndExit({
+            operation: OPERATION,
+            format,
+            errors,
+            exitCode: err.code === "CF_403_CLEARANCE" || err.code === "CF_403_PERSISTENT" ? 2 : 1,
+        });
+    }
+    if (err instanceof profile.external.ProfileError) {
+        emitErrorAndExit({
+            operation: OPERATION,
+            format,
+            errors: [{ code: err.code, message: err.message }],
+            prettySummary: `${COMMAND_LABEL} failed (${err.code}): ${err.message}`,
+        });
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    emitErrorAndExit({
+        operation: OPERATION,
+        format,
+        errors: [{ code: "INTERNAL_ERROR", message }],
+        prettySummary: `${COMMAND_LABEL} failed: ${message}`,
+    });
+}
+/** Pure formatter — directly unit-testable. */
+export function formatAdvancedWizardText(data) {
+    const lines = [
+        `Advanced profile wizard status: ${data.wizardStatus ?? "(unset)"}`,
+        `  travel-visa-count: ${data.travelVisaCount.toString()}`,
+    ];
+    if (data.travelVisaIds.length > 0) {
+        const preview = data.travelVisaIds.slice(0, 5).join(", ");
+        const more = data.travelVisaIds.length > 5 ? ` (+${(data.travelVisaIds.length - 5).toString()} more)` : "";
+        lines.push(`  travel-visa-ids:   ${preview}${more}`);
+    }
+    return lines.join("\n");
+}
+/** Pure formatter — directly unit-testable. */
+export function formatAdvancedWizardTable(data) {
+    const rows = [
+        ["wizard-status", data.wizardStatus ?? ""],
+        ["travel-visa-count", data.travelVisaCount.toString()],
+        ["travel-visa-ids", data.travelVisaIds.join(",")],
+    ];
+    return rows.map(([k, v]) => `${k}\t${v}`).join("\n");
+}
+//# sourceMappingURL=advanced-wizard-show.js.map

package/dist/commands/profile/external/advanced-wizard-show.js.map

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