@ghfs/cli 0.0.4 → 0.1.1

package/dist/provider-DCIsHVeA.d.mts

@@ -0,0 +1,249 @@
+//#region src/types/config.d.ts
+interface GhfsUserConfig {
+  /**
+   * The repository to sync.
+   *
+   * Will try to detect the repository from the current working directory or the `package.json` file.
+   */
+  repo?: string;
+  /**
+   * The directory to store the synced issues and pull requests.
+   *
+   * @default '.ghfs'
+   */
+  directory?: string;
+  /**
+   * The authentication configuration.
+   */
+  auth?: {
+    /**
+     * The GitHub personal access token to use for authentication.
+     *
+     * When not provided, will try to get the token from `gh auth token` or the environment variables `GH_TOKEN` or `GITHUB_TOKEN`.
+     */
+    token?: string;
+  };
+  sync?: {
+    /**
+     * Whether to sync issues.
+     *
+     * @default true
+     */
+    issues?: boolean;
+    /**
+     * Whether to sync pull requests.
+     *
+     * @default true
+     */
+    pulls?: boolean;
+    /**
+     * When to sync closed issues and pull requests.
+     *
+     * - `true`: sync all closed issues and pull requests.
+     * - `false`: don't sync any closed issues and pull requests. And delete any existing closed issues and pull requests from the local filesystem.
+     *
+     * @default false
+     */
+    closed?: boolean;
+    /**
+     * When to download the pull request patch files.
+     *
+     * - `'open'`: only download open pull request patch files.
+     * - `'all'`: download all pull request patch files.
+     * - `false`: don't download any pull request patch files.
+     *
+     * @default 'open'
+     */
+    patches?: 'open' | 'all' | false;
+  };
+}
+type GhfsResolvedConfig = Required<GhfsUserConfig> & {
+  cwd: string;
+  auth: Required<GhfsUserConfig['auth']>;
+  sync: Required<GhfsUserConfig['sync']>;
+};
+//#endregion
+//#region src/types/issue.d.ts
+type IssueKind = 'issue' | 'pull';
+type IssueState = 'open' | 'closed';
+//#endregion
+//#region src/types/provider.d.ts
+interface ProviderReactions {
+  totalCount: number;
+  plusOne: number;
+  minusOne: number;
+  laugh: number;
+  hooray: number;
+  confused: number;
+  heart: number;
+  rocket: number;
+  eyes: number;
+}
+type IssueStateReason = 'completed' | 'not_planned' | 'reopened';
+interface ProviderItem {
+  number: number;
+  kind: IssueKind;
+  url?: string;
+  state: IssueState;
+  stateReason?: IssueStateReason | null;
+  updatedAt: string;
+  createdAt: string;
+  closedAt: string | null;
+  title: string;
+  body: string | null;
+  author: string | null;
+  labels: string[];
+  assignees: string[];
+  milestone: string | null;
+  reactions?: ProviderReactions;
+}
+interface ProviderComment {
+  id: number;
+  body: string | null;
+  createdAt: string;
+  updatedAt: string;
+  author: string | null;
+  reactions?: ProviderReactions;
+}
+interface ProviderPullMetadata {
+  isDraft: boolean;
+  merged: boolean;
+  mergedAt: string | null;
+  baseRef: string;
+  headRef: string;
+  requestedReviewers: string[];
+}
+interface ProviderCommit {
+  sha: string;
+  message: string;
+  authorLogin: string | null;
+  authorName: string | null;
+  authorDate: string;
+  committerLogin: string | null;
+  committerDate: string;
+  url?: string;
+}
+type ProviderTimelineEventKind = 'committed' | 'closed' | 'reopened' | 'merged' | 'labeled' | 'unlabeled' | 'assigned' | 'unassigned' | 'review_requested' | 'review_request_removed' | 'reviewed' | 'commented' | 'renamed' | 'head_ref_force_pushed' | 'head_ref_deleted' | 'head_ref_restored' | 'locked' | 'unlocked' | 'ready_for_review' | 'convert_to_draft' | 'referenced' | 'cross-referenced' | 'unknown';
+type ProviderReviewState = 'approved' | 'changes_requested' | 'commented' | 'dismissed' | 'pending';
+interface ProviderTimelineEvent {
+  id: string;
+  kind: ProviderTimelineEventKind;
+  createdAt: string;
+  actor: string | null;
+  sha?: string;
+  commitMessage?: string;
+  label?: {
+    name: string;
+    color: string;
+  };
+  assignee?: string;
+  requestedReviewer?: string;
+  review?: {
+    state: ProviderReviewState;
+    body: string | null;
+    submittedAt: string;
+  };
+  commentId?: number;
+  body?: string | null;
+  rename?: {
+    from: string;
+    to: string;
+  };
+  stateReason?: string | null;
+}
+interface ProviderRepository {
+  name: string;
+  full_name: string;
+  description: string | null;
+  private: boolean;
+  archived: boolean;
+  default_branch: string;
+  html_url: string;
+  fork: boolean;
+  open_issues_count: number;
+  has_issues: boolean;
+  has_projects: boolean;
+  has_wiki: boolean;
+  created_at: string;
+  updated_at: string;
+  pushed_at: string | null;
+  owner: {
+    login: string;
+  };
+}
+interface ProviderLabel {
+  name: string;
+  color: string;
+  description: string | null;
+  default: boolean;
+}
+interface ProviderAuthenticatedUser {
+  login: string;
+  name: string | null;
+  avatarUrl: string;
+}
+interface ProviderMilestone {
+  number: number;
+  title: string;
+  state: 'open' | 'closed';
+  description: string | null;
+  due_on: string | null;
+  open_issues: number;
+  closed_issues: number;
+  created_at: string;
+  updated_at: string;
+  closed_at: string | null;
+}
+interface ProviderItemSnapshot {
+  number: number;
+  kind: IssueKind;
+  updatedAt: string | null;
+}
+interface ProviderUpdateCounts {
+  issues: number;
+  pulls: number;
+}
+type ProviderLockReason = 'resolved' | 'off-topic' | 'too heated' | 'too-heated' | 'spam';
+interface PaginateItemsOptions {
+  state: IssueState | 'all';
+  since?: string;
+}
+interface RepositoryProvider {
+  paginateItems: (options: PaginateItemsOptions) => AsyncIterable<ProviderItem[]>;
+  fetchItems: (options: PaginateItemsOptions) => Promise<ProviderItem[]>;
+  eachItem: (options: PaginateItemsOptions) => AsyncIterable<ProviderItem>;
+  fetchItemsByNumbers: (numbers: number[]) => Promise<ProviderItem[]>;
+  fetchComments: (number: number) => Promise<ProviderComment[]>;
+  fetchPullMetadata: (number: number) => Promise<ProviderPullMetadata>;
+  fetchPullPatch: (number: number) => Promise<string>;
+  fetchPullCommits: (number: number) => Promise<ProviderCommit[]>;
+  fetchTimeline: (number: number) => Promise<ProviderTimelineEvent[]>;
+  fetchItemSnapshot: (number: number) => Promise<ProviderItemSnapshot>;
+  fetchRepository: () => Promise<ProviderRepository>;
+  fetchRepositoryLabels: () => Promise<ProviderLabel[]>;
+  fetchRepositoryMilestones: () => Promise<ProviderMilestone[]>;
+  fetchAuthenticatedUser: () => Promise<ProviderAuthenticatedUser | null>;
+  countUpdatedSince: (since: string) => Promise<ProviderUpdateCounts>;
+  getRequestCount: () => number;
+  actionClose: (number: number) => Promise<void>;
+  actionReopen: (number: number) => Promise<void>;
+  actionSetTitle: (number: number, title: string) => Promise<void>;
+  actionSetBody: (number: number, body: string) => Promise<void>;
+  actionAddComment: (number: number, body: string) => Promise<void>;
+  actionAddLabels: (number: number, labels: string[]) => Promise<void>;
+  actionRemoveLabels: (number: number, labels: string[]) => Promise<void>;
+  actionSetLabels: (number: number, labels: string[]) => Promise<void>;
+  actionAddAssignees: (number: number, assignees: string[]) => Promise<void>;
+  actionRemoveAssignees: (number: number, assignees: string[]) => Promise<void>;
+  actionSetAssignees: (number: number, assignees: string[]) => Promise<void>;
+  actionSetMilestone: (number: number, milestone: string | number) => Promise<void>;
+  actionClearMilestone: (number: number) => Promise<void>;
+  actionLock: (number: number, reason?: ProviderLockReason) => Promise<void>;
+  actionUnlock: (number: number) => Promise<void>;
+  actionRequestReviewers: (number: number, reviewers: string[]) => Promise<void>;
+  actionRemoveReviewers: (number: number, reviewers: string[]) => Promise<void>;
+  actionMarkReadyForReview: (number: number) => Promise<void>;
+  actionConvertToDraft: (number: number) => Promise<void>;
+}
+//#endregion
+export { ProviderItemSnapshot as a, ProviderTimelineEvent as c, IssueState as d, GhfsResolvedConfig as f, ProviderItem as i, RepositoryProvider as l, ProviderComment as n, ProviderLockReason as o, GhfsUserConfig as p, ProviderCommit as r, ProviderPullMetadata as s, PaginateItemsOptions as t, IssueKind as u };

package/dist/server/index.d.mts

@@ -0,0 +1,330 @@
+import { c as ProviderTimelineEvent, d as IssueState, f as GhfsResolvedConfig, i as ProviderItem, n as ProviderComment, r as ProviderCommit, s as ProviderPullMetadata, u as IssueKind } from "../provider-DCIsHVeA.mjs";
+
+//#region src/types/execution.d.ts
+interface ExecutionResult {
+  runId: string;
+  createdAt: string;
+  mode: 'report' | 'apply';
+  repo: string;
+  applied: number;
+  planned: number;
+  failed: number;
+  details: Array<{
+    op: number;
+    action: string;
+    number: number;
+    target?: IssueKind;
+    status: 'planned' | 'applied' | 'failed' | 'skipped';
+    message: string;
+  }>;
+}
+//#endregion
+//#region src/types/sync-state.d.ts
+type SyncRunStage = 'metadata' | 'pagination' | 'fetch' | 'materialize' | 'prune' | 'save';
+interface SyncRunCounters {
+  scanned: number;
+  selected: number;
+  processed: number;
+  skipped: number;
+  written: number;
+  moved: number;
+  patchesWritten: number;
+  patchesDeleted: number;
+}
+interface SyncRunTelemetry {
+  runId: string;
+  repo: string;
+  startedAt: string;
+  finishedAt: string;
+  durationMs: number;
+  requestCount: number;
+  since?: string;
+  numbersCount?: number;
+  counters: SyncRunCounters;
+  stages: Record<SyncRunStage, number>;
+}
+interface SyncItemCanonicalData {
+  item: ProviderItem;
+  comments: ProviderComment[];
+  pull?: ProviderPullMetadata;
+  commits?: ProviderCommit[];
+  timeline?: ProviderTimelineEvent[];
+}
+interface SyncItemState {
+  number: number;
+  kind: IssueKind;
+  state: IssueState;
+  lastUpdatedAt: string;
+  lastSyncedAt: string;
+  filePath: string;
+  patchPath?: string;
+  data: SyncItemCanonicalData;
+}
+interface SyncState {
+  version: 2;
+  ghfsVersion?: string;
+  repo?: string;
+  lastSyncedAt?: string;
+  lastSince?: string;
+  lastRepoUpdatedAt?: string;
+  lastSyncRun?: SyncRunTelemetry;
+  items: Record<string, SyncItemState>;
+  executions: ExecutionResult[];
+}
+//#endregion
+//#region src/execute/actions.d.ts
+declare const ACTIONS_SUPPORTED: readonly ["close", "close-with-comment", "reopen", "set-title", "set-body", "add-comment", "add-labels", "remove-labels", "set-labels", "add-assignees", "remove-assignees", "set-assignees", "set-milestone", "clear-milestone", "lock", "unlock", "request-reviewers", "remove-reviewers", "mark-ready-for-review", "convert-to-draft"];
+type ActionName = typeof ACTIONS_SUPPORTED[number];
+//#endregion
+//#region src/execute/types.d.ts
+interface PendingOpBase {
+  number: number;
+  action: ActionName;
+  ifUnchangedSince?: string;
+}
+interface PendingTitleOp extends PendingOpBase {
+  action: 'set-title';
+  title: string;
+}
+interface PendingBodyOp extends PendingOpBase {
+  action: 'set-body';
+  body: string;
+}
+interface PendingCommentOp extends PendingOpBase {
+  action: 'add-comment' | 'close-with-comment';
+  body: string;
+}
+interface PendingLabelsOp extends PendingOpBase {
+  action: 'add-labels' | 'remove-labels' | 'set-labels';
+  labels: string[];
+}
+interface PendingAssigneesOp extends PendingOpBase {
+  action: 'add-assignees' | 'remove-assignees' | 'set-assignees';
+  assignees: string[];
+}
+interface PendingSetMilestoneOp extends PendingOpBase {
+  action: 'set-milestone';
+  milestone: string | number;
+}
+interface PendingLockOp extends PendingOpBase {
+  action: 'lock';
+  reason?: 'resolved' | 'off-topic' | 'too heated' | 'too-heated' | 'spam';
+}
+interface PendingReviewersOp extends PendingOpBase {
+  action: 'request-reviewers' | 'remove-reviewers';
+  reviewers: string[];
+}
+interface PendingSimpleOp extends PendingOpBase {
+  action: 'close' | 'reopen' | 'clear-milestone' | 'unlock' | 'mark-ready-for-review' | 'convert-to-draft';
+}
+type PendingOp = PendingSimpleOp | PendingTitleOp | PendingBodyOp | PendingCommentOp | PendingLabelsOp | PendingAssigneesOp | PendingSetMilestoneOp | PendingLockOp | PendingReviewersOp;
+//#endregion
+//#region src/sync/contracts.d.ts
+type SyncStage = 'metadata' | 'pagination' | 'fetch' | 'materialize' | 'prune' | 'save';
+interface SyncProgressSnapshot {
+  scanned: number;
+  selected: number;
+  processed: number;
+  skipped: number;
+  written: number;
+  moved: number;
+  patchesWritten: number;
+  patchesDeleted: number;
+}
+interface SyncSummary {
+  repo: string;
+  since?: string;
+  syncedAt: string;
+  totalIssues: number;
+  totalPulls: number;
+  updatedIssues: number;
+  updatedPulls: number;
+  trackedItems: number;
+  requestCount: number;
+  selected: number;
+  processed: number;
+  skipped: number;
+  scanned: number;
+  written: number;
+  moved: number;
+  patchesWritten: number;
+  patchesDeleted: number;
+  durationMs: number;
+}
+//#endregion
+//#region src/server/ui-state.d.ts
+type PrTabId = 'conversation' | 'commits' | 'changes';
+interface UserOverride {
+  login?: string;
+  name?: string;
+  avatarUrl?: string;
+}
+interface UiState {
+  /** Map of issue number (string) → pending comment draft body. */
+  drafts: Record<string, string>;
+  /** Size (in percent) of the list pane in the Splitpanes layout. */
+  listPaneSize?: number;
+  /** Last tab selected on the PR detail panel. */
+  lastPrTab?: PrTabId;
+  /** Override for the authenticated user info shown in the UI. */
+  userOverride?: UserOverride;
+}
+//#endregion
+//#region src/server/types.d.ts
+interface CurrentUser {
+  login: string;
+  name: string | null;
+  avatarUrl: string;
+}
+type QueueSource = 'execute.yml' | 'execute.md' | 'per-item';
+interface QueueEntry {
+  /** Stable id derived from source+index+action+number; survives refreshes. */
+  id: string;
+  source: QueueSource;
+  /** Index within its source list (ymlOps concat execute.md ops concat per-item ops). */
+  index: number;
+  op: PendingOp;
+  /** Relative file path under the storage directory, for per-item entries. */
+  filePath?: string;
+}
+interface QueueState {
+  entries: QueueEntry[];
+  warnings: string[];
+  /** Total queued ops; drives the ↑ counter. */
+  upCount: number;
+}
+interface RemoteStatus {
+  /** Items updated on GitHub since lastSyncedAt; drives the ↓ counter. */
+  downCount: number;
+  /** ISO timestamp of the last poll (success or failure). */
+  checkedAt: string;
+  /** True if poll was never run, failed, or no token is available. */
+  stale: boolean;
+  /** Optional message explaining stale state (e.g. "Missing token"). */
+  message?: string;
+}
+interface RepoMeta {
+  repo: string;
+  storageDir: string;
+  ghfsVersion: string;
+  lastSyncedAt?: string;
+  lastSince?: string;
+  hasToken: boolean;
+}
+interface RepoLabel {
+  name: string;
+  color: string;
+  description: string | null;
+}
+interface InitialPayload {
+  repo: RepoMeta;
+  syncState: SyncState;
+  queue: QueueState;
+  remote: RemoteStatus;
+  recentExecutions: ExecutionResult[];
+  uiState: UiState;
+  repositoryLabels: RepoLabel[];
+  currentUser: CurrentUser | null;
+}
+interface SyncTriggerOptions {
+  full?: boolean;
+  since?: string;
+  numbers?: number[];
+}
+interface ExecuteTriggerOptions {
+  entryIds?: string[];
+  continueOnError?: boolean;
+}
+interface SyncProgressPayload {
+  stage: SyncStage;
+  message?: string;
+  snapshot: SyncProgressSnapshot;
+}
+interface ExecuteProgressPayload {
+  completed: number;
+  planned: number;
+  applied: number;
+  failed: number;
+  detail: ExecutionResult['details'][number];
+}
+interface ServerFunctions {
+  getInitialPayload: () => Promise<InitialPayload>;
+  getSyncState: () => Promise<SyncState>;
+  getQueue: () => Promise<QueueState>;
+  getRepoMeta: () => Promise<RepoMeta>;
+  triggerSync: (options: SyncTriggerOptions) => Promise<SyncSummary>;
+  executeQueue: (options: ExecuteTriggerOptions) => Promise<ExecutionResult>;
+  addQueueOp: (op: PendingOp) => Promise<QueueState>;
+  updateQueueOp: (id: string, op: PendingOp) => Promise<QueueState>;
+  removeQueueOp: (id: string) => Promise<QueueState>;
+  clearQueue: () => Promise<QueueState>;
+  checkRemote: () => Promise<RemoteStatus>;
+  openInEditor: (filePath: string) => Promise<void>;
+  saveUiState: (state: UiState) => Promise<void>;
+  getPullPatch: (number: number) => Promise<string | null>;
+}
+interface ClientFunctions {
+  onSyncStageStart: (payload: {
+    stage: SyncStage;
+    message: string;
+  }) => void;
+  onSyncProgress: (payload: SyncProgressPayload) => void;
+  onSyncStageEnd: (payload: {
+    stage: SyncStage;
+    durationMs: number;
+  }) => void;
+  onSyncComplete: (summary: SyncSummary) => void;
+  onSyncError: (message: string) => void;
+  onExecuteStart: (payload: {
+    planned: number;
+  }) => void;
+  onExecuteProgress: (payload: ExecuteProgressPayload) => void;
+  onExecuteComplete: (result: ExecutionResult) => void;
+  onExecuteError: (message: string) => void;
+  onSyncStateChange: (state: SyncState) => void;
+  onQueueChange: (queue: QueueState) => void;
+  onRemoteStatusChange: (status: RemoteStatus) => void;
+}
+//#endregion
+//#region src/server/index.d.ts
+interface UiServerLogger {
+  info?: (message: string) => void;
+  warn?: (message: string) => void;
+}
+interface PortlessServerOptions {
+  enabled: boolean;
+  subdomain: string;
+  namespace?: string;
+}
+interface CreateUiServerOptions {
+  config: GhfsResolvedConfig;
+  repo: string;
+  initialToken?: string;
+  port: number;
+  host: string;
+  onRequestToken?: () => Promise<string>;
+  /** Override the directory serving the prebuilt Nuxt SPA. */
+  staticDir?: string;
+  /** When true, skip serving static assets (dev proxies to Nuxt dev server). */
+  devMode?: boolean;
+  /** Poller tick interval; default 60_000. */
+  pollerIntervalMs?: number;
+  /** When provided and enabled, expose the UI through portless at https://<subdomain>.<namespace>.localhost. */
+  portless?: PortlessServerOptions;
+  /** Logger for non-fatal notices (e.g. portless fallback). */
+  logger?: UiServerLogger;
+}
+interface UiServerHandle {
+  /** The preferred URL to open — the portless URL when available, otherwise the direct URL. */
+  url: string;
+  /** The raw `http://host:port` URL, always available. */
+  directUrl: string;
+  /** The portless URL when the reverse proxy was set up successfully. */
+  portlessUrl?: string;
+  port: number;
+  host: string;
+  close: () => Promise<void>;
+}
+declare function createUiServer(options: CreateUiServerOptions): Promise<UiServerHandle>;
+//#endregion
+export { type ClientFunctions, CreateUiServerOptions, type InitialPayload, PortlessServerOptions, type QueueEntry, type QueueState, type RemoteStatus, type RepoMeta, type ServerFunctions, UiServerHandle, UiServerLogger, createUiServer };

package/dist/server/index.mjs

@@ -0,0 +1,2 @@
+import { t as createUiServer } from "../server-BwSU4kqr.mjs";
+export { createUiServer };