gitforest 0.1.0

package/src/state/store.tsx

@@ -0,0 +1,216 @@
+import React, { createContext, useContext, useReducer, type ReactNode } from "react";
+import type { 
+  AppState, 
+  QuickFilter,
+  UnifiedAppState,
+  UnifiedAppAction,
+  UnifiedRepo
+} from "../types/index.ts";
+import { filterProjects, sortProjects } from "../utils/project-utils.ts";
+import { filterByViewMode, filterUnifiedRepos, sortUnifiedRepos } from "../github/unified.ts";
+import { appReducer, initialState } from "./reducer.ts";
+
+/**
+ * Store context
+ */
+interface StoreContextValue {
+  state: UnifiedAppState;
+  dispatch: React.Dispatch<UnifiedAppAction>;
+}
+
+export const StoreContext = createContext<StoreContextValue | null>(null);
+
+/**
+ * Store provider component
+ */
+export function StoreProvider({ children }: { children: ReactNode }) {
+  const [state, dispatch] = useReducer(appReducer, initialState);
+
+  return (
+    <StoreContext.Provider value={{ state, dispatch }}>
+      {children}
+    </StoreContext.Provider>
+  );
+}
+
+/**
+ * Test store provider - accepts initial state and optional mock dispatch
+ * Used for testing components without mock.module()
+ */
+export function TestStoreProvider({
+  children,
+  initialState: testInitialState,
+  dispatch: mockDispatch,
+}: {
+  children: ReactNode;
+  initialState: UnifiedAppState;
+  dispatch?: React.Dispatch<UnifiedAppAction>;
+}) {
+  const [state, realDispatch] = useReducer(appReducer, testInitialState);
+  const dispatch = mockDispatch ?? realDispatch;
+
+  return (
+    <StoreContext.Provider value={{ state, dispatch }}>
+      {children}
+    </StoreContext.Provider>
+  );
+}
+
+/**
+ * Hook to access the store
+ */
+export function useStore(): StoreContextValue {
+  const context = useContext(StoreContext);
+  if (!context) {
+    throw new Error("useStore must be used within a StoreProvider");
+  }
+  return context;
+}
+
+/**
+ * Apply quick filter to projects
+ */
+function applyQuickFilter(projects: AppState["projects"], quickFilter: QuickFilter) {
+  if (quickFilter === "all") return projects;
+
+  return projects.filter((p) => {
+    switch (quickFilter) {
+      case "dirty":
+        return p.status?.isDirty;
+      case "unpushed":
+        return p.status?.isAhead && p.status?.unpushedCommits > 0;
+      case "no-remote":
+        return p.type === "git" && !p.status?.hasRemote;
+      default:
+        return true;
+    }
+  });
+}
+
+/**
+ * Hook to get filtered and sorted projects
+ */
+export function useFilteredProjects() {
+  const { state } = useStore();
+  const { projects, filterText, quickFilter, sortBy, sortDirection } = state;
+
+  let result = projects;
+
+  // Apply quick filter first
+  result = applyQuickFilter(result, quickFilter);
+
+  // Apply text filter
+  if (filterText) {
+    result = filterProjects(result, filterText);
+  }
+
+  // Apply sort
+  result = sortProjects(result, sortBy, sortDirection);
+
+  return result;
+}
+
+/**
+ * Hook to get selected projects
+ */
+export function useSelectedProjects() {
+  const { state } = useStore();
+  const filteredProjects = useFilteredProjects();
+  const { selectedIndices, cursorIndex } = state;
+
+  // If nothing selected, return the project at cursor
+  if (selectedIndices.size === 0) {
+    const current = filteredProjects[cursorIndex];
+    return current ? [current] : [];
+  }
+
+  // Return selected projects (filter out undefined and properly type)
+  return [...selectedIndices]
+    .map((i) => filteredProjects[i])
+    .filter((p): p is NonNullable<typeof p> => p !== undefined);
+}
+
+/**
+ * Apply quick filter to unified repos
+ */
+function applyQuickFilterToUnifiedRepos(repos: UnifiedRepo[], quickFilter: QuickFilter) {
+  if (quickFilter === "all") return repos;
+
+  return repos.filter((r) => {
+    switch (quickFilter) {
+      case "dirty":
+        return r.local?.status?.isDirty;
+      case "unpushed":
+        return r.local?.status?.isAhead && r.local?.status?.unpushedCommits > 0;
+      case "no-remote":
+        return r.local?.type === "git" && !r.local?.status?.hasRemote;
+      case "github-only":
+        return r.source === "github";
+      case "local-only":
+        return r.source === "local" || r.source === "both";
+      case "private":
+        return r.github?.isPrivate === true;
+      case "public":
+        return r.github?.isPrivate === false;
+      case "archived":
+        return r.github?.isArchived === true;
+      case "forks":
+        return r.github?.isFork === true;
+      default:
+        return true;
+    }
+  });
+}
+
+/**
+ * Hook to get filtered and sorted unified repos
+ */
+export function useFilteredUnifiedRepos() {
+  const { state } = useStore();
+  const { unifiedRepos, viewMode, filterText, quickFilter, sortBy, sortDirection, languageFilter } = state;
+
+  let result = unifiedRepos;
+
+  // Apply view mode filter first
+  result = filterByViewMode(result, viewMode);
+
+  // Apply quick filter
+  result = applyQuickFilterToUnifiedRepos(result, quickFilter);
+
+  // Apply text filter
+  if (filterText) {
+    result = filterUnifiedRepos(result, filterText);
+  }
+
+  // Apply language filter
+  if (languageFilter) {
+    result = result.filter(r => 
+      r.github?.language?.toLowerCase() === languageFilter.toLowerCase()
+    );
+  }
+
+  // Apply sort
+  result = sortUnifiedRepos(result, sortBy, sortDirection);
+
+  return result;
+}
+
+/**
+ * Hook to get selected unified repos
+ */
+export function useSelectedUnifiedRepos() {
+  const { state } = useStore();
+  const filteredRepos = useFilteredUnifiedRepos();
+  const { selectedIndices, cursorIndex } = state;
+
+  // If nothing selected, return the repo at cursor
+  if (selectedIndices.size === 0) {
+    const current = filteredRepos[cursorIndex];
+    return current ? [current] : [];
+  }
+
+  // Return selected repos (filter out undefined and properly type)
+  return [...selectedIndices]
+    .map((i) => filteredRepos[i])
+    .filter((r): r is NonNullable<typeof r> => r !== undefined);
+}

package/src/state/types.ts

@@ -0,0 +1,8 @@
+// Re-export state types from main types file
+export type {
+  AppState,
+  AppAction,
+  AppMode,
+  SortField,
+  SortDirection,
+} from "../types/index.ts";

package/src/types/index.ts

@@ -0,0 +1,383 @@
+import { z } from "zod";
+
+// ============================================================================
+// Configuration Types
+// ============================================================================
+
+export const DirectoryConfigSchema = z.object({
+  path: z.string().min(1),
+  maxDepth: z.number().int().min(0).max(10).default(2),
+  label: z.string().optional(),
+  editor: z.string().optional(),
+});
+
+// Reserved keys that cannot be used for custom commands
+export const RESERVED_KEYS = new Set([
+  // Navigation
+  "j", "k", "g", "G",
+  // Selection
+  " ", "a",
+  // View/Filter
+  "/", "s", "S", "F",
+  "0", "1", "2", "3", "4", "5", "6", "7", "8", "9",
+  // Git operations
+  "p", "P", "f", "i",
+  // GitHub operations
+  "c", "C", "A", "D",
+  // General
+  "r", "?", "q",
+  // Modal actions (used in detail modal)
+  "o", "d",
+  // Command palette trigger
+  "x",
+]);
+
+export const CommandConfigSchema = z.object({
+  name: z.string().min(1),
+  key: z.string().length(1).refine(
+    (key) => !RESERVED_KEYS.has(key),
+    (key) => ({ message: `Key '${key}' is reserved and cannot be used for custom commands` })
+  ),
+  command: z.string().min(1),
+  confirm: z.boolean().default(false),
+  background: z.boolean().default(false),
+});
+
+export type CommandConfig = z.infer<typeof CommandConfigSchema>;
+
+export const GitforestConfigSchema = z.object({
+  directories: z.array(DirectoryConfigSchema).min(1),
+  editor: z.string().optional(), // Global editor setting
+  scan: z
+    .object({
+      ignore: z
+        .array(z.string())
+        .default(["node_modules", ".git", "vendor", "__pycache__", "target", "dist", "build"]),
+      includeHidden: z.boolean().default(false),
+      concurrency: z.number().int().min(1).max(20).default(5),
+    })
+    .default({}),
+  github: z
+    .object({
+      defaultVisibility: z.enum(["private", "public"]).default("private"),
+    })
+    .default({}),
+  display: z
+    .object({
+      showSubmodules: z.boolean().default(true),
+      showNonGitProjects: z.boolean().default(true),  // Show non-git projects (folders with project markers but no .git)
+      sortBy: z.enum(["status", "name", "branch", "sync", "language", "stars", "forks", "lastActivity", "size"]).default("status"),
+      sortDirection: z.enum(["asc", "desc"]).default("desc"),
+    })
+    .default({}),
+  cache: z
+    .object({
+      ttlSeconds: z.number().int().positive().default(300),
+      githubTtlSeconds: z.number().int().positive().default(600),
+      enableBackgroundRefresh: z.boolean().default(true),
+      backgroundRefreshIntervalSeconds: z.number().int().positive().default(300),
+    })
+    .default({}),
+  commands: z
+    .array(CommandConfigSchema)
+    .default([])
+    .refine(
+      (commands) => {
+        const keys = commands.map((c) => c.key);
+        return new Set(keys).size === keys.length;
+      },
+      { message: "Duplicate command keys are not allowed" }
+    ),
+});
+
+export type DirectoryConfig = z.infer<typeof DirectoryConfigSchema>;
+export type GitforestConfig = z.infer<typeof GitforestConfigSchema>;
+
+// ============================================================================
+// Project Types
+// ============================================================================
+
+export type ProjectType = "git" | "git-submodule" | "non-git";
+
+export interface SubmoduleInfo {
+  parentPath: string;
+  relativePath: string;
+  configuredCommit: string;
+  currentCommit: string;
+  isInitialized: boolean;
+}
+
+export interface GitStatus {
+  // Working tree status
+  hasUnstagedChanges: boolean;
+  hasStagedChanges: boolean;
+  hasUntrackedFiles: boolean;
+  modifiedCount: number;
+  stagedCount: number;
+  untrackedCount: number;
+
+  // Sync status
+  currentBranch: string;
+  trackingBranch: string | null;
+  unpushedCommits: number;
+  unpulledCommits: number;
+
+  // Remote info
+  hasRemote: boolean;
+  remoteUrl: string | null;
+
+  // Activity timestamps
+  lastLocalCommit: Date | null;
+  lastRemoteActivity: Date | null;
+
+  // Repository state
+  hasCommits: boolean;
+
+  // Computed flags
+  isDirty: boolean;
+  isAhead: boolean;
+  isBehind: boolean;
+  isOutOfSync: boolean;
+}
+
+export interface Project {
+  id: string;
+  name: string;
+  path: string;
+  type: ProjectType;
+  projectMarker: string | null; // e.g., "package.json", "Cargo.toml"
+  status: GitStatus | null;
+  submodule: SubmoduleInfo | null;
+  lastScanned: Date;
+  lastModified: Date | null; // For non-git: most recent file modification time
+}
+
+// ============================================================================
+// Project Markers
+// ============================================================================
+
+export const PROJECT_MARKERS: Record<string, string> = {
+  "package.json": "Node.js",
+  "Cargo.toml": "Rust",
+  "pyproject.toml": "Python",
+  "setup.py": "Python",
+  "go.mod": "Go",
+  "Gemfile": "Ruby",
+  "pom.xml": "Java (Maven)",
+  "build.gradle": "Java (Gradle)",
+  "composer.json": "PHP",
+  "mix.exs": "Elixir",
+  "pubspec.yaml": "Dart/Flutter",
+  "CMakeLists.txt": "C/C++",
+  "Makefile": "Make",
+  "flake.nix": "Nix",
+  "deno.json": "Deno",
+  "bun.lockb": "Bun",
+};
+
+// ============================================================================
+// App State Types
+// ============================================================================
+
+export type SortField =
+  | "status"
+  | "name"
+  | "branch"
+  | "sync"
+  | "language"
+  | "stars"
+  | "forks"
+  | "lastActivity"
+  | "size";
+export type SortDirection = "asc" | "desc";
+export type AppMode = "normal" | "filter" | "action" | "help" | "confirm" | "clone" | "detail" | "filter-options" | "command-palette";
+
+// Quick filter for status-based filtering (1=dirty, 2=unpushed, 3=no-remote, 0=all)
+export type QuickFilter =
+  | "all" | "dirty" | "unpushed" | "no-remote"
+  | "github-only" | "local-only"
+  | "private" | "public" | "archived" | "forks";
+
+export interface ConfirmDialogState {
+  operation: "setup" | "create" | "archive";
+  title: string;
+  message: string;
+  items: string[];
+  projectPaths: string[];
+  showVisibilityToggle: boolean;
+}
+
+export interface CloneDialogState {
+  repos: UnifiedRepo[];
+  directories: DirectoryConfig[];
+  selectedDirIndex: number;
+  useSSH: boolean;
+}
+
+export interface DetailModalState {
+  repo: UnifiedRepo;
+  readmeContent: string | null;
+  readmeLoading: boolean;
+  readmeError: string | null;
+  readmeScrollOffset: number;
+}
+
+export interface AppState {
+  // Data
+  projects: Project[];
+  isLoading: boolean;
+  error: string | null;
+  message: string | null;
+
+  // Selection
+  cursorIndex: number;
+  selectedIndices: Set<number>;
+  scrollOffset: number;
+
+  // Filtering & Sorting
+  filterText: string;
+  quickFilter: QuickFilter;
+  sortBy: SortField;
+  sortDirection: SortDirection;
+
+  // UI state
+  mode: AppMode;
+  actionInProgress: string | null;
+  actionProgress: { current: number; total: number } | null;
+  confirmDialog: ConfirmDialogState | null;
+}
+
+export type AppAction =
+  | { type: "SET_PROJECTS"; payload: Project[] }
+  | { type: "SET_LOADING"; payload: boolean }
+  | { type: "SET_ERROR"; payload: string | null }
+  | { type: "SET_MESSAGE"; payload: string | null }
+  | { type: "MOVE_CURSOR"; payload: number }
+  | { type: "TOGGLE_SELECTION"; payload: number }
+  | { type: "SELECT_ALL" }
+  | { type: "DESELECT_ALL" }
+  | { type: "SET_FILTER"; payload: string }
+  | { type: "SET_QUICK_FILTER"; payload: QuickFilter }
+  | { type: "SET_SORT"; payload: { by: SortField; direction: SortDirection } }
+  | { type: "CYCLE_SORT" }
+  | { type: "SET_MODE"; payload: AppMode }
+  | { type: "START_ACTION"; payload: string }
+  | { type: "END_ACTION" }
+  | { type: "UPDATE_PROGRESS"; payload: { current: number; total: number } }
+  | { type: "SET_SCROLL_OFFSET"; payload: number }
+  | { type: "UPDATE_PROJECT"; payload: { id: string; updates: Partial<Project> } }
+  | { type: "SHOW_CONFIRM_DIALOG"; payload: ConfirmDialogState }
+  | { type: "HIDE_CONFIRM_DIALOG" };
+
+// ============================================================================
+// Operation Results
+// ============================================================================
+
+export interface OperationResult {
+  success: boolean;
+  projectPath: string;
+  operation: string;
+  message?: string;
+  error?: string;
+  duration: number;
+}
+
+export interface BatchResult {
+  total: number;
+  successful: number;
+  failed: number;
+  results: OperationResult[];
+  duration: number;
+}
+
+// ============================================================================
+// GitHub Types
+// ============================================================================
+
+export interface GitHubRepoInfo {
+  name: string;
+  fullName: string;
+  owner: string;
+  description: string | null;
+  htmlUrl: string;
+  sshUrl: string;
+  cloneUrl: string;
+  isPrivate: boolean;
+  isArchived: boolean;
+  isFork: boolean;
+  pushedAt: Date | null;
+  updatedAt: Date | null;
+  defaultBranch: string;
+  language: string | null;
+  size: number;
+  stargazersCount?: number;
+  forksCount?: number;
+  openIssuesCount?: number;
+  watchersCount?: number;
+  topics?: string[];
+  license?: string | null;
+  hasIssues?: boolean;
+  hasWiki?: boolean;
+  hasDiscussions?: boolean;
+}
+
+// ============================================================================
+// Unified View Types (Local + GitHub)
+// ============================================================================
+
+export type ViewMode = "local" | "github" | "combined";
+export type RepoSource = "local" | "github" | "both";
+
+/**
+ * Unified item that can represent:
+ * - A local project (may or may not be on GitHub)
+ * - A GitHub repo (may or may not be cloned locally)
+ */
+export interface UnifiedRepo {
+  id: string;
+  name: string;
+  source: RepoSource;
+
+  // Local project info (if exists locally)
+  local: Project | null;
+
+  // GitHub repo info (if exists on GitHub)
+  github: GitHubRepoInfo | null;
+
+  // Sync status between local and GitHub
+  isCloned: boolean;
+  isOnGitHub: boolean;
+  localPath: string | null;
+}
+
+// Extended AppState for unified view
+export interface UnifiedAppState extends AppState {
+  viewMode: ViewMode;
+  githubRepos: GitHubRepoInfo[];
+  unifiedRepos: UnifiedRepo[];
+  isLoadingGitHub: boolean;
+  githubError: string | null;
+  isRefreshing: boolean;  // Background refresh indicator
+  cloneDialog: CloneDialogState | null;
+  detailModal: DetailModalState | null;
+  languageFilter: string | null;
+}
+
+export type UnifiedAppAction =
+  | AppAction
+  | { type: "SET_VIEW_MODE"; payload: ViewMode }
+  | { type: "SET_GITHUB_REPOS"; payload: GitHubRepoInfo[] }
+  | { type: "SET_UNIFIED_REPOS"; payload: UnifiedRepo[] }
+  | { type: "SET_GITHUB_LOADING"; payload: boolean }
+  | { type: "SET_GITHUB_ERROR"; payload: string | null }
+  | { type: "SET_REFRESHING"; payload: boolean }
+  | { type: "SHOW_CLONE_DIALOG"; payload: CloneDialogState }
+  | { type: "HIDE_CLONE_DIALOG" }
+  | { type: "UPDATE_CLONE_DIALOG"; payload: Partial<CloneDialogState> }
+  | { type: "CLONE_REPO_START"; payload: string }
+  | { type: "CLONE_REPO_COMPLETE"; payload: { id: string; localPath: string } }
+  | { type: "CLONE_REPO_FAILED"; payload: { id: string; error: string } }
+  | { type: "SHOW_DETAIL_MODAL"; payload: DetailModalState }
+  | { type: "HIDE_DETAIL_MODAL" }
+  | { type: "UPDATE_DETAIL_MODAL"; payload: Partial<DetailModalState> }
+  | { type: "SET_LANGUAGE_FILTER"; payload: string | null };

package/src/ui/theme.ts

@@ -0,0 +1,44 @@
+export const palette = {
+  bg: {
+    base: "black",
+    surface: "black",
+    muted: "gray",
+    accent: "blue",
+    caution: "yellow",
+    success: "green",
+    danger: "red",
+    info: "cyan",
+  },
+  text: {
+    primary: "white",
+    muted: "gray",
+    subtle: "brightBlack",
+    info: "cyan",
+    warning: "yellow",
+    success: "green",
+    danger: "red",
+  },
+  badge: {
+    dirty: { fg: "yellow", bg: undefined },
+    push: { fg: "cyan", bg: undefined },
+    pull: { fg: "magenta", bg: undefined },
+    local: { fg: "yellow", bg: undefined },
+    ok: { fg: "green", bg: undefined },
+    github: { fg: "white", bg: undefined },
+  },
+} as const;
+
+export const spacing = {
+  xxs: 0,
+  xs: 1,
+  sm: 2,
+  md: 3,
+} as const;
+
+export const typography = {
+  header: { color: palette.text.info, bold: true },
+  label: { color: palette.text.muted, bold: true },
+  value: { color: palette.text.primary },
+  muted: { color: palette.text.subtle },
+} as const;
+

package/src/utils/array.ts

@@ -0,0 +1,14 @@
+/**
+ * Array utility functions
+ */
+
+/**
+ * Split an array into chunks of a given size
+ */
+export function chunk<T>(arr: T[], size: number): T[][] {
+  const chunks: T[][] = [];
+  for (let i = 0; i < arr.length; i += size) {
+    chunks.push(arr.slice(i, i + size));
+  }
+  return chunks;
+}

package/src/utils/debug.ts

@@ -0,0 +1,38 @@
+/**
+ * Debug logging utility
+ * Enable debug output by setting GITTY_DEBUG=1 environment variable
+ */
+
+const DEBUG = process.env.GITTY_DEBUG === "1" || process.env.GITTY_DEBUG === "true";
+
+/**
+ * Log a debug message (only when GITTY_DEBUG is enabled)
+ */
+export function debug(context: string, message: string, data?: unknown): void {
+  if (!DEBUG) return;
+
+  const timestamp = new Date().toISOString();
+  if (data !== undefined) {
+    console.error(`[gitforest ${timestamp}] [${context}] ${message}`, data);
+  } else {
+    console.error(`[gitforest ${timestamp}] [${context}] ${message}`);
+  }
+}
+
+/**
+ * Log a debug error (only when GITTY_DEBUG is enabled)
+ */
+export function debugError(context: string, message: string, error: unknown): void {
+  if (!DEBUG) return;
+
+  const timestamp = new Date().toISOString();
+  const errorMessage = error instanceof Error ? error.message : String(error);
+  console.error(`[gitforest ${timestamp}] [${context}] ERROR: ${message} - ${errorMessage}`);
+}
+
+/**
+ * Check if debug mode is enabled
+ */
+export function isDebugEnabled(): boolean {
+  return DEBUG;
+}