create-interview-cockpit 0.27.0 → 0.28.0

package/template/client/src/types.ts

@@ -81,6 +81,225 @@ export interface GithubActionsLabWorkspace {
   includeRunHistoryInContext?: boolean;
   /** Local act inputs mirroring GitHub repository variables, secrets, and runner env. */
   environment?: GithubActionsLabEnvironment;
+  /**
+   * Fake "org" roster used to resolve CODEOWNERS handles (e.g. @octocat or
+   * @my-org/frontend) into concrete people during the Pull Request sim.
+   * Mirrors how a real GitHub org's people/teams page would back the
+   * automatic reviewer-request flow.
+   */
+  ghOrg?: GithubLabOrg;
+  /**
+   * Repo-level branch protection rule for the simulated default branch.
+   * Mirrors GitHub's "Require a pull request before merging" settings page.
+   *
+   * @deprecated Superseded by `rulesets`. Kept on the type for backwards
+   * compatibility with saved labs from before rulesets were introduced;
+   * the loader migrates this into a synthetic ruleset on read.
+   */
+  branchProtection?: GithubLabBranchProtection;
+  /**
+   * Repository rulesets — the modern (2023+) replacement for classic
+   * branch protection. Each ruleset targets one or more branches and
+   * applies a set of rules (require_pull_request, required_status_checks,
+   * etc.). Rulesets are evaluated in addition to one another, so when
+   * multiple match a branch their constraints union.
+   */
+  rulesets?: GithubLabRuleset[];
+  /**
+   * Persisted draft pull-request state so users can iterate on the simulation
+   * across sessions (which files were "changed", who approved, etc.).
+   */
+  pullRequest?: GithubLabPullRequest;
+  /**
+   * List of branch names that exist in the simulated repo. Used by the
+   * Settings → Branches page so users can model multi-branch workflows
+   * (e.g. a `main` + `develop` setup and target rulesets at each).
+   * Defaults to `["main"]` if omitted.
+   */
+  branches?: string[];
+  /**
+   * Name of the default branch (the merge target shown on the PR page).
+   * Defaults to `"main"`. Mirrors the Settings → Branches → "Default branch"
+   * dropdown on github.com.
+   */
+  defaultBranch?: string;
+}
+
+// ─── GitHub Lab: people, teams, CODEOWNERS, PR simulation ───────────────
+
+export interface GithubLabTeam {
+  /** Team slug without the `org/` prefix (e.g. `frontend`, `platform-sre`). */
+  slug: string;
+  /** Optional display name shown in the reviewer chips. */
+  name?: string;
+  /** GitHub logins (without @) that are members of this team. */
+  members: string[];
+}
+
+export interface GithubLabOrg {
+  /** Org slug used when matching `@org/team` handles in CODEOWNERS. */
+  slug: string;
+  /** All known individual logins (without @) in the lab. */
+  users: string[];
+  /** Known teams under the org. */
+  teams: GithubLabTeam[];
+  /** The login the lab user is acting as when opening the PR. */
+  viewerLogin: string;
+}
+
+export interface GithubLabBranchProtection {
+  /** Mirrors GitHub's "Require review from Code Owners" checkbox. */
+  requireCodeOwnerReview: boolean;
+  /** Total number of approving reviews required before merge is allowed. */
+  requiredApprovingReviews: number;
+  /**
+   * Status check (workflow job) names that must succeed on the latest act
+   * run before merging. An empty array disables the rule. Matches GitHub's
+   * "Require status checks to pass before merging" branch-protection box.
+   */
+  requiredStatusChecks?: string[];
+}
+
+// ─── Rulesets (modern branch protection model) ────────────────────
+//
+// Mirrors github.com Settings → Rules → Rulesets. Each ruleset has an
+// enforcement state (active, evaluate-only, or disabled), one or more
+// target branch patterns, an optional bypass list, and a flag bag of
+// rules. We model only the rules a lab can actually exhibit; some
+// (signed commits, code scanning) are surfaced as informational so the
+// UI faithfully reflects github.com without misleading the user about
+// what the simulator enforces.
+
+export type GithubLabRulesetEnforcement = "active" | "evaluate" | "disabled";
+
+export interface GithubLabRulesetPullRequestRule {
+  /** Number of approving reviews needed before the PR can merge. */
+  requiredApprovingReviewCount: number;
+  /** Mirrors "Require review from Code Owners". */
+  requireCodeOwnerReview: boolean;
+  /** Dismiss stale approving reviews when new commits land (informational). */
+  dismissStaleReviewsOnPush: boolean;
+  /** Require approval of the most recent reviewable push (informational). */
+  requireLastPushApproval: boolean;
+}
+
+export interface GithubLabRulesetStatusChecksRule {
+  /** Names of workflow jobs that must succeed before merging. */
+  checks: string[];
+  /** Whether branches must be up-to-date before merging (informational). */
+  strict: boolean;
+}
+
+/**
+ * Bag of rule toggles. Each field is independent; absent fields mean
+ * "rule not configured". When a ruleset is active and targets a branch,
+ * `evaluateMergeability` consults these to build the list of merge
+ * blockers.
+ */
+export interface GithubLabRulesetRules {
+  /** Block creating refs that match the target. (Informational.) */
+  restrictCreations?: boolean;
+  /** Block direct pushes — force changes through pull requests. */
+  restrictUpdates?: boolean;
+  /** Block ref deletions. (Informational.) */
+  restrictDeletions?: boolean;
+  /** Disallow merge commits on the target branch. (Informational.) */
+  requireLinearHistory?: boolean;
+  /** Require successful deploys to listed environments before merging. */
+  requireDeployments?: { environments: string[] };
+  /** Require GPG/SSH-signed commits. (Informational.) */
+  requireSignedCommits?: boolean;
+  /** Require a pull request before merging into the target. */
+  pullRequest?: GithubLabRulesetPullRequestRule;
+  /** Require listed status checks to pass before merging. */
+  statusChecks?: GithubLabRulesetStatusChecksRule;
+  /** Block force pushes. (Informational.) */
+  blockForcePushes?: boolean;
+  /** Require code-scanning results before merging. (Informational.) */
+  requireCodeScanning?: { tools: string[] };
+  /** Require code-quality gates to pass. (Informational.) */
+  requireCodeQuality?: boolean;
+}
+
+export interface GithubLabRuleset {
+  /** Stable id used as the React key and for routing inside Settings. */
+  id: string;
+  /** Human name shown on the rulesets list ("Main branch protection"). */
+  name: string;
+  /**
+   * - `active`   — enforced; merges and pushes that violate are blocked.
+   * - `evaluate` — logged but not enforced; surfaces in the UI as a
+   *               warning so users can preview the impact.
+   * - `disabled` — ignored entirely.
+   */
+  enforcement: GithubLabRulesetEnforcement;
+  /**
+   * Branch patterns this ruleset targets. Supports literal names
+   * (`main`), the special token `~DEFAULT_BRANCH`, the wildcard
+   * `~ALL`, or globs (`release/**`).
+   */
+  targetInclude: string[];
+  /** Patterns to subtract from the include set (e.g. `experiments/**`). */
+  targetExclude: string[];
+  /**
+   * Logins (`octocat`) or team handles (`acme/admins`) allowed to
+   * bypass the ruleset. When the viewer is in this list, the ruleset
+   * doesn't block their merges.
+   */
+  bypass: string[];
+  /** The actual rule flags. */
+  rules: GithubLabRulesetRules;
+}
+
+/**
+ * One row in the PR's Review tab — mirrors what GitHub stores when a
+ * reviewer clicks Approve / Request changes / Comment with a body.
+ */
+export interface GithubLabReview {
+  id: string;
+  /** Login (without @) of the person leaving the review. */
+  author: string;
+  state: "approved" | "changes_requested" | "commented";
+  /** Optional free-text review body. */
+  body?: string;
+  /** ISO timestamp; used to determine the latest review per author. */
+  createdAt: string;
+}
+
+/**
+ * Snapshot of one workflow job from the most recent act run, distilled
+ * down to what the "Checks" section on the PR cares about (name + status).
+ */
+export interface GithubLabCheckRunJob {
+  name: string;
+  /** Mirrors act's terminal statuses; "queued" / "running" come from a live run. */
+  status: "queued" | "running" | "success" | "failed" | "cancelled" | "skipped";
+  durationMs?: number;
+}
+
+export interface GithubLabCheckRun {
+  /** Workflow file the run came from. */
+  workflow?: string;
+  /** ISO timestamp captured when the run finished. */
+  completedAt: string;
+  /** Per-job results recorded from the act stream. */
+  jobs: GithubLabCheckRunJob[];
+}
+
+export interface GithubLabPullRequest {
+  /** Repo paths (matching keys in workspace.files) the PR is "changing". */
+  changedFiles: string[];
+  /**
+   * @deprecated — kept only for back-compat with older saved labs.
+   * Approvals are now derived from `reviews` (latest review per author).
+   */
+  approvals?: string[];
+  /** Ordered review log (latest review per author wins for state). */
+  reviews?: GithubLabReview[];
+  /** Most recent CI snapshot used to compute required-check status. */
+  lastCheckRun?: GithubLabCheckRun;
+  /** Optional PR title for display purposes. */
+  title?: string;
 }
 
 export interface WorkspaceMeta {

package/template/client/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["./src/app.tsx","./src/api.ts","./src/browsersecuritytemplates.ts","./src/enterpriselocallab.ts","./src/ghaconcurrency.ts","./src/githubactionslab.ts","./src/infralab.ts","./src/main.tsx","./src/reactlab.ts","./src/store.ts","./src/types.ts","./src/vite-env.d.ts","./src/components/aisettingsmodal.tsx","./src/components/annotationdialog.tsx","./src/components/browsersecuritylabmodal.tsx","./src/components/canvaslabmodal.tsx","./src/components/chatmessage.tsx","./src/components/chatview.tsx","./src/components/codecontextpanel.tsx","./src/components/codelineannotationpopup.tsx","./src/components/coderunnermodal.tsx","./src/components/deploymentlabmodal.tsx","./src/components/docrefmodal.tsx","./src/components/fileattachments.tsx","./src/components/filepickermodal.tsx","./src/components/fileviewermodal.tsx","./src/components/ghaconcurrencypanel.tsx","./src/components/ghahistorypanel.tsx","./src/components/ghajobspanel.tsx","./src/components/gitdiffpanel.tsx","./src/components/gitdiffviewermodal.tsx","./src/components/githubactionslabmodal.tsx","./src/components/infralabmodal.tsx","./src/components/labspanel.tsx","./src/components/linkedconvospicker.tsx","./src/components/markdownrenderer.tsx","./src/components/mermaiddiagram.tsx","./src/components/notesmodal.tsx","./src/components/plotembed.tsx","./src/components/sidebar.tsx","./src/components/textannotator.tsx","./src/components/vizcraftembed.tsx","./src/components/workspaceswitcher.tsx"],"version":"5.9.3"}
+{"root":["./src/app.tsx","./src/api.ts","./src/browsersecuritytemplates.ts","./src/enterpriselocallab.ts","./src/ghaconcurrency.ts","./src/githubactionslab.ts","./src/infralab.ts","./src/main.tsx","./src/reactlab.ts","./src/store.ts","./src/types.ts","./src/vite-env.d.ts","./src/components/aisettingsmodal.tsx","./src/components/annotationdialog.tsx","./src/components/browsersecuritylabmodal.tsx","./src/components/canvaslabmodal.tsx","./src/components/chatmessage.tsx","./src/components/chatview.tsx","./src/components/codecontextpanel.tsx","./src/components/codelineannotationpopup.tsx","./src/components/coderunnermodal.tsx","./src/components/deploymentlabmodal.tsx","./src/components/diagramsmodal.tsx","./src/components/docrefmodal.tsx","./src/components/fileattachments.tsx","./src/components/filepickermodal.tsx","./src/components/fileviewermodal.tsx","./src/components/ghaconcurrencypanel.tsx","./src/components/ghahistorypanel.tsx","./src/components/ghajobspanel.tsx","./src/components/gitdiffpanel.tsx","./src/components/gitdiffviewermodal.tsx","./src/components/githubactionslabmodal.tsx","./src/components/infralabmodal.tsx","./src/components/labspanel.tsx","./src/components/linkedconvospicker.tsx","./src/components/markdownrenderer.tsx","./src/components/mermaiddiagram.tsx","./src/components/notesmodal.tsx","./src/components/plotembed.tsx","./src/components/sidebar.tsx","./src/components/textannotator.tsx","./src/components/vizcraftembed.tsx","./src/components/workspaceswitcher.tsx"],"version":"5.9.3"}

package/template/cockpit.json

@@ -1,3 +1,3 @@
 {
-  "version": "0.26.0"
+  "version": "0.27.0"
 }

package/template/server/src/gha-runner.ts

@@ -273,7 +273,7 @@ function parseWorkspace(input: unknown): GithubActionsLabWorkspace {
     label:
       typeof candidate.label === "string" && candidate.label.trim()
         ? candidate.label.trim()
-        : "GitHub Actions Lab",
+        : "GitHub Lab",
     activeFile:
       typeof candidate.activeFile === "string" &&
       Object.prototype.hasOwnProperty.call(files, candidate.activeFile)