@mrpatronz/nexusflow 0.2.17 → 0.2.18

package/src/generators/codex.ts

@@ -1,48 +1,48 @@
-/**
- * @module generators/codex
- * Generates an AGENTS.md file for OpenAI Codex.
- * Uses the shared base content and adds Codex-specific sections.
- */
-
-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.
- *
- * Codex reads AGENTS.md 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 generateCodexConfig(
-  ctx: WorkspaceContext,
-  workspacePath: string,
-): Promise<void> {
-  const baseContent = buildContextContent(ctx);
-
-  const codexExtra = `
----
-
-## Codex-Specific Notes
-
-- Each project subdirectory may contain its own \`AGENTS.md\` or
-  \`AGENTS.override.md\` with module-specific context.
-- When working in a subdirectory, check for local overrides before
-  applying workspace-level guidance.
-- Use \`codex --approval-mode suggest\` for cross-repo changes to
-  review each change before applying.
-`;
-
-  const content = baseContent + codexExtra;
-  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/codex
+ * Generates an AGENTS.md file for OpenAI Codex.
+ * Uses the shared base content and adds Codex-specific sections.
+ */
+
+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.
+ *
+ * Codex reads AGENTS.md 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 generateCodexConfig(
+  ctx: WorkspaceContext,
+  workspacePath: string,
+): Promise<void> {
+  const baseContent = buildContextContent(ctx);
+
+  const codexExtra = `
+---
+
+## Codex-Specific Notes
+
+- Each project subdirectory may contain its own \`AGENTS.md\` or
+  \`AGENTS.override.md\` with module-specific context.
+- When working in a subdirectory, check for local overrides before
+  applying workspace-level guidance.
+- Use \`codex --approval-mode suggest\` for cross-repo changes to
+  review each change before applying.
+`;
+
+  const content = baseContent + codexExtra;
+  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}`);
+  }
+}

package/src/generators/copilot.ts

@@ -1,56 +1,56 @@
-/**
- * @module generators/copilot
- * Generates a .github/copilot-instructions.md file for GitHub Copilot.
- * Uses the shared base content and adds Copilot-specific sections.
- */
-
-import path from 'node:path';
-import fse from 'fs-extra';
-import type { WorkspaceContext } from '../types.js';
-import { buildContextContent } from './base.js';
-
-/**
- * Generates a `.github/copilot-instructions.md` file at the workspace root.
- *
- * Copilot reads this file for repository-level guidance in Chat and Agent modes.
- *
- * @param ctx           - The workspace context (feature + repos + analysis).
- * @param workspacePath - Absolute path to the workspace root directory.
- */
-export async function generateCopilotConfig(
-  ctx: WorkspaceContext,
-  workspacePath: string,
-): Promise<void> {
-  const baseContent = buildContextContent(ctx);
-
-  const copilotExtra = `
----
-
-## Copilot-Specific Notes
-
-- Path-scoped instructions can be added in \`.github/instructions/\`
-  using \`*.instructions.md\` files with YAML frontmatter to target
-  specific file patterns.
-- Example path-scoped file:
-  \`\`\`markdown
-  ---
-  applyTo:
-    - src/frontend/**
-  ---
-  # Frontend Guidelines
-  - Use TypeScript strict mode.
-  \`\`\`
-`;
-
-  const content = baseContent + copilotExtra;
-  const githubDir = path.join(workspacePath, '.github');
-  const filePath = path.join(githubDir, 'copilot-instructions.md');
-
-  try {
-    await fse.ensureDir(githubDir);
-    await fse.writeFile(filePath, content, 'utf-8');
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    throw new Error(`Failed to write copilot-instructions.md: ${message}`);
-  }
-}
+/**
+ * @module generators/copilot
+ * Generates a .github/copilot-instructions.md file for GitHub Copilot.
+ * Uses the shared base content and adds Copilot-specific sections.
+ */
+
+import path from 'node:path';
+import fse from 'fs-extra';
+import type { WorkspaceContext } from '../types.js';
+import { buildContextContent } from './base.js';
+
+/**
+ * Generates a `.github/copilot-instructions.md` file at the workspace root.
+ *
+ * Copilot reads this file for repository-level guidance in Chat and Agent modes.
+ *
+ * @param ctx           - The workspace context (feature + repos + analysis).
+ * @param workspacePath - Absolute path to the workspace root directory.
+ */
+export async function generateCopilotConfig(
+  ctx: WorkspaceContext,
+  workspacePath: string,
+): Promise<void> {
+  const baseContent = buildContextContent(ctx);
+
+  const copilotExtra = `
+---
+
+## Copilot-Specific Notes
+
+- Path-scoped instructions can be added in \`.github/instructions/\`
+  using \`*.instructions.md\` files with YAML frontmatter to target
+  specific file patterns.
+- Example path-scoped file:
+  \`\`\`markdown
+  ---
+  applyTo:
+    - src/frontend/**
+  ---
+  # Frontend Guidelines
+  - Use TypeScript strict mode.
+  \`\`\`
+`;
+
+  const content = baseContent + copilotExtra;
+  const githubDir = path.join(workspacePath, '.github');
+  const filePath = path.join(githubDir, 'copilot-instructions.md');
+
+  try {
+    await fse.ensureDir(githubDir);
+    await fse.writeFile(filePath, content, 'utf-8');
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`Failed to write copilot-instructions.md: ${message}`);
+  }
+}

package/src/generators/cursor.ts

@@ -1,44 +1,44 @@
-/**
- * @module generators/cursor
- * Generates a .cursor/rules/nexusflow.mdc file for Cursor.
- * Uses the shared base content with Cursor-specific YAML frontmatter.
- */
-
-import path from 'node:path';
-import fse from 'fs-extra';
-import type { WorkspaceContext } from '../types.js';
-import { buildContextContent } from './base.js';
-
-/**
- * Generates a `.cursor/rules/nexusflow.mdc` file at the workspace root.
- *
- * Cursor reads `.mdc` rule files from `.cursor/rules/` for project-wide
- * instructions. The YAML frontmatter controls when the rule is applied.
- *
- * @param ctx           - The workspace context (feature + repos + analysis).
- * @param workspacePath - Absolute path to the workspace root directory.
- */
-export async function generateCursorConfig(
-  ctx: WorkspaceContext,
-  workspacePath: string,
-): Promise<void> {
-  const baseContent = buildContextContent(ctx);
-
-  const content = `---
-description: "NexusFlow workspace context for multi-repo feature development"
-alwaysApply: true
----
-
-${baseContent}`;
-
-  const rulesDir = path.join(workspacePath, '.cursor', 'rules');
-  const filePath = path.join(rulesDir, 'nexusflow.mdc');
-
-  try {
-    await fse.ensureDir(rulesDir);
-    await fse.writeFile(filePath, content, 'utf-8');
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    throw new Error(`Failed to write nexusflow.mdc: ${message}`);
-  }
-}
+/**
+ * @module generators/cursor
+ * Generates a .cursor/rules/nexusflow.mdc file for Cursor.
+ * Uses the shared base content with Cursor-specific YAML frontmatter.
+ */
+
+import path from 'node:path';
+import fse from 'fs-extra';
+import type { WorkspaceContext } from '../types.js';
+import { buildContextContent } from './base.js';
+
+/**
+ * Generates a `.cursor/rules/nexusflow.mdc` file at the workspace root.
+ *
+ * Cursor reads `.mdc` rule files from `.cursor/rules/` for project-wide
+ * instructions. The YAML frontmatter controls when the rule is applied.
+ *
+ * @param ctx           - The workspace context (feature + repos + analysis).
+ * @param workspacePath - Absolute path to the workspace root directory.
+ */
+export async function generateCursorConfig(
+  ctx: WorkspaceContext,
+  workspacePath: string,
+): Promise<void> {
+  const baseContent = buildContextContent(ctx);
+
+  const content = `---
+description: "NexusFlow workspace context for multi-repo feature development"
+alwaysApply: true
+---
+
+${baseContent}`;
+
+  const rulesDir = path.join(workspacePath, '.cursor', 'rules');
+  const filePath = path.join(rulesDir, 'nexusflow.mdc');
+
+  try {
+    await fse.ensureDir(rulesDir);
+    await fse.writeFile(filePath, content, 'utf-8');
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`Failed to write nexusflow.mdc: ${message}`);
+  }
+}

package/src/generators/diff-context.ts

@@ -0,0 +1,75 @@
+import { execa } from 'execa';
+import * as path from 'node:path';
+import * as fs from 'node:fs/promises';
+import type { WorkspaceContext } from '../types.js';
+import { getActiveStorageProvider } from '../core/adapters/registry.js';
+
+/**
+ * Generates an incremental task context file listing only changed files on the branch.
+ */
+export async function generateDiffContext(
+  ctx: WorkspaceContext,
+  workspacePath: string
+): Promise<void> {
+  let content = `# Incremental Task Context (Git Diff)\n\n`;
+  content += `This file lists the files modified or added on this feature branch compared to the base branch. Use this to focus the AI's attention.\n\n`;
+
+  let hasDiff = false;
+
+  for (const repo of ctx.repos) {
+    const repoPath = path.join(workspacePath, repo.name);
+    try {
+      await fs.access(repoPath);
+    } catch {
+      continue;
+    }
+
+    const defaultBranch = repo.defaultBranch || 'main';
+
+    let diffFiles: string[] = [];
+    try {
+      const { stdout } = await execa('git', ['diff', `origin/${defaultBranch}...HEAD`, '--name-only'], {
+        cwd: repoPath,
+        shell: process.platform === 'win32',
+      });
+      diffFiles = stdout.split('\n').map(f => f.trim()).filter(Boolean);
+    } catch {
+      try {
+        const { stdout } = await execa('git', ['diff', `${defaultBranch}...HEAD`, '--name-only'], {
+          cwd: repoPath,
+          shell: process.platform === 'win32',
+        });
+        diffFiles = stdout.split('\n').map(f => f.trim()).filter(Boolean);
+      } catch {
+        try {
+          const { stdout } = await execa('git', ['status', '--porcelain'], {
+            cwd: repoPath,
+            shell: process.platform === 'win32',
+          });
+          diffFiles = stdout.split('\n')
+            .map(line => line.slice(3).trim())
+            .filter(Boolean);
+        } catch {
+          // git command failed or not a repo
+        }
+      }
+    }
+
+    if (diffFiles.length > 0) {
+      hasDiff = true;
+      content += `## Repository: ${repo.name}\n\n`;
+      for (const file of diffFiles) {
+        const absoluteFilePath = path.join(repoPath, file).replace(/\\/g, '/');
+        content += `*   [${file}](file:///${absoluteFilePath})\n`;
+      }
+      content += `\n`;
+    }
+  }
+
+  if (!hasDiff) {
+    content += `*No changed files detected on this branch yet.*\n`;
+  }
+
+  const storage = getActiveStorageProvider();
+  await storage.writeWorkspaceFile(workspacePath, ctx.feature.id, 'nexusflow-diff-context.md', content);
+}