@thinkai/tai-api-contract 2.34.0-pr.810.e54f7dcd → 2.35.0-pr.811.d57af044

package/dist/generated/openapi.d.ts

@@ -394,7 +394,7 @@ export interface paths {
         };
         /**
          * Productivity insights — contributor drilldown
-         * @description Weekly and daily activity rollups for a single contributor on `/phase-c/c4/contributors/:id`. Distributes weekly merged PR counts from precomputed person metrics across weekdays; includes fail-rate signals and period-over-period summary deltas. Accepts org-chart person ids (typically email) and synthetic GitHub scopes (`__github:{login}`) for contributors not in the org chart.
+         * @description Weekly and daily activity rollups for a single contributor on `/insights/productivity/contributors/:loginOrId`. Accepts GitHub login slugs (preferred public URL), org-chart person ids (typically email), and synthetic GitHub scopes (`__github:{login}`) for contributors not in the org chart.
          */
         get: operations["getProductivityInsightsContributor"];
         put?: never;
@@ -641,7 +641,7 @@ export interface paths {
         put?: never;
         /**
          * Create GitHub App installation URL
-         * @description Creates a GitHub App installation URL scoped to the workspace and caller. Body is optional; when omitted, defaults to `/phase-a/p4` return path. Optional `pickerSession` (from user OAuth org picker) recovers `returnPath` from the server-side picker snapshot when the multi-hop authorize→install flow should return to the page where OAuth started.
+         * @description Creates a GitHub App installation URL scoped to the workspace and caller. Body is optional; when omitted, defaults to `/onboarding/integrations` return path. Optional `pickerSession` (from user OAuth org picker) recovers `returnPath` from the server-side picker snapshot when the multi-hop authorize→install flow should return to the page where OAuth started.
          */
         post: operations["postGithubInstallUrl"];
         delete?: never;
@@ -1120,6 +1120,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/readiness/repos/by-slug/{providerSlug}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Single repo readiness by provider slug
+         * @description Returns one stored repository scorecard keyed by `providerSlug` (`owner/repo`). Same response as `GET .../readiness/repos/{repoId}`. Unknown slug returns `404`.
+         */
+        get: operations["getReadinessRepoBySlug"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/readiness/repos/{repoId}": {
         parameters: {
             query?: never;
@@ -1194,7 +1214,7 @@ export interface paths {
         };
         /**
          * Workspace activity log (paginated)
-         * @description Paginated, chronological feed of workspace-scoped lifecycle events: repository add/remove/re-add and GitHub integration add/remove. Inactive repos remain visible in this log. Filter by `eventType`, `actorUserId`, or date range (`since`/`until`).
+         * @description Paginated, chronological feed of workspace-scoped lifecycle events: repository add/remove/re-add and GitHub integration add/remove. Inactive repos remain visible in this log. Filter by a single `eventType`, a coarse `eventCategory`/`productArea`, an `eventSubcategory` (a dotted event-type prefix that matches a whole lifecycle subgroup in one call, e.g. `integrations.cursor.execution_key`), `actorUserId`, or date range (`since`/`until`).
          */
         get: operations["listWorkspaceActivity"];
         put?: never;
@@ -1205,6 +1225,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/activity/export": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Export workspace activity log as CSV
+         * @description Export the workspace activity log as an RFC 4180 CSV file (one row per event). Accepts the same filters as `GET /workspaces/{workspaceId}/activity` (`eventType`, `eventCategory`, `eventSubcategory`, `productArea`, `actorUserId`, `since`, `until`, `search`, `sort`, `order`); `limit`/`offset` are ignored — the export returns up to 50000 matching rows within the sort. Columns: occurredAt, eventType, eventCategory, actorType, actorName, actorEmail, repoName, integrationType, metadata. Opaque internal identifiers (actorUserId, repoId, integrationId, fixRequestId, issueId, readinessRunId) are omitted — the human-readable equivalents are already present and the IDs carry no value in a user-facing export. The response sets `Content-Disposition: attachment` with a `.csv` filename.
+         */
+        get: operations["exportWorkspaceActivity"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/readiness/score-history": {
         parameters: {
             query?: never;
@@ -1549,6 +1589,50 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/workspaces/{workspaceId}/repo-eligibility": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get repo-sync eligibility gate (defaults + per-workspace overrides)
+         * @description Returns the effective repo-sync eligibility gate (archived / fork / size / count) for the workspace: the global `defaults`, any per-workspace `overrides`, the merged `effective` values, and whether the caller can edit without platform-admin (`canEditUnrestricted`). Member-level read access.
+         */
+        get: operations["getWorkspaceRepoEligibility"];
+        /**
+         * Set per-workspace repo-sync eligibility overrides
+         * @description Set (or clear, with an empty `overrides`) the per-workspace repo-sync eligibility overrides. **Platform admins** may set any value (raise caps, `0` = unlimited, include archived/forks). **Workspace admins** may only make the gate *more restrictive* than the platform defaults (lower caps, exclude archived/forks) — exceeding a platform limit returns `403` (`repo_eligibility_bound_exceeded`). Requires workspace admin or platform admin.
+         */
+        put: operations["putWorkspaceRepoEligibility"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/workspaces/{workspaceId}/repo-eligibility/refresh-languages": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Force a language/stack re-detection on the next sync
+         * @description Admin maintenance action: invalidate the cached language/stack freshness marker so the next GitHub repo sync re-fetches `GET /repos/{owner}/{repo}/languages` and recomputes the per-language breakdown and supported stacks. Use after adding a newly-supported language to a repo, or when a repo's stack detection looks stale. Optionally scope to a single repo via `repoSlug` (`owner/name`); omit it to reset every repo in the workspace. Requires workspace admin or platform admin. The refresh itself happens on the next sync (e.g. when the GitHub repo list is loaded with `refresh=true`); the readiness scan also refreshes the breakdown on each successful run.
+         */
+        post: operations["refreshWorkspaceRepoLanguages"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/workspaces/{workspaceId}/readiness/cursor-key-usage": {
         parameters: {
             query?: never;
@@ -1836,7 +1920,7 @@ export interface paths {
         };
         /**
          * Workspace journey step completion
-         * @description Returns the workspace-scoped journey progress state. Returns an empty `completedSteps` list with a synthetic `updatedAt` if no row exists yet. Covers issue #271.
+         * @description Returns the workspace-scoped journey progress state. Returns an empty `completedStepIds` array when no row exists yet (updatedAt is synthetic in that case). Values are canonical step IDs (see `JourneyStepId`); legacy route strings are accepted on PUT and normalized. Covers issue #271.
          */
         get: operations["getYourAiJourneyProgress"];
         /**
@@ -2309,12 +2393,7 @@ export interface components {
             /** @description Short label for the week column (MM/DD), aligned with Measure charts. */
             weekLabel?: string;
             mergedPrCount: number;
-            /** @description DORA change failure rate (deployments/incidents), not CI build failures. */
             failRatePercent: number;
-            /** @description GitHub Actions / Checks CI build failure rate for the week bucket (failed runs / (failed + passed) * 100). Zero when GitHub Actions CI is disabled. */
-            ciFailRatePercent?: number;
-            /** @description Count of build.failed events in the week bucket when CI ingest is enabled. */
-            ciBuildFailuresCount?: number;
             /** @description Mean hours from PR creation to first review in this week bucket. */
             avgReviewWaitHours?: number;
             /** @description Mean hours from first review to first approval in this week bucket. */
@@ -2347,8 +2426,6 @@ export interface components {
             scope: components["schemas"]["ProductivityInsightsAggregatedTeamsScopeDto"];
             /** Format: date-time */
             generatedAt: string;
-            /** @description True when the workspace has opted in to GitHub Actions CI ingest. */
-            githubActionsCiEnabled?: boolean;
             teams: components["schemas"]["ProductivityInsightsAggregatedTeamRowDto"][];
         };
         ProductivityInsightsMergedPrTrendWeekDto: {
@@ -2393,16 +2470,11 @@ export interface components {
             periodAvgMergedPrs: number;
             /** @description Average change failure rate over the range when available. */
             avgFailRatePercent?: number;
-            /** @description Average GitHub Actions CI build failure rate over the range when CI ingest is enabled. */
-            avgCiFailRatePercent?: number;
         };
         ProductivityInsightsTeamSummaryDto: {
             totalMergedPrs: number;
             avgMergedPrsPerWeek: number;
-            /** @description Average DORA change failure rate over the range when available. */
             avgFailRatePercent: number;
-            /** @description Average GitHub Actions CI build failure rate over the range when CI ingest is enabled. */
-            avgCiFailRatePercent?: number;
             headcount: number;
         };
         ProductivityInsightsTeamDetailDto: {
@@ -2429,8 +2501,6 @@ export interface components {
             scope: components["schemas"]["ProductivityInsightsAggregatedTeamsScopeDto"];
             /** Format: date-time */
             generatedAt: string;
-            /** @description True when the workspace has opted in to GitHub Actions CI ingest. */
-            githubActionsCiEnabled?: boolean;
             /** @description Present when `teamId` query is omitted — top-ranked teams. */
             items?: components["schemas"]["ProductivityInsightsTeamLeaderItemDto"][];
             /** @description Present when `teamId` query is set — single-team drilldown. */
@@ -2478,16 +2548,11 @@ export interface components {
             totalMergedPrs: number;
             avgMergedPrsPerWeek: number;
             totalAbsenceDays: number;
-            /** @description Average DORA change failure rate over the range when available. */
             avgFailRate: number;
-            /** @description Average GitHub Actions CI build failure rate over the range when CI ingest is enabled. */
-            avgCiFailRate?: number;
             mergedPrDelta: number;
             avgMergedPrsPerWeekDelta: number;
             totalAbsenceDaysDelta: number;
             avgFailRateDelta: number;
-            /** @description Change in average CI build failure rate vs the prior comparison window. */
-            avgCiFailRateDelta?: number;
         };
         ProductivityInsightsContributorDetailDto: {
             /** Format: uuid */
@@ -2499,8 +2564,6 @@ export interface components {
             scope: components["schemas"]["ProductivityInsightsAggregatedTeamsScopeDto"];
             /** Format: date-time */
             generatedAt: string;
-            /** @description True when the workspace has opted in to GitHub Actions CI ingest. */
-            githubActionsCiEnabled?: boolean;
             contributor: components["schemas"]["ProductivityInsightsContributorProfileDto"];
             weeks: components["schemas"]["ProductivityInsightsContributorActivityWeekDto"][];
             summary: components["schemas"]["ProductivityInsightsContributorActivitySummaryDto"];
@@ -2519,8 +2582,6 @@ export interface components {
             periodAvgMergedPrs: number;
             /** @description Mean weekly change-failure rate when available. */
             avgFailRatePercent?: number;
-            /** @description Mean weekly GitHub Actions CI build failure rate when CI ingest is enabled. */
-            avgCiFailRatePercent?: number;
         };
         ProductivityInsightsNeedsAttentionDto: {
             /** Format: uuid */
@@ -2531,8 +2592,6 @@ export interface components {
             entityType: "teams" | "contributors";
             /** Format: date-time */
             generatedAt: string;
-            /** @description True when GitHub Actions CI ingest is enabled for this workspace. */
-            githubActionsCiEnabled?: boolean;
             items: components["schemas"]["ProductivityInsightsNeedsAttentionItemDto"][];
         };
         AiUsageSpendAggregatedTeamWeekDto: {
@@ -2801,6 +2860,83 @@ export interface components {
              * @description Last push or metadata update from GitHub when available.
              */
             updatedAt?: string | null;
+            /** @description True when the repository is archived (read-only on GitHub). */
+            archived?: boolean | null;
+            /** @description True when the repository is a fork of another repository. */
+            fork?: boolean | null;
+            /** @description True when the repository is disabled on GitHub. */
+            disabled?: boolean | null;
+            /** @description Repository size in KB as reported by GitHub. */
+            size?: number | null;
+            /** @description Hard structural reasons this repo cannot be analyzed (archived, disabled, too-large, workspace repo cap). Each entry is a human-readable explanation (e.g. "This repo is archived"). Empty or absent means no hard block. Forks and unsupported-language repos are NOT listed here — they are advisory `warnings` (#729) and remain analyzable. */
+            ineligibleReasons?: string[] | null;
+            /** @description Non-blocking advisories shown alongside an otherwise-analyzable repo (#729). Includes forks ("results reflect the forked code") and repos with no v1-supported stack, where the message embeds the GitHub language mix in percent. Absent/empty when there are no warnings. Unlike `ineligibleReasons`, warnings do NOT disable analyze/score/fix actions. */
+            warnings?: string[] | null;
+            /**
+             * @description Whether the repo can be analyzed (issue #44/#729). `ineligible` only for HARD structural gates (archived, disabled, too-large, workspace repo cap) — such repos render read-only in the AF list. A repo with no supported stack or that is a fork is `eligible` and carries a non-blocking `warnings` entry instead of being blocked.
+             * @enum {string|null}
+             */
+            eligibilityStatus?: "eligible" | "ineligible" | null;
+            /** @description Human-readable explanation when `eligibilityStatus` is `ineligible` (e.g. "This repo is archived"). For advisory language/fork notices see `warnings`, not this field. */
+            eligibilityReason?: string | null;
+            /** @description Dominant supported stack (by GitHub language bytes), one of backend_jvm | ios_app | web_spa | backend_go | backend_python. Null when no supported stack was detected. */
+            primaryStack?: string | null;
+            /** @description Second supported stack for a multi-stack repo, or null. */
+            secondaryStack?: string | null;
+            /** @description All supported stacks detected for the repo (ordered, primary first). Empty/null when no supported stack is present. Drives multi-stack scanning and the orange mixed-monorepo box in the AF UI. */
+            supportedStacks?: string[] | null;
+            /** @description Per-language share of the repo from GitHub's `GET /repos/{owner}/{repo}/languages` byte counts, ordered by share descending (#729). Powers the "language mix" shown in the unsupported-stack warning. Absent/null until the repo has been synced with a language resolver. */
+            languageBreakdown?: {
+                /** @description GitHub language name (e.g. "TypeScript", "Go"). */
+                language: string;
+                /**
+                 * Format: float
+                 * @description Share of total language bytes, rounded to four decimal places (e.g. 64.2153). The extra precision keeps small/near-tied languages distinguishable for a hover tag; render it rounded for compact labels. May not sum to exactly 100 due to rounding.
+                 */
+                percent: number;
+                /** @description True when this language maps to a v1-supported stack; false when the language is not supported. Lets the UI flag exactly which languages are not (fully) supported in a mixed/monorepo. */
+                supported: boolean;
+                /** @description The supported stack this language maps to (backend_jvm | ios_app | web_spa | backend_go | backend_python), or null when the language is unsupported. */
+                stack?: string | null;
+            }[] | null;
+        };
+        /** @description Resolved repo-sync eligibility gate (defaults or effective). All fields present. */
+        RepoEligibilityConfigDto: {
+            /** @description Skip archived repos during GitHub repo sync. */
+            excludeArchived: boolean;
+            /** @description Skip forked repos. Forks are included by default. */
+            excludeForks: boolean;
+            /** @description Max repo size in KB (GitHub-reported). 0 = no limit. */
+            maxRepoSizeKb: number;
+            /** @description Max repos materialized per workspace per sync. 0 = no limit. */
+            maxReposPerWorkspace: number;
+        };
+        /** @description Per-workspace overrides for the repo-sync eligibility gate. Any field present wins over the global default; omit a field to inherit the default. An empty object clears all overrides. */
+        RepoEligibilityOverridesDto: {
+            excludeArchived?: boolean | null;
+            excludeForks?: boolean | null;
+            maxRepoSizeKb?: number | null;
+            maxReposPerWorkspace?: number | null;
+        };
+        WorkspaceRepoEligibilityDto: {
+            defaults: components["schemas"]["RepoEligibilityConfigDto"];
+            overrides: components["schemas"]["RepoEligibilityOverridesDto"];
+            effective: components["schemas"]["RepoEligibilityConfigDto"];
+            /** @description True when the caller is a platform admin (may set any value, incl. raising caps). */
+            canEditUnrestricted: boolean;
+        };
+        /** @description Effective repo-eligibility limits applied to the GitHub repo list, plus the current count of eligible repos. Lets the UI render per-repo "size / limit" (compare each repo's `size` in `GithubInstalledRepoDto` to `maxRepoSizeKb`) and workspace "N / cap" usage (`eligibleRepoCount` / `maxReposPerWorkspace`). */
+        RepoEligibilityLimitsDto: {
+            /** @description Per-repo size cap in KB (GitHub-reported). 0 = no limit. */
+            maxRepoSizeKb: number;
+            /** @description Max repos that can be eligible per workspace. 0 = no limit. */
+            maxReposPerWorkspace: number;
+            /** @description Whether archived repos are treated as a hard block. */
+            excludeArchived: boolean;
+            /** @description Whether forked repos are excluded by the sync gate (forks are a warning, not a block). */
+            excludeForks: boolean;
+            /** @description Repos currently counting as eligible (eligibilityStatus != "ineligible"), i.e. those that count toward `maxReposPerWorkspace`. */
+            eligibleRepoCount: number;
         };
         GithubMissingPermissionDto: {
             /** @description GitHub App permission key (e.g. contents, pull_requests). */
@@ -2889,6 +3025,8 @@ export interface components {
             account?: components["schemas"]["GithubAccountDto"] | null;
             /** @description Paginated merged installation repositories when `installed` is true. */
             repos?: components["schemas"]["GithubInstalledRepoListDto"] | null;
+            /** @description Effective size/count limits and current eligible-repo usage for the repo list. Present when `installed` is true. Pair with each repo's `size` and `eligibilityStatus` to show "size / limit" and "N / cap" in the UI. */
+            eligibilityLimits?: components["schemas"]["RepoEligibilityLimitsDto"] | null;
             /**
              * Format: uri
              * @description User accounts: github.com/settings/installations/<id>. Organizations: github.com/organizations/<login>/settings/installations/<id>.
@@ -3199,7 +3337,7 @@ export interface components {
             scorePercent?: number;
             /** @description Per-criterion status counts from the latest successful scan */
             criteriaSummary?: components["schemas"]["ReadinessCriteriaSummaryDto"] | null;
-            /** @description Individual rubric criterion outcomes from the latest successful scan. Always present on the single-repo detail endpoint. When the repo has a succeeded scan but a dimension was not evaluated (e.g. Section I on older runs), the API returns full rubric placeholders with status `blocked`. Empty array only when the repo has no succeeded scan yet. */
+            /** @description Individual rubric criterion outcomes from the latest successful scan. Always present on the single-repo detail endpoint; empty array when no scan has completed yet for this dimension. */
             criteriaDetails: components["schemas"]["CriterionDetailDto"][];
             issues: components["schemas"]["ReadinessIssueDto"][];
         };
@@ -3293,6 +3431,34 @@ export interface components {
              * @enum {string|null}
              */
             archivedReason?: "github_removed" | "installation_disconnected" | "installation_replaced" | "superseded" | null;
+            /**
+             * @description Whether the repo can be analyzed (#44/#729). Language support no longer makes a repo `ineligible` — a missing v1-supported stack is surfaced via `warnings` and the repo stays analyzable. It becomes `ineligible` when the most recent scan hit a hard size/file-count limit (e.g. code-size or file-count exceeded): the repo is then restricted here too so this surface matches the GitHub connect list's size gate after the scan. Null until the first sync/scan computes it.
+             * @enum {string|null}
+             */
+            eligibilityStatus?: "eligible" | "ineligible" | null;
+            /** @description Human-readable explanation when `eligibilityStatus` is `ineligible` (e.g. the size / file-count limit message from the last scan). For advisory language notices see `warnings`. */
+            eligibilityReason?: string | null;
+            /** @description Non-blocking advisories for an analyzable repo (#729): no v1-supported stack (with the language mix), and hard-limit run outcomes (code size / file count exceeded) carried from the last run. Absent/empty when there are no warnings. */
+            warnings?: string[] | null;
+            /** @description Dominant supported stack — backend_jvm | ios_app | web_spa | backend_go | backend_python. Null when no supported stack/uncomputed. */
+            primaryStack?: string | null;
+            /** @description Second supported stack for a multi-stack repo, or null. */
+            secondaryStack?: string | null;
+            /** @description All supported stacks detected (ordered, primary first). Empty/null when none. */
+            supportedStacks?: string[] | null;
+            /** @description Per-language share from GitHub languages (#729), ordered by share descending. Each entry has `supported`/`stack` so the UI can tag which languages are (not) supported. Absent until the repo has been synced with a language resolver. */
+            languageBreakdown?: {
+                language: string;
+                /**
+                 * Format: float
+                 * @description Share of total language bytes, rounded to four decimal places (e.g. 64.2153).
+                 */
+                percent: number;
+                supported: boolean;
+                stack?: string | null;
+            }[] | null;
+            /** @description GitHub-reported repository size in KB (includes git history), refreshed on each readiness scan (#729). Compare against `eligibilityLimits.maxRepoSizeKb` on the list response to show per-repo "size / limit". When the size exceeds the limit the latest scan is recorded as `partial_failed` with `lastRunErrorCode = exceeded_repo_size_limit` and the repo is marked `ineligible`. Null until a scan has populated it. */
+            sizeKb?: number | null;
         };
         /** @description Single-repo detail response. Identical to RepoReadinessScoreDto except dimensions use DimensionScoreDetailDto (criteriaDetails required per dimension). */
         RepoReadinessScoreDetailDto: {
@@ -3320,6 +3486,30 @@ export interface components {
             archivedAt?: string | null;
             /** @enum {string|null} */
             archivedReason?: "github_removed" | "installation_disconnected" | "installation_replaced" | "superseded" | null;
+            /**
+             * @description See RepoReadinessScoreDto.eligibilityStatus. Language support is advisory (#729) and surfaced via `warnings`.
+             * @enum {string|null}
+             */
+            eligibilityStatus?: "eligible" | "ineligible" | null;
+            eligibilityReason?: string | null;
+            /** @description Non-blocking advisories (no v1-supported stack, hard-limit run outcomes). See RepoReadinessScoreDto.warnings. */
+            warnings?: string[] | null;
+            primaryStack?: string | null;
+            secondaryStack?: string | null;
+            supportedStacks?: string[] | null;
+            /** @description Per-language share with `supported`/`stack` tags. See RepoReadinessScoreDto.languageBreakdown. */
+            languageBreakdown?: {
+                language: string;
+                /**
+                 * Format: float
+                 * @description Share of total language bytes, rounded to four decimal places (e.g. 64.2153).
+                 */
+                percent: number;
+                supported: boolean;
+                stack?: string | null;
+            }[] | null;
+            /** @description GitHub-reported repository size in KB, refreshed on each scan. See RepoReadinessScoreDto.sizeKb. */
+            sizeKb?: number | null;
         };
         AgenticFoundationDashboardSummaryDto: {
             repoCount: number;
@@ -3344,8 +3534,20 @@ export interface components {
             limit: number;
             offset: number;
         };
+        /** @description Effective size/code limits enforced by readiness scans (#729). Lets the UI render per-repo "size / limit" (compare each repo's `sizeKb` to `maxRepoSizeKb`) and explain why a repo is `ineligible` due to a hard size/file-count limit. A repo over `maxRepoSizeKb` is skipped on the next scan (recorded `partial_failed` with `exceeded_repo_size_limit`); code-line/file counts are evaluated post-clone via `cloc`. */
+        ReadinessEligibilityLimitsDto: {
+            /** @description Per-repo GitHub size cap in KB (includes git history). 0 = no limit. */
+            maxRepoSizeKb: number;
+            /** @description Max total lines of code (cloc) before a scan is skipped. 0 = no limit. */
+            maxLinesOfCode: number;
+            /** @description Max source file count (cloc) before a scan is skipped. 0 = no limit. */
+            maxFileCount: number;
+            /** @description Max repos that can be eligible per workspace. 0 = no limit. */
+            maxReposPerWorkspace: number;
+        };
         ReadinessRepoListDto: components["schemas"]["PageMetaDto"] & {
             items: components["schemas"]["RepoReadinessScoreDto"][];
+            eligibilityLimits?: components["schemas"]["ReadinessEligibilityLimitsDto"];
         };
         /** @description Paginated list of repo readiness scores where each dimension includes criteriaDetails. Used by dimension-slice endpoints (agentic-foundation pillars). */
         ReadinessRepoDetailListDto: components["schemas"]["PageMetaDto"] & {
@@ -3580,14 +3782,31 @@ export interface components {
         AiStrategyPlanDto: {
             phases: components["schemas"]["AiStrategyPhaseBlockDto"][];
         };
+        /**
+         * @description Canonical journey step identifier (stable across URL reshuffles).
+         * @enum {string}
+         */
+        JourneyStepId: "onboarding.workspace" | "onboarding.ai_readiness" | "onboarding.integrations" | "readiness.dashboard" | "readiness.fix_queue" | "readiness.activity" | "insights.productivity" | "insights.productivity.by_user" | "insights.productivity.by_team" | "insights.ai_usage" | "insights.ai_usage.by_user" | "insights.ai_usage.by_team" | "insights.ai_usage.by_model";
         JourneyProgressDto: {
-            completedSteps: string[];
+            /** @description Canonical completed journey step IDs. */
+            completedStepIds: components["schemas"]["JourneyStepId"][];
+            /**
+             * @deprecated
+             * @description Deprecated alias of completedStepIds (legacy clients). Omitted on new responses when empty.
+             */
+            completedSteps?: string[];
             /** Format: date-time */
             updatedAt: string;
         };
         JourneyProgressUpdateDto: {
-            completedSteps: string[];
-        };
+            /** @description Idempotent replace-all of completed step IDs. */
+            completedStepIds?: components["schemas"]["JourneyStepId"][];
+            /**
+             * @deprecated
+             * @description Deprecated input alias — route strings and legacy `/phase-*` paths are normalized to step IDs.
+             */
+            completedSteps?: string[];
+        } | unknown | unknown;
         /** @enum {string} */
         ThemePreference: "light" | "dark" | "system";
         NotificationPreferencesDto: {
@@ -3709,7 +3928,9 @@ export interface components {
             /** Format: date-time */
             windowEnd: string;
             journey: {
-                completedSteps: string[];
+                completedStepIds: components["schemas"]["JourneyStepId"][];
+                /** @deprecated */
+                completedSteps?: string[];
                 /** Format: date-time */
                 updatedAt: string | null;
             };
@@ -3782,7 +4003,7 @@ export interface components {
          * @description Type of workspace lifecycle event.
          * @enum {string}
          */
-        ActivityLogEventTypeDto: "repo.added" | "repo.removed" | "repo.readded" | "integration.github.added" | "integration.github.updated" | "integration.github.removed" | "integration.github.permissions_changed" | "integration.github.repo_added" | "integration.github.repo_removed" | "fix.requested" | "fix.generating" | "fix.pr_created" | "fix.merged" | "fix.failed" | "readiness.scan_started" | "readiness.scan_completed" | "readiness.scan_failed" | "readiness.scan_partial" | "config.cursor.added" | "config.cursor.updated" | "config.cursor.removed" | "config.cursor.platform_key_enabled" | "config.cursor.platform_key_disabled" | "config.claude.added" | "config.claude.updated" | "config.claude.removed" | "config.agent_execution.provider_changed" | "member.invited" | "member.role_changed" | "member.removed";
+        ActivityLogEventTypeDto: "repo.added" | "repo.removed" | "repo.readded" | "integration.github.added" | "integration.github.updated" | "integration.github.removed" | "integration.github.permissions_changed" | "integration.github.repo_added" | "integration.github.repo_removed" | "fix.requested" | "fix.generating" | "fix.pr_created" | "fix.merged" | "fix.failed" | "readiness.scan_started" | "readiness.scan_completed" | "readiness.scan_failed" | "readiness.scan_partial" | "integrations.agent_execution.provider_changed" | "integrations.repo_eligibility.overrides_changed" | "integrations.repo_eligibility.languages_refresh_requested" | "integrations.cursor.platform_key_enabled" | "integrations.cursor.platform_key_disabled" | "member.invited" | "member.role_changed" | "member.removed" | "hris.personio.sync_started" | "hris.personio.sync_completed" | "hris.personio.sync_failed" | "hris.sync_started" | "hris.sync_completed" | "hris.sync_failed" | "repo.sync_skipped" | "integrations.cursor.execution_key.added" | "integrations.cursor.execution_key.updated" | "integrations.cursor.execution_key.removed" | "integrations.cursor.execution_key.check_failed" | "integrations.cursor.admin_key.added" | "integrations.cursor.admin_key.updated" | "integrations.cursor.admin_key.removed" | "integrations.claude.execution_key.added" | "integrations.claude.execution_key.updated" | "integrations.claude.execution_key.removed" | "integrations.claude.execution_key.check_failed" | "integrations.claude.admin_key.added" | "integrations.claude.admin_key.updated" | "integrations.claude.admin_key.removed" | "readiness.scan_precheck_failed" | "productivity.ingest.completed" | "productivity.ingest.failed" | "productivity.ingest.skipped";
         ActivityLogActorDto: {
             /** Format: uuid */
             userId: string;
@@ -4032,6 +4253,8 @@ export interface components {
     parameters: {
         WorkspaceId: string;
         RepoId: string;
+        /** @description Provider repository slug in `owner/repo` form (GitHub). Used for shareable public URLs; resolves to the same row as `repoId` UUID internally. */
+        ProviderSlug: string;
         ProjectId: string;
         NotificationId: string;
         /** @description Workspace member user id (`tai_users.id`). */
@@ -4153,6 +4376,10 @@ export type CreateWorkspaceBodyDto = components['schemas']['CreateWorkspaceBodyD
 export type CompanyProfileDto = components['schemas']['CompanyProfileDto'];
 export type GithubAccountDto = components['schemas']['GithubAccountDto'];
 export type GithubInstalledRepoDto = components['schemas']['GithubInstalledRepoDto'];
+export type RepoEligibilityConfigDto = components['schemas']['RepoEligibilityConfigDto'];
+export type RepoEligibilityOverridesDto = components['schemas']['RepoEligibilityOverridesDto'];
+export type WorkspaceRepoEligibilityDto = components['schemas']['WorkspaceRepoEligibilityDto'];
+export type RepoEligibilityLimitsDto = components['schemas']['RepoEligibilityLimitsDto'];
 export type GithubMissingPermissionDto = components['schemas']['GithubMissingPermissionDto'];
 export type GithubInstallationSummaryDto = components['schemas']['GithubInstallationSummaryDto'];
 export type GithubPendingApprovalDto = components['schemas']['GithubPendingApprovalDto'];
@@ -4205,6 +4432,7 @@ export type RepoReadinessScoreDto = components['schemas']['RepoReadinessScoreDto
 export type RepoReadinessScoreDetailDto = components['schemas']['RepoReadinessScoreDetailDto'];
 export type AgenticFoundationDashboardSummaryDto = components['schemas']['AgenticFoundationDashboardSummaryDto'];
 export type PageMetaDto = components['schemas']['PageMetaDto'];
+export type ReadinessEligibilityLimitsDto = components['schemas']['ReadinessEligibilityLimitsDto'];
 export type ReadinessRepoListDto = components['schemas']['ReadinessRepoListDto'];
 export type ReadinessRepoDetailListDto = components['schemas']['ReadinessRepoDetailListDto'];
 export type ReadinessFixListDto = components['schemas']['ReadinessFixListDto'];
@@ -4236,6 +4464,7 @@ export type AiStrategyRecommendBodyDto = components['schemas']['AiStrategyRecomm
 export type AiStrategyTaskRecommendationDto = components['schemas']['AiStrategyTaskRecommendationDto'];
 export type AiStrategyPhaseBlockDto = components['schemas']['AiStrategyPhaseBlockDto'];
 export type AiStrategyPlanDto = components['schemas']['AiStrategyPlanDto'];
+export type JourneyStepId = components['schemas']['JourneyStepId'];
 export type JourneyProgressDto = components['schemas']['JourneyProgressDto'];
 export type JourneyProgressUpdateDto = components['schemas']['JourneyProgressUpdateDto'];
 export type ThemePreference = components['schemas']['ThemePreference'];
@@ -4273,6 +4502,7 @@ export type ResponseUnauthorized = components['responses']['Unauthorized'];
 export type ResponseForbidden = components['responses']['Forbidden'];
 export type ParameterWorkspaceId = components['parameters']['WorkspaceId'];
 export type ParameterRepoId = components['parameters']['RepoId'];
+export type ParameterProviderSlug = components['parameters']['ProviderSlug'];
 export type ParameterProjectId = components['parameters']['ProjectId'];
 export type ParameterNotificationId = components['parameters']['NotificationId'];
 export type ParameterWorkspaceMemberId = components['parameters']['WorkspaceMemberId'];
@@ -5322,7 +5552,7 @@ export interface operations {
             header?: never;
             path: {
                 workspaceId: components["parameters"]["WorkspaceId"];
-                /** @description Org-chart person id or synthetic GitHub scope id (`__github:{login}`). */
+                /** @description GitHub login slug, org-chart person id, or synthetic `__github:{login}` scope id. */
                 contributorId: string;
             };
             cookie?: never;
@@ -7131,6 +7361,50 @@ export interface operations {
             };
         };
     };
+    getReadinessRepoBySlug: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+                /** @description Provider repository slug in `owner/repo` form (GitHub). Used for shareable public URLs; resolves to the same row as `repoId` UUID internally. */
+                providerSlug: components["parameters"]["ProviderSlug"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Repo score */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RepoReadinessScoreDetailDto"];
+                };
+            };
+            /** @description Malformed providerSlug */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace or repository not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     getReadinessRepo: {
         parameters: {
             query?: never;
@@ -7342,6 +7616,10 @@ export interface operations {
                 offset?: components["parameters"]["PaginationOffset"];
                 /** @description Sort direction. */
                 order?: components["parameters"]["PaginationOrder"];
+                /** @description Server-side sort column (the activity "5 W's"). Combined with `order` (asc/desc). Defaults to `when` (occurredAt). `occurredAt`/`id` is always the tiebreaker. */
+                sort?: "when" | "who" | "what" | "why" | "where";
+                /** @description Coarse product-area grouping filter (#156). `integration` = GitHub + AI-tool key events; `agentic_foundation` = repos, readiness scans, fixes; `workspace_team` = members + HRIS; `productivity` = productivity ingest lifecycle events. Omit (or pass `all`) for every area. */
+                productArea?: "integration" | "agentic_foundation" | "workspace_team" | "productivity" | "all";
                 /** @description Filter to a specific event type. */
                 eventType?: components["schemas"]["ActivityLogEventTypeDto"];
                 /** @description Filter to events performed by a specific user (UUID). */
@@ -7352,6 +7630,8 @@ export interface operations {
                 until?: string;
                 /** @description Filter by event namespace prefix (e.g. "fix", "repo", "integration", "readiness", "config", "member"). */
                 eventCategory?: string;
+                /** @description Filter by a dotted event-type *subgroup* (#156): a strict prefix of an event type with one or more segments (shorter than the full event type), matching every lifecycle event under it in a single call. Single-segment values (e.g. `fix`, `readiness`, `repo`, `productivity`) overlap with `eventCategory` so the same control can filter at any depth. Example: `integrations.cursor.execution_key` returns `integrations.cursor.execution_key.added`, `.updated`, `.removed`, and `.check_failed`; `integrations.cursor` returns all Cursor key events; `fix` returns all fix lifecycle events. Must be one of the known subcategories or the request is rejected (400). */
+                eventSubcategory?: string;
                 /** @description Case-insensitive substring filter applied across repo name, integration type, actor email, and actor display name. */
                 search?: string;
             };
@@ -7394,6 +7674,61 @@ export interface operations {
             };
         };
     };
+    exportWorkspaceActivity: {
+        parameters: {
+            query?: {
+                sort?: "when" | "who" | "what" | "why" | "where";
+                /** @description Sort direction. */
+                order?: components["parameters"]["PaginationOrder"];
+                productArea?: "integration" | "agentic_foundation" | "workspace_team" | "productivity" | "all";
+                eventType?: components["schemas"]["ActivityLogEventTypeDto"];
+                eventCategory?: string;
+                /** @description Dotted event-type subgroup prefix (see the activity list endpoint). */
+                eventSubcategory?: string;
+                actorUserId?: string;
+                since?: string;
+                until?: string;
+                search?: string;
+            };
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description CSV file of activity log entries */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "text/csv": string;
+                };
+            };
+            /** @description Invalid query parameters */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            /** @description Workspace does not exist */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
     getReadinessScoreHistory: {
         parameters: {
             query?: {
@@ -8285,6 +8620,124 @@ export interface operations {
             403: components["responses"]["Forbidden"];
         };
     };
+    getWorkspaceRepoEligibility: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Effective repo-eligibility configuration */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WorkspaceRepoEligibilityDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+        };
+    };
+    putWorkspaceRepoEligibility: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    overrides: components["schemas"]["RepoEligibilityOverridesDto"];
+                };
+            };
+        };
+        responses: {
+            /** @description Overrides saved */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        overrides: components["schemas"]["RepoEligibilityOverridesDto"];
+                        effective: components["schemas"]["RepoEligibilityConfigDto"];
+                    };
+                };
+            };
+            /** @description Invalid request body */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            /** @description Forbidden, or a workspace-admin value exceeds a platform limit (`repo_eligibility_bound_exceeded`) */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+        };
+    };
+    refreshWorkspaceRepoLanguages: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: components["parameters"]["WorkspaceId"];
+            };
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                "application/json": {
+                    /** @description Optional `owner/name` to scope the refresh to a single repo. Omit to reset all repos. */
+                    repoSlug?: string;
+                };
+            };
+        };
+        responses: {
+            /** @description Freshness invalidated; languages will be re-detected on the next sync. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        ok: boolean;
+                        /** @description Number of repo rows whose language/stack cache was invalidated. */
+                        reposReset: number;
+                    };
+                };
+            };
+            /** @description Invalid request body */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorMessageDto"];
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+        };
+    };
     getCursorKeyUsage: {
         parameters: {
             query?: never;
@@ -8542,7 +8995,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Progress (empty completedSteps when no row exists yet; updatedAt is synthetic in that case) */
+            /** @description Progress (empty completedStepIds when no row exists yet; updatedAt is synthetic in that case) */
             200: {
                 headers: {
                     [name: string]: unknown;