@mrpatronz/nexusflow 0.1.0

package/dist/generators/cursor.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @module generators/cursor
+ * Generates a .cursor/rules/nexusflow.mdc file for Cursor.
+ * Uses the shared base content with Cursor-specific YAML frontmatter.
+ */
+import type { WorkspaceContext } from '../types.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 declare function generateCursorConfig(ctx: WorkspaceContext, workspacePath: string): Promise<void>;
+//# sourceMappingURL=cursor.d.ts.map

package/dist/generators/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/generators/cursor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,gBAAgB,EACrB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CAoBf"}

package/dist/generators/cursor.js

@@ -0,0 +1,37 @@
+/**
+ * @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 { 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, workspacePath) {
+    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}`);
+    }
+}
+//# sourceMappingURL=cursor.js.map

package/dist/generators/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/generators/cursor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,GAAG,MAAM,UAAU,CAAC;AAE3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEhD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,GAAqB,EACrB,aAAqB;IAErB,MAAM,WAAW,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAE7C,MAAM,OAAO,GAAG;;;;;EAKhB,WAAW,EAAE,CAAC;IAEd,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IAEtD,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC9B,MAAM,GAAG,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,kCAAkC,OAAO,EAAE,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC"}

package/dist/generators/index.d.ts

@@ -0,0 +1,18 @@
+import type { AIAssistant, WorkspaceContext } from '../types.js';
+/**
+ * Generates AI context files for each of the selected assistants.
+ *
+ * Iterates over the provided assistant list, invokes the corresponding
+ * generator, and logs success / failure for each one.
+ *
+ * @param ctx           - The workspace context (feature + repos).
+ * @param assistants    - Which AI assistants to generate context files for.
+ * @param workspacePath - Absolute path to the workspace root directory.
+ */
+export declare function generateContextFiles(ctx: WorkspaceContext, assistants: AIAssistant[], workspacePath: string): Promise<void>;
+export { generateClaudeConfig } from './claude.js';
+export { generateCodexConfig } from './codex.js';
+export { generateCopilotConfig } from './copilot.js';
+export { generateCursorConfig } from './cursor.js';
+export { buildContextContent } from './base.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/generators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generators/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAsBjE;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,gBAAgB,EACrB,UAAU,EAAE,WAAW,EAAE,EACzB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CA2Ef;AAGD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC"}

package/dist/generators/index.js

@@ -0,0 +1,95 @@
+import chalk from 'chalk';
+import path from 'node:path';
+import fse from 'fs-extra';
+import { generateClaudeConfig } from './claude.js';
+import { generateCodexConfig } from './codex.js';
+import { generateCopilotConfig } from './copilot.js';
+import { generateCursorConfig } from './cursor.js';
+import { buildContextContent } from './base.js';
+/** Maps each assistant to its generator function and the file it produces. */
+const GENERATORS = {
+    claude: { generate: generateClaudeConfig, outputFile: 'CLAUDE.md' },
+    antigravity: { generate: generateClaudeConfig, outputFile: 'CLAUDE.md' },
+    codex: { generate: generateCodexConfig, outputFile: 'AGENTS.md' },
+    copilot: { generate: generateCopilotConfig, outputFile: '.github/copilot-instructions.md' },
+    cursor: { generate: generateCursorConfig, outputFile: '.cursor/rules/nexusflow.mdc' },
+};
+/**
+ * Generates AI context files for each of the selected assistants.
+ *
+ * Iterates over the provided assistant list, invokes the corresponding
+ * generator, and logs success / failure for each one.
+ *
+ * @param ctx           - The workspace context (feature + repos).
+ * @param assistants    - Which AI assistants to generate context files for.
+ * @param workspacePath - Absolute path to the workspace root directory.
+ */
+export async function generateContextFiles(ctx, assistants, workspacePath) {
+    // Always generate a universal WORKSPACE.md at the workspace root
+    try {
+        const content = buildContextContent(ctx);
+        const filePath = path.join(workspacePath, 'WORKSPACE.md');
+        await fse.writeFile(filePath, content, 'utf-8');
+        console.log(chalk.green('  ✔'), `Generated universal ${chalk.bold('WORKSPACE.md')}`);
+        // Generate session.md template if it does not exist
+        const sessionPath = path.join(workspacePath, 'session.md');
+        if (!(await fse.pathExists(sessionPath))) {
+            const sessionContent = `# AI Session Handover Memo
+
+- **Feature Branch**: \`${ctx.feature.branchName}\`
+- **Session Started**: ${new Date().toLocaleDateString()}
+- **Last Modified Files**: None (Start of session)
+
+## Summary of Accomplished Work
+- Setup workspace with ${ctx.repos.length} mapped repositories.
+
+## Active State & Blockers
+- No active blockers.
+
+## Next Steps
+1. Open this workspace in your selected editor.
+2. Ask the assistant to read \`WORKSPACE.md\` and \`session.md\` to get started.
+`;
+            await fse.writeFile(sessionPath, sessionContent, 'utf-8');
+            console.log(chalk.green('  ✔'), `Generated initial session.md`);
+        }
+        // Generate plan.md template if it does not exist
+        const planPath = path.join(workspacePath, 'plan.md');
+        if (!(await fse.pathExists(planPath))) {
+            const planContent = `# Feature Development Plan
+
+## Checklist
+- [ ] Read \`WORKSPACE.md\` and analyze the codebase structure.
+- [ ] Initialize context by creating \`nexusflow-overview.md\` outlining assumptions and raising clarifying questions.
+- [ ] Review user's responses to clarifying questions.
+- [ ] Implement feature logic.
+- [ ] Verify build and run tests.
+- [ ] Compile final changes in the session handover memo.
+`;
+            await fse.writeFile(planPath, planContent, 'utf-8');
+            console.log(chalk.green('  ✔'), `Generated initial plan.md`);
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(chalk.red('  ✖'), `Failed to generate universal context files: ${message}`);
+    }
+    for (const assistant of assistants) {
+        const entry = GENERATORS[assistant];
+        try {
+            await entry.generate(ctx, workspacePath);
+            console.log(chalk.green('  ✔'), `Generated ${chalk.bold(entry.outputFile)} for ${assistant}`);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(chalk.red('  ✖'), `Failed to generate ${entry.outputFile} for ${assistant}: ${message}`);
+        }
+    }
+}
+// Re-export individual generators for direct use
+export { generateClaudeConfig } from './claude.js';
+export { generateCodexConfig } from './codex.js';
+export { generateCopilotConfig } from './copilot.js';
+export { generateCursorConfig } from './cursor.js';
+export { buildContextContent } from './base.js';
+//# sourceMappingURL=index.js.map

package/dist/generators/index.js.map

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