ai-first-cli 1.1.2 → 1.1.5

package/test-projects/express-api/ai/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/tools.json

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

package/test-projects/express-api/controllers/authController.js

@@ -0,0 +1,32 @@
+const jwt = require('jsonwebtoken');
+const authService = require('../services/authService');
+
+const SECRET = process.env.JWT_SECRET || 'secret';
+
+async function login(req, res) {
+  try {
+    const { email, password } = req.body;
+    const user = await authService.verifyCredentials(email, password);
+    
+    if (!user) {
+      return res.status(401).json({ error: 'Invalid credentials' });
+    }
+    
+    const token = jwt.sign({ userId: user.id }, SECRET, { expiresIn: '24h' });
+    res.json({ token, user: { id: user.id, email: user.email } });
+  } catch (error) {
+    res.status(500).json({ error: error.message });
+  }
+}
+
+async function register(req, res) {
+  try {
+    const { email, password } = req.body;
+    const user = await authService.createUser(email, password);
+    res.status(201).json({ user });
+  } catch (error) {
+    res.status(500).json({ error: error.message });
+  }
+}
+
+module.exports = { login, register };

package/test-projects/express-api/controllers/userController.js

@@ -0,0 +1,51 @@
+const userService = require('../services/userService');
+
+async function getAll(req, res) {
+  try {
+    const users = await userService.findAll();
+    res.json(users);
+  } catch (error) {
+    res.status(500).json({ error: error.message });
+  }
+}
+
+async function getById(req, res) {
+  try {
+    const user = await userService.findById(req.params.id);
+    if (!user) {
+      return res.status(404).json({ error: 'User not found' });
+    }
+    res.json(user);
+  } catch (error) {
+    res.status(500).json({ error: error.message });
+  }
+}
+
+async function create(req, res) {
+  try {
+    const user = await userService.create(req.body);
+    res.status(201).json(user);
+  } catch (error) {
+    res.status(500).json({ error: error.message });
+  }
+}
+
+async function update(req, res) {
+  try {
+    const user = await userService.update(req.params.id, req.body);
+    res.json(user);
+  } catch (error) {
+    res.status(500).json({ error: error.message });
+  }
+}
+
+async function remove(req, res) {
+  try {
+    await userService.remove(req.params.id);
+    res.status(204).send();
+  } catch (error) {
+    res.status(500).json({ error: error.message });
+  }
+}
+
+module.exports = { getAll, getById, create, update, delete: remove };

package/test-projects/express-api/index.js

@@ -0,0 +1,21 @@
+const express = require('express');
+const authController = require('./controllers/authController');
+const userController = require('./controllers/userController');
+
+const app = express();
+app.use(express.json());
+
+app.post('/auth/login', authController.login);
+app.post('/auth/register', authController.register);
+app.get('/users', userController.getAll);
+app.get('/users/:id', userController.getById);
+app.post('/users', userController.create);
+app.put('/users/:id', userController.update);
+app.delete('/users/:id', userController.delete);
+
+const PORT = process.env.PORT || 3000;
+app.listen(PORT, () => {
+  console.log(`Server running on port ${PORT}`);
+});
+
+module.exports = app;

package/test-projects/express-api/middleware/authMiddleware.js

@@ -0,0 +1,30 @@
+const jwt = require('jsonwebtoken');
+
+const SECRET = process.env.JWT_SECRET || 'secret';
+
+function authenticate(req, res, next) {
+  const token = req.headers.authorization?.split(' ')[1];
+  
+  if (!token) {
+    return res.status(401).json({ error: 'No token provided' });
+  }
+  
+  try {
+    const decoded = jwt.verify(token, SECRET);
+    req.user = decoded;
+    next();
+  } catch (error) {
+    res.status(401).json({ error: 'Invalid token' });
+  }
+}
+
+function authorize(roles = []) {
+  return (req, res, next) => {
+    if (!roles.includes(req.user?.role)) {
+      return res.status(403).json({ error: 'Forbidden' });
+    }
+    next();
+  };
+}
+
+module.exports = { authenticate, authorize };

package/test-projects/express-api/models/userRepository.js

@@ -0,0 +1,25 @@
+const users = [];
+
+const db = {
+  findAll: () => Promise.resolve(users),
+  findById: (id) => Promise.resolve(users.find(u => u.id === id)),
+  findByEmail: (email) => Promise.resolve(users.find(u => u.email === email)),
+  create: (data) => {
+    const user = { id: String(users.length + 1), ...data };
+    users.push(user);
+    return Promise.resolve(user);
+  },
+  update: (id, data) => {
+    const index = users.findIndex(u => u.id === id);
+    if (index === -1) return Promise.resolve(null);
+    users[index] = { ...users[index], ...data };
+    return Promise.resolve(users[index]);
+  },
+  delete: (id) => {
+    const index = users.findIndex(u => u.id === id);
+    if (index !== -1) users.splice(index, 1);
+    return Promise.resolve();
+  }
+};
+
+module.exports = db;

package/test-projects/express-api/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "express-api",
+  "version": "1.0.0",
+  "description": "Express.js API with auth and users",
+  "main": "index.js",
+  "scripts": {
+    "start": "node index.js",
+    "dev": "nodemon index.js"
+  },
+  "dependencies": {
+    "express": "^4.18.2",
+    "jsonwebtoken": "^9.0.0",
+    "bcrypt": "^5.1.0"
+  },
+  "devDependencies": {
+    "nodemon": "^3.0.0"
+  }
+}

package/test-projects/express-api/services/authService.js

@@ -0,0 +1,17 @@
+const bcrypt = require('bcrypt');
+const userRepository = require('../models/userRepository');
+
+async function verifyCredentials(email, password) {
+  const user = await userRepository.findByEmail(email);
+  if (!user) return null;
+  
+  const valid = await bcrypt.compare(password, user.password);
+  return valid ? user : null;
+}
+
+async function createUser(email, password) {
+  const hashedPassword = await bcrypt.hash(password, 10);
+  return userRepository.create({ email, password: hashedPassword });
+}
+
+module.exports = { verifyCredentials, createUser };

package/test-projects/express-api/services/userService.js

@@ -0,0 +1,28 @@
+class UserService {
+  constructor(repository) {
+    this.repository = repository;
+  }
+
+  async findAll() {
+    return this.repository.findAll();
+  }
+
+  async findById(id) {
+    return this.repository.findById(id);
+  }
+
+  async create(data) {
+    return this.repository.create(data);
+  }
+
+  async update(id, data) {
+    return this.repository.update(id, data);
+  }
+
+  async remove(id) {
+    return this.repository.delete(id);
+  }
+}
+
+const repository = require('../models/userRepository');
+module.exports = new UserService(repository);

package/test-projects/nestjs-backend/ai/ai_context.md

@@ -0,0 +1,110 @@
+# AI Context
+
+> This file provides a comprehensive overview of the repository for AI coding assistants.
+
+---
+
+## Quick Overview
+
+- **Pattern**: Flat / Simple Structure
+- **Languages**: JSON, TypeScript
+- **Frameworks**: TypeScript
+- **Total Files**: 12
+
+---
+
+## 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**: JSON, TypeScript
+
+**Frameworks**: TypeScript
+
+**Libraries**: Passport.js
+
+**Package Managers**: npm
+
+---
+
+## Architecture
+
+## Architectural Pattern
+**Primary**: Flat / Simple Structure
+
+## Layers Identified
+- Infrastructure
+- Config
+
+## Key Modules
+| Module | Responsibility |
+|--------|----------------|
+| `package.json` | Contains 0 files |
+| `src` | Contains 10 files |
+| `tsconfig.json` | Configuration management |
+
+
+---
+
+## Key Entrypoints
+
+### Build
+- `package.json#scripts.build` - build: nest build
+
+### Server
+- `package.json#scripts.start` - start: nest start
+- `package.json#scripts.start:dev` - start:dev: nest start --watch
+- `src/main.ts` - Main
+
+---
+
+## Code Conventions
+
+## Naming Conventions
+- **Files**: camelCase
+
+## Project Structure
+- **Source**: src/
+
+## Code Style
+- **Semicolons**: Required
+
+
+---
+
+## AI Rules
+
+- Language: Use JSON, TypeScript
+- Frameworks: TypeScript
+- Architecture: Follow Flat / Simple Structure pattern
+- File naming: camelCase
+- Source directory: src/
+
+---
+
+## 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/nestjs-backend/ai/ai_rules.md

@@ -0,0 +1,52 @@
+# AI Rules
+
+> Guidelines for AI assistants working on this project
+
+---
+
+## Guidelines
+
+- Language: Use JSON, TypeScript
+- Frameworks: TypeScript
+- Architecture: Follow Flat / Simple Structure pattern
+- File naming: camelCase
+- Source directory: src/
+- Main entry: package.json#scripts.start
+- Dev command: npm run start:dev
+- Build command: npm run build
+
+## Patterns
+
+- Layer structure: infrastructure → config
+
+## Constraints
+
+- Always use semicolons
+
+---
+
+## Quick Reference
+
+| Category | Value |
+|----------|-------|
+| Language | JSON, TypeScript |
+| Framework | TypeScript |
+| Architecture | Flat / Simple Structure |
+| 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/nestjs-backend/ai/architecture.md

@@ -0,0 +1,43 @@
+# Architecture
+
+## Architectural Pattern
+**Primary**: Flat / Simple Structure
+
+## Layers Identified
+- Infrastructure
+- Config
+
+## Key Modules
+| Module | Responsibility |
+|--------|----------------|
+| `package.json` | Contains 0 files |
+| `src` | Contains 10 files |
+| `tsconfig.json` | Configuration management |
+
+
+## Module Details
+
+### package.json
+- **Path**: `package.json`
+- **Responsibility**: Contains 0 files
+
+
+### src
+- **Path**: `src`
+- **Responsibility**: Contains 10 files
+
+
+### tsconfig.json
+- **Path**: `tsconfig.json`
+- **Responsibility**: Configuration management
+
+
+
+## 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/nestjs-backend/ai/cache.json

@@ -0,0 +1,137 @@
+{
+  "files": {
+    "ai/ai_context.md": {
+      "hash": "01e94675a8faa5d598f2782c09e3d5ad",
+      "mtime": 1773796492431.4038
+    },
+    "ai/ai_rules.md": {
+      "hash": "0056c2b3f1d212bd870734924f577d09",
+      "mtime": 1773796492431.4038
+    },
+    "ai/architecture.md": {
+      "hash": "b763c79531f89caf3a6731d8c6b4f157",
+      "mtime": 1773796492425.4036
+    },
+    "ai/context/features/src.json": {
+      "hash": "e62d7f714439c64f0a0051436687b023",
+      "mtime": 1773796492433.4038
+    },
+    "ai/context/flows/auth..json": {
+      "hash": "064519d0be7978f42c408cf2f99edaf9",
+      "mtime": 1773796492433.4038
+    },
+    "ai/context/flows/users..json": {
+      "hash": "743cdda74793f8b1d4fac2656267c24b",
+      "mtime": 1773796492433.4038
+    },
+    "ai/conventions.md": {
+      "hash": "9924468f87cfd5d2328fa48737aac075",
+      "mtime": 1773796492427.4036
+    },
+    "ai/dependencies.json": {
+      "hash": "7dbe8e380f477563ed486728fc7d796e",
+      "mtime": 1773796492430.4038
+    },
+    "ai/entrypoints.md": {
+      "hash": "31bc6c36186b7db7764086f994a34fcf",
+      "mtime": 1773796492426.4036
+    },
+    "ai/files.json": {
+      "hash": "6fc0e5f9f769544e4d28bbd29197b2f5",
+      "mtime": 1773796517474.7942
+    },
+    "ai/graph/module-graph.json": {
+      "hash": "0e4d69958d08b9aaf402549b2cfe2b3a",
+      "mtime": 1773796517467.7942
+    },
+    "ai/modules.json": {
+      "hash": "11513775b7ba2c22e59f9bd915ea33fa",
+      "mtime": 1773796517464.7942
+    },
+    "ai/project.json": {
+      "hash": "3dccdf21bae258d5c57bd9001b4b39e6",
+      "mtime": 1773796492433.4038
+    },
+    "ai/repo-map.json": {
+      "hash": "d0781e3898006491005ab603b6fe5f2a",
+      "mtime": 1773796517466.0496
+    },
+    "ai/repo_map.json": {
+      "hash": "7646f8ddcac9b2573aefd42e6dbf7186",
+      "mtime": 1773796492423.4036
+    },
+    "ai/repo_map.md": {
+      "hash": "d3b93db63ba7b92c1bcba98b7682b487",
+      "mtime": 1773796492423.4036
+    },
+    "ai/schema.json": {
+      "hash": "b7af586eb15247e9b5c644920a03afa4",
+      "mtime": 1773796492433.4038
+    },
+    "ai/summary.md": {
+      "hash": "c97180815314cb04e69623f705703641",
+      "mtime": 1773796492424.4036
+    },
+    "ai/symbols.json": {
+      "hash": "86f0962de99584aca04f8773850703ba",
+      "mtime": 1773796492428.4036
+    },
+    "ai/tech_stack.md": {
+      "hash": "a84eb022eb8e5959365181abc81e5f9d",
+      "mtime": 1773796492426.4036
+    },
+    "ai/tools.json": {
+      "hash": "b1356e52c74e9b3b6a0d397b790a4968",
+      "mtime": 1773796492433.4038
+    },
+    "package.json": {
+      "hash": "54188023d3f4898db4ed5ecb0963ad7c",
+      "mtime": 1773776957019.264
+    },
+    "src/app.module.ts": {
+      "hash": "340f55f1f816bff231e0d7cceb640a6a",
+      "mtime": 1773777098469.8062
+    },
+    "src/auth/auth.controller.ts": {
+      "hash": "042f9828f736d2cd17f81a9f38e92902",
+      "mtime": 1773776992110.6333
+    },
+    "src/auth/auth.module.ts": {
+      "hash": "d77f0da16ab8259e61017e585aa84ba1",
+      "mtime": 1773776981771.5234
+    },
+    "src/auth/auth.service.ts": {
+      "hash": "82d1c6ef4273438c42f5ec7a6d11af7e",
+      "mtime": 1773777003294.753
+    },
+    "src/auth/dto/login.dto.ts": {
+      "hash": "ea30ef087078e1172bffc80a370ebff3",
+      "mtime": 1773777024191.979
+    },
+    "src/auth/strategies/jwt.strategy.ts": {
+      "hash": "0f76815e6d72c4b1d3324713b6c09853",
+      "mtime": 1773777033163.077
+    },
+    "src/main.ts": {
+      "hash": "37685b56941c1e865638bae7fd76d81c",
+      "mtime": 1773777107555.9097
+    },
+    "src/users/users.controller.ts": {
+      "hash": "41b4cfa3872766fb0578a901abd294fa",
+      "mtime": 1773777065483.4343
+    },
+    "src/users/users.module.ts": {
+      "hash": "f3eb2901994d3dcf77b5bb6766f937aa",
+      "mtime": 1773777054886.3164
+    },
+    "src/users/users.service.ts": {
+      "hash": "34c037f935826f26a9f72d53774a3223",
+      "mtime": 1773777078186.5767
+    },
+    "tsconfig.json": {
+      "hash": "f0902e207501d022c8048ac457251ecc",
+      "mtime": 1773777131755.1877
+    }
+  },
+  "lastIndexed": "2026-03-18T01:15:17.476Z"
+}

package/test-projects/nestjs-backend/ai/context/features/src.json

@@ -0,0 +1,23 @@
+{
+  "name": "src",
+  "path": "src",
+  "files": [
+    "src/app.module.ts",
+    "src/auth/auth.controller.ts",
+    "src/auth/auth.module.ts",
+    "src/auth/auth.service.ts",
+    "src/auth/dto/login.dto.ts",
+    "src/auth/strategies/jwt.strategy.ts",
+    "src/main.ts",
+    "src/users/users.controller.ts",
+    "src/users/users.module.ts",
+    "src/users/users.service.ts"
+  ],
+  "entrypoints": [
+    "src/auth/auth.controller.ts",
+    "src/auth/auth.service.ts",
+    "src/users/users.controller.ts",
+    "src/users/users.service.ts"
+  ],
+  "dependencies": []
+}

package/test-projects/nestjs-backend/ai/context/flows/auth..json

@@ -0,0 +1,10 @@
+{
+  "name": "auth.",
+  "entrypoint": "src/auth/auth.controller.ts",
+  "files": [
+    "src/auth/auth.controller.ts",
+    "src/auth/auth.service.ts"
+  ],
+  "depth": 0,
+  "layers": []
+}

package/test-projects/nestjs-backend/ai/context/flows/users..json

@@ -0,0 +1,10 @@
+{
+  "name": "users.",
+  "entrypoint": "src/users/users.controller.ts",
+  "files": [
+    "src/users/users.controller.ts",
+    "src/users/users.service.ts"
+  ],
+  "depth": 0,
+  "layers": []
+}