@ttctl/cli 0.0.0 → 0.1.0-rc.2

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

@@ -0,0 +1,121 @@
+// 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 { runProfilePortfolioAdd } from "./add.js";
+import { runProfilePortfolioHighlight } from "./highlight.js";
+import { runProfilePortfolioList } from "./list.js";
+import { runProfilePortfolioRemove } from "./remove.js";
+import { runProfilePortfolioReorder } from "./reorder.js";
+import { runProfilePortfolioUpdate } from "./update.js";
+import { runProfilePortfolioUpload } from "./upload.js";
+/**
+ * Build the `ttctl profile portfolio` command tree.
+ *
+ * The canonical sub-domain name is `portfolio`; the CLI registers
+ * `projects` 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.
+ *
+ * The seven leaves follow the verb economy from the #68 epic:
+ * `add / update / remove / list / reorder / highlight / upload`. The
+ * `update` verb name is the user-facing CLI form; the core function is
+ * `update()` (no rename — verbs match between CLI and core for portfolio).
+ */
+export function buildProfilePortfolioCommand() {
+    const portfolio = new Command("portfolio")
+        .alias("projects")
+        .description("View and update the portfolio section of your profile");
+    portfolio
+        .command("add")
+        .description("Create a new portfolio item")
+        .requiredOption("--title <text>", "portfolio item title")
+        .option("--description <text>", 'item description (inline text, "-" for stdin, or "@path" to read from file)')
+        .option("--edit", "open $EDITOR to compose the description interactively")
+        .option("--url <url>", "primary URL for the item (alias for --link)")
+        .option("--link <url>", "primary URL for the item (canonical flag, equivalent to --url)")
+        .option("--cover <file>", "path to a cover-image file to upload alongside the item")
+        .option("--industry-id <id>", 'catalog Industry id (repeatable; required — at least one). Discover via `ttctl profile industries autocomplete "<query>"`.', (value, prev) => (prev ? [...prev, value] : [value]))
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (options) => {
+        await runProfilePortfolioAdd(options);
+    });
+    portfolio
+        .command("update")
+        .description("Update fields on a portfolio item")
+        .argument("<id>", "id of the portfolio item to update")
+        .option("--title <text>", "portfolio item title")
+        .option("--description <text>", 'item description (inline text, "-" for stdin, or "@path" to read from file)')
+        .option("--edit", "open $EDITOR to compose the description interactively")
+        .option("--url <url>", "primary URL for the item (alias for --link)")
+        .option("--link <url>", "primary URL for the item (canonical flag, equivalent to --url)")
+        .option("--client <name>", "client/company name")
+        .option("--accomplishment <text>", "accomplishment summary")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (id, options) => {
+        await runProfilePortfolioUpdate(id, options);
+    });
+    portfolio
+        .command("remove")
+        .alias("rm")
+        .description("Remove a portfolio item")
+        .argument("<id>", "id of the portfolio item to remove")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (id, options) => {
+        await runProfilePortfolioRemove(id, options.output);
+    });
+    portfolio
+        .command("list")
+        .description("List portfolio items")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (options) => {
+        await runProfilePortfolioList(options.output);
+    });
+    portfolio
+        .command("reorder")
+        .description("Reorder a portfolio item")
+        .argument("<id>", "id of the portfolio item to move")
+        .option("--before <id>", "place the item immediately before this neighbour id")
+        .option("--after <id>", "place the item immediately after this neighbour id")
+        .option("--to <position>", "place the item at this absolute 0-based position")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (id, options) => {
+        await runProfilePortfolioReorder(id, options);
+    });
+    portfolio
+        .command("highlight")
+        .description("Toggle the highlight flag on a portfolio item (default: enable)")
+        .argument("<id>", "id of the portfolio item to highlight")
+        .option("--off", "clear the highlight flag instead of setting it")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (id, options) => {
+        await runProfilePortfolioHighlight(id, options);
+    });
+    portfolio
+        .command("upload")
+        .description("Upload a cover image (--cover) or attachment file (--file) for the user's portfolio")
+        .argument("[id]", "(unused; reserved for future per-item upload routing)")
+        .option("--cover <file>", "path to a cover-image file to upload")
+        .option("--file <file>", "path to a portfolio-attachment file to upload")
+        .option("--crop <x,y,w,h>", "cover crop (px), comma-separated x,y,w,h; default: whole image (PNG) or sentinel oversize")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (id, options) => {
+        await runProfilePortfolioUpload(id, options);
+    });
+    return portfolio;
+}
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,83 @@
+import { profile } from "@ttctl/core";
+import type { OutputFormat } from "../../../lib/output.js";
+/**
+ * Action handler for `ttctl profile portfolio list`. Reads the user's
+ * portfolio collection and emits it via the cross-CLI output helper
+ * (`packages/cli/src/lib/output.ts` from #71), wrapped in the v0.4
+ * list envelope (`{version, items, pageInfo?}` from #128) for
+ * json/yaml.
+ *
+ * Per #129, the `pretty` slot is registered with `emitResult` and
+ * unwraps the envelope's `items` field for the curated multi-line
+ * layout that surfaces `description`, `accomplishment`, `coverImage`,
+ * and `clientOrCompanyName` (the audit-confirmed dropped fields from
+ * #124). The `table` slot is also wired (also unwrapping `items`) —
+ * `formatResult`'s shape dispatcher prefers `table` for list-shape
+ * data when present, but the audit's Override Registry Decisions
+ * endorse routing portfolio list to multi-line because
+ * `description`/`accomplishment` are paragraph-length and the
+ * row-based table layout collapses them. {@link formatPortfolioTable}
+ * stays exported for direct test use and future override-dispatch
+ * wiring.
+ *
+ * Empty case is handled by the shared empty-state wrapper (#122) via
+ * `empty: { command: "profile.portfolio.list" }`. The wrapper detects
+ * both `[]` and `{items: []}` shapes (per #122's `isEmptyCollection`),
+ * so the post-#128 envelope wrapping continues to short-circuit
+ * BEFORE per-format dispatch — emitting `"No portfolio items found.
+ * Add one with: ttctl profile portfolio add"` for `pretty`, `[]` for
+ * `json`. The formatters keep a defensive empty-list branch for
+ * direct callers (tests, future programmatic use) that bypass the
+ * action handler.
+ */
+export declare function runProfilePortfolioList(format: OutputFormat): Promise<void>;
+/**
+ * Format the portfolio list as the post-#129 `pretty` summary. Pure —
+ * no I/O — directly unit-testable.
+ *
+ * Per-item layout, indented two spaces from the count header:
+ *
+ *   <id>[ ★] <title>
+ *     Client: <clientOrCompanyName>     // skip-if-null
+ *     URL: <link>                        // skip-if-null
+ *     Cover: <coverImage>                // skip-if-null
+ *     Description:                       // always (renders (unset) on null)
+ *       <body, paragraph breaks preserved>
+ *     Accomplishment:                    // skip-if-null (multi-paragraph)
+ *       <body>
+ *
+ * Items are separated by a single blank line. Field ordering for each
+ * item: identity (id, highlight star, title) first, then user-edited
+ * narrative (client, url, cover, description, accomplishment) — most
+ * user-edited last because they're the multi-line block fields that
+ * benefit from sticking to the bottom of the item.
+ *
+ * Closes the audit-confirmed formatter-root-cause defect from #124:
+ * `description`, `accomplishment`, `coverImage`, and
+ * `clientOrCompanyName` are now visible in the default output (the
+ * pre-#129 formatter dropped 7 of 12 entity fields).
+ *
+ * `tags` and `media` are NOT on the wire `PortfolioItem` — neither the
+ * mobile-gateway nor the talent-profile schema declares them. The audit
+ * flagged them as suspect; #127 verified absence empirically. They are
+ * deliberately omitted here.
+ *
+ * Pretty does NOT truncate (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.
+ */
+export declare function formatPortfolioPretty(items: profile.portfolio.PortfolioItem[]): string;
+/**
+ * Format the portfolio list as a `cli-table3`-rendered table sized to
+ * the current terminal width. Restores the `clientOrCompanyName` column
+ * dropped by the pre-#129 formatter (audit-confirmed asymmetric drop:
+ * `text` had it, `table` didn't).
+ *
+ * Long-form fields (`description`, `accomplishment`) are NOT in the
+ * table — paragraph-length text doesn't fit a row layout. The override
+ * registry in `lib/format-overrides.ts` flags `profile portfolio list`
+ * as a candidate for the `multi-line` strategy; users wanting the full
+ * detail land on `pretty` (the post-#126 default).
+ */
+export declare function formatPortfolioTable(items: profile.portfolio.PortfolioItem[], terminalWidth?: number): string;
+//# sourceMappingURL=list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../../src/commands/profile/portfolio/list.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAKtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAI3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBjF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,aAAa,EAAE,GAAG,MAAM,CAMtF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,aAAa,EAAE,EACxC,aAAa,GAAE,MAAqC,GACnD,MAAM,CAsBR"}

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

@@ -0,0 +1,189 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import Table from "cli-table3";
+import { profile } from "@ttctl/core";
+import { wrapListEnvelope } from "../../../lib/envelopes.js";
+import { renderMultiParagraph, unsetOr } from "../../../lib/format-helpers.js";
+import { emitResult } from "../../../lib/output.js";
+import { handlePortfolioError } from "./add.js";
+import { loadAuthTokenOrExit } from "./shared.js";
+/**
+ * Action handler for `ttctl profile portfolio list`. Reads the user's
+ * portfolio collection and emits it via the cross-CLI output helper
+ * (`packages/cli/src/lib/output.ts` from #71), wrapped in the v0.4
+ * list envelope (`{version, items, pageInfo?}` from #128) for
+ * json/yaml.
+ *
+ * Per #129, the `pretty` slot is registered with `emitResult` and
+ * unwraps the envelope's `items` field for the curated multi-line
+ * layout that surfaces `description`, `accomplishment`, `coverImage`,
+ * and `clientOrCompanyName` (the audit-confirmed dropped fields from
+ * #124). The `table` slot is also wired (also unwrapping `items`) —
+ * `formatResult`'s shape dispatcher prefers `table` for list-shape
+ * data when present, but the audit's Override Registry Decisions
+ * endorse routing portfolio list to multi-line because
+ * `description`/`accomplishment` are paragraph-length and the
+ * row-based table layout collapses them. {@link formatPortfolioTable}
+ * stays exported for direct test use and future override-dispatch
+ * wiring.
+ *
+ * Empty case is handled by the shared empty-state wrapper (#122) via
+ * `empty: { command: "profile.portfolio.list" }`. The wrapper detects
+ * both `[]` and `{items: []}` shapes (per #122's `isEmptyCollection`),
+ * so the post-#128 envelope wrapping continues to short-circuit
+ * BEFORE per-format dispatch — emitting `"No portfolio items found.
+ * Add one with: ttctl profile portfolio add"` for `pretty`, `[]` for
+ * `json`. The formatters keep a defensive empty-list branch for
+ * direct callers (tests, future programmatic use) that bypass the
+ * action handler.
+ */
+export async function runProfilePortfolioList(format) {
+    const token = await loadAuthTokenOrExit("portfolio list", format);
+    let items;
+    try {
+        items = await profile.portfolio.list(token);
+    }
+    catch (err) {
+        handlePortfolioError("portfolio list", err, format);
+        return;
+    }
+    emitResult(wrapListEnvelope(items), format, {
+        pretty: (data) => formatPortfolioPretty(data.items),
+        table: (data) => formatPortfolioTable(data.items),
+        empty: { command: "profile.portfolio.list" },
+    });
+}
+/**
+ * Format the portfolio list as the post-#129 `pretty` summary. Pure —
+ * no I/O — directly unit-testable.
+ *
+ * Per-item layout, indented two spaces from the count header:
+ *
+ *   <id>[ ★] <title>
+ *     Client: <clientOrCompanyName>     // skip-if-null
+ *     URL: <link>                        // skip-if-null
+ *     Cover: <coverImage>                // skip-if-null
+ *     Description:                       // always (renders (unset) on null)
+ *       <body, paragraph breaks preserved>
+ *     Accomplishment:                    // skip-if-null (multi-paragraph)
+ *       <body>
+ *
+ * Items are separated by a single blank line. Field ordering for each
+ * item: identity (id, highlight star, title) first, then user-edited
+ * narrative (client, url, cover, description, accomplishment) — most
+ * user-edited last because they're the multi-line block fields that
+ * benefit from sticking to the bottom of the item.
+ *
+ * Closes the audit-confirmed formatter-root-cause defect from #124:
+ * `description`, `accomplishment`, `coverImage`, and
+ * `clientOrCompanyName` are now visible in the default output (the
+ * pre-#129 formatter dropped 7 of 12 entity fields).
+ *
+ * `tags` and `media` are NOT on the wire `PortfolioItem` — neither the
+ * mobile-gateway nor the talent-profile schema declares them. The audit
+ * flagged them as suspect; #127 verified absence empirically. They are
+ * deliberately omitted here.
+ *
+ * Pretty does NOT truncate (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.
+ */
+export function formatPortfolioPretty(items) {
+    if (items.length === 0)
+        return "(no portfolio items)";
+    const headerLine = `${items.length.toString()} portfolio item${items.length === 1 ? "" : "s"}:`;
+    const itemBlocks = items.map((it) => renderPortfolioItem(it));
+    return [headerLine, "", ...joinWithSeparator(itemBlocks, "")].join("\n");
+}
+/**
+ * Format the portfolio list as a `cli-table3`-rendered table sized to
+ * the current terminal width. Restores the `clientOrCompanyName` column
+ * dropped by the pre-#129 formatter (audit-confirmed asymmetric drop:
+ * `text` had it, `table` didn't).
+ *
+ * Long-form fields (`description`, `accomplishment`) are NOT in the
+ * table — paragraph-length text doesn't fit a row layout. The override
+ * registry in `lib/format-overrides.ts` flags `profile portfolio list`
+ * as a candidate for the `multi-line` strategy; users wanting the full
+ * detail land on `pretty` (the post-#126 default).
+ */
+export function formatPortfolioTable(items, terminalWidth = process.stdout.columns || 80) {
+    if (items.length === 0) {
+        const empty = new Table({ head: ["id", "title", "highlight", "client", "link"] });
+        return empty.toString();
+    }
+    const idWidth = 14;
+    const highlightWidth = 12;
+    // Three text columns share the remaining width: title, client, link.
+    // Borders + outer padding consume ~7 chars total.
+    const remaining = Math.max(60, terminalWidth - idWidth - highlightWidth - 7);
+    const titleWidth = Math.max(15, Math.floor(remaining / 3));
+    const clientWidth = Math.max(15, Math.floor(remaining / 3));
+    const linkWidth = Math.max(15, remaining - titleWidth - clientWidth);
+    const table = new Table({
+        head: ["id", "title", "highlight", "client", "link"],
+        colWidths: [idWidth, titleWidth, highlightWidth, clientWidth, linkWidth],
+        wordWrap: true,
+    });
+    for (const it of items) {
+        table.push([it.id, it.title ?? "", it.highlight ? "★" : "", it.clientOrCompanyName ?? "", it.link ?? ""]);
+    }
+    return table.toString();
+}
+/**
+ * Render one portfolio item as a multi-line block. The block is indented
+ * two spaces from the count header; the per-field detail is indented
+ * four spaces total (block indent + nested indent).
+ */
+function renderPortfolioItem(it) {
+    const blockIndent = "  ";
+    const detailIndent = "    ";
+    const star = it.highlight ? " ★" : "";
+    const title = it.title ?? "(untitled)";
+    const lines = [`${blockIndent}${it.id}${star} ${title}`];
+    if (it.clientOrCompanyName !== null) {
+        lines.push(`${detailIndent}Client: ${it.clientOrCompanyName}`);
+    }
+    if (it.link !== null) {
+        lines.push(`${detailIndent}URL: ${it.link}`);
+    }
+    if (it.coverImage !== null) {
+        lines.push(`${detailIndent}Cover: ${it.coverImage}`);
+    }
+    // Description always emits — it's the primary user-edited field, so
+    // the (unset) marker is itself the "you can edit this" signal. Multi-
+    // paragraph rendering preserves `\n\n` as actual blank lines.
+    if (it.description !== null && it.description !== "") {
+        lines.push(renderMultiParagraph("Description", it.description, detailIndent));
+    }
+    else {
+        lines.push(`${detailIndent}Description: ${unsetOr(null)}`);
+    }
+    // Accomplishment is skip-if-null per the AC's "if present" qualifier
+    // — it's secondary narrative content; rendering (unset) for every
+    // item without one would clutter long lists.
+    if (it.accomplishment !== null && it.accomplishment !== "") {
+        lines.push(renderMultiParagraph("Accomplishment", it.accomplishment, detailIndent));
+    }
+    return lines.join("\n");
+}
+/**
+ * Interleave `parts` with `separator` between every adjacent pair, like
+ * `parts.join(separator)` but yielding a string array suitable for
+ * splicing into a larger `lines` array via the spread operator.
+ *
+ * Used to produce the visible blank-line delimiter between portfolio
+ * items without a trailing separator after the last item.
+ */
+function joinWithSeparator(parts, separator) {
+    const out = [];
+    for (let i = 0; i < parts.length; i++) {
+        if (i > 0)
+            out.push(separator);
+        const part = parts[i];
+        if (part !== undefined)
+            out.push(part);
+    }
+    return out;
+}
+//# sourceMappingURL=list.js.map

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

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

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

@@ -0,0 +1,9 @@
+import type { OutputFormat } from "../../../lib/output.js";
+/**
+ * Action handler for `ttctl profile portfolio remove <id>` (alias `rm`).
+ * Removes the portfolio item by id; emits the v0.4 envelope (#128) with
+ * `removed: {id}` and renders the post-removal list under the success
+ * line in pretty mode.
+ */
+export declare function runProfilePortfolioRemove(id: string, format: OutputFormat): Promise<void>;
+//# sourceMappingURL=remove.d.ts.map

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

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

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

@@ -0,0 +1,24 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { profile } from "@ttctl/core";
+import { emitMutationResult, handlePortfolioError } from "./add.js";
+import { loadAuthTokenOrExit } from "./shared.js";
+/**
+ * Action handler for `ttctl profile portfolio remove <id>` (alias `rm`).
+ * Removes the portfolio item by id; emits the v0.4 envelope (#128) with
+ * `removed: {id}` and renders the post-removal list under the success
+ * line in pretty mode.
+ */
+export async function runProfilePortfolioRemove(id, format) {
+    const token = await loadAuthTokenOrExit("portfolio remove", format);
+    let items;
+    try {
+        items = await profile.portfolio.remove(token, id);
+    }
+    catch (err) {
+        handlePortfolioError("portfolio remove", err, format);
+        return;
+    }
+    emitMutationResult(items, format, "remove", { id, prettyHeader: id });
+}
+//# sourceMappingURL=remove.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"remove.js","sourceRoot":"","sources":["../../../../src/commands/profile/portfolio/remove.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,EAAU,EAAE,MAAoB;IAC9E,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;IAEpE,IAAI,KAAwC,CAAC;IAC7C,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,oBAAoB,CAAC,kBAAkB,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;QACtD,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/portfolio/reorder.d.ts

@@ -0,0 +1,17 @@
+import type { OutputFormat } from "../../../lib/output.js";
+/**
+ * Action handler for `ttctl profile portfolio reorder <id>`. The user
+ * supplies exactly one of `--before <id>` / `--after <id>` / `--to <pos>`;
+ * the helper translates `--before`/`--after` to an absolute position by
+ * fetching the current list, then issues `changePortfolioItemPosition`.
+ *
+ * Mutually-exclusive enforcement is at the CLI layer — the service-side
+ * `reorder()` only accepts an absolute integer position.
+ */
+export declare function runProfilePortfolioReorder(id: string, options: {
+    before?: string;
+    after?: string;
+    to?: string;
+    output: OutputFormat;
+}): Promise<void>;
+//# sourceMappingURL=reorder.d.ts.map

package/dist/commands/profile/portfolio/reorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reorder.d.ts","sourceRoot":"","sources":["../../../../src/commands/profile/portfolio/reorder.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAI3D;;;;;;;;GAQG;AACH,wBAAsB,0BAA0B,CAC9C,EAAE,EAAE,MAAM,EACV,OAAO,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GAC9E,OAAO,CAAC,IAAI,CAAC,CAsHf"}

package/dist/commands/profile/portfolio/reorder.js

@@ -0,0 +1,135 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { profile } from "@ttctl/core";
+import { emitErrorAndExit } from "../../../lib/envelopes.js";
+import { emitMutationResult, handlePortfolioError } from "./add.js";
+import { loadAuthTokenOrExit } from "./shared.js";
+/**
+ * Action handler for `ttctl profile portfolio reorder <id>`. The user
+ * supplies exactly one of `--before <id>` / `--after <id>` / `--to <pos>`;
+ * the helper translates `--before`/`--after` to an absolute position by
+ * fetching the current list, then issues `changePortfolioItemPosition`.
+ *
+ * Mutually-exclusive enforcement is at the CLI layer — the service-side
+ * `reorder()` only accepts an absolute integer position.
+ */
+export async function runProfilePortfolioReorder(id, options) {
+    const modes = [options.before !== undefined, options.after !== undefined, options.to !== undefined];
+    const modeCount = modes.filter(Boolean).length;
+    if (modeCount === 0) {
+        emitErrorAndExit({
+            operation: "profile.portfolio.reorder",
+            format: options.output,
+            errors: [
+                {
+                    code: "VALIDATION_ERROR",
+                    message: "supply exactly one of --before <id>, --after <id>, or --to <position>.",
+                },
+            ],
+            prettySummary: "portfolio reorder failed (VALIDATION_ERROR): supply exactly one of --before <id>, --after <id>, or --to <position>.",
+        });
+    }
+    if (modeCount > 1) {
+        emitErrorAndExit({
+            operation: "profile.portfolio.reorder",
+            format: options.output,
+            errors: [
+                {
+                    code: "VALIDATION_ERROR",
+                    message: "--before, --after, and --to are mutually exclusive.",
+                },
+            ],
+            prettySummary: "portfolio reorder failed (VALIDATION_ERROR): --before, --after, and --to are mutually exclusive.",
+        });
+    }
+    const token = await loadAuthTokenOrExit("portfolio reorder", options.output);
+    let position;
+    if (options.to !== undefined) {
+        const parsed = Number.parseInt(options.to, 10);
+        if (!Number.isInteger(parsed) || parsed < 0) {
+            emitErrorAndExit({
+                operation: "profile.portfolio.reorder",
+                format: options.output,
+                errors: [
+                    {
+                        code: "VALIDATION_ERROR",
+                        field: "to",
+                        message: "--to must be a non-negative integer position.",
+                    },
+                ],
+                prettySummary: "portfolio reorder failed (VALIDATION_ERROR): --to must be a non-negative integer position.",
+            });
+        }
+        position = parsed;
+    }
+    else {
+        // Need the current list to translate neighbour-anchored flags into
+        // an absolute index. The read is a separate round-trip; the cost
+        // is acceptable because reorder is a low-frequency operation.
+        let current;
+        try {
+            current = await profile.portfolio.list(token);
+        }
+        catch (err) {
+            handlePortfolioError("portfolio reorder", err, options.output);
+            return;
+        }
+        if (options.before !== undefined) {
+            // Pass `id` (the moving item) so the helper filters it out before
+            // computing the target's index. Without it, the helper would
+            // return a position that's one off in the common "A before B (A
+            // is before B in the list)" case and the server would either
+            // reject or move the item to the wrong slot. See service-layer
+            // doc comment on `positionBefore` for the post-removal semantics.
+            const result = profile.portfolio.positionBefore(current, options.before, id);
+            if (result === null) {
+                emitErrorAndExit({
+                    operation: "profile.portfolio.reorder",
+                    format: options.output,
+                    errors: [
+                        {
+                            code: "VALIDATION_ERROR",
+                            field: "before",
+                            message: `--before id '${options.before}' is not in the portfolio.`,
+                        },
+                    ],
+                    prettySummary: `portfolio reorder failed (VALIDATION_ERROR): --before id '${options.before}' is not in the portfolio.`,
+                });
+            }
+            position = result;
+        }
+        else {
+            const after = options.after;
+            // See positionBefore comment above — `id` (moving item) is
+            // filtered out before computing the target's index.
+            const result = profile.portfolio.positionAfter(current, after, id);
+            if (result === null) {
+                emitErrorAndExit({
+                    operation: "profile.portfolio.reorder",
+                    format: options.output,
+                    errors: [
+                        {
+                            code: "VALIDATION_ERROR",
+                            field: "after",
+                            message: `--after id '${after}' is not in the portfolio.`,
+                        },
+                    ],
+                    prettySummary: `portfolio reorder failed (VALIDATION_ERROR): --after id '${after}' is not in the portfolio.`,
+                });
+            }
+            position = result;
+        }
+    }
+    let items;
+    try {
+        items = await profile.portfolio.reorder(token, id, position);
+    }
+    catch (err) {
+        handlePortfolioError("portfolio reorder", err, options.output);
+        return;
+    }
+    emitMutationResult(items, options.output, "update", {
+        prettyHeader: `Portfolio item ${id} moved to position ${position.toString()}.`,
+    });
+}
+//# sourceMappingURL=reorder.js.map

package/dist/commands/profile/portfolio/reorder.js.map

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

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

@@ -0,0 +1,8 @@
+/**
+ * Shared helpers for `ttctl profile portfolio` leaves. Re-exports
+ * `loadAuthTokenOrExit` from `../shared.ts` (post-#107 unification — the
+ * separate token file is gone; auth-token resolution is centralised on
+ * the in-memory `config.auth.token`).
+ */
+export { loadAuthTokenOrExit } from "../shared.js";
+//# sourceMappingURL=shared.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../src/commands/profile/portfolio/shared.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}