@ttctl/cli 0.0.0 → 0.1.0-rc.2

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

@@ -0,0 +1,350 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import Table from "cli-table3";
+import { DateInputError, parseDateInput, 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, presentSubDomainError } from "../shared.js";
+/**
+ * Build the `ttctl profile certifications` command tree.
+ *
+ * The canonical sub-domain name is `certifications`; the CLI registers
+ * `certs` 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.
+ *
+ * Five leaves:
+ *   - `add --name --issuer [--issued --expires]`
+ *   - `update <id> [field-flags]`
+ *   - `remove <id>`
+ *   - `show <id> [-o text|json|table]`
+ *   - `highlight <id>`
+ *
+ * Date input flags accept ISO-8601 (`2023-01-15`) or year-only (`2023`).
+ * Certifications store month + year (separate Int fields) so the helper
+ * preserves the month component and ignores any provided day.
+ */
+export function buildProfileCertificationsCommand() {
+    const certs = new Command("certifications")
+        .alias("certs")
+        .description("View and update the certifications section of your profile");
+    certs
+        .command("add")
+        .description("Add a new certification entry to your profile")
+        .requiredOption("--name <text>", "certification name (mapped to certificate)")
+        .requiredOption("--issuer <text>", "issuing organization (mapped to institution)")
+        .option("--issued <date>", "issue date — ISO-8601 (YYYY-MM-DD) or year (YYYY)")
+        .option("--expires <date>", "expiration date — ISO-8601 or year")
+        .option("--link <url>", "credential URL (optional)")
+        .option("--number <text>", "credential ID / certificate number (optional)")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (options) => {
+        await runAdd(options);
+    });
+    certs
+        .command("update")
+        .description("Update an existing certification entry by id")
+        .argument("<id>", "certification id (V1-Certification-NNN)")
+        .option("--name <text>", "certification name")
+        .option("--issuer <text>", "issuing organization")
+        .option("--issued <date>", "issue date — ISO-8601 or year")
+        .option("--expires <date>", "expiration date — ISO-8601 or year")
+        .option("--link <url>", "credential URL")
+        .option("--number <text>", "credential ID / certificate number")
+        .option("--highlight <bool>", "set highlight flag (true|false)")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (id, options) => {
+        await runUpdate(id, options);
+    });
+    certs
+        .command("remove")
+        .description("Remove a certification entry by id")
+        .argument("<id>", "certification id")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (id, options) => {
+        await runRemove(id, options.output);
+    });
+    certs
+        .command("show")
+        .description("Show a single certification entry by id")
+        .argument("<id>", "certification id")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (id, options) => {
+        await runShow(id, options.output);
+    });
+    certs
+        .command("list")
+        .description("List every certification entry on your profile")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (options) => {
+        await runList(options.output);
+    });
+    certs
+        .command("highlight")
+        .description("Toggle highlight on a certification entry")
+        .argument("<id>", "certification id")
+        .option("--off", "un-highlight (default is to highlight)", false)
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (id, options) => {
+        await runHighlight(id, !options.off, options.output);
+    });
+    return certs;
+}
+async function runAdd(options) {
+    const fields = {
+        certificate: options.name,
+        institution: options.issuer,
+    };
+    applyDateFlags(fields, options, "profile certifications add", options.output);
+    if (options.link !== undefined)
+        fields.link = options.link;
+    if (options.number !== undefined)
+        fields.number = options.number;
+    const token = await loadAuthTokenOrExit("profile certifications add", options.output);
+    let result;
+    try {
+        result = await profile.certifications.add(token, fields);
+    }
+    catch (err) {
+        presentSubDomainError("profile certifications add", err, options.output);
+    }
+    emitAddSuccess({
+        operation: "profile.certifications.add",
+        format: options.output,
+        created: result,
+        prettySummary: `${result.certificate} — ${result.institution} (id ${result.id})`,
+        prettyEntity: formatCertificationText,
+    });
+}
+async function runUpdate(id, options) {
+    const fields = {};
+    if (options.name !== undefined)
+        fields.certificate = options.name;
+    if (options.issuer !== undefined)
+        fields.institution = options.issuer;
+    if (options.link !== undefined)
+        fields.link = options.link;
+    if (options.number !== undefined)
+        fields.number = options.number;
+    if (options.highlight !== undefined) {
+        if (options.highlight !== "true" && options.highlight !== "false") {
+            emitErrorAndExit({
+                operation: "profile.certifications.update",
+                format: options.output,
+                errors: [
+                    {
+                        code: "VALIDATION_ERROR",
+                        field: "highlight",
+                        message: '--highlight expects "true" or "false"',
+                    },
+                ],
+                prettySummary: 'profile certifications update failed (VALIDATION_ERROR): --highlight expects "true" or "false"',
+            });
+        }
+        fields.highlight = options.highlight === "true";
+    }
+    applyDateFlags(fields, options, "profile certifications update", options.output);
+    if (Object.keys(fields).length === 0) {
+        emitErrorAndExit({
+            operation: "profile.certifications.update",
+            format: options.output,
+            errors: [{ code: "VALIDATION_ERROR", message: "at least one field flag is required" }],
+            prettySummary: "profile certifications update failed (VALIDATION_ERROR): at least one field flag is required",
+        });
+    }
+    const token = await loadAuthTokenOrExit("profile certifications update", options.output);
+    let result;
+    try {
+        result = await profile.certifications.update(token, id, fields);
+    }
+    catch (err) {
+        presentSubDomainError("profile certifications update", err, options.output);
+    }
+    emitUpdateSuccess({
+        operation: "profile.certifications.update",
+        format: options.output,
+        updated: result,
+        prettySummary: `${result.certificate} — ${result.institution} (id ${result.id})`,
+        prettyEntity: formatCertificationText,
+    });
+}
+async function runRemove(id, format) {
+    const token = await loadAuthTokenOrExit("profile certifications remove", format);
+    let removedId;
+    try {
+        removedId = await profile.certifications.remove(token, id);
+    }
+    catch (err) {
+        presentSubDomainError("profile certifications remove", err, format);
+    }
+    emitRemoveSuccess({
+        operation: "profile.certifications.remove",
+        format,
+        id: removedId,
+    });
+}
+async function runShow(id, format) {
+    const token = await loadAuthTokenOrExit("profile certifications show", format);
+    let result;
+    try {
+        result = await profile.certifications.show(token, id);
+    }
+    catch (err) {
+        presentSubDomainError("profile certifications show", err, format);
+    }
+    emitResult(result, format, { pretty: formatCertificationText, table: formatCertificationTable });
+}
+async function runList(format) {
+    const token = await loadAuthTokenOrExit("profile certifications list", format);
+    let rows;
+    try {
+        rows = await profile.certifications.list(token);
+    }
+    catch (err) {
+        presentSubDomainError("profile certifications list", err, format);
+    }
+    emitResult(wrapListEnvelope(rows), format, {
+        pretty: (data) => formatCertificationListText(data.items),
+        table: (data) => formatCertificationListTable(data.items),
+        empty: { command: "profile.certifications.list" },
+    });
+}
+async function runHighlight(id, value, format) {
+    const token = await loadAuthTokenOrExit("profile certifications highlight", format);
+    let result;
+    try {
+        result = await profile.certifications.highlight(token, id, value);
+    }
+    catch (err) {
+        presentSubDomainError("profile certifications highlight", err, format);
+    }
+    emitUpdateSuccess({
+        operation: "profile.certifications.highlight",
+        format,
+        updated: result,
+        prettySummary: `${result.id} highlight set to ${result.highlight.toString()}`,
+        prettyEntity: (entity) => `highlight: ${entity.highlight.toString()}`,
+    });
+}
+/**
+ * Map `--issued` / `--expires` flag strings to `validFromMonth` /
+ * `validFromYear` / `validToMonth` / `validToYear` Ints. Year-only inputs
+ * default month to `1` per the issue's "January 1st" rule. ISO-8601
+ * inputs preserve the parsed month and ignore the day component.
+ *
+ * Routes errors through the envelope ABI (#128).
+ */
+function applyDateFlags(fields, options, commandLabel, format) {
+    try {
+        if (options.issued !== undefined) {
+            const parsed = parseDateInput(options.issued, "issued");
+            fields.validFromMonth = parsed.month;
+            fields.validFromYear = parsed.year;
+        }
+        if (options.expires !== undefined) {
+            const parsed = parseDateInput(options.expires, "expires");
+            fields.validToMonth = parsed.month;
+            fields.validToYear = parsed.year;
+        }
+    }
+    catch (err) {
+        if (err instanceof DateInputError) {
+            emitErrorAndExit({
+                operation: commandLabel.replace(/ /g, "."),
+                format,
+                errors: [{ code: err.code, message: err.message }],
+                prettySummary: `${commandLabel} failed (${err.code}): ${err.message}`,
+            });
+        }
+        throw err;
+    }
+}
+/**
+ * Pretty-print a Certification row. Pure — no I/O.
+ */
+export function formatCertificationText(c) {
+    const lines = [`${c.certificate} — ${c.institution}`];
+    lines.push(`  ${formatValidityRange(c.validFromMonth, c.validFromYear, c.validToMonth, c.validToYear)}`);
+    if (c.number)
+        lines.push(`  cred-id: ${c.number}`);
+    if (c.link)
+        lines.push(`  ${c.link}`);
+    if (c.highlight)
+        lines.push(`  highlighted`);
+    lines.push(`  id: ${c.id}`);
+    return lines.join("\n");
+}
+/**
+ * Pretty-print a Certification row as a key/value table.
+ */
+export function formatCertificationTable(c) {
+    const rows = [
+        ["id", c.id],
+        ["certificate", c.certificate],
+        ["institution", c.institution],
+        ["valid", formatValidityRange(c.validFromMonth, c.validFromYear, c.validToMonth, c.validToYear)],
+        ["number", c.number ?? ""],
+        ["link", c.link ?? ""],
+        ["highlight", c.highlight.toString()],
+    ];
+    return rows.map(([k, v]) => `${k}\t${v}`).join("\n");
+}
+function formatValidityRange(fromMonth, fromYear, toMonth, toYear) {
+    const fromStr = formatMonthYear(fromMonth, fromYear);
+    const toStr = formatMonthYear(toMonth, toYear);
+    if (fromStr === "—" && toStr === "—")
+        return "—";
+    if (toStr === "—")
+        return `${fromStr}–no expiry`;
+    if (fromStr === "—")
+        return `?–${toStr}`;
+    return `${fromStr}–${toStr}`;
+}
+function formatMonthYear(month, year) {
+    if (year === null)
+        return "—";
+    if (month === null)
+        return year.toString();
+    return `${month.toString().padStart(2, "0")}/${year.toString()}`;
+}
+/**
+ * Pretty-print a list of Certification rows. One row per line, tab-separated:
+ * certificate, institution, validity range, id.
+ */
+export function formatCertificationListText(rows) {
+    if (rows.length === 0)
+        return "(no certifications on profile)";
+    return rows
+        .map((c) => `${c.certificate}\t${c.institution}\t${formatValidityRange(c.validFromMonth, c.validFromYear, c.validToMonth, c.validToYear)}\t${c.id}`)
+        .join("\n");
+}
+/**
+ * Pretty-print a list of Certification rows as a cli-table3 table.
+ */
+export function formatCertificationListTable(rows) {
+    const table = new Table({ head: ["Certificate", "Issuer", "Valid", "Highlight", "Id"], wordWrap: true });
+    for (const c of rows) {
+        table.push([
+            c.certificate,
+            c.institution,
+            formatValidityRange(c.validFromMonth, c.validFromYear, c.validToMonth, c.validToYear),
+            c.highlight ? "yes" : "no",
+            c.id,
+        ]);
+    }
+    return table.toString();
+}
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,37 @@
+import { profile } from "@ttctl/core";
+import { Command } from "commander";
+/**
+ * Build the `ttctl profile education` command tree.
+ *
+ * Five leaves:
+ *   - `add --institution --degree [--from --to]`
+ *   - `update <id> [field-flags]`
+ *   - `remove <id>`
+ *   - `show <id> [-o text|json|table]`
+ *   - `highlight <id>`
+ *
+ * Date input flags (`--from`, `--to`) accept ISO-8601 (`2023-01-15`) or
+ * year-only (`2023`); the date helper at `core/src/lib/date.ts` enforces
+ * format and rejects impossible calendar dates. Education stores year
+ * only, so the month/day are dropped before sending to the API.
+ */
+export declare function buildProfileEducationCommand(): Command;
+/**
+ * Pretty-print an Education row. Pure — no I/O. Years render as "YYYY"
+ * or "YYYY–YYYY" or "YYYY–present"; missing years collapse to a hyphen.
+ */
+export declare function formatEducationText(e: profile.education.Education): string;
+/**
+ * Pretty-print an Education row as a key/value table.
+ */
+export declare function formatEducationTable(e: profile.education.Education): string;
+/**
+ * Pretty-print a list of Education rows. One row per line, tab-separated:
+ * degree, institution, years, id.
+ */
+export declare function formatEducationListText(rows: profile.education.Education[]): string;
+/**
+ * Pretty-print a list of Education rows as a cli-table3 table.
+ */
+export declare function formatEducationListTable(rows: profile.education.Education[]): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/profile/education/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAkC,OAAO,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAa5C;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,4BAA4B,IAAI,OAAO,CAgGtD;AAoMD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,SAAS,GAAG,MAAM,CAQ1E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,SAAS,GAAG,MAAM,CAY3E;AASD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,SAAS,EAAE,GAAG,MAAM,CAGnF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,SAAS,EAAE,GAAG,MAAM,CAMpF"}