@cat-factory/app 0.6.0 → 0.7.3

package/app/types/documents.ts

@@ -1,104 +1,104 @@
-// ---------------------------------------------------------------------------
-// Document-source integration. Requirements / RFCs / PRDs imported from external
-// sources (Confluence, Notion, …) can be expanded into board structure or
-// attached to a task as agent context. These mirror the `@cat-factory/contracts`
-// document schemas; the abstraction is source-agnostic, keyed by `source`.
-// ---------------------------------------------------------------------------
-
-import type { BlockType } from './domain'
-
-/** The external document sources cat-factory can link to. */
-export type DocumentSourceKind = 'confluence' | 'notion' | 'github'
-
-/** One credential a provider needs to connect (rendered as a form field). */
-export interface CredentialField {
-  key: string
-  label: string
-  help?: string
-  placeholder?: string
-  secret?: boolean
-}
-
-/** A source's self-description: drives the generic connect + import UI. */
-export interface DocumentSourceDescriptor {
-  source: DocumentSourceKind
-  label: string
-  /** Lucide icon name for the source. */
-  icon: string
-  credentialFields: CredentialField[]
-  refLabel: string
-  refPlaceholder: string
-  /** Whether the source supports searching its catalogue by title/content. */
-  searchable?: boolean
-}
-
-/** A workspace's connection to a document source (never carries credentials). */
-export interface DocumentConnection {
-  source: DocumentSourceKind
-  /** Human-friendly label for what we're connected to (site URL, workspace name). */
-  label: string
-  /** When the connection was established (epoch ms). */
-  connectedAt: number
-}
-
-/** A page imported from a source into the workspace. */
-export interface SourceDocument {
-  source: DocumentSourceKind
-  /** The source's stable id for the page. */
-  externalId: string
-  title: string
-  url: string
-  /** Short plain-text preview of the page body. */
-  excerpt: string
-  /** The board block this document is attached to as context, if any. */
-  linkedBlockId: string | null
-  syncedAt: number
-}
-
-/** A lean hit from searching a document source's catalogue (not yet imported). */
-export interface DocumentSearchResult {
-  source: DocumentSourceKind
-  /** The source's stable id for the page (re-usable as an import ref). */
-  externalId: string
-  title: string
-  url: string
-  /** Short plain-text preview (may be empty). */
-  excerpt: string
-}
-
-/** A proposed task within a planned frame/module. */
-export interface PlanTask {
-  title: string
-  description?: string
-}
-
-/** A proposed module grouping tasks within a planned frame. */
-export interface PlanModule {
-  name: string
-  tasks: PlanTask[]
-}
-
-/** A proposed top-level frame with its modules and loose tasks. */
-export interface PlanFrame {
-  type: BlockType
-  title: string
-  description?: string
-  modules: PlanModule[]
-  tasks: PlanTask[]
-}
-
-/** A board structure extracted from an imported document. */
-export interface DocumentBoardPlan {
-  source: DocumentSourceKind
-  externalId: string
-  /** Whether an LLM produced the plan or the deterministic heading parser did. */
-  planner: 'llm' | 'headings'
-  frames: PlanFrame[]
-}
-
-/** Counts of blocks created by spawning a plan onto the board. */
-export interface SpawnResult {
-  frames: number
-  modules: number
-  tasks: number
-}
+// ---------------------------------------------------------------------------
+// Document-source integration. Requirements / RFCs / PRDs imported from external
+// sources (Confluence, Notion, …) can be expanded into board structure or
+// attached to a task as agent context. These mirror the `@cat-factory/contracts`
+// document schemas; the abstraction is source-agnostic, keyed by `source`.
+// ---------------------------------------------------------------------------
+
+import type { BlockType } from './domain'
+
+/** The external document sources cat-factory can link to. */
+export type DocumentSourceKind = 'confluence' | 'notion' | 'github'
+
+/** One credential a provider needs to connect (rendered as a form field). */
+export interface CredentialField {
+  key: string
+  label: string
+  help?: string
+  placeholder?: string
+  secret?: boolean
+}
+
+/** A source's self-description: drives the generic connect + import UI. */
+export interface DocumentSourceDescriptor {
+  source: DocumentSourceKind
+  label: string
+  /** Lucide icon name for the source. */
+  icon: string
+  credentialFields: CredentialField[]
+  refLabel: string
+  refPlaceholder: string
+  /** Whether the source supports searching its catalogue by title/content. */
+  searchable?: boolean
+}
+
+/** A workspace's connection to a document source (never carries credentials). */
+export interface DocumentConnection {
+  source: DocumentSourceKind
+  /** Human-friendly label for what we're connected to (site URL, workspace name). */
+  label: string
+  /** When the connection was established (epoch ms). */
+  connectedAt: number
+}
+
+/** A page imported from a source into the workspace. */
+export interface SourceDocument {
+  source: DocumentSourceKind
+  /** The source's stable id for the page. */
+  externalId: string
+  title: string
+  url: string
+  /** Short plain-text preview of the page body. */
+  excerpt: string
+  /** The board block this document is attached to as context, if any. */
+  linkedBlockId: string | null
+  syncedAt: number
+}
+
+/** A lean hit from searching a document source's catalogue (not yet imported). */
+export interface DocumentSearchResult {
+  source: DocumentSourceKind
+  /** The source's stable id for the page (re-usable as an import ref). */
+  externalId: string
+  title: string
+  url: string
+  /** Short plain-text preview (may be empty). */
+  excerpt: string
+}
+
+/** A proposed task within a planned frame/module. */
+export interface PlanTask {
+  title: string
+  description?: string
+}
+
+/** A proposed module grouping tasks within a planned frame. */
+export interface PlanModule {
+  name: string
+  tasks: PlanTask[]
+}
+
+/** A proposed top-level frame with its modules and loose tasks. */
+export interface PlanFrame {
+  type: BlockType
+  title: string
+  description?: string
+  modules: PlanModule[]
+  tasks: PlanTask[]
+}
+
+/** A board structure extracted from an imported document. */
+export interface DocumentBoardPlan {
+  source: DocumentSourceKind
+  externalId: string
+  /** Whether an LLM produced the plan or the deterministic heading parser did. */
+  planner: 'llm' | 'headings'
+  frames: PlanFrame[]
+}
+
+/** Counts of blocks created by spawning a plan onto the board. */
+export interface SpawnResult {
+  frames: number
+  modules: number
+  tasks: number
+}

package/app/types/domain.ts

@@ -23,7 +23,7 @@ import type { ClarityReview } from './clarity'
 import type { MergeThresholdPreset } from './merge'
 import type { PipelineSchedule } from './recurring'
 import type { Service, WorkspaceMount } from './services'
-import type { TrackerSettings } from './tracker'
+import type { TrackerSettings, WritebackOverride } from './tracker'
 
 /** Lifecycle of an architecture building block. */
 export type BlockStatus =
@@ -145,6 +145,10 @@ export interface Block {
    * with the `product` role, notified when requirement review flags this task.
    */
   responsibleProductUserId?: string | null
+  /** task-only: override "comment on the linked issue when a PR opens"; absent/null = inherit workspace. */
+  trackerCommentOnPrOpen?: WritebackOverride | null
+  /** task-only: override "close the linked issue as resolved on merge"; absent/null = inherit workspace. */
+  trackerResolveOnMerge?: WritebackOverride | null
 }
 
 /**

package/app/types/execution.ts

@@ -333,6 +333,22 @@ export interface PipelineStep {
 export interface GateFailingCheck {
   name: string
   conclusion: string | null
+  /** GitHub web URL of the check run, so the UI can link to the failed run's logs */
+  url?: string | null
+}
+
+/** One helper-agent attempt the gate dispatched (mirrors `gateAttemptSchema`). */
+export interface GateAttempt {
+  /** 1-based attempt number */
+  attempt: number
+  /** epoch ms when the helper job finished */
+  at: number
+  /** how the helper job ended */
+  outcome: 'completed' | 'failed'
+  /** the PR head commit the helper worked against, when known */
+  headSha?: string | null
+  /** the helper's own account of what it did / what remains */
+  summary?: string | null
 }
 
 /** Live state of a polling gate step (`ci` / `conflicts`); mirrors `gateStepStateSchema`. */
@@ -350,6 +366,8 @@ export interface GateStepState {
   lastFailureSummary?: string | null
   /** structured failing checks behind the summary (CI gate only; absent for conflicts) */
   failingChecks?: GateFailingCheck[] | null
+  /** history of the helper-agent attempts this gate dispatched, newest last */
+  attemptLog?: GateAttempt[] | null
 }
 
 /** Live state of a `tester` step's Tester→Fixer loop (mirrors `testerStepStateSchema`). */

package/app/types/github.ts

@@ -1,173 +1,173 @@
-// ---------------------------------------------------------------------------
-// GitHub integration. The backend's `GitHubModule` projects GitHub data
-// (repos/branches, pull requests/issues) into D1 and serves it fast and
-// rate-limit-free, alongside connect/resync/write endpoints. These mirror the
-// `@cat-factory/contracts` GitHub schemas so responses drop straight into the
-// Pinia store, just as the document-source types do for Confluence/Notion.
-// ---------------------------------------------------------------------------
-
-/** A workspace's GitHub App installation, as exposed to clients (no token). */
-export interface GitHubConnection {
-  installationId: number
-  accountLogin: string
-  targetType: 'Organization' | 'User'
-  connectedAt: number
-  /**
-   * Whether cat-factory can create repos under this account itself (privileged
-   * App tier). When true, the bootstrap UI drops the manual "create on GitHub"
-   * step. Defaults to false for older backends that don't send it.
-   */
-  canCreateRepos?: boolean
-  /**
-   * Whether the installation granted the App `workflows: write`. When false, agent
-   * pushes that add/update `.github/workflows/*` are rejected by GitHub, so the UI
-   * warns the user to grant the permission. Defaults to false for older backends.
-   */
-  canManageWorkflows?: boolean
-}
-
-/**
- * A discoverable App installation for the connect picker. `connected` says
- * whether it's already bound: to THIS workspace, to ANOTHER (so connecting would
- * be rejected), or to NONE (free to connect).
- */
-export interface GitHubInstallationOption {
-  installationId: number
-  accountLogin: string
-  targetType: 'Organization' | 'User'
-  accountAvatarUrl: string | null
-  connected: 'this' | 'other' | 'none'
-}
-
-/** A repository the integration tracks for a workspace. */
-export interface GitHubRepo {
-  githubId: number
-  installationId: number
-  owner: string
-  name: string
-  defaultBranch: string | null
-  private: boolean
-  /** Optional link to a board block this repo backs. */
-  blockId: string | null
-  /** Whether this repo is a monorepo hosting several services (each pinned to a subdirectory). */
-  isMonorepo?: boolean
-  syncedAt: number
-}
-
-/** One directory entry of a repo's tree, used by the monorepo service picker. */
-export interface RepoTreeEntry {
-  /** Path relative to the repo root, e.g. `packages/api`. */
-  path: string
-  /** Base name, e.g. `api`. */
-  name: string
-  /** `file` | `dir` | `symlink` | `submodule`. */
-  type: string
-}
-
-export interface GitHubBranch {
-  repoGithubId: number
-  name: string
-  headSha: string
-  protected: boolean
-  syncedAt: number
-}
-
-/**
- * A repo the connected installation can access, annotated with whether the
- * current workspace links it. Drives the per-workspace repo picker — repos are
- * linked explicitly per board, since the installation is shared across an
- * account's workspaces.
- */
-export interface GitHubAvailableRepo {
-  githubId: number
-  owner: string
-  name: string
-  defaultBranch: string | null
-  private: boolean
-  linked: boolean
-  /** Whether the (linked) repo is flagged as a monorepo. */
-  isMonorepo?: boolean
-}
-
-export type GitHubPullRequestState = 'open' | 'closed'
-
-export interface GitHubPullRequest {
-  repoGithubId: number
-  number: number
-  githubId: number
-  title: string
-  state: GitHubPullRequestState
-  headRef: string | null
-  baseRef: string | null
-  headSha: string | null
-  merged: boolean
-  author: string | null
-  updatedAt: number | null
-  syncedAt: number
-}
-
-export type GitHubIssueState = 'open' | 'closed'
-
-export interface GitHubIssue {
-  repoGithubId: number
-  number: number
-  githubId: number
-  title: string
-  state: GitHubIssueState
-  author: string | null
-  labels: string[]
-  updatedAt: number | null
-  syncedAt: number
-}
-
-// ---- request inputs -------------------------------------------------------
-
-/** Trigger a resync. Defaults to an incremental resync of all tracked repos. */
-export interface ResyncRequest {
-  /** Limit the resync to a single repo (by its GitHub numeric id). */
-  repoGithubId?: number
-  /** Run a full backfill (durable Workflow) instead of an incremental pass. */
-  full?: boolean
-}
-
-export interface CreateBranchInput {
-  name: string
-  fromSha: string
-}
-
-/** Body for programmatic repo creation (privileged App tier). */
-export interface CreateRepoRequest {
-  /** A single GitHub name segment — no "owner/" prefix. */
-  name: string
-  private?: boolean
-  description?: string
-}
-
-/** The freshly-created repository returned by the create-repo endpoint. */
-export interface CreatedRepo {
-  githubId: number
-  owner: string
-  name: string
-  defaultBranch: string | null
-  private: boolean
-}
-
-export interface CommitFilesInput {
-  branch: string
-  message: string
-  files: { path: string; content: string }[]
-  /** Parent commit to build on; defaults to the branch tip. */
-  baseSha?: string
-}
-
-export interface OpenPullRequestInput {
-  title: string
-  head: string
-  base: string
-  body?: string
-  draft?: boolean
-}
-
-export interface MergePullRequestInput {
-  method?: 'merge' | 'squash' | 'rebase'
-}
+// ---------------------------------------------------------------------------
+// GitHub integration. The backend's `GitHubModule` projects GitHub data
+// (repos/branches, pull requests/issues) into D1 and serves it fast and
+// rate-limit-free, alongside connect/resync/write endpoints. These mirror the
+// `@cat-factory/contracts` GitHub schemas so responses drop straight into the
+// Pinia store, just as the document-source types do for Confluence/Notion.
+// ---------------------------------------------------------------------------
+
+/** A workspace's GitHub App installation, as exposed to clients (no token). */
+export interface GitHubConnection {
+  installationId: number
+  accountLogin: string
+  targetType: 'Organization' | 'User'
+  connectedAt: number
+  /**
+   * Whether cat-factory can create repos under this account itself (privileged
+   * App tier). When true, the bootstrap UI drops the manual "create on GitHub"
+   * step. Defaults to false for older backends that don't send it.
+   */
+  canCreateRepos?: boolean
+  /**
+   * Whether the installation granted the App `workflows: write`. When false, agent
+   * pushes that add/update `.github/workflows/*` are rejected by GitHub, so the UI
+   * warns the user to grant the permission. Defaults to false for older backends.
+   */
+  canManageWorkflows?: boolean
+}
+
+/**
+ * A discoverable App installation for the connect picker. `connected` says
+ * whether it's already bound: to THIS workspace, to ANOTHER (so connecting would
+ * be rejected), or to NONE (free to connect).
+ */
+export interface GitHubInstallationOption {
+  installationId: number
+  accountLogin: string
+  targetType: 'Organization' | 'User'
+  accountAvatarUrl: string | null
+  connected: 'this' | 'other' | 'none'
+}
+
+/** A repository the integration tracks for a workspace. */
+export interface GitHubRepo {
+  githubId: number
+  installationId: number
+  owner: string
+  name: string
+  defaultBranch: string | null
+  private: boolean
+  /** Optional link to a board block this repo backs. */
+  blockId: string | null
+  /** Whether this repo is a monorepo hosting several services (each pinned to a subdirectory). */
+  isMonorepo?: boolean
+  syncedAt: number
+}
+
+/** One directory entry of a repo's tree, used by the monorepo service picker. */
+export interface RepoTreeEntry {
+  /** Path relative to the repo root, e.g. `packages/api`. */
+  path: string
+  /** Base name, e.g. `api`. */
+  name: string
+  /** `file` | `dir` | `symlink` | `submodule`. */
+  type: string
+}
+
+export interface GitHubBranch {
+  repoGithubId: number
+  name: string
+  headSha: string
+  protected: boolean
+  syncedAt: number
+}
+
+/**
+ * A repo the connected installation can access, annotated with whether the
+ * current workspace links it. Drives the per-workspace repo picker — repos are
+ * linked explicitly per board, since the installation is shared across an
+ * account's workspaces.
+ */
+export interface GitHubAvailableRepo {
+  githubId: number
+  owner: string
+  name: string
+  defaultBranch: string | null
+  private: boolean
+  linked: boolean
+  /** Whether the (linked) repo is flagged as a monorepo. */
+  isMonorepo?: boolean
+}
+
+export type GitHubPullRequestState = 'open' | 'closed'
+
+export interface GitHubPullRequest {
+  repoGithubId: number
+  number: number
+  githubId: number
+  title: string
+  state: GitHubPullRequestState
+  headRef: string | null
+  baseRef: string | null
+  headSha: string | null
+  merged: boolean
+  author: string | null
+  updatedAt: number | null
+  syncedAt: number
+}
+
+export type GitHubIssueState = 'open' | 'closed'
+
+export interface GitHubIssue {
+  repoGithubId: number
+  number: number
+  githubId: number
+  title: string
+  state: GitHubIssueState
+  author: string | null
+  labels: string[]
+  updatedAt: number | null
+  syncedAt: number
+}
+
+// ---- request inputs -------------------------------------------------------
+
+/** Trigger a resync. Defaults to an incremental resync of all tracked repos. */
+export interface ResyncRequest {
+  /** Limit the resync to a single repo (by its GitHub numeric id). */
+  repoGithubId?: number
+  /** Run a full backfill (durable Workflow) instead of an incremental pass. */
+  full?: boolean
+}
+
+export interface CreateBranchInput {
+  name: string
+  fromSha: string
+}
+
+/** Body for programmatic repo creation (privileged App tier). */
+export interface CreateRepoRequest {
+  /** A single GitHub name segment — no "owner/" prefix. */
+  name: string
+  private?: boolean
+  description?: string
+}
+
+/** The freshly-created repository returned by the create-repo endpoint. */
+export interface CreatedRepo {
+  githubId: number
+  owner: string
+  name: string
+  defaultBranch: string | null
+  private: boolean
+}
+
+export interface CommitFilesInput {
+  branch: string
+  message: string
+  files: { path: string; content: string }[]
+  /** Parent commit to build on; defaults to the branch tip. */
+  baseSha?: string
+}
+
+export interface OpenPullRequestInput {
+  title: string
+  head: string
+  base: string
+  body?: string
+  draft?: boolean
+}
+
+export interface MergePullRequestInput {
+  method?: 'merge' | 'squash' | 'rebase'
+}

package/app/types/services.ts

@@ -1,27 +1,27 @@
-// In-org shared services. Mirrors the `@cat-factory/contracts` `services` wire schemas:
-// a `Service` is the account-owned unit of work (a service frame + its subtree + repo),
-// shared across the workspaces that *mount* it; a `WorkspaceMount` places a service onto a
-// workspace board with that board's own frame layout override.
-
-export interface Service {
-  id: string
-  accountId: string | null
-  frameBlockId: string
-  installationId: number | null
-  repoGithubId: number | null
-  /** Subdirectory within the linked monorepo this service lives in (null = whole repo). */
-  directory?: string | null
-  createdAt: number
-  /** How many boards mount this service. Set only on the org catalog (for the "Shared" badge). */
-  mountCount?: number
-}
-
-export interface WorkspaceMount {
-  workspaceId: string
-  serviceId: string
-  /** This board's frame position override. */
-  position: { x: number; y: number }
-  /** This board's dragged frame size; null/absent = auto-size. */
-  size?: { w: number; h: number } | null
-  createdAt: number
-}
+// In-org shared services. Mirrors the `@cat-factory/contracts` `services` wire schemas:
+// a `Service` is the account-owned unit of work (a service frame + its subtree + repo),
+// shared across the workspaces that *mount* it; a `WorkspaceMount` places a service onto a
+// workspace board with that board's own frame layout override.
+
+export interface Service {
+  id: string
+  accountId: string | null
+  frameBlockId: string
+  installationId: number | null
+  repoGithubId: number | null
+  /** Subdirectory within the linked monorepo this service lives in (null = whole repo). */
+  directory?: string | null
+  createdAt: number
+  /** How many boards mount this service. Set only on the org catalog (for the "Shared" badge). */
+  mountCount?: number
+}
+
+export interface WorkspaceMount {
+  workspaceId: string
+  serviceId: string
+  /** This board's frame position override. */
+  position: { x: number; y: number }
+  /** This board's dragged frame size; null/absent = auto-size. */
+  size?: { w: number; h: number } | null
+  createdAt: number
+}