refactor: reorganize codebase into feature-based architecture

refactor: reorganize codebase into feature-based architecture 
10a7b46
Restructured src/ from technical grouping (utils/) to domain-driven feature modules following SRP and Clean Code principles.

Changes:
- Created 5 feature directories: config-collection/, project-scaffolding/, documentation/, tool-setup/, assistant-kickoff/
- Split 209-line project-structure.ts into 8 modular file generators
- Split 226-line agents-md.ts into 4 section builders
- Split 97-line prompts.ts into validators and choice builders
- Added README.md to all top-level feature directories explaining purpose and responsibilities
- Added TSDoc with examples to all 30+ functions
- Created 6 test spec files with it.todo for logic branches (Vitest)
- Applied consistent formatting (double quotes, spacing)

Each feature now has single responsibility, thin files (<100 lines), and colocated tests in __tests__ directories.
@drewdrewthis
test: add E2E test infrastructure with fluent CLI runner 
cff4ae4
- Install vitest and @vitest/ui for testing
- Create CLITestRunner class with fluent API for readable test flows
- Add utilities for CLI spawning, temp directory management
- Configure separate vitest configs for unit and E2E tests
- Add 44 comprehensive test todos covering full user flow:
  * Prompt sequence validation
  * Input validation and re-prompting
  * File generation for all framework/language combinations
  * Progress indication and spinner updates
  * Error handling scenarios
- Support inline snapshots for file content verification
- Add test scripts to package.json (test, test:watch, test:e2e)

The CLITestRunner enables tests that verify actual user experience by asserting on prompts, inputs, outputs, and filesystem artifacts in a readable chained syntax.

Author: drewdrewthis

.cursor/rules/coding-guidelines.mdc

@@ -15,4 +15,5 @@ DIRECTIVES:
 - Code should be modular
 - Functions should be small
 - Classes should be small
-- functions, classes, methods should have TSDoc with example usage
+- functions, classes, methods should have TSDoc with example usage
+- top-level directories represent core features, and should each have a README.md that describes the feature and its purpose.

.cursor/rules/commits.mdc

@@ -0,0 +1,12 @@
+---
+description: After writing code
+alwaysApply: false
+---
+After you finish writing code, PROPOSE a command to have a professional convensional commit + description for your work.
+
+DO NOT EXECUTE THE COMMAND, ONLY PROPOSE IT.
+
+Example:
+```bash
+git commit -m "feat: add new feature" -m "This commit adds a new feature to the project."
+```

.cursor/rules/unit-tests.mdc .cursor/rules/unit-tests-todos.mdc.cursor/rules/unit-tests.mdc renamed to .cursor/rules/unit-tests-todos.mdc

@@ -1,8 +1,7 @@
 ---
-description: When proposing/writing unit tests
+description: When proposing/writing unit test specs
 alwaysApply: false
 ---
-
 Stack:
 - Vitest
 
@@ -12,6 +11,7 @@ Testing rules:
 - A ‘when’ should indicate a describe block, and then we will out the todos.
 - Don’t test implementation details, only the public API.
 
+- DO NOT WRITE THE ACTUAL TESTING, ONLY THE TODOS.
 - Propose only a spec test of todos:
 
 Example:

src/__tests__/e2e/init.e2e.test.ts

@@ -0,0 +1,189 @@
+import { describe, it, beforeEach, afterEach } from "vitest";
+import { CLITestRunner } from "../utils/cli-test-runner.js";
+
+describe("superagents init - complete user flow", () => {
+  let runner: CLITestRunner;
+
+  beforeEach(() => {
+    runner = new CLITestRunner();
+  });
+
+  afterEach(async () => {
+    await runner.cleanup();
+  });
+
+  describe("full flow scenarios", () => {
+    it.todo("completes typescript + agno project setup");
+    // When implemented:
+    // await runner
+    //   .command('init', 'test-project')
+    //   .expectPrompt('Welcome to Superagents')
+    //   .expectPrompt('What programming language')
+    //   .input('typescript')
+    //   .expectPrompt('What agent framework')
+    //   .input('agno')
+    //   .expectPrompt('What coding assistant')
+    //   .input('claude-code')
+    //   .expectPrompt('What LLM provider')
+    //   .input('openai')
+    //   .expectPrompt('Enter your OpenAI API key')
+    //   .input('sk-test123')
+    //   .expectPrompt('Enter your LangWatch API key')
+    //   .input('lw_test123')
+    //   .expectPrompt('What do you want to build')
+    //   .input('Build a chatbot')
+    //   .expectOutput('Project structure created')
+    //   .expectOutput('MCP configuration set up')
+    //   .expectOutput('Agno configuration set up')
+    //   .expectOutput('AGENTS.md generated')
+    //   .expectOutput('Project setup complete')
+    //   .expectFile('src/prompts/sample.ts')
+    //   .expectFile('src/scenarios/sample.test.ts')
+    //   .expectFile('evaluations/sample.ts')
+    //   .expectFile('.env')
+    //   .expectFile('.gitignore')
+    //   .expectFile('AGENTS.md')
+    //   .expectFile('.cursorrules')
+    //   .expectFileContains('.env', 'OPENAI_API_KEY=sk-test123')
+    //   .expectFileContains('.env', 'LANGWATCH_API_KEY=lw_test123')
+    //   .expectFileToMatchInlineSnapshot('.env')
+    //   .expectFileToMatchInlineSnapshot('src/prompts/sample.ts')
+    //   .run();
+
+    it.todo("completes typescript + mastra project setup");
+
+    it.todo("completes python + agno project setup");
+  });
+
+  describe("prompt sequence validation", () => {
+    it.todo("displays welcome message");
+
+    it.todo("prompts for language selection");
+
+    it.todo("prompts for framework after language");
+
+    it.todo(
+      "shows only typescript-compatible frameworks when typescript selected"
+    );
+
+    it.todo("shows only python-compatible frameworks when python selected");
+
+    it.todo("prompts for coding assistant");
+
+    it.todo("prompts for LLM provider");
+
+    it.todo("displays LangWatch authorization URL before key prompt");
+
+    it.todo("prompts for OpenAI API key with masked input");
+
+    it.todo("prompts for LangWatch API key with masked input");
+
+    it.todo("prompts for project goal");
+  });
+
+  describe("input validation", () => {
+    it.todo("re-prompts when OpenAI key is invalid");
+    // When implemented:
+    // await runner
+    //   .command('init', 'test')
+    //   // ... navigate to API key prompt ...
+    //   .expectPrompt('Enter your OpenAI API key')
+    //   .input('invalid-key')
+    //   .expectOutput("must start with 'sk-'")
+    //   .expectPrompt('Enter your OpenAI API key')
+    //   .input('sk-valid123')
+    //   .run();
+
+    it.todo("re-prompts when LangWatch key is invalid");
+
+    it.todo("re-prompts when project goal is empty");
+
+    it.todo("accepts valid inputs and proceeds");
+  });
+
+  describe("file generation", () => {
+    describe("when typescript + agno", () => {
+      it.todo("creates correct directory structure");
+
+      it.todo("generates typescript main entry point");
+
+      it.todo("generates typescript scenario test");
+
+      it.todo("includes agno-specific tools configuration");
+
+      it.todo("includes agno rules in .cursorrules");
+
+      it.todo("generates AGENTS.md with agno guidance");
+    });
+
+    describe("when typescript + mastra", () => {
+      it.todo("generates mastra-compatible entry point");
+
+      it.todo("skips agno-specific configuration");
+    });
+
+    describe("when python + agno", () => {
+      it.todo("generates python main entry point");
+
+      it.todo("generates python scenario test");
+
+      it.todo("uses python-compatible file structure");
+    });
+  });
+
+  describe("file content verification", () => {
+    it.todo("generates .env with correct API keys");
+
+    it.todo("generates .gitignore with appropriate patterns");
+
+    it.todo("generates sample prompt file");
+
+    it.todo("generates sample scenario test");
+
+    it.todo("generates sample evaluation file");
+
+    it.todo("generates MCP settings configuration");
+
+    it.todo("generates AGENTS.md with project-specific content");
+  });
+
+  describe("progress indication", () => {
+    it.todo("displays spinner during setup");
+
+    it.todo("updates spinner text after structure creation");
+
+    it.todo("updates spinner text after MCP setup");
+
+    it.todo("updates spinner text after framework setup");
+
+    it.todo("updates spinner text after documentation generation");
+
+    it.todo("displays success message on completion");
+
+    it.todo("displays project location path");
+  });
+
+  describe("assistant kickoff", () => {
+    it.todo("displays assistant instructions after setup");
+
+    it.todo("includes project goal in assistant context");
+  });
+
+  describe("error handling", () => {
+    it.todo("handles directory creation failure");
+
+    it.todo("handles file generation failure");
+
+    it.todo("displays error message on failure");
+
+    it.todo("exits with non-zero code on error");
+
+    it.todo("fails spinner on error");
+  });
+
+  describe("existing directory handling", () => {
+    it.todo("uses existing directory without error");
+
+    it.todo("creates subdirectories in existing directory");
+  });
+});

src/__tests__/utils/README.md

@@ -0,0 +1,37 @@
+# E2E Test Utilities
+
+Utilities for end-to-end testing of the superagents CLI.
+
+## CLITestRunner
+
+Fluent API for testing CLI user interactions.
+
+### Example
+
+```typescript
+import { CLITestRunner } from "./utils/cli-test-runner.js";
+
+it("creates a project", async () => {
+  const runner = new CLITestRunner();
+  
+  await runner
+    .command('init', 'my-project')
+    .expectPrompt('What programming language')
+    .input('typescript')
+    .expectPrompt('What agent framework')
+    .input('agno')
+    .expectOutput('Project setup complete')
+    .expectFile('src/main.ts')
+    .expectFileToMatchInlineSnapshot('package.json')
+    .run();
+    
+  await runner.cleanup();
+});
+```
+
+## Helper Functions
+
+- **spawnCLI** - Spawns CLI process with stdin injection
+- **createTempDir** - Creates isolated temp directory
+- **cleanupTempDir** - Removes temp directory
+