@ttctl/cli 0.0.0 → 0.1.0-rc.2

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

@@ -0,0 +1,258 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { profile } from "@ttctl/core";
+import { Command, Option } from "commander";
+import { emitAddSuccess, emitErrorAndExit, emitRemoveSuccess, emitUpdateSuccess, wrapListEnvelope, } from "../../../lib/envelopes.js";
+import { OUTPUT_FORMATS, emitResult } from "../../../lib/output.js";
+import { loadAuthTokenOrExit, parseLimitOrExit, presentSubDomainError } from "../shared.js";
+/**
+ * Build the `ttctl profile industries` command tree.
+ *
+ * Six leaves:
+ *   - `add <name> [--connection <type>]`
+ *   - `update <id> [field-flags]`
+ *   - `remove <id>`
+ *   - `show <id> [-o text|json|table]`
+ *   - `list [-o text|json|table]`
+ *   - `autocomplete <query>` — looks up known industry names from the
+ *     Toptal catalog
+ *
+ * Each `add` creates an `IndustryProfile` row (the user's authored
+ * domain-expertise entry). `<name>` becomes `title`; `--connection`
+ * becomes `domainArea` (the user's role within the industry, e.g.
+ * "Healthcare" + connection "Backend").
+ *
+ * `autocomplete` is a separate query against `industriesAutocomplete`
+ * — the catalog of known industry names. `add` does NOT consult the
+ * catalog; users supply the title directly.
+ *
+ * `show <id>` is the per-id read companion of `list`, added in #342 to
+ * close the Class A surface-shape gap (service exported a `show()` but
+ * neither CLI nor MCP exposed it). The wire call resolves the row via
+ * the schema's `node()` resolver — see
+ * `packages/core/src/services/profile/industries/index.ts:226`.
+ */
+export function buildProfileIndustriesCommand() {
+    const industries = new Command("industries").description("View and update the industries section of your profile");
+    industries
+        .command("add")
+        .description("Add a new industry-profile entry to your profile")
+        .argument("<name>", "industry name (mapped to title)")
+        .option("--connection <type>", "your connection / role within the industry (mapped to domainArea)")
+        .option("--about <text>", "longer-form description (optional)")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (name, options) => {
+        await runAdd(name, options);
+    });
+    industries
+        .command("update")
+        .description("Update an existing industry-profile entry by id")
+        .argument("<id>", "industry profile id")
+        .option("--name <text>", "industry name (mapped to title)")
+        .option("--connection <type>", "your connection / role within the industry")
+        .option("--about <text>", "longer-form description")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (id, options) => {
+        await runUpdate(id, options);
+    });
+    industries
+        .command("remove")
+        .description("Remove an industry-profile entry by id")
+        .argument("<id>", "industry profile id")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (id, options) => {
+        await runRemove(id, options.output);
+    });
+    industries
+        .command("show")
+        .description("Show a single industry-profile entry by id")
+        .argument("<id>", "industry profile id")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (id, options) => {
+        await runShow(id, options.output);
+    });
+    industries
+        .command("list")
+        .description("List your industry-profile entries")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (options) => {
+        await runList(options.output);
+    });
+    industries
+        .command("autocomplete")
+        .description('Search the known-industries catalog for a name (e.g. "Healthcare")')
+        .argument("<query>", "search term")
+        .option("--limit <n>", "max results (default 10)", "10")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (query, options) => {
+        await runAutocomplete(query, options);
+    });
+    return industries;
+}
+async function runAdd(name, options) {
+    const fields = { title: name };
+    if (options.connection !== undefined)
+        fields.domainArea = options.connection;
+    if (options.about !== undefined)
+        fields.about = options.about;
+    const token = await loadAuthTokenOrExit("profile industries add", options.output);
+    let result;
+    try {
+        result = await profile.industries.add(token, fields);
+    }
+    catch (err) {
+        presentSubDomainError("profile industries add", err, options.output);
+    }
+    emitAddSuccess({
+        operation: "profile.industries.add",
+        format: options.output,
+        created: result,
+        prettySummary: `${result.title} (id ${result.id})`,
+        prettyEntity: formatIndustryText,
+    });
+}
+async function runUpdate(id, options) {
+    const fields = {};
+    if (options.name !== undefined)
+        fields.title = options.name;
+    if (options.connection !== undefined)
+        fields.domainArea = options.connection;
+    if (options.about !== undefined)
+        fields.about = options.about;
+    if (Object.keys(fields).length === 0) {
+        emitErrorAndExit({
+            operation: "profile.industries.update",
+            format: options.output,
+            errors: [{ code: "VALIDATION_ERROR", message: "at least one field flag is required" }],
+            prettySummary: "profile industries update failed (VALIDATION_ERROR): at least one field flag is required",
+        });
+    }
+    const token = await loadAuthTokenOrExit("profile industries update", options.output);
+    let result;
+    try {
+        result = await profile.industries.update(token, id, fields);
+    }
+    catch (err) {
+        presentSubDomainError("profile industries update", err, options.output);
+    }
+    emitUpdateSuccess({
+        operation: "profile.industries.update",
+        format: options.output,
+        updated: result,
+        prettySummary: `${result.title} (id ${result.id})`,
+        prettyEntity: formatIndustryText,
+    });
+}
+async function runRemove(id, format) {
+    const token = await loadAuthTokenOrExit("profile industries remove", format);
+    let removedId;
+    try {
+        removedId = await profile.industries.remove(token, id);
+    }
+    catch (err) {
+        presentSubDomainError("profile industries remove", err, format);
+    }
+    emitRemoveSuccess({
+        operation: "profile.industries.remove",
+        format,
+        id: removedId,
+    });
+}
+async function runShow(id, format) {
+    const token = await loadAuthTokenOrExit("profile industries show", format);
+    let result;
+    try {
+        result = await profile.industries.show(token, id);
+    }
+    catch (err) {
+        presentSubDomainError("profile industries show", err, format);
+    }
+    emitResult(result, format, { pretty: formatIndustryText, table: formatIndustryTable });
+}
+async function runList(format) {
+    const token = await loadAuthTokenOrExit("profile industries list", format);
+    let result;
+    try {
+        result = await profile.industries.list(token);
+    }
+    catch (err) {
+        presentSubDomainError("profile industries list", err, format);
+    }
+    emitResult(wrapListEnvelope(result), format, {
+        pretty: (data) => formatIndustryListText(data.items),
+        table: (data) => formatIndustryListTable(data.items),
+        empty: { command: "profile.industries.list" },
+    });
+}
+async function runAutocomplete(query, options) {
+    const limit = parseLimitOrExit(options.limit, "profile industries autocomplete", options.output);
+    const token = await loadAuthTokenOrExit("profile industries autocomplete", options.output);
+    let suggestions;
+    try {
+        suggestions = await profile.industries.autocomplete(token, query, { limit });
+    }
+    catch (err) {
+        presentSubDomainError("profile industries autocomplete", err, options.output);
+    }
+    emitResult(wrapListEnvelope(suggestions), options.output, {
+        pretty: (data) => formatCatalogText(data.items),
+        table: (data) => formatCatalogTable(data.items),
+    });
+}
+/**
+ * Pretty-print an IndustryProfile row.
+ */
+export function formatIndustryText(i) {
+    const lines = [i.title];
+    if (i.domainArea)
+        lines.push(`  domain: ${i.domainArea}`);
+    if (i.about)
+        lines.push(`  ${i.about}`);
+    lines.push(`  id: ${i.id}`);
+    return lines.join("\n");
+}
+/**
+ * Pretty-print an IndustryProfile row as a key/value table.
+ */
+export function formatIndustryTable(i) {
+    const rows = [
+        ["id", i.id],
+        ["title", i.title],
+        ["domain", i.domainArea ?? ""],
+        ["about", i.about ?? ""],
+    ];
+    return rows.map(([k, v]) => `${k}\t${v}`).join("\n");
+}
+export function formatIndustryListText(rows) {
+    if (rows.length === 0)
+        return "(no industries on this profile)";
+    return rows.map(formatIndustryText).join("\n\n");
+}
+export function formatIndustryListTable(rows) {
+    if (rows.length === 0)
+        return "(no industries on this profile)";
+    return rows.map((i) => `${i.id}\t${i.title}\t${i.domainArea ?? ""}`).join("\n");
+}
+export function formatCatalogText(rows) {
+    if (rows.length === 0)
+        return "(no matches)";
+    return rows.map((r) => `${r.name} (${r.id})`).join("\n");
+}
+export function formatCatalogTable(rows) {
+    if (rows.length === 0)
+        return "(no matches)";
+    return rows.map((r) => `${r.id}\t${r.name}`).join("\n");
+}
+//# sourceMappingURL=index.js.map

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