ai-first-cli 1.1.2 → 1.1.5

package/test-projects/nestjs-backend/src/main.ts

@@ -0,0 +1,9 @@
+import { NestFactory } from '@nestjs/core';
+import { AppModule } from './app.module';
+
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule);
+  await app.listen(3000);
+  console.log('Application is running on: http://localhost:3000');
+}
+bootstrap();

package/test-projects/nestjs-backend/src/users/users.controller.ts

@@ -0,0 +1,32 @@
+import { Controller, Get, Post, Put, Delete, Body, Param } from '@nestjs/common';
+import { UsersService } from './users.service';
+
+@Controller('users')
+export class UsersController {
+  constructor(private readonly usersService: UsersService) {}
+
+  @Get()
+  findAll() {
+    return this.usersService.findAll();
+  }
+
+  @Get(':id')
+  findOne(@Param('id') id: string) {
+    return this.usersService.findOne(id);
+  }
+
+  @Post()
+  create(@Body() body: { email: string; name: string }) {
+    return this.usersService.create(body);
+  }
+
+  @Put(':id')
+  update(@Param('id') id: string, @Body() body: any) {
+    return this.usersService.update(id, body);
+  }
+
+  @Delete(':id')
+  remove(@Param('id') id: string) {
+    return this.usersService.remove(id);
+  }
+}

package/test-projects/nestjs-backend/src/users/users.module.ts

@@ -0,0 +1,10 @@
+import { Module } from '@nestjs/common';
+import { UsersController } from './users.controller';
+import { UsersService } from './users.service';
+
+@Module({
+  controllers: [UsersController],
+  providers: [UsersService],
+  exports: [UsersService],
+})
+export class UsersModule {}

package/test-projects/nestjs-backend/src/users/users.service.ts

@@ -0,0 +1,42 @@
+import { Injectable, NotFoundException } from '@nestjs/common';
+
+interface User {
+  id: string;
+  email: string;
+  name: string;
+}
+
+@Injectable()
+export class UsersService {
+  private users: User[] = [
+    { id: '1', email: 'test@test.com', name: 'Test User' }
+  ];
+
+  findAll(): User[] {
+    return this.users;
+  }
+
+  findOne(id: string): User {
+    const user = this.users.find(u => u.id === id);
+    if (!user) throw new NotFoundException('User not found');
+    return user;
+  }
+
+  create(data: { email: string; name: string }): User {
+    const user = { id: String(this.users.length + 1), ...data };
+    this.users.push(user);
+    return user;
+  }
+
+  update(id: string, data: Partial<User>): User {
+    const index = this.users.findIndex(u => u.id === id);
+    if (index === -1) throw new NotFoundException('User not found');
+    this.users[index] = { ...this.users[index], ...data };
+    return this.users[index];
+  }
+
+  remove(id: string): void {
+    const index = this.users.findIndex(u => u.id === id);
+    if (index !== -1) this.users.splice(index, 1);
+  }
+}

package/test-projects/nestjs-backend/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "module": "commonjs",
+    "declaration": true,
+    "removeComments": true,
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "allowSyntheticDefaultImports": true,
+    "target": "ES2021",
+    "sourceMap": true,
+    "outDir": "./dist",
+    "baseUrl": "./",
+    "incremental": true,
+    "skipLibCheck": true,
+    "strictNullChecks": false,
+    "noImplicitAny": false,
+    "strictBindCallApply": false,
+    "forceConsistentCasingInFileNames": false,
+    "noFallthroughCasesInSwitch": false
+  }
+}

package/test-projects/python-cli/__init__.py

@@ -0,0 +1 @@
+# CLI tool to manage tasks

package/test-projects/python-cli/ai/ai_context.md

@@ -0,0 +1,94 @@
+# AI Context
+
+> This file provides a comprehensive overview of the repository for AI coding assistants.
+
+---
+
+## Quick Overview
+
+- **Pattern**: MVC (Model-View-Controller)
+- **Languages**: Python
+- **Frameworks**: None
+- **Total Files**: 9
+
+---
+
+## Table of Contents
+
+1. [Tech Stack](#tech-stack)
+2. [Architecture](#architecture)
+3. [Key Entrypoints](#key-entrypoints)
+4. [Code Conventions](#code-conventions)
+5. [AI Rules](#ai-rules)
+6. [Repository Map](#repository-map)
+
+---
+
+## Tech Stack
+
+**Languages**: Python
+
+---
+
+## Architecture
+
+## Architectural Pattern
+**Primary**: MVC (Model-View-Controller)
+**Secondary**: CLI Application
+
+## Layers Identified
+- Domain
+
+## Key Modules
+| Module | Responsibility |
+|--------|----------------|
+| `__init__.py` | Contains 0 files |
+| `cli` | Contains 4 files |
+| `main.py` | Contains 0 files |
+| `models` | Data models and entities |
+
+
+---
+
+## Key Entrypoints
+
+---
+
+## Code Conventions
+
+## Naming Conventions
+- **Files**: kebab-case or snake_case
+
+## Project Structure
+
+## Code Style
+- **Semicolons**: Required
+
+
+---
+
+## AI Rules
+
+- Language: Use Python
+- Architecture: Follow MVC (Model-View-Controller) pattern
+- File naming: kebab-case or snake_case
+
+---
+
+## Repository Map
+
+See repo_map.md for the full structure.
+
+---
+
+## Notes for AI Assistants
+
+1. Follow the established naming conventions (see conventions.md)
+2. Use the detected frameworks and libraries
+3. Target the correct entrypoints for modifications
+4. Maintain the detected architecture patterns
+5. Follow AI rules in ai_rules.md
+
+---
+
+*Generated by ai-first*

package/test-projects/python-cli/ai/ai_rules.md

@@ -0,0 +1,47 @@
+# AI Rules
+
+> Guidelines for AI assistants working on this project
+
+---
+
+## Guidelines
+
+- Language: Use Python
+- Architecture: Follow MVC (Model-View-Controller) pattern
+- File naming: kebab-case or snake_case
+
+## Patterns
+
+- Layer structure: domain
+
+## Constraints
+
+- Always use semicolons
+
+---
+
+## Quick Reference
+
+| Category | Value |
+|----------|-------|
+| Language | Python |
+| Framework | N/A |
+| Architecture | MVC (Model-View-Controller) |
+| Naming | kebab-case or snake_case |
+| Indentation | unknown |
+
+---
+
+## Best Practices
+
+1. Follow the established naming conventions
+2. Keep functions small and focused
+3. Write tests for new features
+4. Use descriptive variable names
+5. Keep the architecture consistent
+6. Document complex logic
+7. Review code before committing
+
+---
+
+*Generated by ai-first*

package/test-projects/python-cli/ai/architecture.md

@@ -0,0 +1,49 @@
+# Architecture
+
+## Architectural Pattern
+**Primary**: MVC (Model-View-Controller)
+**Secondary**: CLI Application
+
+## Layers Identified
+- Domain
+
+## Key Modules
+| Module | Responsibility |
+|--------|----------------|
+| `__init__.py` | Contains 0 files |
+| `cli` | Contains 4 files |
+| `main.py` | Contains 0 files |
+| `models` | Data models and entities |
+
+
+## Module Details
+
+### __init__.py
+- **Path**: `__init__.py`
+- **Responsibility**: Contains 0 files
+
+
+### cli
+- **Path**: `cli`
+- **Responsibility**: Contains 4 files
+
+
+### main.py
+- **Path**: `main.py`
+- **Responsibility**: Contains 0 files
+
+
+### models
+- **Path**: `models`
+- **Responsibility**: Data models and entities
+
+
+
+## Recommendations
+
+- Keep the architecture consistent as the project grows
+- Follow the established layer structure
+- Use dependency injection to manage module relationships
+
+---
+*Generated by ai-first*

package/test-projects/python-cli/ai/cache.json

@@ -0,0 +1,129 @@
+{
+  "files": {
+    "__init__.py": {
+      "hash": "b8e919564af9b6e38c79d449bb77a7b5",
+      "mtime": 1773777152897.4336
+    },
+    "ai/ai_context.md": {
+      "hash": "ed58b5050b4b428a2dc5ddde0d8f0784",
+      "mtime": 1773796492511.405
+    },
+    "ai/ai_rules.md": {
+      "hash": "497d2aaa36fc25e1a1d43ad93a5e3631",
+      "mtime": 1773796492510.405
+    },
+    "ai/architecture.md": {
+      "hash": "96f6c50d3d91f5ac670473220a4aa87e",
+      "mtime": 1773796492506.4048
+    },
+    "ai/context/features/cli.json": {
+      "hash": "db233eedf90a4de1cbb42f260b4ec159",
+      "mtime": 1773796492512.405
+    },
+    "ai/context/flows/add_.json": {
+      "hash": "8fd1b0ccd628661384b1982917527e10",
+      "mtime": 1773796492512.405
+    },
+    "ai/context/flows/list_.json": {
+      "hash": "2307454625174d3b69e727acf6e10261",
+      "mtime": 1773796492512.405
+    },
+    "ai/context/flows/remove_.json": {
+      "hash": "12bece7cdabce999d2430fee0b316b3b",
+      "mtime": 1773796492512.405
+    },
+    "ai/conventions.md": {
+      "hash": "9c37d280c1cab6899447a58aa03b0f44",
+      "mtime": 1773796492508.4048
+    },
+    "ai/dependencies.json": {
+      "hash": "b1333fe58b2dddfa6ecb8c53292f442f",
+      "mtime": 1773796492509.405
+    },
+    "ai/entrypoints.md": {
+      "hash": "34c8965a66697d9f1d428bb0904f5d8d",
+      "mtime": 1773796492507.4048
+    },
+    "ai/files.json": {
+      "hash": "c82d9d1331bd255fc43be845aa368725",
+      "mtime": 1773796517554.7957
+    },
+    "ai/graph/module-graph.json": {
+      "hash": "54539a6536c57542d107b5e587852d21",
+      "mtime": 1773796517549.7954
+    },
+    "ai/modules.json": {
+      "hash": "366ccb4be2fcb4b7098548e68cee7a06",
+      "mtime": 1773796517540.7954
+    },
+    "ai/project.json": {
+      "hash": "0511f31fdb8944b75813100c96738f88",
+      "mtime": 1773796492513.405
+    },
+    "ai/repo-map.json": {
+      "hash": "a2b87275ea77eb88a7ce50f6874d52d8",
+      "mtime": 1773796517541.7954
+    },
+    "ai/repo_map.json": {
+      "hash": "aa9b5cffb4fea856e640d50ae2f843be",
+      "mtime": 1773796492505.4048
+    },
+    "ai/repo_map.md": {
+      "hash": "ef0d7f67520571d71a944a89aed09b85",
+      "mtime": 1773796492504.4048
+    },
+    "ai/schema.json": {
+      "hash": "5f906385bbf15f468465b9b3b4e4cabb",
+      "mtime": 1773796492512.405
+    },
+    "ai/summary.md": {
+      "hash": "ce45f19fa9b88934464c679faa8bb5e1",
+      "mtime": 1773796492505.4048
+    },
+    "ai/symbols.json": {
+      "hash": "cd04c4c359d5fdffb6f49d080ee81749",
+      "mtime": 1773796492509.405
+    },
+    "ai/tech_stack.md": {
+      "hash": "549e166f1ac035b5c54f522a1962321e",
+      "mtime": 1773796492507.4048
+    },
+    "ai/tools.json": {
+      "hash": "b1356e52c74e9b3b6a0d397b790a4968",
+      "mtime": 1773796492513.405
+    },
+    "cli/__init__.py": {
+      "hash": "a3b6d5054e9628836636cf4d6927e33a",
+      "mtime": 1773777227193.3157
+    },
+    "cli/add_command.py": {
+      "hash": "d9b48d790c714aebf7b29db0f8aa3464",
+      "mtime": 1773777196493.9478
+    },
+    "cli/list_command.py": {
+      "hash": "fd7ca8830013f013e16afd191e6c5c75",
+      "mtime": 1773777202889.024
+    },
+    "cli/remove_command.py": {
+      "hash": "1209f465970ad86ef87ed6c0409cef50",
+      "mtime": 1773777208836.0952
+    },
+    "main.py": {
+      "hash": "8e7d98c3b644a2b27f760c017100e886",
+      "mtime": 1773777186036.8235
+    },
+    "models/__init__.py": {
+      "hash": "a99db8f336d72b5c5700545705baf7de",
+      "mtime": 1773777266541.7935
+    },
+    "models/task.py": {
+      "hash": "95274739cbb686a2f8c661836623c692",
+      "mtime": 1773777234068.3987
+    },
+    "models/task_repository.py": {
+      "hash": "68215671f3b74e5dbd6fdc06671b08b1",
+      "mtime": 1773777261367.7302
+    }
+  },
+  "lastIndexed": "2026-03-18T01:15:17.555Z"
+}

package/test-projects/python-cli/ai/context/features/cli.json

@@ -0,0 +1,16 @@
+{
+  "name": "cli",
+  "path": "cli",
+  "files": [
+    "cli/__init__.py",
+    "cli/add_command.py",
+    "cli/list_command.py",
+    "cli/remove_command.py"
+  ],
+  "entrypoints": [
+    "cli/add_command.py",
+    "cli/list_command.py",
+    "cli/remove_command.py"
+  ],
+  "dependencies": []
+}

package/test-projects/python-cli/ai/context/flows/add_.json

@@ -0,0 +1,9 @@
+{
+  "name": "add_",
+  "entrypoint": "cli/add_command.py",
+  "files": [
+    "cli/add_command.py"
+  ],
+  "depth": 0,
+  "layers": []
+}

package/test-projects/python-cli/ai/context/flows/list_.json

@@ -0,0 +1,9 @@
+{
+  "name": "list_",
+  "entrypoint": "cli/list_command.py",
+  "files": [
+    "cli/list_command.py"
+  ],
+  "depth": 0,
+  "layers": []
+}

package/test-projects/python-cli/ai/context/flows/remove_.json

@@ -0,0 +1,9 @@
+{
+  "name": "remove_",
+  "entrypoint": "cli/remove_command.py",
+  "files": [
+    "cli/remove_command.py"
+  ],
+  "depth": 0,
+  "layers": []
+}

package/test-projects/python-cli/ai/conventions.md

@@ -0,0 +1,51 @@
+# Code Conventions
+
+## Naming Conventions
+- **Files**: kebab-case or snake_case
+
+## Project Structure
+
+## Code Style
+- **Semicolons**: Required
+
+
+## Naming Conventions
+
+| Element | Convention |
+|---------|------------|
+| Files | kebab-case or snake_case |
+| Components | unknown |
+| Test Files | unknown |
+| Directories | unknown |
+
+## Project Structure
+
+| Directory | Location |
+|-----------|----------|
+| Source | unknown |
+| Tests | unknown |
+| Config | unknown |
+
+## Code Style
+
+| Style Element | Value |
+|---------------|-------|
+| Indentation | unknown |
+| Semicolons | Required |
+
+## Testing
+
+| Aspect | Value |
+|--------|-------|
+| Framework | unknown |
+| Test Pattern | unknown |
+
+## Git
+
+| Aspect | Value |
+|--------|-------|
+| Branch Strategy | Trunk-based (main/master) |
+| Commit Format | unknown |
+
+---
+*Generated by ai-first*

package/test-projects/python-cli/ai/dependencies.json

@@ -0,0 +1,66 @@
+{
+  "totalDependencies": 8,
+  "totalModules": 5,
+  "dependencies": [
+    {
+      "source": "cli/__init__.py",
+      "target": "/.py",
+      "type": "from"
+    },
+    {
+      "source": "main.py",
+      "target": "cli/commands.py",
+      "type": "from"
+    },
+    {
+      "source": "main.py",
+      "target": "argparse.py",
+      "type": "import"
+    },
+    {
+      "source": "models/__init__.py",
+      "target": "/task.py",
+      "type": "from"
+    },
+    {
+      "source": "models/__init__.py",
+      "target": "/task_repository.py",
+      "type": "from"
+    },
+    {
+      "source": "models/task.py",
+      "target": "datetime.py",
+      "type": "from"
+    },
+    {
+      "source": "models/task_repository.py",
+      "target": "models/task.py",
+      "type": "from"
+    },
+    {
+      "source": "models/task_repository.py",
+      "target": "datetime.py",
+      "type": "from"
+    }
+  ],
+  "byFile": {
+    "cli/__init__.py": [
+      "/.py"
+    ],
+    "main.py": [
+      "cli/commands.py",
+      "argparse.py"
+    ],
+    "models/__init__.py": [
+      "/task.py",
+      "/task_repository.py"
+    ],
+    "models/task.py": [
+      "datetime.py"
+    ],
+    "models/task_repository.py": [
+      "models/task.py",
+      "datetime.py"
+    ]
+  }
+}

package/test-projects/python-cli/ai/entrypoints.md

@@ -0,0 +1,4 @@
+# Entrypoints
+
+---
+*Generated by ai-first*