@mrpatronz/nexusflow 0.2.17 → 0.2.18

package/src/core/worktree.ts

@@ -1,120 +1,120 @@
-/**
- * @module core/worktree
- * Git worktree operations — create and remove worktrees for feature branches.
- */
-
-import { execa } from 'execa';
-
-/**
- * Creates a new git worktree for a feature branch.
- *
- * Runs:
- * 1. `git fetch origin` — ensure we have the latest remote refs.
- * 2. `git worktree add <targetPath> -b <branchName> origin/<baseBranch>`
- *
- * @param repoPath   - Absolute path to the main repo checkout.
- * @param targetPath - Absolute path where the worktree should be created.
- * @param branchName - Name of the new local branch to create.
- * @param baseBranch - Remote branch to base the new branch on (e.g. 'main').
- */
-export async function createWorktree(
-  repoPath: string,
-  targetPath: string,
-  branchName: string,
-  baseBranch: string,
-): Promise<void> {
-  let fetched = false;
-  // Fetch latest remote state.
-  try {
-    await execa('git', ['fetch', 'origin'], { cwd: repoPath });
-    fetched = true;
-  } catch {
-    // Silently ignore fetch failures (e.g., offline or no remote origin)
-  }
-
-  // Update local base branch, main, and master to keep them in sync with remote before branching
-  if (fetched) {
-    try {
-      const { stdout: currentBranchRaw } = await execa('git', ['branch', '--show-current'], { cwd: repoPath });
-      const currentBranch = currentBranchRaw.trim();
-      
-      const branchesToUpdate = Array.from(new Set([baseBranch, 'main', 'master']));
-      
-      for (const branch of branchesToUpdate) {
-        try {
-          if (currentBranch === branch) {
-            // Safe fast-forward pull for the currently checked-out branch
-            await execa('git', ['pull', '--ff-only'], { cwd: repoPath });
-          } else {
-            // Fast-forward local ref from remote ref without checkout
-            await execa('git', ['fetch', 'origin', `${branch}:${branch}`], { cwd: repoPath });
-          }
-        } catch {
-          // Ignore individual branch update failures
-        }
-      }
-    } catch {
-      // Ignore failures
-    }
-  }
-
-  // Determine starting point: remote branch if fetched successfully and exists, else local branch.
-  let startPoint = baseBranch;
-  if (fetched) {
-    try {
-      await execa('git', ['rev-parse', '--verify', `origin/${baseBranch}`], { cwd: repoPath });
-      startPoint = `origin/${baseBranch}`;
-    } catch {
-      // remote tracking branch does not exist, fallback to local branch
-    }
-  }
-
-  // Check if the target branch already exists locally
-  let branchExists = false;
-  try {
-    await execa('git', ['rev-parse', '--verify', branchName], { cwd: repoPath });
-    branchExists = true;
-  } catch {
-    // Branch does not exist locally
-  }
-
-  // Create the worktree
-  if (branchExists) {
-    // If the branch already exists, checkout the existing branch
-    await execa(
-      'git',
-      ['worktree', 'add', targetPath, branchName],
-      { cwd: repoPath },
-    );
-  } else {
-    // If the branch does not exist, create a new branch based on the start point without tracking it
-    await execa(
-      'git',
-      ['worktree', 'add', '--no-track', targetPath, '-b', branchName, startPoint],
-      { cwd: repoPath },
-    );
-  }
-}
-
-/**
- * Removes an existing git worktree.
- *
- * Runs `git worktree remove [--force] <worktreePath>` from the main repo.
- *
- * @param repoPath     - Absolute path to the main repo checkout.
- * @param worktreePath - Absolute path to the worktree to remove.
- * @param force        - Whether to force removal (cleanly removes modified files).
- */
-export async function removeWorktree(
-  repoPath: string,
-  worktreePath: string,
-  force = false,
-): Promise<void> {
-  const args = ['worktree', 'remove'];
-  if (force) {
-    args.push('--force');
-  }
-  args.push(worktreePath);
-  await execa('git', args, { cwd: repoPath });
-}
-
+/**
+ * @module core/worktree
+ * Git worktree operations — create and remove worktrees for feature branches.
+ */
+
+import { execa } from 'execa';
+
+/**
+ * Creates a new git worktree for a feature branch.
+ *
+ * Runs:
+ * 1. `git fetch origin` — ensure we have the latest remote refs.
+ * 2. `git worktree add <targetPath> -b <branchName> origin/<baseBranch>`
+ *
+ * @param repoPath   - Absolute path to the main repo checkout.
+ * @param targetPath - Absolute path where the worktree should be created.
+ * @param branchName - Name of the new local branch to create.
+ * @param baseBranch - Remote branch to base the new branch on (e.g. 'main').
+ */
+export async function createWorktree(
+  repoPath: string,
+  targetPath: string,
+  branchName: string,
+  baseBranch: string,
+): Promise<void> {
+  let fetched = false;
+  // Fetch latest remote state.
+  try {
+    await execa('git', ['fetch', 'origin'], { cwd: repoPath });
+    fetched = true;
+  } catch {
+    // Silently ignore fetch failures (e.g., offline or no remote origin)
+  }
+
+  // Update local base branch, main, and master to keep them in sync with remote before branching
+  if (fetched) {
+    try {
+      const { stdout: currentBranchRaw } = await execa('git', ['branch', '--show-current'], { cwd: repoPath });
+      const currentBranch = currentBranchRaw.trim();
+      
+      const branchesToUpdate = Array.from(new Set([baseBranch, 'main', 'master']));
+      
+      for (const branch of branchesToUpdate) {
+        try {
+          if (currentBranch === branch) {
+            // Safe fast-forward pull for the currently checked-out branch
+            await execa('git', ['pull', '--ff-only'], { cwd: repoPath });
+          } else {
+            // Fast-forward local ref from remote ref without checkout
+            await execa('git', ['fetch', 'origin', `${branch}:${branch}`], { cwd: repoPath });
+          }
+        } catch {
+          // Ignore individual branch update failures
+        }
+      }
+    } catch {
+      // Ignore failures
+    }
+  }
+
+  // Determine starting point: remote branch if fetched successfully and exists, else local branch.
+  let startPoint = baseBranch;
+  if (fetched) {
+    try {
+      await execa('git', ['rev-parse', '--verify', `origin/${baseBranch}`], { cwd: repoPath });
+      startPoint = `origin/${baseBranch}`;
+    } catch {
+      // remote tracking branch does not exist, fallback to local branch
+    }
+  }
+
+  // Check if the target branch already exists locally
+  let branchExists = false;
+  try {
+    await execa('git', ['rev-parse', '--verify', branchName], { cwd: repoPath });
+    branchExists = true;
+  } catch {
+    // Branch does not exist locally
+  }
+
+  // Create the worktree
+  if (branchExists) {
+    // If the branch already exists, checkout the existing branch
+    await execa(
+      'git',
+      ['worktree', 'add', targetPath, branchName],
+      { cwd: repoPath },
+    );
+  } else {
+    // If the branch does not exist, create a new branch based on the start point without tracking it
+    await execa(
+      'git',
+      ['worktree', 'add', '--no-track', targetPath, '-b', branchName, startPoint],
+      { cwd: repoPath },
+    );
+  }
+}
+
+/**
+ * Removes an existing git worktree.
+ *
+ * Runs `git worktree remove [--force] <worktreePath>` from the main repo.
+ *
+ * @param repoPath     - Absolute path to the main repo checkout.
+ * @param worktreePath - Absolute path to the worktree to remove.
+ * @param force        - Whether to force removal (cleanly removes modified files).
+ */
+export async function removeWorktree(
+  repoPath: string,
+  worktreePath: string,
+  force = false,
+): Promise<void> {
+  const args = ['worktree', 'remove'];
+  if (force) {
+    args.push('--force');
+  }
+  args.push(worktreePath);
+  await execa('git', args, { cwd: repoPath });
+}
+

package/src/generators/antigravity.ts

@@ -1,32 +1,32 @@
-/**
- * @module generators/antigravity
- * Generates an AGENTS.md file for Antigravity.
- */
-
-import path from 'node:path';
-import fse from 'fs-extra';
-import type { WorkspaceContext } from '../types.js';
-import { buildContextContent } from './base.js';
-
-/**
- * Generates an `AGENTS.md` file at the workspace root.
- *
- * Antigravity reads this file for persistent context about the workspace.
- *
- * @param ctx           - The workspace context (feature + repos + analysis).
- * @param workspacePath - Absolute path to the workspace root directory.
- */
-export async function generateAntigravityConfig(
-  ctx: WorkspaceContext,
-  workspacePath: string,
-): Promise<void> {
-  const content = buildContextContent(ctx);
-  const filePath = path.join(workspacePath, 'AGENTS.md');
-
-  try {
-    await fse.writeFile(filePath, content, 'utf-8');
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    throw new Error(`Failed to write AGENTS.md: ${message}`);
-  }
-}
+/**
+ * @module generators/antigravity
+ * Generates an AGENTS.md file for Antigravity.
+ */
+
+import path from 'node:path';
+import fse from 'fs-extra';
+import type { WorkspaceContext } from '../types.js';
+import { buildContextContent } from './base.js';
+
+/**
+ * Generates an `AGENTS.md` file at the workspace root.
+ *
+ * Antigravity reads this file for persistent context about the workspace.
+ *
+ * @param ctx           - The workspace context (feature + repos + analysis).
+ * @param workspacePath - Absolute path to the workspace root directory.
+ */
+export async function generateAntigravityConfig(
+  ctx: WorkspaceContext,
+  workspacePath: string,
+): Promise<void> {
+  const content = buildContextContent(ctx);
+  const filePath = path.join(workspacePath, 'AGENTS.md');
+
+  try {
+    await fse.writeFile(filePath, content, 'utf-8');
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`Failed to write AGENTS.md: ${message}`);
+  }
+}