p-dev-harness 0.3.0 → 0.3.1

package/workspace-snapshot/files/apps/gui/components/ui/separator.tsx

@@ -0,0 +1,23 @@
+import * as React from "react";
+
+import { cn } from "@/lib/utils";
+
+const Separator = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement> & {
+    orientation?: "horizontal" | "vertical";
+  }
+>(({ className, orientation = "horizontal", ...props }, ref) => (
+  <div
+    ref={ref}
+    className={cn(
+      "shrink-0 bg-border",
+      orientation === "horizontal" ? "h-px w-full" : "h-full w-px",
+      className,
+    )}
+    {...props}
+  />
+));
+Separator.displayName = "Separator";
+
+export { Separator };

package/workspace-snapshot/files/apps/gui/components/ui/skeleton.tsx

@@ -0,0 +1,13 @@
+import { cn } from "@/lib/utils";
+
+export function Skeleton({
+  className,
+  ...props
+}: React.HTMLAttributes<HTMLDivElement>) {
+  return (
+    <div
+      className={cn("animate-pulse rounded-md bg-muted", className)}
+      {...props}
+    />
+  );
+}

package/workspace-snapshot/files/apps/gui/components/ui/textarea.tsx

@@ -0,0 +1,22 @@
+import * as React from "react";
+
+import { cn } from "@/lib/utils";
+
+const Textarea = React.forwardRef<
+  HTMLTextAreaElement,
+  React.ComponentProps<"textarea">
+>(({ className, ...props }, ref) => {
+  return (
+    <textarea
+      className={cn(
+        "flex min-h-[80px] w-full rounded-md border border-input bg-transparent px-3 py-2 text-sm shadow-sm placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:cursor-not-allowed disabled:opacity-50",
+        className,
+      )}
+      ref={ref}
+      {...props}
+    />
+  );
+});
+Textarea.displayName = "Textarea";
+
+export { Textarea };

package/workspace-snapshot/files/apps/gui/components.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "new-york",
+  "rsc": true,
+  "tsx": true,
+  "tailwind": {
+    "config": "",
+    "css": "styles/globals.css",
+    "baseColor": "neutral",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "iconLibrary": "lucide",
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils",
+    "ui": "@/components/ui",
+    "lib": "@/lib",
+    "hooks": "@/hooks"
+  }
+}

package/workspace-snapshot/files/apps/gui/lib/constants/breakpoints.ts

@@ -0,0 +1,13 @@
+export const BREAKPOINTS = {
+  tablet: "md",
+  desktop: "lg",
+} as const;
+
+export const RESPONSIVE = {
+  pageTitle: "text-2xl font-semibold tracking-tight md:text-3xl",
+  pageDescription: "text-sm text-muted-foreground md:text-base",
+  sectionTitle: "text-lg font-semibold tracking-tight md:text-xl",
+  sectionDescription: "text-sm text-muted-foreground",
+  twoColumnGrid: "grid grid-cols-1 gap-4 md:grid-cols-2",
+  previewPanel: "overflow-x-auto rounded-md border border-border bg-muted/40 p-4 text-xs md:text-sm",
+} as const;

package/workspace-snapshot/files/apps/gui/lib/constants/form.ts

@@ -0,0 +1,8 @@
+export const FORM = {
+  fieldStack: "space-y-2",
+  fieldGrid: "grid grid-cols-1 gap-4 md:grid-cols-2",
+  actions: "flex flex-wrap items-center gap-3",
+  confirmationBox:
+    "rounded-md border border-border bg-muted/20 p-4 space-y-3",
+  secretHint: "text-xs text-muted-foreground",
+} as const;

package/workspace-snapshot/files/apps/gui/lib/constants/index.ts

@@ -0,0 +1,4 @@
+export { LAYOUT } from "./layout";
+export { SPACING } from "./spacing";
+export { BREAKPOINTS, RESPONSIVE } from "./breakpoints";
+export { FORM } from "./form";

package/workspace-snapshot/files/apps/gui/lib/constants/layout.ts

@@ -0,0 +1,9 @@
+export const LAYOUT = {
+  page: "mx-auto w-full max-w-5xl",
+  shell: "min-h-screen bg-background",
+  header: "border-b border-border bg-card",
+  headerInner: "mx-auto flex w-full max-w-5xl items-center justify-between px-4 py-4 md:px-6",
+  main: "mx-auto w-full max-w-5xl px-4 py-8 md:px-6 md:py-10",
+  sectionStack: "flex flex-col gap-6",
+  cardGrid: "grid grid-cols-1 gap-4 md:grid-cols-2",
+} as const;

package/workspace-snapshot/files/apps/gui/lib/constants/spacing.ts

@@ -0,0 +1,8 @@
+export const SPACING = {
+  section: "space-y-6",
+  card: "p-6",
+  cardHeader: "space-y-1.5 pb-4",
+  list: "space-y-3",
+  inline: "flex flex-wrap items-center gap-2",
+  stackSm: "space-y-2",
+} as const;

package/workspace-snapshot/files/apps/gui/lib/guided-setup.ts

@@ -0,0 +1,216 @@
+import type { FirstRunStepId } from "@harness/setup/first-run-readiness";
+import type { SetupGuiViewModel } from "@/lib/setup-server";
+
+/** Number of guided setup steps before the "Ready for first run" completion state. */
+export const GUIDED_SETUP_STEP_COUNT = 7;
+
+const FIRST_RUN_STEP_ORDER: readonly FirstRunStepId[] = [
+  "connect-services",
+  "linear-workspace",
+  "vercel-bridge",
+  "local-setup",
+  "local-readiness",
+  "cloud-secrets",
+  "target-workflow",
+  "ready-for-first-run",
+] as const;
+
+/** Sub-steps within guided local setup workflow. */
+export type GuidedLocalSetupStep = "connect-services" | "choose-target-repos";
+
+/** Every screen the guided configure flow can display, including completion. */
+export type GuidedDisplayStepId =
+  | "connect-services"
+  | "linear-workspace"
+  | "vercel-bridge"
+  | GuidedLocalSetupStep
+  | "local-readiness"
+  | "cloud-secrets"
+  | "target-workflow"
+  | "ready-for-first-run";
+
+export const GUIDED_DISPLAY_STEP_ORDER: readonly GuidedDisplayStepId[] = [
+  "connect-services",
+  "linear-workspace",
+  "vercel-bridge",
+  "choose-target-repos",
+  "local-readiness",
+  "cloud-secrets",
+  "target-workflow",
+  "ready-for-first-run",
+] as const;
+
+export function guidedDisplayStepIndex(step: GuidedDisplayStepId): number {
+  return GUIDED_DISPLAY_STEP_ORDER.indexOf(step);
+}
+
+export function getPreviousGuidedDisplayStep(
+  step: GuidedDisplayStepId,
+): GuidedDisplayStepId | null {
+  const index = guidedDisplayStepIndex(step);
+  if (index <= 0) {
+    return null;
+  }
+  return GUIDED_DISPLAY_STEP_ORDER[index - 1] ?? null;
+}
+
+export function maxGuidedDisplayStepForReadiness(
+  currentStepId: FirstRunStepId,
+): GuidedDisplayStepId {
+  switch (currentStepId) {
+    case "connect-services":
+      return "connect-services";
+    case "linear-workspace":
+      return "linear-workspace";
+    case "vercel-bridge":
+      return "vercel-bridge";
+    case "local-setup":
+      return "choose-target-repos";
+    case "local-readiness":
+      return "local-readiness";
+    case "cloud-secrets":
+      return "cloud-secrets";
+    case "target-workflow":
+      return "target-workflow";
+    case "ready-for-first-run":
+      return "ready-for-first-run";
+  }
+}
+
+function localServiceKeysConfigured(summary: SetupGuiViewModel): boolean {
+  return (
+    summary.envKeyPresence.LINEAR_API_KEY &&
+    summary.envKeyPresence.CURSOR_API_KEY &&
+    summary.envKeyPresence.GITHUB_TOKEN &&
+    summary.envKeyPresence.VERCEL_TOKEN
+  );
+}
+
+function localEnvFileExists(summary: SetupGuiViewModel): boolean {
+  return summary.localFiles.find((file) => file.label === ".env.local")?.exists ?? false;
+}
+
+export function localSetupFilesExist(summary: SetupGuiViewModel): boolean {
+  return summary.overview.localFilesPresent;
+}
+
+/** Guided display step after Step 4 local file apply succeeds (first apply or update). */
+export const GUIDED_DISPLAY_STEP_AFTER_LOCAL_APPLY: GuidedDisplayStepId =
+  "local-readiness";
+
+/** Guided display step when all target workflows are installed on production. */
+export const GUIDED_DISPLAY_STEP_AFTER_WORKFLOW_READY: GuidedDisplayStepId =
+  "ready-for-first-run";
+
+/** Guided display step after service keys are saved in Step 1. */
+export const GUIDED_DISPLAY_STEP_AFTER_CONNECT_SERVICES: GuidedDisplayStepId =
+  "linear-workspace";
+
+/** Guided display step after local readiness is reviewed in Step 5. */
+export const GUIDED_DISPLAY_STEP_AFTER_LOCAL_READINESS: GuidedDisplayStepId =
+  "cloud-secrets";
+
+/** Guided display step after cloud secrets are verified and reviewed in Step 6. */
+export const GUIDED_DISPLAY_STEP_AFTER_CLOUD_SECRETS: GuidedDisplayStepId =
+  "target-workflow";
+
+/**
+ * Default guided screen after mount or when readiness advances forward.
+ * Does not resurrect a manually visited earlier sub-step from browser/session storage.
+ */
+export function defaultGuidedDisplayStep(input: {
+  currentStepId: FirstRunStepId;
+  summary: SetupGuiViewModel;
+}): GuidedDisplayStepId {
+  switch (input.currentStepId) {
+    case "connect-services":
+      return "connect-services";
+    case "linear-workspace":
+      return "linear-workspace";
+    case "vercel-bridge":
+      return "vercel-bridge";
+    case "local-setup":
+      return localEnvFileExists(input.summary) && localSetupFilesExist(input.summary)
+        ? "choose-target-repos"
+        : "choose-target-repos";
+    case "local-readiness":
+      return "local-readiness";
+    case "cloud-secrets":
+      return "cloud-secrets";
+    case "target-workflow":
+      return "target-workflow";
+    case "ready-for-first-run":
+      return "ready-for-first-run";
+  }
+}
+
+export function isGuidedLocalSetupStep(
+  step: GuidedDisplayStepId,
+): step is GuidedLocalSetupStep {
+  return step === "connect-services" || step === "choose-target-repos";
+}
+
+export function shouldShowGuidedBackButton(step: GuidedDisplayStepId): boolean {
+  return getPreviousGuidedDisplayStep(step) !== null;
+}
+
+export function compareGuidedDisplaySteps(
+  left: GuidedDisplayStepId,
+  right: GuidedDisplayStepId,
+): number {
+  return guidedDisplayStepIndex(left) - guidedDisplayStepIndex(right);
+}
+
+export function compareFirstRunStepIds(
+  left: FirstRunStepId,
+  right: FirstRunStepId,
+): number {
+  return FIRST_RUN_STEP_ORDER.indexOf(left) - FIRST_RUN_STEP_ORDER.indexOf(right);
+}
+
+export function readinessStepAdvanced(
+  next: FirstRunStepId,
+  previous: FirstRunStepId,
+): boolean {
+  return compareFirstRunStepIds(next, previous) > 0;
+}
+
+/**
+ * Whether readiness moving forward should update the guided display step.
+ * Step 1 must not auto-advance to Linear workspace when keys become complete;
+ * the user clicks Continue instead.
+ */
+export function shouldReadinessAdvanceGuidedDisplay(
+  previous: FirstRunStepId,
+  next: FirstRunStepId,
+): boolean {
+  if (
+    previous === "connect-services" &&
+    next === "linear-workspace"
+  ) {
+    return false;
+  }
+  return readinessStepAdvanced(next, previous);
+}
+
+export function isGuidedDisplayStepAllowed(
+  target: GuidedDisplayStepId,
+  currentStepId: FirstRunStepId,
+): boolean {
+  const maxAllowed = maxGuidedDisplayStepForReadiness(currentStepId);
+  return compareGuidedDisplaySteps(target, maxAllowed) <= 0;
+}
+
+export function clampGuidedDisplayStep(input: {
+  target: GuidedDisplayStepId;
+  currentStepId: FirstRunStepId;
+}): GuidedDisplayStepId {
+  const maxAllowed = maxGuidedDisplayStepForReadiness(input.currentStepId);
+  return compareGuidedDisplaySteps(input.target, maxAllowed) > 0
+    ? maxAllowed
+    : input.target;
+}
+
+export function connectServicesComplete(summary: SetupGuiViewModel): boolean {
+  return localServiceKeysConfigured(summary);
+}

package/workspace-snapshot/files/apps/gui/lib/setup-json-response.ts

@@ -0,0 +1,19 @@
+export async function readSetupJsonResponse<T>(
+  response: Response,
+  route: string,
+): Promise<T> {
+  const bodyText = await response.text();
+  if (!bodyText.trim()) {
+    throw new Error(
+      `Setup request failed: ${route} returned HTTP ${response.status} with an empty response body`,
+    );
+  }
+
+  try {
+    return JSON.parse(bodyText) as T;
+  } catch {
+    throw new Error(
+      `Setup request failed: ${route} returned HTTP ${response.status} with an invalid JSON body`,
+    );
+  }
+}