@ttctl/cli 0.0.0 → 0.1.0-rc.1

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

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

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

@@ -0,0 +1,43 @@
+import { profile } from "@ttctl/core";
+import type { OutputFormat } from "../../../lib/output.js";
+/**
+ * Action handler for `ttctl profile portfolio add`. Creates a new
+ * portfolio item; if `--cover` is supplied, the cover image is uploaded
+ * first and its server-issued `coverImageCacheName` is forwarded into
+ * the create call so the new item carries the cover from creation.
+ */
+export declare function runProfilePortfolioAdd(options: {
+    title: string;
+    description?: string;
+    edit?: boolean;
+    url?: string;
+    link?: string;
+    cover?: string;
+    industryId?: string[];
+    output: OutputFormat;
+}): Promise<void>;
+/**
+ * Route service errors through the envelope ABI (#128). `TtctlError`
+ * subclasses keep their dedicated 3-block pretty rendering on `pretty`;
+ * `json`/`yaml` flow through the envelope so machine consumers see the
+ * stable wire shape. Domain `PortfolioError` codes always flow through
+ * the envelope.
+ */
+declare function handlePortfolioError(commandLabel: string, err: unknown, format?: OutputFormat): never;
+/**
+ * Emit the post-mutation portfolio list, wrapped in the v0.4 envelope
+ * ABI (#128). The portfolio core API returns the FULL post-mutation
+ * list rather than the single mutated entity, so the envelope's
+ * `created` / `updated` field carries the list (`PortfolioItem[]`)
+ * rather than a single `PortfolioItem`. The pretty rendering keeps the
+ * existing "success header + table" UX so users continue to see the
+ * post-state at a glance.
+ */
+export declare function emitMutationResult(items: profile.portfolio.PortfolioItem[], format: OutputFormat, verb: "add" | "update" | "remove", options: {
+    id?: string;
+    prettyHeader: string;
+}): void;
+/** Backward-compatible alias; new call sites use `emitMutationResult`. */
+export declare function emitListResult(items: profile.portfolio.PortfolioItem[], format: OutputFormat, successMessage: string): void;
+export { handlePortfolioError };
+//# sourceMappingURL=add.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../../src/commands/profile/portfolio/add.ts"],"names":[],"mappings":"AAGA,OAAO,EAAc,OAAO,EAAE,MAAM,aAAa,CAAC;AAMlD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG3D;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE,YAAY,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgFhB;AAED;;;;;;GAMG;AACH,iBAAS,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,YAAuB,GAAG,KAAK,CA0BxG;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,aAAa,EAAE,EACxC,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,EACjC,OAAO,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC7C,IAAI,CAoCN;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,aAAa,EAAE,EACxC,MAAM,EAAE,YAAY,EACpB,cAAc,EAAE,MAAM,GACrB,IAAI,CAEN;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

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

@@ -0,0 +1,181 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { TtctlError, profile } from "@ttctl/core";
+import { presentTtctlError } from "../../../errors.js";
+import { emitAddSuccess, emitErrorAndExit, emitRemoveSuccess, emitUpdateSuccess } from "../../../lib/envelopes.js";
+import { FreeTextError, resolveFreeText } from "../../../lib/freetext.js";
+import { loadAuthTokenOrExit } from "./shared.js";
+/**
+ * Action handler for `ttctl profile portfolio add`. Creates a new
+ * portfolio item; if `--cover` is supplied, the cover image is uploaded
+ * first and its server-issued `coverImageCacheName` is forwarded into
+ * the create call so the new item carries the cover from creation.
+ */
+export async function runProfilePortfolioAdd(options) {
+    let description;
+    try {
+        description = await resolveFreeText(options.description, {
+            flagName: "description",
+            enableEditor: options.edit ?? false,
+        });
+    }
+    catch (err) {
+        if (err instanceof FreeTextError) {
+            emitErrorAndExit({
+                operation: "profile.portfolio.add",
+                format: options.output,
+                errors: [{ code: err.code, message: err.message }],
+                prettySummary: `portfolio add failed (${err.code}): ${err.message}`,
+            });
+        }
+        throw err;
+    }
+    if (options.url !== undefined && options.link !== undefined && options.url !== options.link) {
+        emitErrorAndExit({
+            operation: "profile.portfolio.add",
+            format: options.output,
+            errors: [{ code: "VALIDATION_ERROR", message: "--url and --link cannot disagree." }],
+            prettySummary: "portfolio add failed (VALIDATION_ERROR): --url and --link cannot disagree.",
+        });
+    }
+    if (options.industryId === undefined || options.industryId.length === 0) {
+        emitErrorAndExit({
+            operation: "profile.portfolio.add",
+            format: options.output,
+            errors: [
+                {
+                    code: "VALIDATION_ERROR",
+                    message: "--industry-id is required (at least one). " +
+                        'Discover catalog IDs via `ttctl profile industries autocomplete "<query>"`.',
+                },
+            ],
+            prettySummary: "portfolio add failed (VALIDATION_ERROR): --industry-id is required.",
+        });
+    }
+    const link = options.link ?? options.url;
+    const token = await loadAuthTokenOrExit("portfolio add", options.output);
+    // Optional cover-image upload BEFORE create. The two calls are sequenced
+    // because `createPortfolioItem` needs the server-issued cache name to
+    // bind the cover to the new item; uploading is idempotent so a retry on
+    // a transient create failure is safe.
+    let coverImageCacheName = null;
+    if (options.cover !== undefined) {
+        try {
+            const result = await profile.portfolio.uploadCover(token, { kind: "path", path: options.cover });
+            coverImageCacheName = result.coverImageCacheName;
+        }
+        catch (err) {
+            handlePortfolioError("portfolio add", err, options.output);
+            return;
+        }
+    }
+    // `options.industryId` is verified non-empty above (emitErrorAndExit
+    // short-circuits) — narrow for TypeScript's benefit.
+    const industryIds = options.industryId;
+    const input = {
+        title: options.title,
+        industryIds,
+    };
+    if (description !== undefined)
+        input.description = description;
+    if (link !== undefined)
+        input.link = link;
+    if (coverImageCacheName !== null)
+        input.coverImage = coverImageCacheName;
+    let items;
+    try {
+        items = await profile.portfolio.add(token, input);
+    }
+    catch (err) {
+        handlePortfolioError("portfolio add", err, options.output);
+        return;
+    }
+    emitMutationResult(items, options.output, "add", { prettyHeader: "Portfolio item created." });
+}
+/**
+ * Route service errors through the envelope ABI (#128). `TtctlError`
+ * subclasses keep their dedicated 3-block pretty rendering on `pretty`;
+ * `json`/`yaml` flow through the envelope so machine consumers see the
+ * stable wire shape. Domain `PortfolioError` codes always flow through
+ * the envelope.
+ */
+function handlePortfolioError(commandLabel, err, format = "pretty") {
+    if (err instanceof TtctlError) {
+        if (format === "pretty")
+            presentTtctlError(err);
+        const errors = [{ code: err.code, message: err.message, hint: err.recovery }];
+        emitErrorAndExit({
+            operation: commandLabel.replace(/ /g, "."),
+            format,
+            errors,
+            exitCode: err.code === "CF_403_CLEARANCE" || err.code === "CF_403_PERSISTENT" ? 2 : 1,
+        });
+    }
+    if (err instanceof profile.portfolio.PortfolioError) {
+        emitErrorAndExit({
+            operation: commandLabel.replace(/ /g, "."),
+            format,
+            errors: [{ code: err.code, message: err.message }],
+            prettySummary: `${commandLabel} failed (${err.code}): ${err.message}`,
+        });
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    emitErrorAndExit({
+        operation: commandLabel.replace(/ /g, "."),
+        format,
+        errors: [{ code: "INTERNAL_ERROR", message }],
+        prettySummary: `${commandLabel} failed: ${message}`,
+    });
+}
+/**
+ * Emit the post-mutation portfolio list, wrapped in the v0.4 envelope
+ * ABI (#128). The portfolio core API returns the FULL post-mutation
+ * list rather than the single mutated entity, so the envelope's
+ * `created` / `updated` field carries the list (`PortfolioItem[]`)
+ * rather than a single `PortfolioItem`. The pretty rendering keeps the
+ * existing "success header + table" UX so users continue to see the
+ * post-state at a glance.
+ */
+export function emitMutationResult(items, format, verb, options) {
+    const rows = items.map((it) => `${it.id}\t${it.title ?? ""}\t${it.highlight ? "★" : ""}\t${it.link ?? ""}`);
+    const tableText = ["id\ttitle\thighlight\tlink", ...rows].join("\n");
+    if (verb === "remove") {
+        const id = options.id;
+        if (id === undefined) {
+            throw new Error("emitMutationResult: `id` is required for the `remove` verb");
+        }
+        emitRemoveSuccess({
+            operation: "profile.portfolio.remove",
+            format,
+            id,
+            prettySummary: options.prettyHeader,
+        });
+        if (format === "pretty" && items.length > 0) {
+            process.stdout.write(`${tableText}\n`);
+        }
+        return;
+    }
+    if (verb === "add") {
+        emitAddSuccess({
+            operation: "profile.portfolio.add",
+            format,
+            created: items,
+            prettySummary: options.prettyHeader,
+            prettyEntity: () => tableText,
+        });
+        return;
+    }
+    emitUpdateSuccess({
+        operation: "profile.portfolio.update",
+        format,
+        updated: items,
+        prettySummary: options.prettyHeader,
+        prettyEntity: () => tableText,
+    });
+}
+/** Backward-compatible alias; new call sites use `emitMutationResult`. */
+export function emitListResult(items, format, successMessage) {
+    emitMutationResult(items, format, "update", { prettyHeader: successMessage });
+}
+export { handlePortfolioError };
+//# sourceMappingURL=add.js.map

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

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

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

@@ -0,0 +1,11 @@
+import type { OutputFormat } from "../../../lib/output.js";
+/**
+ * Action handler for `ttctl profile portfolio highlight <id>`. Sets the
+ * `highlight` flag on the named item. Pass `--off` to clear instead of
+ * set. Emits the v0.4 update envelope (#128).
+ */
+export declare function runProfilePortfolioHighlight(id: string, options: {
+    off?: boolean;
+    output: OutputFormat;
+}): Promise<void>;
+//# sourceMappingURL=highlight.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"highlight.d.ts","sourceRoot":"","sources":["../../../../src/commands/profile/portfolio/highlight.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAI3D;;;;GAIG;AACH,wBAAsB,4BAA4B,CAChD,EAAE,EAAE,MAAM,EACV,OAAO,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GAC/C,OAAO,CAAC,IAAI,CAAC,CAmBf"}

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

@@ -0,0 +1,31 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { profile } from "@ttctl/core";
+import { emitUpdateSuccess } from "../../../lib/envelopes.js";
+import { handlePortfolioError } from "./add.js";
+import { loadAuthTokenOrExit } from "./shared.js";
+/**
+ * Action handler for `ttctl profile portfolio highlight <id>`. Sets the
+ * `highlight` flag on the named item. Pass `--off` to clear instead of
+ * set. Emits the v0.4 update envelope (#128).
+ */
+export async function runProfilePortfolioHighlight(id, options) {
+    const flag = !(options.off ?? false);
+    const token = await loadAuthTokenOrExit("portfolio highlight", options.output);
+    let result;
+    try {
+        result = await profile.portfolio.highlight(token, id, flag);
+    }
+    catch (err) {
+        handlePortfolioError("portfolio highlight", err, options.output);
+        return;
+    }
+    emitUpdateSuccess({
+        operation: "profile.portfolio.highlight",
+        format: options.output,
+        updated: result,
+        prettySummary: `${result.id} highlight ${result.highlight ? "enabled" : "cleared"}`,
+        prettyEntity: (entity) => `highlight: ${entity.highlight.toString()}`,
+    });
+}
+//# sourceMappingURL=highlight.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"highlight.js","sourceRoot":"","sources":["../../../../src/commands/profile/portfolio/highlight.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,EAAU,EACV,OAAgD;IAEhD,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,qBAAqB,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAE/E,IAAI,MAA0C,CAAC;IAC/C,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;IAC9D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,oBAAoB,CAAC,qBAAqB,EAAE,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACjE,OAAO;IACT,CAAC;IAED,iBAAiB,CAAC;QAChB,SAAS,EAAE,6BAA6B;QACxC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,MAAM;QACf,aAAa,EAAE,GAAG,MAAM,CAAC,EAAE,cAAc,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE;QACnF,YAAY,EAAE,CAAC,MAA0C,EAAE,EAAE,CAAC,cAAc,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE;KAC1G,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,16 @@
+import { Command } from "commander";
+/**
+ * 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 declare function buildProfilePortfolioCommand(): Command;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/profile/portfolio/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAY5C;;;;;;;;;;;;GAYG;AACH,wBAAgB,4BAA4B,IAAI,OAAO,CA0JtD"}

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"}