@cat-factory/app 0.6.0 → 0.7.2

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
+}

package/app/types/tasks.ts

@@ -1,82 +1,82 @@
-// ---------------------------------------------------------------------------
-// Task-source integration. Individual issues imported from external task
-// trackers (Jira, …) can be attached to a board task as agent context. These
-// mirror the `@cat-factory/contracts` task schemas; the abstraction is
-// source-agnostic, keyed by `source`. Unlike document sources there is no
-// plan/spawn — an issue is linked for context, never expanded into structure.
-// ---------------------------------------------------------------------------
-
-import type { CredentialField } from './documents'
-
-/** The external task trackers cat-factory can link to. */
-export type TaskSourceKind = 'jira' | 'github'
-
-export type { CredentialField }
-
-/** A source's self-description: drives the generic connect + import UI. */
-export interface TaskSourceDescriptor {
-  source: TaskSourceKind
-  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 task source (never carries credentials). */
-export interface TaskConnection {
-  source: TaskSourceKind
-  /** Human-friendly label for what we're connected to (site URL). */
-  label: string
-  /** When the connection was established (epoch ms). */
-  connectedAt: number
-}
-
-/** A single comment on an issue, with its body as lightweight Markdown. */
-export interface TaskComment {
-  author: string
-  createdAt: string
-  body: string
-}
-
-/** An issue imported from a source into the workspace, as a structured record. */
-export interface SourceTask {
-  source: TaskSourceKind
-  /** The source's canonical key for the issue (e.g. `PROJ-123`). */
-  externalId: string
-  title: string
-  url: string
-  /** Workflow status name, e.g. `In Progress`. */
-  status: string
-  /** Issue type name, e.g. `Bug`. */
-  type: string
-  /** Assignee display name, or null when unassigned. */
-  assignee: string | null
-  /** Priority name, or null when none. */
-  priority: string | null
-  labels: string[]
-  /** Issue description as lightweight Markdown. */
-  description: string
-  comments: TaskComment[]
-  /** Short plain-text preview of the issue. */
-  excerpt: string
-  /** The board block this issue is attached to as context, if any. */
-  linkedBlockId: string | null
-  syncedAt: number
-}
-
-/** A lean hit from searching a tracker's issues (not yet imported). */
-export interface TaskSearchResult {
-  source: TaskSourceKind
-  /** The source's canonical key for the issue (re-usable as an import ref). */
-  externalId: string
-  title: string
-  url: string
-  /** Workflow status name, e.g. `In Progress` (may be empty). */
-  status: string
-  /** Short plain-text preview (may be empty). */
-  excerpt: string
-}
+// ---------------------------------------------------------------------------
+// Task-source integration. Individual issues imported from external task
+// trackers (Jira, …) can be attached to a board task as agent context. These
+// mirror the `@cat-factory/contracts` task schemas; the abstraction is
+// source-agnostic, keyed by `source`. Unlike document sources there is no
+// plan/spawn — an issue is linked for context, never expanded into structure.
+// ---------------------------------------------------------------------------
+
+import type { CredentialField } from './documents'
+
+/** The external task trackers cat-factory can link to. */
+export type TaskSourceKind = 'jira' | 'github'
+
+export type { CredentialField }
+
+/** A source's self-description: drives the generic connect + import UI. */
+export interface TaskSourceDescriptor {
+  source: TaskSourceKind
+  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 task source (never carries credentials). */
+export interface TaskConnection {
+  source: TaskSourceKind
+  /** Human-friendly label for what we're connected to (site URL). */
+  label: string
+  /** When the connection was established (epoch ms). */
+  connectedAt: number
+}
+
+/** A single comment on an issue, with its body as lightweight Markdown. */
+export interface TaskComment {
+  author: string
+  createdAt: string
+  body: string
+}
+
+/** An issue imported from a source into the workspace, as a structured record. */
+export interface SourceTask {
+  source: TaskSourceKind
+  /** The source's canonical key for the issue (e.g. `PROJ-123`). */
+  externalId: string
+  title: string
+  url: string
+  /** Workflow status name, e.g. `In Progress`. */
+  status: string
+  /** Issue type name, e.g. `Bug`. */
+  type: string
+  /** Assignee display name, or null when unassigned. */
+  assignee: string | null
+  /** Priority name, or null when none. */
+  priority: string | null
+  labels: string[]
+  /** Issue description as lightweight Markdown. */
+  description: string
+  comments: TaskComment[]
+  /** Short plain-text preview of the issue. */
+  excerpt: string
+  /** The board block this issue is attached to as context, if any. */
+  linkedBlockId: string | null
+  syncedAt: number
+}
+
+/** A lean hit from searching a tracker's issues (not yet imported). */
+export interface TaskSearchResult {
+  source: TaskSourceKind
+  /** The source's canonical key for the issue (re-usable as an import ref). */
+  externalId: string
+  title: string
+  url: string
+  /** Workflow status name, e.g. `In Progress` (may be empty). */
+  status: string
+  /** Short plain-text preview (may be empty). */
+  excerpt: string
+}

package/app/types/tracker.ts

@@ -1,18 +1,27 @@
-// Issue-tracker selection shapes, mirroring `@cat-factory/contracts` (tracker.ts).
-// A workspace designates one tracker — GitHub Issues or Jira — where the tech-debt
-// recurring pipeline files its ticket before implementation starts.
-
-export type TrackerKind = 'github' | 'jira'
-
-export interface TrackerSettings {
-  /** The selected tracker, or null when none is configured. */
-  tracker: TrackerKind | null
-  /** Jira project key new tickets are filed under (e.g. 'ENG'); null unless Jira. */
-  jiraProjectKey: string | null
-  updatedAt: number
-}
-
-export interface PutTrackerSettingsInput {
-  tracker: TrackerKind | null
-  jiraProjectKey?: string | null
-}
+// Issue-tracker selection shapes, mirroring `@cat-factory/contracts` (tracker.ts).
+// A workspace designates one tracker — GitHub Issues or Jira — where the tech-debt
+// recurring pipeline files its ticket before implementation starts.
+
+export type TrackerKind = 'github' | 'jira'
+
+export interface TrackerSettings {
+  /** The selected tracker, or null when none is configured. */
+  tracker: TrackerKind | null
+  /** Jira project key new tickets are filed under (e.g. 'ENG'); null unless Jira. */
+  jiraProjectKey: string | null
+  /** Writeback: comment on a task's linked issue when its PR opens. Per-task overridable. */
+  writebackCommentOnPrOpen: boolean
+  /** Writeback: comment + close a task's linked issue as resolved when its PR merges. */
+  writebackResolveOnMerge: boolean
+  updatedAt: number
+}
+
+export interface PutTrackerSettingsInput {
+  tracker: TrackerKind | null
+  jiraProjectKey?: string | null
+  writebackCommentOnPrOpen?: boolean
+  writebackResolveOnMerge?: boolean
+}
+
+/** Per-task writeback override; absent ⇒ inherit the workspace setting. */
+export type WritebackOverride = 'on' | 'off'