@ttctl/core 0.0.0 → 0.1.0-rc.1

package/dist/__tests__/fixtures/profile/data.js

@@ -0,0 +1,230 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+/**
+ * Realistic senior-developer fixture data, deliberately fixed (no
+ * `new Date()` calls — every date is a hard-coded ISO 8601 string or
+ * integer year/month) so snapshot diffs stay deterministic across runs
+ * and CI hosts. IDs follow `<entity>_test_<NNN>` so a snapshot diff
+ * reads cleanly.
+ *
+ * No PII: every URL points at the IANA-reserved `example.com` test
+ * domain; every company / institution name is a fictitious placeholder
+ * (`Acme Financial`, `Mercury Health`, `Stellar Logistics`,
+ * `Test Institution`). The fixture entities don't carry email or
+ * person-name fields directly — those live on shapes outside this
+ * fixture's scope (e.g., the GraphQL `Viewer` type used by
+ * `services/profile/__tests__/fixtures.ts`).
+ *
+ * The persona is loosely modeled on a Toptal-eligible senior backend
+ * engineer — enough domain detail (TypeScript / PostgreSQL / Kubernetes
+ * stack, distributed-systems portfolio, Stanford CS degree, AWS
+ * certifications, fintech/healthtech industry tags) that table-format
+ * rendering tests exercise realistic column widths instead of toy data
+ * like `"foo"` / `"bar"`.
+ */
+// -----------------------------------------------------------------------
+// Skills
+// -----------------------------------------------------------------------
+// `experience` is a count of months on the wire (see `ProfileSkillSet` —
+// the CLI converts a duration string like `"5y"` to months before
+// calling `set()`). The trailing `// N years` comments below name the
+// month count's intent so readers don't have to divide by 12.
+export const SKILL_TYPESCRIPT = {
+    id: "sk_test_001",
+    experience: 96, // 8 years
+    rating: "EXPERT",
+    public: true,
+    position: 1,
+    skill: { id: "skill_cat_ts", name: "TypeScript" },
+    connectionsCount: 4,
+};
+export const SKILL_POSTGRES = {
+    id: "sk_test_002",
+    experience: 84, // 7 years
+    rating: "EXPERT",
+    public: true,
+    position: 2,
+    skill: { id: "skill_cat_pg", name: "PostgreSQL" },
+    connectionsCount: 3,
+};
+export const SKILL_KUBERNETES = {
+    id: "sk_test_003",
+    experience: 48, // 4 years
+    rating: "STRONG",
+    public: true,
+    position: 3,
+    skill: { id: "skill_cat_k8s", name: "Kubernetes" },
+    connectionsCount: 2,
+};
+export const SKILL_GRAPHQL = {
+    id: "sk_test_004",
+    experience: 60, // 5 years
+    rating: "STRONG",
+    public: true,
+    position: 4,
+    skill: { id: "skill_cat_gql", name: "GraphQL" },
+    connectionsCount: 2,
+};
+// -----------------------------------------------------------------------
+// Portfolio — paragraph-bearing entities (description + accomplishment)
+// -----------------------------------------------------------------------
+export const PORTFOLIO_DISTRIBUTED_LEDGER = {
+    id: "port_test_001",
+    title: "Distributed transaction ledger",
+    description: "Designed and shipped a multi-region transaction ledger handling 12k writes/sec at p99 latency under 35ms. " +
+        "Built on PostgreSQL logical replication with a custom conflict-resolution layer and an audit trail wired " +
+        "into Kafka. Stack: TypeScript, Node 20, PostgreSQL 15, Kafka, Kubernetes on AWS EKS.",
+    link: "https://example.com/case-studies/ledger",
+    highlight: true,
+    coverImage: "https://example.com/covers/ledger.png",
+    accomplishment: "Cut reconciliation lead time from 18 hours to under 4 minutes; eliminated a recurring weekend on-call class.",
+    publicationPermit: true,
+    clientOrCompanyName: "Acme Financial",
+    websiteUrl: "https://example.com/acme",
+    toptalRelated: true,
+    showViaToptal: true,
+    kind: "classic",
+    skills: [{ id: "sk_test_typescript", name: "TypeScript" }],
+    industries: [{ id: "ind_test_finance", name: "Financial Software" }],
+};
+export const PORTFOLIO_EHR_GATEWAY = {
+    id: "port_test_002",
+    title: "FHIR-compliant EHR gateway",
+    description: "Built a HIPAA-compliant gateway exposing a subset of FHIR R4 resources to third-party clinical apps. " +
+        "Authentication via SMART-on-FHIR (OAuth 2 + OIDC); per-resource consent enforcement at the API gateway. " +
+        "Operated 99.97% uptime over 14 months across three AWS regions.",
+    link: "https://example.com/case-studies/fhir-gateway",
+    highlight: true,
+    coverImage: null,
+    accomplishment: "Onboarded 11 partner clinics in the first quarter; passed an external HIPAA audit on first attempt.",
+    publicationPermit: true,
+    clientOrCompanyName: "Mercury Health",
+    websiteUrl: "https://example.com/mercury",
+    toptalRelated: false,
+    showViaToptal: true,
+    kind: "code_base",
+    skills: [{ id: "sk_test_typescript", name: "TypeScript" }],
+    industries: [{ id: "ind_test_healthcare", name: "Healthcare Software" }],
+};
+export const PORTFOLIO_OBSERVABILITY = {
+    id: "port_test_003",
+    title: "Internal observability platform",
+    description: "Replaced a legacy logging stack with an OpenTelemetry-native observability platform for a 200-engineer org. " +
+        "Unified logs, metrics, and traces under a single retention policy; reduced infra spend by 38% while " +
+        "doubling cardinality.",
+    link: "https://example.com/case-studies/observability",
+    highlight: false,
+    coverImage: null,
+    accomplishment: "MTTR for production incidents dropped from 47 minutes to 11 minutes within two quarters of rollout.",
+    publicationPermit: true,
+    clientOrCompanyName: "Stellar Logistics",
+    websiteUrl: null,
+    toptalRelated: false,
+    showViaToptal: false,
+    kind: "basic",
+    skills: [{ id: "sk_test_typescript", name: "TypeScript" }],
+    industries: [{ id: "ind_test_software", name: "Software" }],
+};
+// -----------------------------------------------------------------------
+// Employment — paragraph-bearing experienceItems
+// -----------------------------------------------------------------------
+export const EMPLOYMENT_PRINCIPAL_ENGINEER = {
+    id: "emp_test_001",
+    company: "Acme Financial",
+    position: "Principal Engineer",
+    companyWebsite: "https://example.com/acme",
+    noWebsite: false,
+    startDate: 2021,
+    endDate: null, // current role
+    experienceItems: [
+        "Owned the architecture of the multi-region transaction ledger from prototype to production at 12k writes/sec.",
+        "Mentored a team of 6 engineers; ran weekly architecture-review forums and pairing sessions on hard-to-debug latency tails.",
+        "Drove the migration off a hand-rolled ORM onto Drizzle, removing ~14k lines of bespoke SQL plumbing.",
+    ],
+    highlight: true,
+    showViaToptal: true,
+    toptalRelated: false,
+};
+export const EMPLOYMENT_SENIOR_ENGINEER = {
+    id: "emp_test_002",
+    company: "Mercury Health",
+    position: "Senior Software Engineer",
+    companyWebsite: "https://example.com/mercury",
+    noWebsite: false,
+    startDate: 2017,
+    endDate: 2021,
+    experienceItems: [
+        "Built the FHIR-compliant EHR gateway from green field to 11 partner clinics in production.",
+        "Led the SMART-on-FHIR auth integration; co-authored an internal RFC adopted across two sister product teams.",
+    ],
+    highlight: true,
+    showViaToptal: true,
+    toptalRelated: false,
+};
+// -----------------------------------------------------------------------
+// Education
+// -----------------------------------------------------------------------
+export const EDUCATION_STANFORD_BS = {
+    id: "edu_test_001",
+    institution: "Stanford University",
+    degree: "Bachelor of Science",
+    fieldOfStudy: "Computer Science",
+    location: "Stanford, CA",
+    title: "BS, Computer Science",
+    yearFrom: 2010,
+    yearTo: 2014,
+    highlight: true,
+};
+// -----------------------------------------------------------------------
+// Certifications
+// -----------------------------------------------------------------------
+export const CERT_AWS_PRO = {
+    id: "cert_test_001",
+    certificate: "AWS Certified Solutions Architect — Professional",
+    institution: "Amazon Web Services",
+    link: "https://example.com/cert/aws-pro",
+    number: "AWS-SAP-12345",
+    validFromMonth: 3,
+    validFromYear: 2023,
+    validToMonth: 3,
+    validToYear: 2026,
+    highlight: true,
+};
+export const CERT_CKAD = {
+    id: "cert_test_002",
+    certificate: "Certified Kubernetes Application Developer",
+    institution: "Cloud Native Computing Foundation",
+    link: "https://example.com/cert/ckad",
+    number: "CKAD-67890",
+    validFromMonth: 6,
+    validFromYear: 2022,
+    validToMonth: 6,
+    validToYear: 2025,
+    highlight: false,
+};
+// -----------------------------------------------------------------------
+// Industries
+// -----------------------------------------------------------------------
+export const INDUSTRY_FINTECH = {
+    id: "ind_test_001",
+    title: "Financial services",
+    about: "8 years building ledger, payments, and reconciliation systems for B2B fintech.",
+    domainArea: "Payments and ledger",
+};
+export const INDUSTRY_HEALTHTECH = {
+    id: "ind_test_002",
+    title: "Healthcare",
+    about: "4 years on HIPAA-compliant clinical-data infrastructure and FHIR integrations.",
+    domainArea: "Clinical data exchange",
+};
+// -----------------------------------------------------------------------
+// Travel visas
+// -----------------------------------------------------------------------
+export const VISA_US = {
+    id: "visa_test_001",
+    countryId: "country_us",
+    countryName: "United States",
+    visaType: "B1/B2",
+    expiryDate: "2030-06-15",
+};
+//# sourceMappingURL=data.js.map

package/dist/__tests__/fixtures/profile/data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.js","sourceRoot":"","sources":["../../../../src/__tests__/fixtures/profile/data.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAYpC;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,0EAA0E;AAC1E,SAAS;AACT,0EAA0E;AAE1E,yEAAyE;AACzE,kEAAkE;AAClE,sEAAsE;AACtE,8DAA8D;AAE9D,MAAM,CAAC,MAAM,gBAAgB,GAAoB;IAC/C,EAAE,EAAE,aAAa;IACjB,UAAU,EAAE,EAAE,EAAE,UAAU;IAC1B,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,IAAI;IACZ,QAAQ,EAAE,CAAC;IACX,KAAK,EAAE,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,YAAY,EAAE;IACjD,gBAAgB,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAoB;IAC7C,EAAE,EAAE,aAAa;IACjB,UAAU,EAAE,EAAE,EAAE,UAAU;IAC1B,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,IAAI;IACZ,QAAQ,EAAE,CAAC;IACX,KAAK,EAAE,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,YAAY,EAAE;IACjD,gBAAgB,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAoB;IAC/C,EAAE,EAAE,aAAa;IACjB,UAAU,EAAE,EAAE,EAAE,UAAU;IAC1B,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,IAAI;IACZ,QAAQ,EAAE,CAAC;IACX,KAAK,EAAE,EAAE,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,YAAY,EAAE;IAClD,gBAAgB,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAoB;IAC5C,EAAE,EAAE,aAAa;IACjB,UAAU,EAAE,EAAE,EAAE,UAAU;IAC1B,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,IAAI;IACZ,QAAQ,EAAE,CAAC;IACX,KAAK,EAAE,EAAE,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,SAAS,EAAE;IAC/C,gBAAgB,EAAE,CAAC;CACpB,CAAC;AAEF,0EAA0E;AAC1E,wEAAwE;AACxE,0EAA0E;AAE1E,MAAM,CAAC,MAAM,4BAA4B,GAAkB;IACzD,EAAE,EAAE,eAAe;IACnB,KAAK,EAAE,gCAAgC;IACvC,WAAW,EACT,4GAA4G;QAC5G,2GAA2G;QAC3G,sFAAsF;IACxF,IAAI,EAAE,yCAAyC;IAC/C,SAAS,EAAE,IAAI;IACf,UAAU,EAAE,uCAAuC;IACnD,cAAc,EACZ,8GAA8G;IAChH,iBAAiB,EAAE,IAAI;IACvB,mBAAmB,EAAE,gBAAgB;IACrC,UAAU,EAAE,0BAA0B;IACtC,aAAa,EAAE,IAAI;IACnB,aAAa,EAAE,IAAI;IACnB,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,oBAAoB,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;IAC1D,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC;CACrE,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAkB;IAClD,EAAE,EAAE,eAAe;IACnB,KAAK,EAAE,4BAA4B;IACnC,WAAW,EACT,uGAAuG;QACvG,0GAA0G;QAC1G,iEAAiE;IACnE,IAAI,EAAE,+CAA+C;IACrD,SAAS,EAAE,IAAI;IACf,UAAU,EAAE,IAAI;IAChB,cAAc,EAAE,qGAAqG;IACrH,iBAAiB,EAAE,IAAI;IACvB,mBAAmB,EAAE,gBAAgB;IACrC,UAAU,EAAE,6BAA6B;IACzC,aAAa,EAAE,KAAK;IACpB,aAAa,EAAE,IAAI;IACnB,IAAI,EAAE,WAAW;IACjB,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,oBAAoB,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;IAC1D,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE,qBAAqB,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAC;CACzE,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAkB;IACpD,EAAE,EAAE,eAAe;IACnB,KAAK,EAAE,iCAAiC;IACxC,WAAW,EACT,8GAA8G;QAC9G,sGAAsG;QACtG,uBAAuB;IACzB,IAAI,EAAE,gDAAgD;IACtD,SAAS,EAAE,KAAK;IAChB,UAAU,EAAE,IAAI;IAChB,cAAc,EAAE,qGAAqG;IACrH,iBAAiB,EAAE,IAAI;IACvB,mBAAmB,EAAE,mBAAmB;IACxC,UAAU,EAAE,IAAI;IAChB,aAAa,EAAE,KAAK;IACpB,aAAa,EAAE,KAAK;IACpB,IAAI,EAAE,OAAO;IACb,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,oBAAoB,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;IAC1D,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE,mBAAmB,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;CAC5D,CAAC;AAEF,0EAA0E;AAC1E,iDAAiD;AACjD,0EAA0E;AAE1E,MAAM,CAAC,MAAM,6BAA6B,GAAe;IACvD,EAAE,EAAE,cAAc;IAClB,OAAO,EAAE,gBAAgB;IACzB,QAAQ,EAAE,oBAAoB;IAC9B,cAAc,EAAE,0BAA0B;IAC1C,SAAS,EAAE,KAAK;IAChB,SAAS,EAAE,IAAI;IACf,OAAO,EAAE,IAAI,EAAE,eAAe;IAC9B,eAAe,EAAE;QACf,+GAA+G;QAC/G,4HAA4H;QAC5H,sGAAsG;KACvG;IACD,SAAS,EAAE,IAAI;IACf,aAAa,EAAE,IAAI;IACnB,aAAa,EAAE,KAAK;CACrB,CAAC;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAe;IACpD,EAAE,EAAE,cAAc;IAClB,OAAO,EAAE,gBAAgB;IACzB,QAAQ,EAAE,0BAA0B;IACpC,cAAc,EAAE,6BAA6B;IAC7C,SAAS,EAAE,KAAK;IAChB,SAAS,EAAE,IAAI;IACf,OAAO,EAAE,IAAI;IACb,eAAe,EAAE;QACf,4FAA4F;QAC5F,8GAA8G;KAC/G;IACD,SAAS,EAAE,IAAI;IACf,aAAa,EAAE,IAAI;IACnB,aAAa,EAAE,KAAK;CACrB,CAAC;AAEF,0EAA0E;AAC1E,YAAY;AACZ,0EAA0E;AAE1E,MAAM,CAAC,MAAM,qBAAqB,GAAc;IAC9C,EAAE,EAAE,cAAc;IAClB,WAAW,EAAE,qBAAqB;IAClC,MAAM,EAAE,qBAAqB;IAC7B,YAAY,EAAE,kBAAkB;IAChC,QAAQ,EAAE,cAAc;IACxB,KAAK,EAAE,sBAAsB;IAC7B,QAAQ,EAAE,IAAI;IACd,MAAM,EAAE,IAAI;IACZ,SAAS,EAAE,IAAI;CAChB,CAAC;AAEF,0EAA0E;AAC1E,iBAAiB;AACjB,0EAA0E;AAE1E,MAAM,CAAC,MAAM,YAAY,GAAkB;IACzC,EAAE,EAAE,eAAe;IACnB,WAAW,EAAE,kDAAkD;IAC/D,WAAW,EAAE,qBAAqB;IAClC,IAAI,EAAE,kCAAkC;IACxC,MAAM,EAAE,eAAe;IACvB,cAAc,EAAE,CAAC;IACjB,aAAa,EAAE,IAAI;IACnB,YAAY,EAAE,CAAC;IACf,WAAW,EAAE,IAAI;IACjB,SAAS,EAAE,IAAI;CAChB,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAkB;IACtC,EAAE,EAAE,eAAe;IACnB,WAAW,EAAE,4CAA4C;IACzD,WAAW,EAAE,mCAAmC;IAChD,IAAI,EAAE,+BAA+B;IACrC,MAAM,EAAE,YAAY;IACpB,cAAc,EAAE,CAAC;IACjB,aAAa,EAAE,IAAI;IACnB,YAAY,EAAE,CAAC;IACf,WAAW,EAAE,IAAI;IACjB,SAAS,EAAE,KAAK;CACjB,CAAC;AAEF,0EAA0E;AAC1E,aAAa;AACb,0EAA0E;AAE1E,MAAM,CAAC,MAAM,gBAAgB,GAAoB;IAC/C,EAAE,EAAE,cAAc;IAClB,KAAK,EAAE,oBAAoB;IAC3B,KAAK,EAAE,gFAAgF;IACvF,UAAU,EAAE,qBAAqB;CAClC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAoB;IAClD,EAAE,EAAE,cAAc;IAClB,KAAK,EAAE,YAAY;IACnB,KAAK,EAAE,gFAAgF;IACvF,UAAU,EAAE,wBAAwB;CACrC,CAAC;AAEF,0EAA0E;AAC1E,eAAe;AACf,0EAA0E;AAE1E,MAAM,CAAC,MAAM,OAAO,GAAe;IACjC,EAAE,EAAE,eAAe;IACnB,SAAS,EAAE,YAAY;IACvB,WAAW,EAAE,eAAe;IAC5B,QAAQ,EAAE,OAAO;IACjB,UAAU,EAAE,YAAY;CACzB,CAAC"}

package/dist/__tests__/fixtures/profile/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Profile rendering fixtures — reusable test data for empty / single-item
+ * / paragraph-bearing / full / minimal list scenarios. See `README.md`
+ * for the full builder API and the rationale behind the
+ * `buildParagraphBearingList` shape.
+ */
+export { buildEmptyProfile, buildFullProfile, buildMinimalProfile, buildParagraphBearingList, buildSingleItemList, } from "./builders.js";
+export type { Certification, Education, Employment, IndustryProfile, PortfolioItem, ProfileFixture, ProfileSkillSet, TravelVisa, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/__tests__/fixtures/profile/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/__tests__/fixtures/profile/index.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AAEH,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,aAAa,EACb,SAAS,EACT,UAAU,EACV,eAAe,EACf,aAAa,EACb,cAAc,EACd,eAAe,EACf,UAAU,GACX,MAAM,YAAY,CAAC"}

package/dist/__tests__/fixtures/profile/index.js

@@ -0,0 +1,10 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+/**
+ * Profile rendering fixtures — reusable test data for empty / single-item
+ * / paragraph-bearing / full / minimal list scenarios. See `README.md`
+ * for the full builder API and the rationale behind the
+ * `buildParagraphBearingList` shape.
+ */
+export { buildEmptyProfile, buildFullProfile, buildMinimalProfile, buildParagraphBearingList, buildSingleItemList, } from "./builders.js";
+//# sourceMappingURL=index.js.map

package/dist/__tests__/fixtures/profile/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/__tests__/fixtures/profile/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC;;;;;GAKG;AAEH,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,eAAe,CAAC"}

package/dist/__tests__/fixtures/profile/types.d.ts

@@ -0,0 +1,53 @@
+import type { Certification } from "../../../services/profile/certifications/index.js";
+import type { Education } from "../../../services/profile/education/index.js";
+import type { Employment } from "../../../services/profile/employment/index.js";
+import type { IndustryProfile } from "../../../services/profile/industries/index.js";
+import type { PortfolioItem } from "../../../services/profile/portfolio/index.js";
+import type { ProfileSkillSet } from "../../../services/profile/skills/index.js";
+import type { TravelVisa } from "../../../services/profile/visas/index.js";
+/**
+ * Fixture-only aggregate bundling every per-domain list a CLI/MCP rendering
+ * test might want to drive against in one shape. Production code does not
+ * have an aggregate `Profile` — each sub-domain (`profile.skills`,
+ * `profile.portfolio`, …) returns its own list — so this aggregate exists
+ * solely so test code can write
+ *
+ * ```ts
+ * const fx = buildEmptyProfile();
+ * expect(fx.skills).toEqual([]);
+ * expect(fx.portfolio).toEqual([]);
+ * ```
+ *
+ * Each member is the production entity type verbatim (re-exported from the
+ * sub-domain modules — no type duplication, no hand-rolled mock shapes).
+ *
+ * Note: the issue body referenced a `reviews` list with paragraph-bearing
+ * body text, but the production `reviews` domain (`profile.reviews`) is the
+ * admin section-review queue (`SectionReview`) with no prose body. The
+ * paragraph-bearing fixture therefore populates `portfolio` items with
+ * realistic multi-sentence `description` + `accomplishment` content (the
+ * actual paragraph-bearing fields in production). See the `README.md`
+ * sibling for the rationale.
+ */
+export interface ProfileFixture {
+    skills: ProfileSkillSet[];
+    portfolio: PortfolioItem[];
+    employment: Employment[];
+    education: Education[];
+    certifications: Certification[];
+    industries: IndustryProfile[];
+    visas: TravelVisa[];
+}
+/**
+ * Re-exports of the per-domain entity types so consumers can pull
+ * everything they need from one fixture-module path:
+ *
+ * ```ts
+ * import type { ProfileFixture, ProfileSkillSet } from "../fixtures/profile";
+ * ```
+ *
+ * The re-exports point at the production types — there is no
+ * fixture-private variant.
+ */
+export type { Certification, Education, Employment, IndustryProfile, PortfolioItem, ProfileSkillSet, TravelVisa };
+//# sourceMappingURL=types.d.ts.map

package/dist/__tests__/fixtures/profile/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/__tests__/fixtures/profile/types.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mDAAmD,CAAC;AACvF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8CAA8C,CAAC;AAC9E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+CAA+C,CAAC;AAChF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+CAA+C,CAAC;AACrF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAC;AAClF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAC;AAE3E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,UAAU,EAAE,UAAU,EAAE,CAAC;IACzB,SAAS,EAAE,SAAS,EAAE,CAAC;IACvB,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED;;;;;;;;;;GAUG;AACH,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,EAAE,aAAa,EAAE,eAAe,EAAE,UAAU,EAAE,CAAC"}

package/dist/__tests__/fixtures/profile/types.js

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+export {};
+//# sourceMappingURL=types.js.map

package/dist/__tests__/fixtures/profile/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/__tests__/fixtures/profile/types.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC"}

package/dist/auth/errors.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Cross-cutting typed-error contract for authentication failures.
+ *
+ * Each Toptal Talent backend (gateway, talent_profile, scheduler) reports
+ * authentication failures with a different wire shape:
+ *
+ *   - gateway          → JSON `{ errors: [{ extensions: { code: 'AUTHENTICATION_REQUIRED' } }] }`
+ *   - talent_profile   → JSON `{ errors: [{ extensions: { code: 'UNAUTHENTICATED' } }] }`
+ *                        OR HTML Cloudflare challenge (HTTP 403)
+ *   - scheduler        → JSON `{ error: 'unauthorized' }` (post-v1)
+ *
+ * Transport and service modules detect each shape and throw a concrete
+ * `TtctlError` subclass. Errors are NOT caught at the service layer — they
+ * propagate to `@ttctl/cli` (CLI) and `@ttctl/mcp` (MCP) which present them
+ * per surface conventions (CLI: human-readable text + exit code; MCP:
+ * structured tool-error response).
+ *
+ * Each subclass carries:
+ *   - `code`     — stable machine-readable identifier (e.g. `'AUTH_REVOKED'`).
+ *                  Script consumers branch on this without parsing prose.
+ *   - `recovery` — short, actionable user-facing string explaining how to
+ *                  recover. Phrasing should match what the user CAN do, not
+ *                  what TTCtl COULD do internally.
+ *   - `autoRecover` (optional) — when `true`, signals that the transport or
+ *                  service layer SHOULD attempt recovery once before
+ *                  surfacing the error (e.g. scheduler-bearer re-mint via
+ *                  `GetTopSchedulerToken` post-v1). Defaults to `false`.
+ *
+ * See `hq/engineering/adr/ADR-005-auth-model.md` for the cross-surface
+ * auth model. See issue #77 for the full failure-mode table.
+ */
+export declare abstract class TtctlError extends Error {
+    /**
+     * Stable, machine-readable error code. Subclasses provide a literal string
+     * (e.g. `'AUTH_REVOKED'`, `'CF_403_CLEARANCE'`). Script consumers branch
+     * on this; the value is part of the public API and should not change
+     * casually.
+     */
+    abstract readonly code: string;
+    /**
+     * Short, actionable user-facing string. Phrased imperatively where the
+     * user can take an action (e.g. `Run \`ttctl auth signin\` to
+     * re-authenticate.`). Phrased descriptively where there is no clean user
+     * action (e.g. `Cloudflare's bot-management has flipped a feature flag.
+     * File an issue at ...`). Surface-renderers (CLI / MCP) pass this through
+     * verbatim.
+     */
+    abstract readonly recovery: string;
+    /**
+     * When `true`, the transport or service layer should attempt automated
+     * recovery once before surfacing this error to the user. Concrete
+     * subclasses opt in by overriding to `true` (e.g. `SchedulerBearerExpired`
+     * post-v1, where `GetTopSchedulerToken` re-mints transparently).
+     *
+     * Default `false` — most auth failures (revoked token, Cloudflare block)
+     * require user intervention and cannot be auto-recovered.
+     */
+    readonly autoRecover: boolean;
+}
+/**
+ * Authentication revoked or expired — the token TTCtl is replaying as
+ * `Authorization: Token token=<X>` is no longer accepted by the gateway.
+ *
+ * Detected at the service layer when:
+ *   - HTTP response is 401, OR
+ *   - GraphQL response carries `errors[0].extensions.code` equal to
+ *     `'AUTHENTICATION_REQUIRED'` (gateway form) or `'UNAUTHENTICATED'`
+ *     (talent_profile form).
+ *
+ * Recovery is unambiguous: the user runs `ttctl auth signin` to re-mint a
+ * session token. There is no automated path — sign-in requires credentials
+ * the agent does not have.
+ */
+export declare class AuthRevokedError extends TtctlError {
+    readonly name = "AuthRevokedError";
+    readonly code = "AUTH_REVOKED";
+    readonly recovery = "Run `ttctl auth signin` to re-authenticate.";
+    constructor(message?: string, options?: {
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/auth/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/auth/errors.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,8BAAsB,UAAW,SAAQ,KAAK;IAC5C;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAE/B;;;;;;;OAOG;IACH,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAEnC;;;;;;;;OAQG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAS;CACvC;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C,SAAkB,IAAI,sBAAsB;IAC5C,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,QAAQ,iDAAiD;gBAEtD,OAAO,GAAE,MAAyC,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAG9F"}

package/dist/auth/errors.js

@@ -0,0 +1,68 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+/**
+ * Cross-cutting typed-error contract for authentication failures.
+ *
+ * Each Toptal Talent backend (gateway, talent_profile, scheduler) reports
+ * authentication failures with a different wire shape:
+ *
+ *   - gateway          → JSON `{ errors: [{ extensions: { code: 'AUTHENTICATION_REQUIRED' } }] }`
+ *   - talent_profile   → JSON `{ errors: [{ extensions: { code: 'UNAUTHENTICATED' } }] }`
+ *                        OR HTML Cloudflare challenge (HTTP 403)
+ *   - scheduler        → JSON `{ error: 'unauthorized' }` (post-v1)
+ *
+ * Transport and service modules detect each shape and throw a concrete
+ * `TtctlError` subclass. Errors are NOT caught at the service layer — they
+ * propagate to `@ttctl/cli` (CLI) and `@ttctl/mcp` (MCP) which present them
+ * per surface conventions (CLI: human-readable text + exit code; MCP:
+ * structured tool-error response).
+ *
+ * Each subclass carries:
+ *   - `code`     — stable machine-readable identifier (e.g. `'AUTH_REVOKED'`).
+ *                  Script consumers branch on this without parsing prose.
+ *   - `recovery` — short, actionable user-facing string explaining how to
+ *                  recover. Phrasing should match what the user CAN do, not
+ *                  what TTCtl COULD do internally.
+ *   - `autoRecover` (optional) — when `true`, signals that the transport or
+ *                  service layer SHOULD attempt recovery once before
+ *                  surfacing the error (e.g. scheduler-bearer re-mint via
+ *                  `GetTopSchedulerToken` post-v1). Defaults to `false`.
+ *
+ * See `hq/engineering/adr/ADR-005-auth-model.md` for the cross-surface
+ * auth model. See issue #77 for the full failure-mode table.
+ */
+export class TtctlError extends Error {
+    /**
+     * When `true`, the transport or service layer should attempt automated
+     * recovery once before surfacing this error to the user. Concrete
+     * subclasses opt in by overriding to `true` (e.g. `SchedulerBearerExpired`
+     * post-v1, where `GetTopSchedulerToken` re-mints transparently).
+     *
+     * Default `false` — most auth failures (revoked token, Cloudflare block)
+     * require user intervention and cannot be auto-recovered.
+     */
+    autoRecover = false;
+}
+/**
+ * Authentication revoked or expired — the token TTCtl is replaying as
+ * `Authorization: Token token=<X>` is no longer accepted by the gateway.
+ *
+ * Detected at the service layer when:
+ *   - HTTP response is 401, OR
+ *   - GraphQL response carries `errors[0].extensions.code` equal to
+ *     `'AUTHENTICATION_REQUIRED'` (gateway form) or `'UNAUTHENTICATED'`
+ *     (talent_profile form).
+ *
+ * Recovery is unambiguous: the user runs `ttctl auth signin` to re-mint a
+ * session token. There is no automated path — sign-in requires credentials
+ * the agent does not have.
+ */
+export class AuthRevokedError extends TtctlError {
+    name = "AuthRevokedError";
+    code = "AUTH_REVOKED";
+    recovery = "Run `ttctl auth signin` to re-authenticate.";
+    constructor(message = "Session is invalid or expired.", options) {
+        super(message, options);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/auth/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/auth/errors.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,OAAgB,UAAW,SAAQ,KAAK;IAmB5C;;;;;;;;OAQG;IACM,WAAW,GAAY,KAAK,CAAC;CACvC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,gBAAiB,SAAQ,UAAU;IAC5B,IAAI,GAAG,kBAAkB,CAAC;IACnC,IAAI,GAAG,cAAc,CAAC;IACtB,QAAQ,GAAG,6CAA6C,CAAC;IAElE,YAAY,UAAkB,gCAAgC,EAAE,OAA6B;QAC3F,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1B,CAAC;CACF"}