@danxbot/plugin-sdk 0.0.0-stage → 0.1.1

package/dist/card-kit.d.ts

@@ -0,0 +1,1246 @@
+declare module "@danxbot/card-kit@1" {
+  import { PagedWindow, SortValue } from '@danxbot/ui';
+  import * as react from 'react';
+  import { ReactNode } from 'react';
+  export { Link, useNavigate } from 'react-router';
+
+  type IssueType = "Epic" | "Bug" | "Feature" | "Story" | "Chore" | "Task";
+  type IssueStatus$1 = "Review" | "ToDo" | "In Progress" | "Backlog" | "Done" | "Cancelled";
+  type EffortLevelName = "min" | "very_low" | "low" | "medium" | "high" | "very_high" | "max";
+  type IssueProblemType = "question" | "action";
+  type DecisionOutcome = "answered" | "rejected";
+  type IssueDependencyKind = "depends_on" | "conflict_on";
+  type IssueDispatchKind = "work" | "triage" | "recovery" | "flesh-out" | "chat" | "main-sync-repair" | "worktree-maintenance" | "manual" | `gate-${string}`;
+  type IssueAssignmentMode = "automated" | "manual";
+  interface IssueV2 {
+      id: string;
+      repo_name: string;
+      board_id: string;
+      schema_version: number;
+      type: IssueType;
+      title: string;
+      description: string;
+      summary: string | null;
+      pull_request_url: string | null;
+      parent_id: string | null;
+      effort_level: EffortLevelName;
+      escalation_rung: EffortLevelName | null;
+      escalation_attempts: number;
+      downward_rung: EffortLevelName | null;
+      source_type: string;
+      list_name: string | null;
+      list_id: string | null;
+      assigned_agent: string | null;
+      priority: number;
+      created_at: string;
+      updated_at: string;
+      deleted_at: string | null;
+      ready_at: string | null;
+      started_at: string | null;
+      completed_at: string | null;
+      cancelled_at: string | null;
+      archived_at: string | null;
+      wake_at: string | null;
+      wake_action: "ready" | "review" | null;
+      dispatch_id: string | null;
+      dispatch_started_at: string | null;
+      dispatch_kind: IssueDispatchKind | null;
+      assignment_mode: IssueAssignmentMode;
+      card_branch: string | null;
+      last_commit_sha: string | null;
+      card_branch_retired_at: string | null;
+      card_branch_retired_reason: string | null;
+      card_branch_retired_by: string | null;
+      chat_session_uuid: string | null;
+      slack_session_uuid: string | null;
+      blocked_at: string | null;
+      blocked_reason: string | null;
+      blocked_by: string | null;
+      open_problem_count: number;
+      triage_ice_total: number | null;
+      triage_ice_i: number | null;
+      triage_ice_c: number | null;
+      triage_ice_e: number | null;
+      triage_confidence: number | null;
+      triage_last_status: string;
+      triage_last_explain: string;
+      status_derived: IssueStatus$1;
+      in_progress_derived: boolean;
+      dispatchable_derived: boolean;
+      self_dispatchable_derived: boolean;
+      triage_enabled: boolean;
+      content_hash: string;
+  }
+  type ChecklistItemStatus$1 = "incomplete" | "failing" | "passing" | "cancelled" | "deferred";
+  interface ChecklistV2 {
+      id: number;
+      issue_id: string;
+      ordinal: number;
+      name: string;
+      created_at: string;
+      updated_at: string;
+      deleted_at: string | null;
+  }
+  interface ChecklistItemV2 {
+      id: number;
+      checklist_id: number;
+      ordinal: number;
+      label: string;
+      detail: string;
+      status: ChecklistItemStatus$1;
+      created_at: string;
+      updated_at: string;
+      deleted_at: string | null;
+  }
+  interface ChecklistWithItemsV2 extends ChecklistV2 {
+      items: ChecklistItemV2[];
+  }
+  type ThumbnailStatus = "ready" | "not_image" | "failed" | "pending";
+  interface IssueAttachmentV2 {
+      id: number;
+      issue_id: string;
+      source_type: string;
+      external_id: string;
+      url: string;
+      filename: string;
+      mime: string;
+      is_primary: boolean;
+      thumbnail_status: ThumbnailStatus;
+      thumbnail_url: string | null;
+      thumbnail_error: string | null;
+      created_at: string;
+      updated_at: string;
+      deleted_at: string | null;
+  }
+  type QualityGateStatus = "pending" | "pass" | "fail" | "skipped";
+
+  interface RepoProfileCopy {
+      shipped: string;
+      repo: string;
+  }
+  type ProfileNameId = string;
+
+  type ListType$1 = "and" | "or" | "semicolon";
+  interface ListValue<Item> {
+      list: readonly Item[];
+      type?: ListType$1;
+  }
+  type StatusReasonId = string;
+  type StatusReasonValues = Record<string, string | number | boolean | null | StatusReason | ProfileNameMessage | StatusReason[] | StatusReasonLines | StatusReasonList>;
+  interface ProfileNameMessage {
+      id: ProfileNameId;
+      values: StatusReasonValues;
+  }
+  type StatusReasonList = ListValue<string | number | StatusReason | ProfileNameMessage>;
+  interface StatusReasonLines {
+      lines: StatusReason[];
+  }
+  interface StatusReason {
+      id: StatusReasonId;
+      values: StatusReasonValues;
+  }
+
+  type QualityGatePhase = "plan" | "code";
+
+  interface ViaKey {
+      id: number;
+      name: string;
+  }
+  type MirrorProviderId = "trello" | "slack" | "asana";
+  type SourceOrigin = "" | "trello" | "slack" | "asana" | "danxbot" | "card-only";
+  type ControlValue = boolean | string;
+
+  type ControlSource = "card" | "plan" | "board" | "parent" | "system";
+  interface ControlFallback {
+      readonly value: ControlValue;
+      readonly source: Exclude<ControlSource, "card">;
+  }
+
+  interface HolderAgentPause {
+      reason: string;
+      since: string;
+      until: string;
+  }
+  type AssignedAgentKind = "session" | "person" | "worker" | "label";
+
+  interface UsageTokenCounts {
+      input: number;
+      output: number;
+      cacheRead: number;
+      cacheWrite: number;
+  }
+  interface UsageSlice {
+      tokens: UsageTokenCounts;
+      costUsd: number;
+  }
+  interface UsageTotals extends UsageTokenCounts {
+      cacheWrite5m: number;
+      cacheWrite1h: number;
+      cacheWriteUnsplit: number;
+  }
+  interface UsageModelRow extends UsageSlice {
+      model: string | null;
+  }
+  type UsageKind = "work" | "operator-session" | `gate:${string}` | "triage" | "maintenance" | "chat" | "other";
+  interface UsageKindRow extends UsageSlice {
+      kind: UsageKind;
+      label: string;
+  }
+  type UsageSubagentTypeKey = "main" | "unknown" | "unattributed" | `agent:${string}`;
+  interface UsageSubagentTypeRow extends UsageSlice {
+      key: UsageSubagentTypeKey;
+      label: string;
+      sourceCount: number;
+  }
+  interface UsageTiming {
+      apiMs: number;
+      agentMs: number;
+      linesAdded: number;
+      linesRemoved: number;
+  }
+  interface UsageSummary {
+      totals: UsageTotals;
+      costUsd: number;
+      byModel: UsageModelRow[];
+      byKind: UsageKindRow[];
+      bySubagentType: UsageSubagentTypeRow[];
+      dispatchCount: number;
+      operatorAttributionSince: number | null;
+      timing: UsageTiming;
+      timingMeasuredSince: number | null;
+  }
+  type UsageErrorCode = "unattributable_dispatch" | "usage_inconsistent";
+  interface UsageError {
+      error: {
+          code: UsageErrorCode;
+          message: string;
+          dispatchId: string;
+      };
+  }
+  type CardUsage = UsageSummary | UsageError | null;
+  interface DesignSourceFile {
+      path: string;
+      content: string;
+  }
+
+  interface CodeGateStatus {
+      gate: string;
+      status: QualityGateStatus;
+  }
+  interface RelationPageView {
+      readonly limit: number;
+      readonly total: number;
+      readonly next_cursor: string | null;
+  }
+
+  type ConnectionState = "connecting" | "connected" | "disconnected";
+  interface LiveQueryResult<T> {
+      data: T | null;
+      loading: boolean;
+      error: Error | null;
+      connection: ConnectionState;
+      refetch: () => void;
+  }
+
+  interface ReadinessBlocker {
+      worker_id: string;
+      incomplete_count: number;
+      items: {
+          id: string;
+          label: string;
+          label_message: StatusReason;
+          reason: string;
+          reason_message: StatusReason;
+          status: string;
+      }[];
+  }
+
+  type DispatchKeyRefusal = {
+      reason: "role_exceeds_owner";
+      missingPermissions: readonly string[];
+  } | {
+      reason: "owner_terms_not_accepted";
+  } | {
+      reason: "owner_not_member";
+  } | {
+      reason: "profile_role_missing";
+  };
+
+  interface DispatchKeyBlocker {
+      worker_id: string;
+      owner_user_id: number;
+      owner_username: string;
+      reason: DispatchKeyRefusal["reason"];
+      detail: string;
+  }
+
+  type PickerRouting = "gate" | "work" | "orchestrated" | "skip" | "terminal_or_container";
+  interface DispatchableExplainView {
+      id: string;
+      dispatchable: boolean;
+      self_dispatchable: boolean;
+      ancestor_blocked: boolean;
+      next_pre_gate: string | null;
+      next_code_gate: string | null;
+      blocking_gates: {
+          gate: string;
+          detail: string;
+      }[];
+      picker_routing: PickerRouting;
+      dispatch_key_blockers: DispatchKeyBlocker[];
+      worker_readiness_blockers: ReadinessBlocker[];
+  }
+
+  interface SolutionContent {
+      title: string;
+      body: string;
+      pro: string;
+      con: string;
+      recommended: boolean;
+  }
+
+  interface V2CopyComment {
+      author: string;
+      text: string;
+  }
+  interface V2CopyAc {
+      title: string;
+      checked: boolean;
+  }
+  interface V2CopyChecklist {
+      name: string;
+      items: V2CopyChecklistItem[];
+  }
+  interface V2CopyChecklistItem {
+      label: string;
+      detail: string;
+      status: ChecklistItemStatus$1;
+  }
+  interface V2CopyDependency {
+      kind: IssueDependencyKind;
+      target_id: string;
+      reason: string;
+  }
+  interface V2CopyRetro {
+      good: string;
+      bad: string;
+      correctable_danxbot_problem: boolean;
+      correctable_danxbot_problem_description: string;
+      action_item_ids: string[];
+      commits: {
+          sha: string;
+          subject: string;
+      }[];
+      tests: V2CopyRetroTest[];
+  }
+  interface V2CopyRetroTest {
+      name: string;
+      kind: "group" | "e2e";
+      num_tests: number;
+      num_assertions: number | null;
+      num_passing_tests: number;
+      num_passing_assertions: number | null;
+      duration_ms: number;
+  }
+  interface V2CopyMirror {
+      target_type: MirrorProviderId;
+      target_ref: string;
+      target_url: string;
+      source_ref: string;
+  }
+  type SourceMirrorLocation = Record<MirrorProviderId, string | null>;
+  interface V2CopyQualityGate {
+      gate: string;
+      decision_note: string;
+      effort_level: EffortLevelName | null;
+      status: QualityGateStatus;
+      message: string;
+      completed_at: string | null;
+      attempts: number;
+      reviewed_ref: string | null;
+  }
+  interface V2CopySolution extends SolutionContent {
+      removed: boolean;
+      steps: V2CopyStep[];
+  }
+  interface V2CopyStep {
+      title: string;
+      description: string | null;
+      steps: V2CopyStep[];
+  }
+  interface V2CopyDecision {
+      solution_index: number | null;
+      outcome: DecisionOutcome;
+      freeform: string | null;
+      note: string | null;
+      decided_by: string;
+      decided_at: string;
+      retracted_at: string | null;
+  }
+  interface V2CopyProblem {
+      statement: string;
+      context: string | null;
+      type: IssueProblemType;
+      summary: string | null;
+      removed: boolean;
+      solutions: V2CopySolution[];
+      decisions: V2CopyDecision[];
+  }
+  interface V2CopyIssue {
+      id: string;
+      parent_id: string | null;
+      type: IssueType;
+      title: string;
+      description: string;
+      summary: string | null;
+      priority: number;
+      effort_level: EffortLevelName | null;
+      assigned_agent: string | null;
+      ready_at: string | null;
+      completed_at: string | null;
+      cancelled_at: string | null;
+      archived_at: string | null;
+      blocked_at: string | null;
+      blocked_reason: string | null;
+      ac: V2CopyAc[];
+      checklists: V2CopyChecklist[];
+      comments: V2CopyComment[];
+      dependencies: V2CopyDependency[];
+      retro: V2CopyRetro | null;
+      mirrors: V2CopyMirror[];
+      quality_gates: V2CopyQualityGate[];
+      problems: V2CopyProblem[];
+      triage_enabled: boolean;
+      unknown_fields: V2CopyUnknownField[];
+  }
+  interface V2CopyUnknownField {
+      path: string;
+      value: unknown;
+  }
+  interface V2CopyPayload {
+      schema_version: number;
+      issues: V2CopyIssue[];
+      source_mirror_location: SourceMirrorLocation;
+  }
+
+  type IssueStatus = "Review" | "ToDo" | "In Progress" | "Backlog" | "Done" | "Cancelled";
+  interface InheritedBlockedViewV2 {
+      id: string;
+      reason: string;
+  }
+  interface WaitingOnViewV2 {
+      by: string[];
+      reason: string;
+      timestamp: string;
+  }
+  interface ConflictEntryViewV2 {
+      id: string;
+      reason: string;
+  }
+  interface IceViewV2 {
+      total: number | null;
+      i: number | null;
+      c: number | null;
+      e: number | null;
+  }
+  interface TriageHistoryEntryViewV2 {
+      timestamp: string;
+      status: string;
+      explain: string;
+      ice: IceViewV2;
+      confidence: number | null;
+  }
+  interface TriageViewV2 {
+      last_status: string;
+      last_explain: string;
+      ice: IceViewV2;
+      confidence: number | null;
+      history: TriageHistoryEntryViewV2[];
+  }
+  interface RetroTestViewV2 {
+      name: string;
+      kind: "group" | "e2e";
+      num_tests: number;
+      num_assertions: number | null;
+      num_passing_tests: number;
+      num_passing_assertions: number | null;
+      duration_ms: number;
+  }
+  interface RetroViewV2 {
+      good: string;
+      bad: string;
+      correctable_danxbot_problem: boolean;
+      correctable_danxbot_problem_description: string;
+      action_item_ids: string[];
+      commits: string[];
+      tests: RetroTestViewV2[];
+      commit_url_base?: string | null;
+  }
+  interface CommentViewV2 {
+      id: string;
+      author: string;
+      timestamp: string;
+      text: string;
+      updated_at: string;
+      origin: SourceOrigin;
+      via_key?: ViaKey | null;
+      metadata?: unknown | null;
+      answers_decision_id?: number | null;
+      problem_id?: number | null;
+  }
+  interface AttachmentViewV2 {
+      id: number;
+      source: SourceOrigin;
+      url: string;
+      filename: string;
+      mime: string;
+      is_primary: boolean;
+      thumbnail_status: ThumbnailStatus;
+      thumbnail_url: string | null;
+      thumbnail_error: string | null;
+      created_at: string;
+  }
+  interface AttachmentPreviewV2 {
+      id: number;
+      url: string;
+      thumbnail_url: string | null;
+      filename: string;
+      mime: string;
+  }
+  interface AcItemViewV2 {
+      check_item_id: string;
+      title: string;
+      checked: boolean;
+  }
+  type ChecklistItemStatus = "incomplete" | "failing" | "passing" | "cancelled" | "deferred";
+  interface ChecklistItemView {
+      id: number;
+      label: string;
+      detail: string;
+      status: ChecklistItemStatus;
+  }
+  interface ChecklistView {
+      id: number;
+      name: string;
+      items: ChecklistItemView[];
+  }
+  interface ChecklistHistoryViewV2 {
+      action: "create" | "rename" | "remove" | "add_item" | "update_item" | "remove_item";
+      checklist: string;
+      item: string | null;
+      changed: "status" | "label" | "detail" | null;
+  }
+  interface LatestWorkDispatchViewV2 {
+      dispatch_id: string;
+      started_at_ms: number;
+      completed_at_ms: number | null;
+      status: string;
+      usage_input: number;
+      usage_output: number;
+      assigned_worker_id: string | null;
+  }
+  interface ChildAssignmentViewV2 {
+      agent: string;
+      agent_repo_copy: RepoProfileCopy | null;
+      issue_id: string;
+      issue_title: string;
+  }
+  type IssueViewV2 = {
+    triage?: undefined | TriageViewV2;
+    comments?: undefined | (Array<{
+    id: string;
+    author: string;
+    timestamp: string;
+    text: string;
+    updated_at: string;
+    origin: "" | "trello" | "slack" | "asana" | "danxbot" | "card-only";
+    via_key?: undefined | null | ViaKey;
+    metadata?: unknown;
+    answers_decision_id?: undefined | null | number;
+    problem_id?: undefined | null | number;
+  }>);
+    checklists?: undefined | Array<ChecklistView>;
+    attachments?: undefined | (Array<{
+    id: number;
+    source: "" | "trello" | "slack" | "asana" | "danxbot" | "card-only";
+    url: string;
+    filename: string;
+    mime: string;
+    is_primary: boolean;
+    thumbnail_status: "ready" | "not_image" | "failed" | "pending";
+    thumbnail_url: null | string;
+    thumbnail_error: null | string;
+    created_at: string;
+  }>);
+    title: string;
+    description?: undefined | string;
+    status: "Cancelled" | "Review" | "ToDo" | "In Progress" | "Backlog" | "Done";
+    type: "Epic" | "Bug" | "Feature" | "Story" | "Chore" | "Task";
+    priority: number;
+    id: string;
+    parent_id: null | string;
+    created_at: number;
+    updated_at: number;
+    assigned_agent: null | string;
+    content_hash: string;
+    retro?: undefined | RetroViewV2;
+    stored_row?: undefined | IssueV2;
+    stored_checklists?: undefined | Array<ChecklistWithItemsV2>;
+    stored_attachments?: undefined | Array<IssueAttachmentV2>;
+    retro_commit_shas?: undefined | Array<string>;
+    code_gates?: undefined | Array<CodeGateStatus>;
+    deleted_at?: undefined | null | number;
+    dispatchable_derived?: undefined | false | true;
+    blocked?: undefined | null | { at: string; reason: string; by: string | null; };
+    board_id?: undefined | string;
+    ready_at?: undefined | null | string;
+    archived_at?: undefined | null | string;
+    completed_at?: undefined | null | string;
+    cancelled_at?: undefined | null | string;
+    wake_at?: undefined | null | string;
+    wake_action?: undefined | null | "review" | "ready";
+    assigned_agent_name?: undefined | null | string;
+    resolved_list_id?: undefined | string;
+    list_name?: undefined | string;
+    list_color?: undefined | null | string;
+    list_emoji?: undefined | null | string;
+    refs?: undefined | Array<CardRefViewV2>;
+    parent_title?: undefined | null | string;
+    parent_type?: undefined | null | "Epic" | "Bug" | "Feature" | "Story" | "Chore" | "Task";
+    parent_created_at?: undefined | null | number;
+    parent_updated_at?: undefined | null | number;
+    parent_blocked?: undefined | null | false | true;
+    parent_open_problem_count?: undefined | null | number;
+    projection_error?: undefined | null | string;
+    summary?: undefined | null | string;
+    pull_request_url?: undefined | null | string;
+    problem_total?: undefined | number;
+    design_revision_count?: undefined | number;
+    open_action_count?: undefined | number;
+    open_problem_count?: undefined | number;
+    ac?: undefined | Array<AcItemViewV2>;
+    triage_enabled?: undefined | false | true;
+    dispatch?: undefined | null | { started_at: string | null; };
+    dispatch_kind?: undefined | null | "work" | "triage" | "recovery" | "flesh-out" | "chat" | "main-sync-repair" | "worktree-maintenance" | "manual" | `gate-${string}`;
+    assignment_mode?: undefined | "manual" | "automated";
+    assigned_agent_kind?: undefined | null | "session" | "person" | "worker" | "label";
+    assigned_agent_pause?: undefined | null | HolderAgentPause;
+    assigned_agent_repo_copy?: undefined | null | RepoProfileCopy;
+    latest_work_dispatch?: undefined | null | LatestWorkDispatchViewV2;
+    usage?: undefined | null | UsageSummary | UsageError;
+    effort_level?: undefined | "min" | "very_low" | "low" | "medium" | "high" | "very_high" | "max";
+    escalation_rung?: undefined | null | "min" | "very_low" | "low" | "medium" | "high" | "very_high" | "max";
+    escalation_attempts?: undefined | number;
+    downward_rung?: undefined | null | "min" | "very_low" | "low" | "medium" | "high" | "very_high" | "max";
+    waiting_on_gate?: undefined | null | WaitingOnViewV2;
+    waiting_on_dep_ids?: undefined | Record<string, number>;
+    conflict_on?: undefined | Array<ConflictEntryViewV2>;
+    conflict_on_reverse?: undefined | Array<ConflictEntryViewV2>;
+    conflict_on_partners?: undefined | Record<string, { status: IssueStatus; title: string; }>;
+    conflict_dep_ids?: undefined | Record<string, number>;
+    conflict_on_active_count?: undefined | number;
+    children?: undefined | Array<string>;
+    blocked_descendants?: undefined | Array<InheritedBlockedViewV2>;
+    child_assignments?: undefined | Array<ChildAssignmentViewV2>;
+    ac_total?: undefined | number;
+    ac_done?: undefined | number;
+    ac_items?: undefined | (Array<{ title: string; status: "incomplete" | "failing" | "passing" | "cancelled" | "deferred"; }>);
+    comments_count?: undefined | number;
+    has_retro?: undefined | false | true;
+    primary_attachment?: undefined | null | AttachmentPreviewV2;
+    in_progress_derived?: undefined | false | true;
+    waiting_on?: undefined | false | true;
+    waiting_on_reason?: undefined | null | string;
+    waiting_on_by?: undefined | Array<string>;
+    triage_ice_total?: undefined | null | number;
+    triage_ice_i?: undefined | null | number;
+    triage_ice_c?: undefined | null | number;
+    triage_ice_e?: undefined | null | number;
+    triage_confidence?: undefined | null | number;
+    triage_last_explain?: undefined | string;
+    triage_last_status?: undefined | string;
+    triage_last_decision_at?: undefined | null | string;
+    next_pre_gate?: undefined | null | string;
+    next_code_gate?: undefined | null | string;
+    dispatchable_explain?: undefined | DispatchableExplainView;
+    copy_payload?: undefined | V2CopyPayload;
+    copy_issue?: undefined | V2CopyIssue;
+    design_revisions?: undefined | (Array<{
+    revision_no: number;
+    target: string;
+    entry: string;
+    built_from_commit: string;
+    note: string;
+    created_by: string;
+    created_at: string;
+    bundle_bytes: null | number;
+    bundle_available: boolean;
+    screenshot_available: boolean;
+    source_files?: undefined | Array<DesignSourceFile>;
+  }>);
+    design_decisions?: undefined | (Array<{
+    decision_id: number;
+    revision_no: number;
+    outcome: "rejected" | "approved" | "changes_requested";
+    note: null | string;
+    decided_by: string;
+    created_at: string;
+  }>);
+    pull_request_reviews?: undefined | (Array<{
+    id: number;
+    kind: "review" | "comment" | "thread";
+    author_login: string;
+    state: null | "approved" | "changes_requested" | "commented" | "dismissed";
+    body: string;
+    html_url: string;
+    path: null | string;
+    line: null | number;
+    resolved: null | false | true;
+    occurred_at: string;
+  }>);
+    code_review_items?: undefined | Array<{
+    gate_name: string;
+    title: string;
+    description: string;
+    status: string;
+    reasoning: string;
+  }>;
+    children_detail?: undefined | (Array<{
+    id: string;
+    name: string;
+    status: "Cancelled" | "Review" | "ToDo" | "In Progress" | "Backlog" | "Done";
+    type?: undefined | "Epic" | "Bug" | "Feature" | "Story" | "Chore" | "Task";
+    priority?: undefined | number;
+    summary?: undefined | null | string;
+    waiting_on: boolean;
+    waiting_on_by_card: boolean;
+    open_problem_count: number;
+    blocked: boolean;
+    waiting_on_ids: Array<string>;
+    conflict_on_ids: Array<string>;
+  }>);
+    plans?: undefined | Array<{
+    id: number;
+    ref: string;
+    name: string;
+  }>;
+    mirrors?: undefined | (Array<{
+    target_type: "trello" | "slack" | "asana";
+    target_url: string;
+    sync_state: "synced" | "out_of_sync" | "error" | "dead" | "unavailable" | "diverged";
+    dead_reason: "" | "archived" | "deleted";
+    source_ref: string;
+    last_error: null | StatusReason;
+    owed: Array<"comments" | "checklists" | "attachments" | "title" | "description" | "status" | "type" | "priority" | "parent_child" | "dependencies" | "card_create" | "card_delete">;
+    description_unreadable: boolean;
+    target_ref: string;
+    target_label: string;
+    last_synced_at: number;
+    logo_url: string;
+  }>);
+    history?: undefined | (Array<{
+    id: string;
+    timestamp: string;
+    actor: string;
+    via_key: undefined | null | ViaKey;
+    event: "created" | "blocked" | "activity" | "status_change" | "unblocked" | "field_change" | "dependency_added" | "dependency_removed" | "conflict_added" | "conflict_removed";
+    label: undefined | StatusReason;
+    from: undefined | "Cancelled" | "Review" | "ToDo" | "In Progress" | "Backlog" | "Done";
+    to: undefined | "Cancelled" | "Review" | "ToDo" | "In Progress" | "Backlog" | "Done";
+    note: undefined | string;
+    field: undefined | string;
+    value_before: undefined | null | string;
+    value_after: undefined | null | string;
+    target: undefined | string;
+    checklist: undefined | ChecklistHistoryViewV2;
+  }>);
+    controls?: undefined | (Array<{
+    key: string;
+    scope: "board" | "plan" | "card";
+    scope_id: string;
+    value: null | string | false | true;
+    source: "board" | "plan" | "card" | "parent" | "system" | "inherit";
+    base_hash: string;
+    kind: "boolean" | "enum" | "branch" | "markdown";
+    options: null | Array<string>;
+    description: string;
+    system_default: string | false | true;
+    fallback: null | ControlFallback;
+  }>);
+    comments_page?: undefined | RelationPageView;
+    history_page?: undefined | RelationPageView;
+    problems?: undefined | Array<ProblemViewV2>;
+    subtree?: undefined | Array<IssueViewV2>;
+    quality_gates?: undefined | Array<QualityGateChipV2> | Array<QualityGateViewV2>;
+  };
+  interface QualityGateChipV2 {
+      gate: string;
+      phase: QualityGatePhase;
+      status: "pending" | "pass" | "fail" | "skipped";
+  }
+  type QualityGateViewV2 = {
+    gate: string;
+    decision_note: string;
+    status: "pending" | "pass" | "fail" | "skipped";
+    completed_at: null | string;
+    message: string;
+    reviewed_ref: null | string;
+    effort_level: null | "min" | "very_low" | "low" | "medium" | "high" | "very_high" | "max";
+    phase: "plan" | "code";
+  };
+  type ProblemViewV2 = {
+    id: number;
+    issue_id: string;
+    ordinal: number;
+    statement: string;
+    context: null | string;
+    type: "question" | "action";
+    summary: null | string;
+    content_hash: string;
+    created_at: string;
+    updated_at: string;
+    open: boolean;
+    solutions: Array<{
+    id: number;
+    problem_id: number;
+    removed: boolean;
+    title: string;
+    body: string;
+    pro: string;
+    con: string;
+    recommended: boolean;
+    content_hash: string;
+    steps_hash: string;
+    steps: Array<{
+    id: number;
+    solution_id: number;
+    parent_step_id: null | number;
+    label: string;
+    title: string;
+    description: null | string;
+    content_hash: string;
+    checked_at: null | string;
+    checked_by: null | string;
+    steps: Array<SolutionStepViewV2>;
+  }>;
+  }>;
+    decisions: Array<{
+    id: number;
+    problem_id: number;
+    solution_id: null | number;
+    solution_title: null | string;
+    outcome: "answered" | "rejected";
+    freeform: null | string;
+    note: null | string;
+    decided_by: string;
+    decided_at: string;
+    retracted_at: null | string;
+    relayed_by_session: null | string;
+    content_hash: string;
+  }>;
+  };
+  type SolutionViewV2 = {
+    id: number;
+    problem_id: number;
+    removed: boolean;
+    title: string;
+    body: string;
+    pro: string;
+    con: string;
+    recommended: boolean;
+    content_hash: string;
+    steps_hash: string;
+    steps: Array<{
+    id: number;
+    solution_id: number;
+    parent_step_id: null | number;
+    label: string;
+    title: string;
+    description: null | string;
+    content_hash: string;
+    checked_at: null | string;
+    checked_by: null | string;
+    steps: Array<SolutionStepViewV2>;
+  }>;
+  };
+  interface SolutionStepViewV2 {
+      id: number;
+      solution_id: number;
+      parent_step_id: number | null;
+      label: string;
+      title: string;
+      description: string | null;
+      content_hash: string;
+      checked_at: string | null;
+      checked_by: string | null;
+      steps: SolutionStepViewV2[];
+  }
+  interface DecisionViewV2 {
+      id: number;
+      problem_id: number;
+      solution_id: number | null;
+      solution_title: string | null;
+      outcome: DecisionOutcome;
+      freeform: string | null;
+      note: string | null;
+      decided_by: string;
+      decided_at: string;
+      retracted_at: string | null;
+      relayed_by_session: string | null;
+      content_hash: string;
+  }
+  interface CardRefViewV2 {
+      source: "danxbot" | MirrorProviderId;
+      ref: string;
+      url: string;
+  }
+
+  type TransitionAction = "ready" | "unready" | "pickup" | "rollback_pickup" | "escalate" | "gate_release" | "gate_repin" | "claim_repin" | "complete" | "cancel" | "block" | "unblock" | "archive" | "snooze" | "coerce" | "reopen";
+
+  type LifecycleAction = Extract<TransitionAction, "ready" | "unready" | "complete" | "cancel" | "reopen">;
+
+  function transitionCard(id: string, action: LifecycleAction | "unblock" | "archive"): Promise<void>;
+  type PriorityPlacement = {
+      side: "after" | "before";
+      id: string;
+  } | {
+      edge: "top" | "bottom";
+  };
+  interface DetachedDispatch {
+      dispatchId: string;
+      stop: "requested" | "unreachable";
+  }
+
+  interface LaneMoveRequest {
+      issueId: string;
+      lane: IssueStatus$1;
+      placement: PriorityPlacement | null;
+  }
+  type BoardMoveResult = {
+      ok: true;
+      reason: null;
+      updatedAt: number;
+      detachedDispatch: DetachedDispatch | null;
+  } | {
+      ok: false;
+      reason: string;
+      updatedAt: null;
+  };
+
+  function useIssueDetail(id: string): LiveQueryResult<IssueViewV2>;
+  function requestBoardMove(req: LaneMoveRequest): Promise<BoardMoveResult>;
+
+  interface CardMutation {
+      pending: string | null;
+      run: (key: string, failureTitle: string, op: () => Promise<void>) => Promise<boolean>;
+  }
+  function useCardMutation(): CardMutation;
+  type HideableLane = "Cancelled" | "Backlog";
+  interface LaneVisibility {
+      isShown: (lane: IssueStatus$1) => boolean;
+      setShown: (lane: HideableLane, shown: boolean) => void;
+  }
+
+  type LaneSortField = "title" | "id" | "priority" | "updated_at" | "created_at";
+  type LaneSort = SortValue<LaneSortField>;
+  type LaneSorts = Readonly<Record<IssueStatus$1, LaneSort>>;
+  interface LaneSortState {
+      readonly sorts: LaneSorts;
+      readonly setSort: (lane: IssueStatus$1, sort: LaneSort) => void;
+  }
+
+  type BoardScope = {
+      readonly kind: "board";
+      readonly board: string;
+      readonly boards: readonly string[];
+  } | {
+      readonly kind: "plan";
+      readonly planId: number;
+      readonly boards: readonly string[];
+  };
+  type BoardLaneWindows = Readonly<Record<IssueStatus$1, PagedWindow<IssueViewV2>>>;
+  interface BoardLaneState {
+      readonly scope: BoardScope;
+      readonly windows: BoardLaneWindows;
+      readonly visibility: LaneVisibility;
+      readonly sorts: LaneSorts;
+      readonly setSort: LaneSortState["setSort"];
+      readonly openCount: number | null;
+  }
+  function useBoardLaneState(scope: BoardScope): BoardLaneState;
+
+  function boardCardPath(cardId: string): string;
+  function planCardPath(planId: number, cardId: string, planSearch?: string): string;
+  function planPathFromCard(planId: number, cardSearch?: string): string;
+
+  function CardLink({ id, className, onNavigate }: {
+      id: string;
+      className?: string;
+      onNavigate?: () => void;
+  }): react.JSX.Element;
+
+  function EditableTitle({ card }: {
+      card: IssueViewV2;
+  }): react.JSX.Element;
+
+  function EditableSummary({ card }: {
+      card: IssueViewV2;
+  }): react.JSX.Element;
+
+  function EditableContext({ card }: {
+      card: IssueViewV2;
+  }): react.JSX.Element;
+
+  function ChecklistsSection({ card, mutation }: {
+      card: IssueViewV2;
+      mutation: CardMutation;
+  }): react.JSX.Element;
+
+  type CardTone = "success" | "warning" | "danger" | "info" | "neutral" | "accent" | "brand" | "muted";
+  interface ChildProgress {
+      done: number;
+      total: number;
+  }
+  interface CardStatusPresentation {
+      label: string;
+      tone: CardTone;
+      icon: string;
+      reason: string | null;
+      live: boolean;
+      isContainer: boolean;
+      childProgress: ChildProgress | null;
+  }
+  type SnoozePresentation = {
+      active: false;
+  } | {
+      active: true;
+      wakeAt: string;
+      wakeAction: "ready" | "review";
+  };
+  interface GateBreakdownEntry {
+      gate: string;
+      label: string;
+      status: GateVerdict;
+  }
+  type GateVerdict = QualityGateViewV2["status"];
+
+  interface ProblemAttention {
+      problem: ProblemViewV2;
+      solutions: SolutionViewV2[];
+      removedSolutionIds: ReadonlySet<number>;
+      decisions: DecisionViewV2[];
+  }
+
+  function ProblemsSection({ cardId, problems, comments, canAnswer, mutation, }: {
+      cardId: string;
+      problems: ProblemAttention[];
+      comments: readonly CommentViewV2[];
+      canAnswer: boolean;
+      mutation: CardMutation;
+  }): react.JSX.Element;
+
+  function DependenciesSection({ card, mutation }: {
+      card: IssueViewV2;
+      mutation: CardMutation;
+  }): react.JSX.Element;
+
+  function ChildrenSection({ card }: {
+      card: IssueViewV2;
+  }): react.JSX.Element;
+
+  function ParentField({ card, mutation }: {
+      card: IssueViewV2;
+      mutation: CardMutation;
+  }): react.JSX.Element;
+
+  function PlansField({ card, mutation }: {
+      card: IssueViewV2;
+      mutation: CardMutation;
+  }): react.JSX.Element;
+
+  function GatesSection({ card }: {
+      card: IssueViewV2;
+  }): react.JSX.Element;
+
+  interface ActivityProps {
+      card: IssueViewV2;
+      mutation: CardMutation;
+      onFocusProblem?: (problemId: number) => void;
+  }
+  function ActivityTab(props: ActivityProps): react.JSX.Element;
+
+  type ShownAttachment = AttachmentViewV2 & {
+      pending: boolean;
+  };
+
+  interface AttachmentActions {
+      attachments: ShownAttachment[];
+      add: (files: readonly File[]) => void;
+      replace: (id: number, file: File) => void;
+      rename: (id: number, filename: string) => void;
+      setCover: (id: number) => void;
+      remove: (id: number) => void;
+  }
+  function useAttachmentActions(card: Pick<IssueViewV2, "id" | "attachments">): AttachmentActions;
+
+  interface AttachmentViewer {
+      open: (attachmentId: number) => void;
+      element: ReactNode;
+  }
+
+  function AttachmentsTab({ cardId, actions, viewer, }: {
+      cardId: string;
+      actions: AttachmentActions;
+      viewer: AttachmentViewer;
+  }): react.JSX.Element;
+
+  function RetroTab({ retro }: {
+      retro: RetroViewV2;
+  }): react.JSX.Element;
+
+  interface AttentionZoneProps {
+      card: IssueViewV2;
+      mutation: CardMutation;
+  }
+  function AttentionZone({ card, mutation }: AttentionZoneProps): react.JSX.Element;
+
+  interface CardActionsMenuProps {
+      card: IssueViewV2;
+      mutation: CardMutation;
+  }
+  function CardActionsMenu({ card, mutation }: CardActionsMenuProps): react.JSX.Element;
+
+  interface WorkStateInput {
+      terminal: boolean;
+      container: boolean;
+      assignedAgent: string | null;
+      assignedAgentName: string | null;
+      assignedAgentKind: AssignedAgentKind | null;
+      assignedAgentRepoCopy: RepoProfileCopy | null;
+      assignedAgentPause: HolderAgentPause | null;
+      heldSince: string | null;
+      blocked: {
+          reason: string;
+          by: string | null;
+          at: string | null;
+      } | null;
+      waitingOn: readonly string[];
+      conflictIds: readonly string[];
+      conflictActive: number;
+  }
+
+  interface WorkStateControlProps {
+      cardId: string;
+      input: WorkStateInput;
+      size?: "sm" | "2xs";
+      onOpenHold?: () => void;
+      onOpenDependencies?: () => void;
+  }
+  function WorkStateControl({ cardId, input, size, onOpenHold, onOpenDependencies }: WorkStateControlProps): react.JSX.Element | null;
+
+  interface ControlProps {
+      card: IssueViewV2;
+      mutation: CardMutation;
+  }
+  function PriorityControl({ card, mutation }: ControlProps): react.JSX.Element;
+  function EffortControl({ card, mutation }: ControlProps): react.JSX.Element;
+  function TypeControl({ card, mutation }: ControlProps): react.JSX.Element;
+  function StatusControl({ card, mutation }: ControlProps): react.JSX.Element;
+
+  interface StandardCardPageProps {
+      card: IssueViewV2;
+      mutation: CardMutation;
+  }
+  function StandardCardPage({ card, mutation }: StandardCardPageProps): react.JSX.Element;
+
+  interface CardFaceAc {
+      total: number;
+      byStatus: Record<ChecklistItemStatus, number>;
+      items?: NonNullable<IssueViewV2["ac_items"]>;
+  }
+  interface CardFaceModel {
+      id: string;
+      title: string;
+      type: IssueType;
+      priority: number;
+      statusName: IssueStatus$1;
+      status: CardStatusPresentation;
+      list: CardFaceList | null;
+      to: string;
+      parent: {
+          id: string;
+          title: string | null;
+          to: string;
+      } | null;
+      needsHuman: {
+          questions: number;
+          actions: number;
+      };
+      work: WorkStateInput;
+      snooze: SnoozePresentation;
+      effort: EffortLevelName | null;
+      planGates: readonly GateBreakdownEntry[];
+      codeGates: readonly GateBreakdownEntry[];
+      ac: CardFaceAc;
+      commentsCount: number;
+      hasRetro: boolean;
+      onPullRequest: boolean;
+      childrenCount: number;
+      childrenDetail?: NonNullable<IssueViewV2["children_detail"]>;
+      triage: {
+          lastDecisionAt: string | null;
+          confidence: number | null;
+          iceTotal: number | null;
+          iceI: number | null;
+          iceC: number | null;
+          iceE: number | null;
+      };
+      agent: {
+          childAssignments: readonly ChildAssignmentViewV2[];
+          dispatchKind?: IssueDispatchKind | null;
+          latestWorkDispatch: LatestWorkDispatchViewV2 | null;
+      };
+      usage: CardUsage;
+      createdAt: string | number;
+      updatedAt: string | number;
+  }
+  type CardFaceList = {
+    name: string;
+    id: string;
+    color: string;
+    emoji: string;
+  };
+
+  type CardFaceStatusMark = {
+      kind: "labelled";
+  } | {
+      kind: "lane";
+      laneListId: string | null;
+  };
+  interface CardFaceProps {
+      card: CardFaceModel;
+      renderTitle: (props: {
+          className: string;
+          describedBy: string;
+      }) => ReactNode;
+      trailing?: ReactNode;
+      statusMark: CardFaceStatusMark;
+      cover?: ReactNode;
+      demo?: boolean;
+  }
+  function CardFace({ card, renderTitle, trailing, statusMark, cover, demo }: CardFaceProps): react.JSX.Element;
+
+  function CardBoard({ state, cardPath, }: {
+      state: BoardLaneState;
+      cardPath?: (cardId: string) => string;
+  }): react.JSX.Element;
+
+  type CardViewProps = StandardCardPageProps;
+  interface CardListViewProps {
+      readonly scope: BoardScope;
+      readonly cardPath: (cardId: string) => string;
+  }
+
+  export { ActivityTab, AttachmentsTab, AttentionZone, CardActionsMenu, CardBoard, CardFace, CardLink, ChecklistsSection, ChildrenSection, DependenciesSection, EditableContext, EditableSummary, EditableTitle, EffortControl, GatesSection, ParentField, PlansField, PriorityControl, ProblemsSection, RetroTab, StandardCardPage, StatusControl, TypeControl, WorkStateControl, boardCardPath, planCardPath, planPathFromCard, requestBoardMove, transitionCard, useAttachmentActions, useBoardLaneState, useIssueDetail as useCard, useCardMutation };
+  export type { AttachmentActions, BoardLaneState, BoardMoveResult, BoardScope, CardFaceProps, CardListViewProps, CardMutation, CardViewProps, IssueViewV2, LaneMoveRequest, LiveQueryResult, StandardCardPageProps };
+}