gitgrip 0.2.0

package/dist/types.d.ts

@@ -0,0 +1,312 @@
+/**
+ * Configuration for copying a file from repo to workspace
+ */
+export interface CopyFileConfig {
+    /** Source path relative to repo */
+    src: string;
+    /** Destination path relative to workspace root */
+    dest: string;
+}
+/**
+ * Configuration for creating a symlink from repo to workspace
+ */
+export interface LinkFileConfig {
+    /** Source path relative to repo */
+    src: string;
+    /** Destination path relative to workspace root */
+    dest: string;
+}
+/**
+ * Configuration for a single repository in the manifest
+ */
+export interface RepoConfig {
+    /** Git URL (SSH or HTTPS) */
+    url: string;
+    /** Local path relative to manifest root */
+    path: string;
+    /** Default branch name (e.g., main, master) */
+    default_branch: string;
+    /** Files to copy from repo to workspace */
+    copyfile?: CopyFileConfig[];
+    /** Symlinks to create from repo to workspace */
+    linkfile?: LinkFileConfig[];
+}
+/**
+ * Configuration for the manifest repository itself
+ */
+export interface ManifestRepoConfig {
+    /** Git URL for the manifest repository */
+    url: string;
+    /** Default branch name (e.g., main, master) */
+    default_branch?: string;
+    /** Files to copy from manifest repo to workspace */
+    copyfile?: CopyFileConfig[];
+    /** Symlinks to create from manifest repo to workspace */
+    linkfile?: LinkFileConfig[];
+}
+/**
+ * Global settings for the manifest
+ */
+export interface ManifestSettings {
+    /** Prefix for cross-repo PR titles */
+    pr_prefix: string;
+    /** Merge strategy: all-or-nothing means all linked PRs must merge together */
+    merge_strategy: 'all-or-nothing' | 'independent';
+}
+/**
+ * A step in a multi-step script
+ */
+export interface ScriptStep {
+    /** Step name for display */
+    name: string;
+    /** Command to execute */
+    command: string;
+    /** Working directory relative to workspace root */
+    cwd?: string;
+}
+/**
+ * A workspace script definition
+ */
+export interface WorkspaceScript {
+    /** Description of what the script does */
+    description?: string;
+    /** Single command to run (mutually exclusive with steps) */
+    command?: string;
+    /** Working directory for single command */
+    cwd?: string;
+    /** Multi-step commands (mutually exclusive with command) */
+    steps?: ScriptStep[];
+}
+/**
+ * A hook command to run
+ */
+export interface HookCommand {
+    /** Command to execute */
+    command: string;
+    /** Working directory relative to workspace root */
+    cwd?: string;
+}
+/**
+ * Workspace hooks configuration
+ */
+export interface WorkspaceHooks {
+    /** Hooks to run after sync */
+    'post-sync'?: HookCommand[];
+    /** Hooks to run after checkout */
+    'post-checkout'?: HookCommand[];
+}
+/**
+ * Workspace configuration section
+ */
+export interface WorkspaceConfig {
+    /** Environment variables to set */
+    env?: Record<string, string>;
+    /** Named scripts */
+    scripts?: Record<string, WorkspaceScript>;
+    /** Lifecycle hooks */
+    hooks?: WorkspaceHooks;
+}
+/**
+ * The full manifest file structure (manifest.yaml)
+ */
+export interface Manifest {
+    version: number;
+    /** Optional manifest repository configuration for self-tracking */
+    manifest?: ManifestRepoConfig;
+    repos: Record<string, RepoConfig>;
+    settings: ManifestSettings;
+    /** Workspace configuration for scripts, hooks, and env */
+    workspace?: WorkspaceConfig;
+}
+/**
+ * Parsed repository info with computed fields
+ */
+export interface RepoInfo extends RepoConfig {
+    /** Repository name (key from manifest) */
+    name: string;
+    /** Absolute path on disk */
+    absolutePath: string;
+    /** Owner from GitHub URL */
+    owner: string;
+    /** Repo name from GitHub URL */
+    repo: string;
+}
+/**
+ * Status of a single repository
+ */
+export interface RepoStatus {
+    /** Repository name */
+    name: string;
+    /** Current branch */
+    branch: string;
+    /** Whether working directory is clean */
+    clean: boolean;
+    /** Number of staged files */
+    staged: number;
+    /** Number of modified files */
+    modified: number;
+    /** Number of untracked files */
+    untracked: number;
+    /** Commits ahead of remote */
+    ahead: number;
+    /** Commits behind remote */
+    behind: number;
+    /** Whether repo exists on disk */
+    exists: boolean;
+}
+/**
+ * A linked PR in a child repository
+ */
+export interface LinkedPR {
+    /** Repository name (from manifest) */
+    repoName: string;
+    /** Owner on GitHub */
+    owner: string;
+    /** Repo name on GitHub */
+    repo: string;
+    /** PR number */
+    number: number;
+    /** PR URL */
+    url: string;
+    /** PR state: open, closed, merged */
+    state: 'open' | 'closed' | 'merged';
+    /** Whether PR is approved */
+    approved: boolean;
+    /** Whether all checks passed */
+    checksPass: boolean;
+    /** Whether PR is mergeable */
+    mergeable: boolean;
+}
+/**
+ * A manifest PR that tracks linked child PRs
+ */
+export interface ManifestPR {
+    /** Manifest PR number */
+    number: number;
+    /** Manifest PR URL */
+    url: string;
+    /** PR title */
+    title: string;
+    /** Linked child PRs */
+    linkedPRs: LinkedPR[];
+    /** Overall state */
+    state: 'open' | 'closed' | 'merged';
+    /** Whether all linked PRs are ready to merge */
+    readyToMerge: boolean;
+}
+/**
+ * State file for tracking cross-repo work (.gitgrip/state.json)
+ */
+export interface StateFile {
+    /** Current manifest PR being worked on */
+    currentManifestPR?: number;
+    /** Map of branch names to manifest PR numbers */
+    branchToPR: Record<string, number>;
+    /** Map of manifest PR numbers to linked PRs */
+    prLinks: Record<number, LinkedPR[]>;
+}
+/**
+ * Result of a git operation across repos
+ */
+export interface MultiRepoResult<T> {
+    /** Repository name */
+    repoName: string;
+    /** Whether operation succeeded */
+    success: boolean;
+    /** Result data if successful */
+    data?: T;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Options for PR creation
+ */
+export interface PRCreateOptions {
+    /** PR title */
+    title: string;
+    /** PR body/description */
+    body?: string;
+    /** Base branch to merge into */
+    base?: string;
+    /** Whether to create as draft */
+    draft?: boolean;
+    /** Only create PRs for repos with changes */
+    changesOnly?: boolean;
+}
+/**
+ * Options for PR merge
+ */
+export interface PRMergeOptions {
+    /** Merge method: merge, squash, or rebase */
+    method?: 'merge' | 'squash' | 'rebase';
+    /** Whether to delete branches after merge */
+    deleteBranch?: boolean;
+    /** Whether to skip confirmation */
+    force?: boolean;
+}
+/**
+ * GitHub repository info extracted from URL
+ */
+export interface GitHubRepoInfo {
+    owner: string;
+    repo: string;
+}
+/**
+ * Status of a file link (copyfile or linkfile)
+ */
+export interface LinkStatus {
+    /** Type of link */
+    type: 'copyfile' | 'linkfile';
+    /** Repository name */
+    repoName: string;
+    /** Source path (absolute) */
+    src: string;
+    /** Destination path (absolute) */
+    dest: string;
+    /** Status of the link */
+    status: 'valid' | 'broken' | 'missing' | 'conflict';
+    /** Additional message */
+    message?: string;
+}
+/**
+ * A single timing entry in a timing report
+ */
+export interface TimingEntry {
+    /** Label for this timing phase */
+    label: string;
+    /** Duration in milliseconds */
+    duration: number;
+    /** Nested timing entries */
+    children?: TimingEntry[];
+}
+/**
+ * A complete timing report with all phases
+ */
+export interface TimingReport {
+    /** Total duration in milliseconds */
+    total: number;
+    /** Individual timing entries */
+    entries: TimingEntry[];
+}
+/**
+ * Result of a benchmark run
+ */
+export interface BenchmarkResult {
+    /** Benchmark name */
+    name: string;
+    /** Number of iterations run */
+    iterations: number;
+    /** Minimum duration in milliseconds */
+    min: number;
+    /** Maximum duration in milliseconds */
+    max: number;
+    /** Average duration in milliseconds */
+    avg: number;
+    /** 50th percentile (median) in milliseconds */
+    p50: number;
+    /** 95th percentile in milliseconds */
+    p95: number;
+    /** Standard deviation in milliseconds */
+    stdDev: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "gitgrip",
+  "version": "0.2.0",
+  "description": "git a grip - Multi-repo workflow tool",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "gitgrip": "dist/index.js",
+    "gr": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "lint": "eslint src/",
+    "test": "vitest",
+    "bench": "vitest bench",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "git",
+    "gitgrip",
+    "grip",
+    "multi-repo",
+    "monorepo",
+    "github",
+    "pr",
+    "cli",
+    "workflow"
+  ],
+  "author": "Layne Penney",
+  "license": "MIT",
+  "homepage": "https://github.com/laynepenney/gitgrip#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/laynepenney/gitgrip.git"
+  },
+  "bugs": {
+    "url": "https://github.com/laynepenney/gitgrip/issues"
+  },
+  "dependencies": {
+    "@octokit/rest": "^21.0.0",
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "inquirer": "^9.2.0",
+    "ora": "^8.0.0",
+    "simple-git": "^3.22.0",
+    "yaml": "^2.3.0"
+  },
+  "devDependencies": {
+    "@types/inquirer": "^9.0.7",
+    "@types/node": "^20.11.0",
+    "eslint": "^8.56.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.2.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}