@ttctl/cli 0.0.0 → 0.1.0-rc.2

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

@@ -0,0 +1,331 @@
+// 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 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 function buildProfileEducationCommand() {
+    const education = new Command("education").description("View and update the education section of your profile");
+    education
+        .command("add")
+        .description("Add a new education entry to your profile")
+        .requiredOption("--institution <name>", "school / university name")
+        .requiredOption("--degree <type>", "degree (e.g. BSc, MSc, PhD)")
+        .option("--from <date>", "start date — ISO-8601 (YYYY-MM-DD) or year (YYYY)")
+        .option("--to <date>", "end date — ISO-8601 (YYYY-MM-DD) or year (YYYY)")
+        .option("--field-of-study <text>", "field of study (optional)")
+        .option("--location <text>", "city / country (optional)")
+        .option("--title <text>", "thesis or program title (optional)")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (options) => {
+        await runAdd(options);
+    });
+    education
+        .command("update")
+        .description("Update an existing education entry by id")
+        .argument("<id>", "education id (V1-Education-NNN)")
+        .option("--institution <name>", "school / university name")
+        .option("--degree <type>", "degree")
+        .option("--from <date>", "start date — ISO-8601 or YYYY")
+        .option("--to <date>", "end date — ISO-8601 or YYYY")
+        .option("--field-of-study <text>", "field of study")
+        .option("--location <text>", "city / country")
+        .option("--title <text>", "thesis or program title")
+        .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);
+    });
+    education
+        .command("remove")
+        .description("Remove an education entry by id")
+        .argument("<id>", "education id")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (id, options) => {
+        await runRemove(id, options.output);
+    });
+    education
+        .command("show")
+        .description("Show a single education entry by id")
+        .argument("<id>", "education id")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (id, options) => {
+        await runShow(id, options.output);
+    });
+    education
+        .command("list")
+        .description("List every education entry on your profile")
+        .addOption(new Option("-o, --output <format>", "output format")
+        .choices(OUTPUT_FORMATS)
+        .default("pretty"))
+        .action(async (options) => {
+        await runList(options.output);
+    });
+    education
+        .command("highlight")
+        .description("Toggle highlight on an education entry")
+        .argument("<id>", "education 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 education;
+}
+async function runAdd(options) {
+    const fields = {
+        institution: options.institution,
+        degree: options.degree,
+    };
+    applyDateFlags(fields, options, "profile education add", options.output);
+    applyOptionalStrings(fields, options);
+    const token = await loadAuthTokenOrExit("profile education add", options.output);
+    let result;
+    try {
+        result = await profile.education.add(token, fields);
+    }
+    catch (err) {
+        presentSubDomainError("profile education add", err, options.output);
+    }
+    emitAddSuccess({
+        operation: "profile.education.add",
+        format: options.output,
+        created: result,
+        prettySummary: `${result.degree} — ${result.institution} (id ${result.id})`,
+        prettyEntity: formatEducationText,
+    });
+}
+async function runUpdate(id, options) {
+    const fields = {};
+    if (options.institution !== undefined)
+        fields.institution = options.institution;
+    if (options.degree !== undefined)
+        fields.degree = options.degree;
+    if (options.fieldOfStudy !== undefined)
+        fields.fieldOfStudy = options.fieldOfStudy;
+    if (options.location !== undefined)
+        fields.location = options.location;
+    if (options.title !== undefined)
+        fields.title = options.title;
+    if (options.highlight !== undefined) {
+        if (options.highlight !== "true" && options.highlight !== "false") {
+            emitErrorAndExit({
+                operation: "profile.education.update",
+                format: options.output,
+                errors: [
+                    {
+                        code: "VALIDATION_ERROR",
+                        field: "highlight",
+                        message: '--highlight expects "true" or "false"',
+                    },
+                ],
+                prettySummary: 'profile education update failed (VALIDATION_ERROR): --highlight expects "true" or "false"',
+            });
+        }
+        fields.highlight = options.highlight === "true";
+    }
+    applyDateFlags(fields, options, "profile education update", options.output);
+    if (Object.keys(fields).length === 0) {
+        emitErrorAndExit({
+            operation: "profile.education.update",
+            format: options.output,
+            errors: [{ code: "VALIDATION_ERROR", message: "at least one field flag is required" }],
+            prettySummary: "profile education update failed (VALIDATION_ERROR): at least one field flag is required",
+        });
+    }
+    const token = await loadAuthTokenOrExit("profile education update", options.output);
+    let result;
+    try {
+        result = await profile.education.update(token, id, fields);
+    }
+    catch (err) {
+        presentSubDomainError("profile education update", err, options.output);
+    }
+    emitUpdateSuccess({
+        operation: "profile.education.update",
+        format: options.output,
+        updated: result,
+        prettySummary: `${result.degree} — ${result.institution} (id ${result.id})`,
+        prettyEntity: formatEducationText,
+    });
+}
+async function runRemove(id, format) {
+    const token = await loadAuthTokenOrExit("profile education remove", format);
+    let removedId;
+    try {
+        removedId = await profile.education.remove(token, id);
+    }
+    catch (err) {
+        presentSubDomainError("profile education remove", err, format);
+    }
+    emitRemoveSuccess({
+        operation: "profile.education.remove",
+        format,
+        id: removedId,
+    });
+}
+async function runShow(id, format) {
+    const token = await loadAuthTokenOrExit("profile education show", format);
+    let result;
+    try {
+        result = await profile.education.show(token, id);
+    }
+    catch (err) {
+        presentSubDomainError("profile education show", err, format);
+    }
+    emitResult(result, format, { pretty: formatEducationText, table: formatEducationTable });
+}
+async function runList(format) {
+    const token = await loadAuthTokenOrExit("profile education list", format);
+    let rows;
+    try {
+        rows = await profile.education.list(token);
+    }
+    catch (err) {
+        presentSubDomainError("profile education list", err, format);
+    }
+    emitResult(wrapListEnvelope(rows), format, {
+        pretty: (data) => formatEducationListText(data.items),
+        table: (data) => formatEducationListTable(data.items),
+        empty: { command: "profile.education.list" },
+    });
+}
+async function runHighlight(id, value, format) {
+    const token = await loadAuthTokenOrExit("profile education highlight", format);
+    let result;
+    try {
+        result = await profile.education.highlight(token, id, value);
+    }
+    catch (err) {
+        presentSubDomainError("profile education highlight", err, format);
+    }
+    emitUpdateSuccess({
+        operation: "profile.education.highlight",
+        format,
+        updated: result,
+        prettySummary: `${result.id} highlight set to ${result.highlight.toString()}`,
+        prettyEntity: (entity) => `highlight: ${entity.highlight.toString()}`,
+    });
+}
+/**
+ * Map `--from` / `--to` flag strings to `yearFrom` / `yearTo` Ints (year
+ * only, dropping any provided month/day per Education's GraphQL field
+ * shape). The date helper validates ISO-8601 and year-only formats and
+ * surfaces malformed input as `DateInputError` — routed through the
+ * envelope ABI (#128).
+ */
+function applyDateFlags(fields, options, commandLabel, format) {
+    try {
+        if (options.from !== undefined)
+            fields.yearFrom = parseDateInput(options.from, "from").year;
+        if (options.to !== undefined)
+            fields.yearTo = parseDateInput(options.to, "to").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;
+    }
+}
+function applyOptionalStrings(fields, options) {
+    if (options.fieldOfStudy !== undefined)
+        fields.fieldOfStudy = options.fieldOfStudy;
+    if (options.location !== undefined)
+        fields.location = options.location;
+    if (options.title !== undefined)
+        fields.title = options.title;
+}
+/**
+ * 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 function formatEducationText(e) {
+    const lines = [`${e.degree}${e.fieldOfStudy ? `, ${e.fieldOfStudy}` : ""} — ${e.institution}`];
+    if (e.location)
+        lines.push(`  ${e.location}`);
+    lines.push(`  ${formatYearRange(e.yearFrom, e.yearTo)}`);
+    if (e.title)
+        lines.push(`  ${e.title}`);
+    if (e.highlight)
+        lines.push(`  highlighted`);
+    lines.push(`  id: ${e.id}`);
+    return lines.join("\n");
+}
+/**
+ * Pretty-print an Education row as a key/value table.
+ */
+export function formatEducationTable(e) {
+    const rows = [
+        ["id", e.id],
+        ["institution", e.institution],
+        ["degree", e.degree],
+        ["field_of_study", e.fieldOfStudy ?? ""],
+        ["location", e.location ?? ""],
+        ["title", e.title ?? ""],
+        ["years", formatYearRange(e.yearFrom, e.yearTo)],
+        ["highlight", e.highlight.toString()],
+    ];
+    return rows.map(([k, v]) => `${k}\t${v}`).join("\n");
+}
+function formatYearRange(from, to) {
+    if (from === null && to === null)
+        return "—";
+    if (from !== null && to === null)
+        return `${from.toString()}–present`;
+    if (from === null && to !== null)
+        return `?–${to.toString()}`;
+    return `${(from ?? 0).toString()}–${(to ?? 0).toString()}`;
+}
+/**
+ * Pretty-print a list of Education rows. One row per line, tab-separated:
+ * degree, institution, years, id.
+ */
+export function formatEducationListText(rows) {
+    if (rows.length === 0)
+        return "(no education entries on profile)";
+    return rows.map((e) => `${e.degree}\t${e.institution}\t${formatYearRange(e.yearFrom, e.yearTo)}\t${e.id}`).join("\n");
+}
+/**
+ * Pretty-print a list of Education rows as a cli-table3 table.
+ */
+export function formatEducationListTable(rows) {
+    const table = new Table({ head: ["Degree", "Institution", "Years", "Highlight", "Id"], wordWrap: true });
+    for (const e of rows) {
+        table.push([e.degree, e.institution, formatYearRange(e.yearFrom, e.yearTo), e.highlight ? "yes" : "no", e.id]);
+    }
+    return table.toString();
+}
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,49 @@
+import { profile } from "@ttctl/core";
+import { Command } from "commander";
+/**
+ * Build the `ttctl profile employment` command tree.
+ *
+ * The canonical sub-domain name is `employment`; the CLI registers
+ * `experience` 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.
+ *
+ * Six leaves:
+ *   - `add --company --role [--from --to --current]`
+ *   - `update <id> [field-flags] [--description --edit]`
+ *   - `remove <id>`
+ *   - `show <id> [-o text|json|table]`
+ *   - `highlight <id>`
+ *   - `employer-autocomplete <query>` — looks up known employer names
+ *
+ * Date input flags accept ISO-8601 (`2023-01-15`) or year-only (`2023`).
+ * Employment stores year only (Int field), so the helper drops month/day.
+ *
+ * `update --description` is multi-paragraph free-text via the four-mode
+ * helper from `lib/freetext.ts` (#70): inline, stdin (`-`), file (`@path`),
+ * editor (`--edit`).
+ */
+export declare function buildProfileEmploymentCommand(): Command;
+/**
+ * Pretty-print an Employment row.
+ */
+export declare function formatEmploymentText(e: profile.employment.Employment): string;
+/**
+ * Pretty-print an Employment row as a key/value table.
+ */
+export declare function formatEmploymentTable(e: profile.employment.Employment): string;
+/**
+ * Pretty-print a list of Employment rows. One row per line, tab-separated:
+ * position, company, years, id. Mirrors `formatSkillsListText` shape.
+ */
+export declare function formatEmploymentListText(rows: profile.employment.Employment[]): string;
+/**
+ * Pretty-print a list of Employment rows as a cli-table3 table.
+ */
+export declare function formatEmploymentListTable(rows: profile.employment.Employment[]): string;
+/**
+ * Pretty-print employer-autocomplete suggestions.
+ */
+export declare function formatEmployersText(suggestions: profile.employment.EmployerSuggestion[]): string;
+export declare function formatEmployersTable(suggestions: profile.employment.EmployerSuggestion[]): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/profile/employment/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAkC,OAAO,EAAmB,MAAM,aAAa,CAAC;AACvF,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAgB5C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,6BAA6B,IAAI,OAAO,CAmHvD;AAoOD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,UAAU,GAAG,MAAM,CAuB7E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,UAAU,GAAG,MAAM,CAiB9E;AASD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,GAAG,MAAM,CAGtF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,GAAG,MAAM,CAMvF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,GAAG,MAAM,CAUhG;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,GAAG,MAAM,CAKjG"}