@ttctl/cli 0.0.0 → 0.1.0-rc.1

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

@@ -0,0 +1,71 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { Command, Option } from "commander";
+import { OUTPUT_FORMATS } from "../../../lib/output.js";
+import { runProfileReviewsApproveItem } from "./approve-item.js";
+import { runProfileReviewsApproveSection } from "./approve-section.js";
+import { runProfileReviewsList } from "./list.js";
+import { runProfileReviewsSubmitForReview } from "./submit-for-review.js";
+/**
+ * Build the `ttctl profile reviews` command tree. See
+ * `core/services/profile/reviews/index.ts` for the per-leaf rationale and
+ * spec/API divergences (notably: the `<id>` shorthand from the issue spec
+ * is replaced by named flags because the API requires three fields per
+ * approval).
+ *
+ * Four leaves:
+ *   - list                  — pending section reviews
+ *   - approve-item          — approve one pending item
+ *   - approve-section       — approve all pending items in a section
+ *   - submit-for-review     — submit profile for platform re-review
+ *
+ * Approval is destructive (final per platform semantics). When `--dry-run`
+ * (#52) ships, this sub-tree should opt in.
+ */
+export function buildProfileReviewsCommand() {
+    const reviews = new Command("reviews").description("View and approve pending section/item reviews; submit profile for platform re-review");
+    reviews
+        .command("list")
+        .description("List pending section reviews (and their items)")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (options) => {
+        await runProfileReviewsList(options.output);
+    });
+    reviews
+        .command("approve-item")
+        .description("Approve a single pending item within a section review. " +
+        "Run `profile reviews list` first to obtain the three required IDs.")
+        .requiredOption("--review-id <id>", "section-review ID (from `profile reviews list`)")
+        .requiredOption("--item-id <id>", "underlying item ID (from `profile reviews list`)")
+        .requiredOption("--kind <kind>", "ItemReviewKind enum value (e.g. EDUCATION, EMPLOYMENT)")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (options) => {
+        await runProfileReviewsApproveItem(options);
+    });
+    reviews
+        .command("approve-section")
+        .description("Approve all pending items in a section review")
+        .requiredOption("--review-id <id>", "section-review ID (from `profile reviews list`)")
+        .requiredOption("--section <section>", "ReviewSection enum value (e.g. EDUCATION)")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (options) => {
+        await runProfileReviewsApproveSection(options);
+    });
+    reviews
+        .command("submit-for-review")
+        .description("Submit the profile for platform-side re-review (used after edits)")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (options) => {
+        await runProfileReviewsSubmitForReview(options);
+    });
+    return reviews;
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/commands/profile/reviews/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,+BAA+B,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,gCAAgC,EAAE,MAAM,wBAAwB,CAAC;AAE1E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,0BAA0B;IACxC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,CAChD,sFAAsF,CACvF,CAAC;IAEF,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,gDAAgD,CAAC;SAC7D,SAAS,CACR,IAAI,MAAM,CAAC,uBAAuB,EAAE,eAAe,CAAC;SACjD,OAAO,CAAC,cAAc,CAAC;SACvB,OAAO,CAAC,QAA+B,CAAC,CAC5C;SACA,MAAM,CAAC,KAAK,EAAE,OAAiC,EAAE,EAAE;QAClD,MAAM,qBAAqB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,cAAc,CAAC;SACvB,WAAW,CACV,yDAAyD;QACvD,oEAAoE,CACvE;SACA,cAAc,CAAC,kBAAkB,EAAE,iDAAiD,CAAC;SACrF,cAAc,CAAC,gBAAgB,EAAE,kDAAkD,CAAC;SACpF,cAAc,CAAC,eAAe,EAAE,wDAAwD,CAAC;SACzF,SAAS,CACR,IAAI,MAAM,CAAC,uBAAuB,EAAE,eAAe,CAAC;SACjD,OAAO,CAAC,cAAc,CAAC;SACvB,OAAO,CAAC,QAA+B,CAAC,CAC5C;SACA,MAAM,CAAC,KAAK,EAAE,OAAiF,EAAE,EAAE;QAClG,MAAM,4BAA4B,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,iBAAiB,CAAC;SAC1B,WAAW,CAAC,+CAA+C,CAAC;SAC5D,cAAc,CAAC,kBAAkB,EAAE,iDAAiD,CAAC;SACrF,cAAc,CAAC,qBAAqB,EAAE,2CAA2C,CAAC;SAClF,SAAS,CACR,IAAI,MAAM,CAAC,uBAAuB,EAAE,eAAe,CAAC;SACjD,OAAO,CAAC,cAAc,CAAC;SACvB,OAAO,CAAC,QAA+B,CAAC,CAC5C;SACA,MAAM,CAAC,KAAK,EAAE,OAAoE,EAAE,EAAE;QACrF,MAAM,+BAA+B,CAAC,OAAO,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,mBAAmB,CAAC;SAC5B,WAAW,CAAC,mEAAmE,CAAC;SAChF,SAAS,CACR,IAAI,MAAM,CAAC,uBAAuB,EAAE,eAAe,CAAC;SACjD,OAAO,CAAC,cAAc,CAAC;SACvB,OAAO,CAAC,QAA+B,CAAC,CAC5C;SACA,MAAM,CAAC,KAAK,EAAE,OAAiC,EAAE,EAAE;QAClD,MAAM,gCAAgC,CAAC,OAAO,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEL,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,17 @@
+import { profile } from "@ttctl/core";
+import type { OutputFormat } from "../../../lib/output.js";
+/**
+ * Action handler for `ttctl profile reviews list`.
+ *
+ * Lists pending section reviews for the signed-in user, wrapped in the
+ * v0.4 list envelope (#128). Each row carries the `reviewId` (needed by
+ * `approve-section`) and an `items` array, where each item carries its
+ * own `id` (needed by `approve-item`) and the underlying `itemId` (the
+ * entity being reviewed).
+ */
+export declare function runProfileReviewsList(format: OutputFormat): Promise<void>;
+/** Pure formatter — directly unit-testable. */
+export declare function formatReviewsText(data: profile.reviews.SectionReview[]): string;
+/** Pure formatter — directly unit-testable. */
+export declare function formatReviewsTable(data: profile.reviews.SectionReview[]): string;
+//# sourceMappingURL=list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../../src/commands/profile/reviews/list.ts"],"names":[],"mappings":"AAGA,OAAO,EAAc,OAAO,EAAE,MAAM,aAAa,CAAC;AAMlD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAK3D;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB/E;AA8BD,+CAA+C;AAC/C,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,MAAM,CAc/E;AAED,+CAA+C;AAC/C,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,MAAM,CAchF"}

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

@@ -0,0 +1,96 @@
+// 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, wrapListEnvelope } from "../../../lib/envelopes.js";
+import { emitResult } from "../../../lib/output.js";
+import { loadAuthTokenOrExit } from "./_shared.js";
+const COMMAND_LABEL = "profile reviews list";
+/**
+ * Action handler for `ttctl profile reviews list`.
+ *
+ * Lists pending section reviews for the signed-in user, wrapped in the
+ * v0.4 list envelope (#128). Each row carries the `reviewId` (needed by
+ * `approve-section`) and an `items` array, where each item carries its
+ * own `id` (needed by `approve-item`) and the underlying `itemId` (the
+ * entity being reviewed).
+ */
+export async function runProfileReviewsList(format) {
+    const token = await loadAuthTokenOrExit(COMMAND_LABEL, format);
+    let result;
+    try {
+        result = await profile.reviews.list(token);
+    }
+    catch (err) {
+        handleError(err, format);
+        return;
+    }
+    emitResult(wrapListEnvelope(result), format, {
+        pretty: (data) => formatReviewsText(data.items),
+        table: (data) => formatReviewsTable(data.items),
+        empty: { command: "profile.reviews.list" },
+    });
+}
+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: "profile.reviews.list",
+            format,
+            errors,
+            exitCode: err.code === "CF_403_CLEARANCE" || err.code === "CF_403_PERSISTENT" ? 2 : 1,
+        });
+    }
+    if (err instanceof profile.reviews.ProfileError) {
+        emitErrorAndExit({
+            operation: "profile.reviews.list",
+            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: "profile.reviews.list",
+        format,
+        errors: [{ code: "INTERNAL_ERROR", message }],
+        prettySummary: `${COMMAND_LABEL} failed: ${message}`,
+    });
+}
+/** Pure formatter — directly unit-testable. */
+export function formatReviewsText(data) {
+    if (data.length === 0)
+        return "No pending section reviews.";
+    const lines = [`Pending section reviews (${data.length.toString()}):`];
+    for (const row of data) {
+        const sectionLabel = row.section ?? "(unknown section)";
+        const requestedAt = row.requestedAt ?? "?";
+        lines.push(`  - section: ${sectionLabel}  reviewId: ${row.id}  requestedAt: ${requestedAt}`);
+        if (row.items.length > 0) {
+            for (const item of row.items) {
+                lines.push(`      item: id=${item.id}  itemId=${item.itemId}  requestedAt=${item.requestedAt ?? "?"}`);
+            }
+        }
+    }
+    return lines.join("\n");
+}
+/** Pure formatter — directly unit-testable. */
+export function formatReviewsTable(data) {
+    const header = ["section", "reviewId", "itemId", "sectionItemId", "requestedAt"];
+    if (data.length === 0)
+        return header.join("\t");
+    const rows = [header];
+    for (const row of data) {
+        if (row.items.length === 0) {
+            rows.push([row.section ?? "", row.id, "", "", row.requestedAt ?? ""]);
+            continue;
+        }
+        for (const item of row.items) {
+            rows.push([row.section ?? "", row.id, item.itemId, item.id, item.requestedAt ?? ""]);
+        }
+    }
+    return rows.map((cols) => cols.join("\t")).join("\n");
+}
+//# sourceMappingURL=list.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../../src/commands/profile/reviews/list.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE/E,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,aAAa,GAAG,sBAAsB,CAAC;AAE7C;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,MAAoB;IAC9D,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAE/D,IAAI,MAAuC,CAAC;IAC5C,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACzB,OAAO;IACT,CAAC;IAED,UAAU,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE;QAC3C,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC;QAC/C,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC;QAC/C,KAAK,EAAE,EAAE,OAAO,EAAE,sBAAsB,EAAE;KAC3C,CAAC,CAAC;AACL,CAAC;AAED,SAAS,WAAW,CAAC,GAAY,EAAE,MAAoB;IACrD,IAAI,GAAG,YAAY,UAAU,EAAE,CAAC;QAC9B,IAAI,MAAM,KAAK,QAAQ;YAAE,iBAAiB,CAAC,GAAG,CAAC,CAAC;QAChD,MAAM,MAAM,GAAoB,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC/F,gBAAgB,CAAC;YACf,SAAS,EAAE,sBAAsB;YACjC,MAAM;YACN,MAAM;YACN,QAAQ,EAAE,GAAG,CAAC,IAAI,KAAK,kBAAkB,IAAI,GAAG,CAAC,IAAI,KAAK,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SACtF,CAAC,CAAC;IACL,CAAC;IACD,IAAI,GAAG,YAAY,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;QAChD,gBAAgB,CAAC;YACf,SAAS,EAAE,sBAAsB;YACjC,MAAM;YACN,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;YAClD,aAAa,EAAE,GAAG,aAAa,YAAY,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,OAAO,EAAE;SACvE,CAAC,CAAC;IACL,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,gBAAgB,CAAC;QACf,SAAS,EAAE,sBAAsB;QACjC,MAAM;QACN,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;QAC7C,aAAa,EAAE,GAAG,aAAa,YAAY,OAAO,EAAE;KACrD,CAAC,CAAC;AACL,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,iBAAiB,CAAC,IAAqC;IACrE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,6BAA6B,CAAC;IAC5D,MAAM,KAAK,GAAa,CAAC,4BAA4B,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACjF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,YAAY,GAAG,GAAG,CAAC,OAAO,IAAI,mBAAmB,CAAC;QACxD,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,gBAAgB,YAAY,eAAe,GAAG,CAAC,EAAE,kBAAkB,WAAW,EAAE,CAAC,CAAC;QAC7F,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;gBAC7B,KAAK,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,EAAE,YAAY,IAAI,CAAC,MAAM,iBAAiB,IAAI,CAAC,WAAW,IAAI,GAAG,EAAE,CAAC,CAAC;YACzG,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,kBAAkB,CAAC,IAAqC;IACtE,MAAM,MAAM,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,eAAe,EAAE,aAAa,CAAC,CAAC;IACjF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,IAAI,GAAe,CAAC,MAAM,CAAC,CAAC;IAClC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,CAAC;YACtE,SAAS;QACX,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;YAC7B,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxD,CAAC"}

package/dist/commands/profile/reviews/submit-for-review.d.ts

@@ -0,0 +1,16 @@
+import type { OutputFormat } from "../../../lib/output.js";
+/**
+ * Action handler for `ttctl profile reviews submit-for-review`.
+ *
+ * Re-submits the talent's profile for platform-side re-review (used after
+ * profile edits that need re-verification). Emits the v0.4 update
+ * envelope (#128) — re-submission is conceptually a state transition,
+ * mapped to `update`.
+ *
+ * The underlying mutation's input shape is INFERRED — UNVERIFIED (see
+ * the service module top-comment).
+ */
+export declare function runProfileReviewsSubmitForReview(options: {
+    output: OutputFormat;
+}): Promise<void>;
+//# sourceMappingURL=submit-for-review.d.ts.map

package/dist/commands/profile/reviews/submit-for-review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit-for-review.d.ts","sourceRoot":"","sources":["../../../../src/commands/profile/reviews/submit-for-review.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAK3D;;;;;;;;;;GAUG;AACH,wBAAsB,gCAAgC,CAAC,OAAO,EAAE;IAAE,MAAM,EAAE,YAAY,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBvG"}

package/dist/commands/profile/reviews/submit-for-review.js

@@ -0,0 +1,65 @@
+// 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, emitUpdateSuccess } from "../../../lib/envelopes.js";
+import { loadAuthTokenOrExit } from "./_shared.js";
+const COMMAND_LABEL = "profile reviews submit-for-review";
+/**
+ * Action handler for `ttctl profile reviews submit-for-review`.
+ *
+ * Re-submits the talent's profile for platform-side re-review (used after
+ * profile edits that need re-verification). Emits the v0.4 update
+ * envelope (#128) — re-submission is conceptually a state transition,
+ * mapped to `update`.
+ *
+ * The underlying mutation's input shape is INFERRED — UNVERIFIED (see
+ * the service module top-comment).
+ */
+export async function runProfileReviewsSubmitForReview(options) {
+    const token = await loadAuthTokenOrExit(COMMAND_LABEL, options.output);
+    let result;
+    try {
+        result = await profile.reviews.submitForReview(token);
+    }
+    catch (err) {
+        handleError(err, options.output);
+        return;
+    }
+    emitUpdateSuccess({
+        operation: "profile.reviews.submit-for-review",
+        format: options.output,
+        updated: result,
+        prettySummary: "Profile submitted for review.",
+        notice: result.notice ?? undefined,
+    });
+}
+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: "profile.reviews.submit-for-review",
+            format,
+            errors,
+            exitCode: err.code === "CF_403_CLEARANCE" || err.code === "CF_403_PERSISTENT" ? 2 : 1,
+        });
+    }
+    if (err instanceof profile.reviews.ProfileError) {
+        emitErrorAndExit({
+            operation: "profile.reviews.submit-for-review",
+            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: "profile.reviews.submit-for-review",
+        format,
+        errors: [{ code: "INTERNAL_ERROR", message }],
+        prettySummary: `${COMMAND_LABEL} failed: ${message}`,
+    });
+}
+//# sourceMappingURL=submit-for-review.js.map

package/dist/commands/profile/reviews/submit-for-review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit-for-review.js","sourceRoot":"","sources":["../../../../src/commands/profile/reviews/submit-for-review.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAGhF,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,aAAa,GAAG,mCAAmC,CAAC;AAE1D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,gCAAgC,CAAC,OAAiC;IACtF,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAEvE,IAAI,MAA6C,CAAC;IAClD,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IACxD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACjC,OAAO;IACT,CAAC;IAED,iBAAiB,CAAC;QAChB,SAAS,EAAE,mCAAmC;QAC9C,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,MAAM;QACf,aAAa,EAAE,+BAA+B;QAC9C,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,SAAS;KACnC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,WAAW,CAAC,GAAY,EAAE,MAAoB;IACrD,IAAI,GAAG,YAAY,UAAU,EAAE,CAAC;QAC9B,IAAI,MAAM,KAAK,QAAQ;YAAE,iBAAiB,CAAC,GAAG,CAAC,CAAC;QAChD,MAAM,MAAM,GAAoB,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC/F,gBAAgB,CAAC;YACf,SAAS,EAAE,mCAAmC;YAC9C,MAAM;YACN,MAAM;YACN,QAAQ,EAAE,GAAG,CAAC,IAAI,KAAK,kBAAkB,IAAI,GAAG,CAAC,IAAI,KAAK,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SACtF,CAAC,CAAC;IACL,CAAC;IACD,IAAI,GAAG,YAAY,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;QAChD,gBAAgB,CAAC;YACf,SAAS,EAAE,mCAAmC;YAC9C,MAAM;YACN,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;YAClD,aAAa,EAAE,GAAG,aAAa,YAAY,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,OAAO,EAAE;SACvE,CAAC,CAAC;IACL,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,gBAAgB,CAAC;QACf,SAAS,EAAE,mCAAmC;QAC9C,MAAM;QACN,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;QAC7C,aAAa,EAAE,GAAG,aAAa,YAAY,OAAO,EAAE;KACrD,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,46 @@
+import type { OutputFormat } from "../../lib/output.js";
+/**
+ * Load the persisted auth token from the user's `.ttctl.yaml` (in-memory
+ * read of `config.auth.token` after `resolveConfigForCli`). Exits with a
+ * uniform `UNAUTHENTICATED` stderr message when no token is present —
+ * Form A / B configs that haven't been signed-in yet, or post-signout
+ * Form A / Form C configs where the token field was removed.
+ *
+ * Single-arg signature post-#107 — the prior dual-arg form
+ * (`loadAuthTokenOrExit(label, tokenPath)`) is gone because the token
+ * no longer lives in a separate file. Callers that need the in-memory
+ * config object alongside the token can use `resolveConfigForCli()` directly.
+ *
+ * `commandLabel` is the user-visible prefix used in the error line (e.g.
+ * `"profile education add"`); pick the leaf-verb pair that triggered the
+ * call so the user maps the error back to their command.
+ *
+ * Async signature is preserved (returns `Promise<string>`) for source-
+ * compatibility with the pre-#107 callers — every leaf already `await`s
+ * this function, and downgrading to sync would mean ~50 callers also
+ * change shape. The actual work is synchronous after `loadAuthToken` was
+ * removed alongside the separate token file.
+ */
+export declare function loadAuthTokenOrExit(commandLabel: string, format?: OutputFormat): Promise<string>;
+/**
+ * Render a domain error from any of the four sub-domain services
+ * (education, certifications, employment, industries). All four reuse
+ * `profile.basic.ProfileError` for domain errors.
+ *
+ * Thin wrapper around the shared CLI error router (#330) closed over
+ * `profile.basic.ProfileError`. No per-code hint adapter — `ProfileError`
+ * codes do not carry actionable next-step hints today.
+ *
+ * `commandLabel` is the user-facing leaf-verb pair (e.g.
+ * `"profile education add"`). Returns `never` (always exits).
+ */
+export declare function presentSubDomainError(commandLabel: string, err: unknown, format?: OutputFormat): never;
+/**
+ * Parse the `--limit` flag for autocomplete-style sub-commands. Rejects
+ * non-integers and values outside `1..50` via the envelope ABI (#128).
+ *
+ * `commandLabel` is the user-facing leaf-verb pair (e.g.
+ * `"profile industries autocomplete"`). Returns the parsed integer.
+ */
+export declare function parseLimitOrExit(raw: string, commandLabel: string, format?: OutputFormat): number;
+//# sourceMappingURL=shared.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/commands/profile/shared.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAYxD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,GAAE,YAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CA+BhH;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,YAAuB,GAAG,KAAK,CAEhH;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAE,YAAuB,GAAG,MAAM,CAiB3G"}

package/dist/commands/profile/shared.js

@@ -0,0 +1,111 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { ConfigError, profile } from "@ttctl/core";
+import { resolveConfigForCli } from "../../lib/config-context.js";
+import { emitErrorAndExit } from "../../lib/envelopes.js";
+import { handleDomainError } from "../../lib/error-routing.js";
+/**
+ * Translate the user-visible command label (`profile skills add`) into
+ * the canonical envelope `operation` value (`profile.skills.add`) used
+ * as a stable machine-readable discriminator across all envelopes for
+ * the affected verb.
+ */
+function operationFor(commandLabel) {
+    return commandLabel.replace(/ /g, ".");
+}
+/**
+ * Load the persisted auth token from the user's `.ttctl.yaml` (in-memory
+ * read of `config.auth.token` after `resolveConfigForCli`). Exits with a
+ * uniform `UNAUTHENTICATED` stderr message when no token is present —
+ * Form A / B configs that haven't been signed-in yet, or post-signout
+ * Form A / Form C configs where the token field was removed.
+ *
+ * Single-arg signature post-#107 — the prior dual-arg form
+ * (`loadAuthTokenOrExit(label, tokenPath)`) is gone because the token
+ * no longer lives in a separate file. Callers that need the in-memory
+ * config object alongside the token can use `resolveConfigForCli()` directly.
+ *
+ * `commandLabel` is the user-visible prefix used in the error line (e.g.
+ * `"profile education add"`); pick the leaf-verb pair that triggered the
+ * call so the user maps the error back to their command.
+ *
+ * Async signature is preserved (returns `Promise<string>`) for source-
+ * compatibility with the pre-#107 callers — every leaf already `await`s
+ * this function, and downgrading to sync would mean ~50 callers also
+ * change shape. The actual work is synchronous after `loadAuthToken` was
+ * removed alongside the separate token file.
+ */
+export async function loadAuthTokenOrExit(commandLabel, format = "pretty") {
+    let config;
+    try {
+        ({ config } = resolveConfigForCli());
+    }
+    catch (err) {
+        if (err instanceof ConfigError) {
+            emitErrorAndExit({
+                operation: operationFor(commandLabel),
+                format,
+                errors: [{ code: err.code, message: err.message }],
+                prettySummary: `${commandLabel} failed (${err.code}): ${err.message}`,
+            });
+        }
+        throw err;
+    }
+    const token = config.auth.token;
+    if (token === undefined) {
+        emitErrorAndExit({
+            operation: operationFor(commandLabel),
+            format,
+            errors: [
+                {
+                    code: "UNAUTHENTICATED",
+                    message: "No auth token found in config. Run `ttctl auth signin` to sign in.",
+                    hint: "ttctl auth signin",
+                },
+            ],
+            prettySummary: `${commandLabel} failed (UNAUTHENTICATED): No auth token found in config. Run \`ttctl auth signin\` to sign in.`,
+        });
+    }
+    return Promise.resolve(token);
+}
+/**
+ * Render a domain error from any of the four sub-domain services
+ * (education, certifications, employment, industries). All four reuse
+ * `profile.basic.ProfileError` for domain errors.
+ *
+ * Thin wrapper around the shared CLI error router (#330) closed over
+ * `profile.basic.ProfileError`. No per-code hint adapter — `ProfileError`
+ * codes do not carry actionable next-step hints today.
+ *
+ * `commandLabel` is the user-facing leaf-verb pair (e.g.
+ * `"profile education add"`). Returns `never` (always exits).
+ */
+export function presentSubDomainError(commandLabel, err, format = "pretty") {
+    handleDomainError(commandLabel, err, profile.basic.ProfileError, format);
+}
+/**
+ * Parse the `--limit` flag for autocomplete-style sub-commands. Rejects
+ * non-integers and values outside `1..50` via the envelope ABI (#128).
+ *
+ * `commandLabel` is the user-facing leaf-verb pair (e.g.
+ * `"profile industries autocomplete"`). Returns the parsed integer.
+ */
+export function parseLimitOrExit(raw, commandLabel, format = "pretty") {
+    const n = Number(raw);
+    if (!Number.isInteger(n) || n < 1 || n > 50) {
+        emitErrorAndExit({
+            operation: operationFor(commandLabel),
+            format,
+            errors: [
+                {
+                    code: "VALIDATION_ERROR",
+                    field: "limit",
+                    message: `--limit must be an integer between 1 and 50; got "${raw}"`,
+                },
+            ],
+            prettySummary: `${commandLabel} failed (VALIDATION_ERROR): --limit must be an integer between 1 and 50; got "${raw}"`,
+        });
+    }
+    return n;
+}
+//# sourceMappingURL=shared.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/commands/profile/shared.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAG/D;;;;;GAKG;AACH,SAAS,YAAY,CAAC,YAAoB;IACxC,OAAO,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,YAAoB,EAAE,SAAuB,QAAQ;IAC7F,IAAI,MAAwD,CAAC;IAC7D,IAAI,CAAC;QACH,CAAC,EAAE,MAAM,EAAE,GAAG,mBAAmB,EAAE,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,WAAW,EAAE,CAAC;YAC/B,gBAAgB,CAAC;gBACf,SAAS,EAAE,YAAY,CAAC,YAAY,CAAC;gBACrC,MAAM;gBACN,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;gBAClD,aAAa,EAAE,GAAG,YAAY,YAAY,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,OAAO,EAAE;aACtE,CAAC,CAAC;QACL,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;IAChC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,gBAAgB,CAAC;YACf,SAAS,EAAE,YAAY,CAAC,YAAY,CAAC;YACrC,MAAM;YACN,MAAM,EAAE;gBACN;oBACE,IAAI,EAAE,iBAAiB;oBACvB,OAAO,EAAE,oEAAoE;oBAC7E,IAAI,EAAE,mBAAmB;iBAC1B;aACF;YACD,aAAa,EAAE,GAAG,YAAY,iGAAiG;SAChI,CAAC,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB,CAAC,YAAoB,EAAE,GAAY,EAAE,SAAuB,QAAQ;IACvG,iBAAiB,CAAC,YAAY,EAAE,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;AAC3E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,YAAoB,EAAE,SAAuB,QAAQ;IACjG,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QAC5C,gBAAgB,CAAC;YACf,SAAS,EAAE,YAAY,CAAC,YAAY,CAAC;YACrC,MAAM;YACN,MAAM,EAAE;gBACN;oBACE,IAAI,EAAE,kBAAkB;oBACxB,KAAK,EAAE,OAAO;oBACd,OAAO,EAAE,qDAAqD,GAAG,GAAG;iBACrE;aACF;YACD,aAAa,EAAE,GAAG,YAAY,iFAAiF,GAAG,GAAG;SACtH,CAAC,CAAC;IACL,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

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

@@ -0,0 +1,29 @@
+import { Command } from "commander";
+import { profile } from "@ttctl/core";
+/**
+ * Parse an `--experience` flag value into an integer count of months.
+ * Accepts a bare number ("60" → 60), `Ny` ("5y" → 60), or `Nm` ("60m" →
+ * 60). Returns `null` for anything that doesn't match — the caller turns
+ * that into a `VALIDATION_ERROR` exit.
+ *
+ * Pure function — directly unit-testable.
+ */
+export declare function parseExperience(raw: string): number | null;
+export declare function formatSkillSetText(skill: profile.skills.ProfileSkillSet): string;
+export declare function formatSkillSetTable(skill: profile.skills.ProfileSkillSet): string;
+export declare function formatSkillsListText(skills: profile.skills.ProfileSkillSet[]): string;
+export declare function formatSkillsListTable(skills: profile.skills.ProfileSkillSet[]): string;
+/**
+ * Build the `ttctl profile skills` command tree. Exposes the seven leaves
+ * the issue (#73) specifies — `add`, `remove`, `update`, `show`, `list`,
+ * `autocomplete`, `readiness` — registered in the canonical name spelling
+ * (`remove`) plus the `rm` alias per the project convention introduced
+ * by issue #72 (any `remove` verb gets an `rm` alias).
+ *
+ * No top-level Commander.js alias on the sub-domain itself: the issue
+ * doesn't introduce one (#72 declares aliases only for `certifications` /
+ * `employment` / `portfolio` / `resume`), and `skills` already reads
+ * naturally as a CLI flag.
+ */
+export declare function buildProfileSkillsCommand(): Command;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/profile/skills/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAc,OAAO,EAAE,MAAM,aAAa,CAAC;AAiPlD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS1D;AA4FD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,eAAe,GAAG,MAAM,CAOhF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,eAAe,GAAG,MAAM,CASjF;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,GAAG,MAAM,CAKrF;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,GAAG,MAAM,CAYtF;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,IAAI,OAAO,CAkHnD"}