ai-first-cli 1.1.3 → 1.2.0

package/test-projects/express-api/.ai-dev/ai_context.md

@@ -0,0 +1,112 @@
+# AI Context
+
+> This file provides a comprehensive overview of the repository for AI coding assistants.
+
+---
+
+## Quick Overview
+
+- **Pattern**: MVC (Model-View-Controller)
+- **Languages**: JavaScript, JSON
+- **Frameworks**: Express.js
+- **Total Files**: 8
+
+---
+
+## 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**: JavaScript, JSON
+
+**Frameworks**: Express.js
+
+**Libraries**: Bcrypt, JWT
+
+**Package Managers**: npm
+
+---
+
+## Architecture
+
+## Architectural Pattern
+**Primary**: MVC (Model-View-Controller)
+**Secondary**: Layered Architecture, Microservices
+
+## Layers Identified
+- Application
+- Domain
+
+## Key Modules
+| Module | Responsibility |
+|--------|----------------|
+| `controllers` | API endpoints and request handling |
+| `index.js` | Contains 0 files |
+| `middleware` | Request/response middleware |
+| `models` | Data models and entities |
+| `package.json` | Contains 0 files |
+| `services` | Business logic and use cases |
+
+
+---
+
+## Key Entrypoints
+
+### Library
+- `index.js` - Main entry point
+
+### Server
+- `package.json#scripts.start` - start: node index.js
+- `package.json#scripts.dev` - dev: nodemon index.js
+
+---
+
+## Code Conventions
+
+## Naming Conventions
+- **Files**: camelCase
+
+## Project Structure
+
+## Code Style
+- **Semicolons**: Required
+
+
+---
+
+## AI Rules
+
+- Language: Use JavaScript, JSON
+- Frameworks: Express.js
+- Architecture: Follow MVC (Model-View-Controller) pattern
+- File naming: camelCase
+- Main entry: package.json#scripts.start
+
+---
+
+## 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/express-api/.ai-dev/ai_rules.md

@@ -0,0 +1,50 @@
+# AI Rules
+
+> Guidelines for AI assistants working on this project
+
+---
+
+## Guidelines
+
+- Language: Use JavaScript, JSON
+- Frameworks: Express.js
+- Architecture: Follow MVC (Model-View-Controller) pattern
+- File naming: camelCase
+- Main entry: package.json#scripts.start
+- Dev command: npm run dev
+
+## Patterns
+
+- Layer structure: application → domain
+
+## Constraints
+
+- Always use semicolons
+
+---
+
+## Quick Reference
+
+| Category | Value |
+|----------|-------|
+| Language | JavaScript, JSON |
+| Framework | Express.js |
+| Architecture | MVC (Model-View-Controller) |
+| Naming | camelCase |
+| 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/express-api/.ai-dev/architecture.md

@@ -0,0 +1,62 @@
+# Architecture
+
+## Architectural Pattern
+**Primary**: MVC (Model-View-Controller)
+**Secondary**: Layered Architecture, Microservices
+
+## Layers Identified
+- Application
+- Domain
+
+## Key Modules
+| Module | Responsibility |
+|--------|----------------|
+| `controllers` | API endpoints and request handling |
+| `index.js` | Contains 0 files |
+| `middleware` | Request/response middleware |
+| `models` | Data models and entities |
+| `package.json` | Contains 0 files |
+| `services` | Business logic and use cases |
+
+
+## Module Details
+
+### controllers
+- **Path**: `controllers`
+- **Responsibility**: API endpoints and request handling
+- **Depends on**: service, model
+
+### index.js
+- **Path**: `index.js`
+- **Responsibility**: Contains 0 files
+
+
+### middleware
+- **Path**: `middleware`
+- **Responsibility**: Request/response middleware
+
+
+### models
+- **Path**: `models`
+- **Responsibility**: Data models and entities
+
+
+### package.json
+- **Path**: `package.json`
+- **Responsibility**: Contains 0 files
+
+
+### services
+- **Path**: `services`
+- **Responsibility**: Business logic and use cases
+- **Depends on**: model, repository
+
+
+## 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/express-api/.ai-dev/context/features/controllers.json

@@ -0,0 +1,13 @@
+{
+  "name": "controllers",
+  "path": "controllers",
+  "files": [
+    "controllers/authController.js",
+    "controllers/userController.js"
+  ],
+  "entrypoints": [
+    "controllers/authController.js",
+    "controllers/userController.js"
+  ],
+  "dependencies": []
+}

package/test-projects/express-api/.ai-dev/context/features/services.json

@@ -0,0 +1,13 @@
+{
+  "name": "services",
+  "path": "services",
+  "files": [
+    "services/authService.js",
+    "services/userService.js"
+  ],
+  "entrypoints": [
+    "services/authService.js",
+    "services/userService.js"
+  ],
+  "dependencies": []
+}

package/test-projects/express-api/.ai-dev/context/flows/auth.json

@@ -0,0 +1,12 @@
+{
+  "name": "auth",
+  "entrypoint": "controllers/authController.js",
+  "files": [
+    "controllers/authController.js",
+    "services/authService.js"
+  ],
+  "depth": 1,
+  "layers": [
+    "service"
+  ]
+}

package/test-projects/express-api/.ai-dev/context/flows/user.json

@@ -0,0 +1,13 @@
+{
+  "name": "user",
+  "entrypoint": "controllers/userController.js",
+  "files": [
+    "controllers/userController.js",
+    "models/userRepository.js",
+    "services/userService.js"
+  ],
+  "depth": 1,
+  "layers": [
+    "service"
+  ]
+}

package/test-projects/express-api/.ai-dev/conventions.md

@@ -0,0 +1,51 @@
+# Code Conventions
+
+## Naming Conventions
+- **Files**: camelCase
+
+## Project Structure
+
+## Code Style
+- **Semicolons**: Required
+
+
+## Naming Conventions
+
+| Element | Convention |
+|---------|------------|
+| Files | camelCase |
+| 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/express-api/.ai-dev/dependencies.json

@@ -0,0 +1,54 @@
+{
+  "totalDependencies": 6,
+  "totalModules": 5,
+  "dependencies": [
+    {
+      "source": "controllers/authController.js",
+      "target": "services/authService",
+      "type": "require"
+    },
+    {
+      "source": "controllers/userController.js",
+      "target": "services/userService",
+      "type": "require"
+    },
+    {
+      "source": "index.js",
+      "target": "controllers/authController",
+      "type": "require"
+    },
+    {
+      "source": "index.js",
+      "target": "controllers/userController",
+      "type": "require"
+    },
+    {
+      "source": "services/authService.js",
+      "target": "models/userRepository",
+      "type": "require"
+    },
+    {
+      "source": "services/userService.js",
+      "target": "models/userRepository",
+      "type": "require"
+    }
+  ],
+  "byFile": {
+    "controllers/authController.js": [
+      "services/authService"
+    ],
+    "controllers/userController.js": [
+      "services/userService"
+    ],
+    "index.js": [
+      "controllers/authController",
+      "controllers/userController"
+    ],
+    "services/authService.js": [
+      "models/userRepository"
+    ],
+    "services/userService.js": [
+      "models/userRepository"
+    ]
+  }
+}

package/test-projects/express-api/.ai-dev/entrypoints.md

@@ -0,0 +1,17 @@
+# Entrypoints
+
+## Library
+
+| Name | Path | Command |
+|------|------|--------|
+| Main | `index.js` | - |
+
+## Server
+
+| Name | Path | Command |
+|------|------|--------|
+| start | `package.json#scripts.start` | npm run start |
+| dev | `package.json#scripts.dev` | npm run dev |
+
+---
+*Generated by ai-first*

package/test-projects/express-api/.ai-dev/modules.json

@@ -0,0 +1,30 @@
+{
+  "modules": {
+    "controllers": {
+      "path": "controllers",
+      "files": [
+        "controllers/authController.js",
+        "controllers/userController.js"
+      ]
+    },
+    "middleware": {
+      "path": "middleware",
+      "files": [
+        "middleware/authMiddleware.js"
+      ]
+    },
+    "models": {
+      "path": "models",
+      "files": [
+        "models/userRepository.js"
+      ]
+    },
+    "services": {
+      "path": "services",
+      "files": [
+        "services/authService.js",
+        "services/userService.js"
+      ]
+    }
+  }
+}

package/test-projects/express-api/.ai-dev/project.json

@@ -0,0 +1,15 @@
+{
+  "name": "express-api",
+  "rootDir": "/mnt/m2/Código/opencode-ai-first/test-projects/express-api",
+  "features": [
+    "controllers",
+    "services"
+  ],
+  "flows": [
+    "auth",
+    "user"
+  ],
+  "languages": [],
+  "frameworks": [],
+  "generatedAt": "2026-03-19T01:00:36.366Z"
+}

package/test-projects/express-api/.ai-dev/repo_map.json

@@ -0,0 +1,100 @@
+{
+  "generated": "2026-03-19T01:00:36.355Z",
+  "totalFiles": 8,
+  "structure": {
+    "controllers": {
+      "type": "directory",
+      "children": {
+        "authController.js": {
+          "type": "file",
+          "extension": "js"
+        },
+        "userController.js": {
+          "type": "file",
+          "extension": "js"
+        }
+      }
+    },
+    "index.js": {
+      "type": "file",
+      "extension": "js"
+    },
+    "middleware": {
+      "type": "directory",
+      "children": {
+        "authMiddleware.js": {
+          "type": "file",
+          "extension": "js"
+        }
+      }
+    },
+    "models": {
+      "type": "directory",
+      "children": {
+        "userRepository.js": {
+          "type": "file",
+          "extension": "js"
+        }
+      }
+    },
+    "package.json": {
+      "type": "file",
+      "extension": "json"
+    },
+    "services": {
+      "type": "directory",
+      "children": {
+        "authService.js": {
+          "type": "file",
+          "extension": "js"
+        },
+        "userService.js": {
+          "type": "file",
+          "extension": "js"
+        }
+      }
+    }
+  },
+  "files": [
+    {
+      "path": "controllers/authController.js",
+      "name": "authController.js",
+      "extension": "js"
+    },
+    {
+      "path": "controllers/userController.js",
+      "name": "userController.js",
+      "extension": "js"
+    },
+    {
+      "path": "index.js",
+      "name": "index.js",
+      "extension": "js"
+    },
+    {
+      "path": "middleware/authMiddleware.js",
+      "name": "authMiddleware.js",
+      "extension": "js"
+    },
+    {
+      "path": "models/userRepository.js",
+      "name": "userRepository.js",
+      "extension": "js"
+    },
+    {
+      "path": "package.json",
+      "name": "package.json",
+      "extension": "json"
+    },
+    {
+      "path": "services/authService.js",
+      "name": "authService.js",
+      "extension": "js"
+    },
+    {
+      "path": "services/userService.js",
+      "name": "userService.js",
+      "extension": "js"
+    }
+  ]
+}

package/test-projects/express-api/.ai-dev/repo_map.md

@@ -0,0 +1,36 @@
+# Repository Map
+## controllers
+  - authController.js
+  - userController.js
+
+## index.js
+  - index.js
+
+## middleware
+  - authMiddleware.js
+
+## models
+  - userRepository.js
+
+## package.json
+  - package.json
+
+## services
+  - authService.js
+  - userService.js
+
+
+
+# Repository Structure (Tree View)
+├── controllers/
+│   ├── authController.js
+│   └── userController.js
+├── middleware/
+│   └── authMiddleware.js
+├── models/
+│   └── userRepository.js
+├── services/
+│   ├── authService.js
+│   └── userService.js
+├── index.js
+└── package.json

package/test-projects/express-api/.ai-dev/schema.json

@@ -0,0 +1,5 @@
+{
+  "schemaVersion": "1.0",
+  "generatedBy": "ai-first",
+  "generatedAt": "2026-03-19T01:00:36.365Z"
+}

package/test-projects/express-api/.ai-dev/summary.md

@@ -0,0 +1,14 @@
+# Repository Summary
+- **Total files**: 8
+
+## Files by Extension
+  - .js: 7
+  - .json: 1
+
+## Files by Directory
+  - controllers: 2
+  - index.js: 1
+  - middleware: 1
+  - models: 1
+  - package.json: 1
+  - services: 2

package/test-projects/express-api/.ai-dev/symbols.json

@@ -0,0 +1,7 @@
+{
+  "symbols": {},
+  "total": 0,
+  "byType": {},
+  "byFile": {},
+  "exported": []
+}

package/test-projects/express-api/.ai-dev/tech_stack.md

@@ -0,0 +1,38 @@
+# Technology Stack
+
+**Languages**: JavaScript, JSON
+
+**Frameworks**: Express.js
+
+**Libraries**: Bcrypt, JWT
+
+**Package Managers**: npm
+
+## Languages
+- JavaScript
+- JSON
+
+## Frameworks
+- Express.js
+
+## Key Libraries
+- Bcrypt
+- JWT
+
+## Development Tools
+- None detected
+
+## Package Managers
+- npm
+
+## Testing
+- None detected
+
+## Linters
+- None detected
+
+## Formatters
+- None detected
+
+---
+*Generated by ai-first*

package/test-projects/express-api/.ai-dev/tools.json

@@ -0,0 +1,10 @@
+{
+  "compatibleAgents": [
+    "ai-first-bridge",
+    "opencode",
+    "cursor",
+    "windsurf",
+    "cline"
+  ],
+  "schemaVersion": "1.0"
+}