ai-first-cli 1.1.5 → 1.2.0

package/test-projects/nestjs-backend/.ai-dev/repo_map.md

@@ -0,0 +1,104 @@
+# Repository Map
+## ai
+  - ai_context.md
+  - ai_rules.md
+  - architecture.md
+  - auth..json
+  - auth.controller.json
+  - auth.json
+  - cache.json
+  - conventions.md
+  - dependencies.json
+  - entrypoints.md
+  - files.json
+  - index-state.json
+  - module-graph.json
+  - modules.json
+  - project.json
+  - repo_map.json
+  - repo_map.md
+  - repo-map.json
+  - schema.json
+  - src.json
+  - summary.md
+  - symbol-graph.json
+  - symbol-references.json
+  - symbols.json
+  - tech_stack.md
+  - tools.json
+  - users..json
+  - users.controller.json
+  - users.json
+
+## package.json
+  - package.json
+
+## src
+  - app.module.ts
+  - auth.controller.ts
+  - auth.module.ts
+  - auth.service.ts
+  - jwt.strategy.ts
+  - login.dto.ts
+  - main.ts
+  - users.controller.ts
+  - users.module.ts
+  - users.service.ts
+
+## tsconfig.json
+  - tsconfig.json
+
+
+
+# Repository Structure (Tree View)
+├── ai/
+│   ├── context/
+│   │   ├── features/
+│   │   │   └── src.json
+│   │   └── flows/
+│   │       ├── auth..json
+│   │       ├── auth.controller.json
+│   │       ├── auth.json
+│   │       ├── users..json
+│   │       ├── users.controller.json
+│   │       └── users.json
+│   ├── graph/
+│   │   ├── module-graph.json
+│   │   ├── symbol-graph.json
+│   │   └── symbol-references.json
+│   ├── ai_context.md
+│   ├── ai_rules.md
+│   ├── architecture.md
+│   ├── cache.json
+│   ├── conventions.md
+│   ├── dependencies.json
+│   ├── entrypoints.md
+│   ├── files.json
+│   ├── index-state.json
+│   ├── modules.json
+│   ├── project.json
+│   ├── repo-map.json
+│   ├── repo_map.json
+│   ├── repo_map.md
+│   ├── schema.json
+│   ├── summary.md
+│   ├── symbols.json
+│   ├── tech_stack.md
+│   └── tools.json
+├── src/
+│   ├── auth/
+│   │   ├── dto/
+│   │   │   └── login.dto.ts
+│   │   ├── strategies/
+│   │   │   └── jwt.strategy.ts
+│   │   ├── auth.controller.ts
+│   │   ├── auth.module.ts
+│   │   └── auth.service.ts
+│   ├── users/
+│   │   ├── users.controller.ts
+│   │   ├── users.module.ts
+│   │   └── users.service.ts
+│   ├── app.module.ts
+│   └── main.ts
+├── package.json
+└── tsconfig.json

package/test-projects/nestjs-backend/.ai-dev/schema.json

@@ -0,0 +1,5 @@
+{
+  "schemaVersion": "1.0",
+  "generatedBy": "ai-first",
+  "generatedAt": "2026-03-18T19:21:52.231Z"
+}

package/test-projects/nestjs-backend/{ai → .ai-dev}/summary.md

@@ -1,11 +1,13 @@
 # Repository Summary
-- **Total files**: 12
+- **Total files**: 41
 
 ## Files by Extension
-  - .json: 2
+  - .json: 23
+  - .md: 8
   - .ts: 10
 
 ## Files by Directory
+  - ai: 29
   - package.json: 1
   - src: 10
   - tsconfig.json: 1

package/test-projects/nestjs-backend/.ai-dev/symbols.json

@@ -0,0 +1 @@
+[]

package/test-projects/nestjs-backend/{ai → .ai-dev}/tech_stack.md

@@ -1,6 +1,6 @@
 # Technology Stack
 
-**Languages**: JSON, TypeScript
+**Languages**: Markdown, JSON, TypeScript
 
 **Frameworks**: TypeScript
 
@@ -9,6 +9,7 @@
 **Package Managers**: npm
 
 ## Languages
+- Markdown
 - JSON
 - TypeScript
 

package/test-projects/nestjs-backend/.ai-dev/tools.json

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

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

@@ -0,0 +1,111 @@
+# AI Context
+
+> This file provides a comprehensive overview of the repository for AI coding assistants.
+
+---
+
+## Quick Overview
+
+- **Pattern**: Flat / Simple Structure
+- **Languages**: Markdown, JSON, TypeScript
+- **Frameworks**: TypeScript
+- **Total Files**: 41
+
+---
+
+## 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**: Markdown, 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 |
+|--------|----------------|
+| `ai` | Contains 29 files |
+| `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**: kebab-case or snake_case
+
+## Project Structure
+- **Source**: src/
+
+## Code Style
+- **Semicolons**: Required
+
+
+---
+
+## AI Rules
+
+- Language: Use Markdown, JSON, TypeScript
+- Frameworks: TypeScript
+- Architecture: Follow Flat / Simple Structure pattern
+- File naming: kebab-case or snake_case
+- 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-context/ai_rules.md

@@ -0,0 +1,52 @@
+# AI Rules
+
+> Guidelines for AI assistants working on this project
+
+---
+
+## Guidelines
+
+- Language: Use Markdown, JSON, TypeScript
+- Frameworks: TypeScript
+- Architecture: Follow Flat / Simple Structure pattern
+- File naming: kebab-case or snake_case
+- 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 | Markdown, JSON, TypeScript |
+| Framework | TypeScript |
+| Architecture | Flat / Simple Structure |
+| 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/nestjs-backend/ai-context/architecture.md

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

@@ -0,0 +1,169 @@
+{
+  "files": {
+    "ai/ai_context.md": {
+      "hash": "dc4d82dff3d163eec91a59ffd33a9d0b",
+      "mtime": 1773861712228.3884
+    },
+    "ai/ai_rules.md": {
+      "hash": "ff38809c07720686d6283332a4760f65",
+      "mtime": 1773861712227.3884
+    },
+    "ai/architecture.md": {
+      "hash": "9cd69e54b4936db380d2f02eaa91159c",
+      "mtime": 1773861712219.3884
+    },
+    "ai/cache.json": {
+      "hash": "26c8ef59478d363a106dfd15b861e043",
+      "mtime": 1773854929731.0337
+    },
+    "ai/context/features/src.json": {
+      "hash": "e62d7f714439c64f0a0051436687b023",
+      "mtime": 1773861712230.3884
+    },
+    "ai/context/flows/auth..json": {
+      "hash": "064519d0be7978f42c408cf2f99edaf9",
+      "mtime": 1773861712230.3884
+    },
+    "ai/context/flows/auth.controller.json": {
+      "hash": "a61ee04c482158f50919e84978222248",
+      "mtime": 1773854929731.0337
+    },
+    "ai/context/flows/auth.json": {
+      "hash": "064519d0be7978f42c408cf2f99edaf9",
+      "mtime": 1773854807615.8489
+    },
+    "ai/context/flows/users..json": {
+      "hash": "743cdda74793f8b1d4fac2656267c24b",
+      "mtime": 1773861712230.3884
+    },
+    "ai/context/flows/users.controller.json": {
+      "hash": "a797f6c268b0619dc79a49e34ed9dc0f",
+      "mtime": 1773854929731.0337
+    },
+    "ai/context/flows/users.json": {
+      "hash": "743cdda74793f8b1d4fac2656267c24b",
+      "mtime": 1773854807615.8489
+    },
+    "ai/conventions.md": {
+      "hash": "4a959bcf697c45bbc461ff8a3a85ca09",
+      "mtime": 1773861712222.3884
+    },
+    "ai/dependencies.json": {
+      "hash": "7dbe8e380f477563ed486728fc7d796e",
+      "mtime": 1773861712226.3884
+    },
+    "ai/entrypoints.md": {
+      "hash": "31bc6c36186b7db7764086f994a34fcf",
+      "mtime": 1773861712221.3884
+    },
+    "ai/files.json": {
+      "hash": "6fc0e5f9f769544e4d28bbd29197b2f5",
+      "mtime": 1773861712313.39
+    },
+    "ai/graph/module-graph.json": {
+      "hash": "0e4d69958d08b9aaf402549b2cfe2b3a",
+      "mtime": 1773861712303.3896
+    },
+    "ai/graph/symbol-graph.json": {
+      "hash": "986b59bfb6749a14615b087b9bad8319",
+      "mtime": 1773861712312.39
+    },
+    "ai/graph/symbol-references.json": {
+      "hash": "79cb95e21ec8f98e24480e9ca0dca706",
+      "mtime": 1773861712313.39
+    },
+    "ai/index-state.json": {
+      "hash": "0a1cb9edc3311943232bc10889d43ba0",
+      "mtime": 1773854832725.3047
+    },
+    "ai/modules.json": {
+      "hash": "11513775b7ba2c22e59f9bd915ea33fa",
+      "mtime": 1773861712301.3896
+    },
+    "ai/project.json": {
+      "hash": "d42baa9ea486ea455dd97c61dd510da2",
+      "mtime": 1773861712231.3887
+    },
+    "ai/repo-map.json": {
+      "hash": "8d09dadd3cb2015e8f47f36fcccf90b7",
+      "mtime": 1773861712302.3896
+    },
+    "ai/repo_map.json": {
+      "hash": "97716ee79dfb6da78b13e42f9199d9eb",
+      "mtime": 1773861712218.3884
+    },
+    "ai/repo_map.md": {
+      "hash": "0b62ca4d2dfecdec6553535a0ebac43a",
+      "mtime": 1773861712217.3884
+    },
+    "ai/schema.json": {
+      "hash": "becd5147ab1da9871232b649b2e88199",
+      "mtime": 1773861712230.3884
+    },
+    "ai/summary.md": {
+      "hash": "ce16f1c5df38a01c0858233859198dc2",
+      "mtime": 1773861712218.3884
+    },
+    "ai/symbols.json": {
+      "hash": "86f0962de99584aca04f8773850703ba",
+      "mtime": 1773861712224.3884
+    },
+    "ai/tech_stack.md": {
+      "hash": "b74441da415edfa8e680d22fc6fab869",
+      "mtime": 1773861712221.3884
+    },
+    "ai/tools.json": {
+      "hash": "b1356e52c74e9b3b6a0d397b790a4968",
+      "mtime": 1773861712231.3887
+    },
+    "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-18T19:21:52.314Z"
+}

package/test-projects/nestjs-backend/ai-context/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/context/flows/auth.controller.json

@@ -0,0 +1,14 @@
+{
+  "name": "auth.controller",
+  "entrypoint": "src/auth/auth.controller.ts",
+  "files": [
+    "src/auth/auth.controller.ts",
+    "@nestjs/common",
+    "src/auth/./auth.service/index"
+  ],
+  "depth": 3,
+  "layers": [
+    "util",
+    "unknown"
+  ]
+}

package/test-projects/nestjs-backend/ai-context/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/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": []
+}

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

@@ -0,0 +1,14 @@
+{
+  "name": "users.controller",
+  "entrypoint": "src/users/users.controller.ts",
+  "files": [
+    "src/users/users.controller.ts",
+    "@nestjs/common",
+    "src/users/./users.service/index"
+  ],
+  "depth": 3,
+  "layers": [
+    "util",
+    "unknown"
+  ]
+}

package/test-projects/nestjs-backend/ai-context/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": []
+}

package/test-projects/nestjs-backend/ai-context/conventions.md

@@ -0,0 +1,52 @@
+# Code Conventions
+
+## Naming Conventions
+- **Files**: kebab-case or snake_case
+
+## Project Structure
+- **Source**: src/
+
+## Code Style
+- **Semicolons**: Required
+
+
+## Naming Conventions
+
+| Element | Convention |
+|---------|------------|
+| Files | kebab-case or snake_case |
+| Components | unknown |
+| Test Files | unknown |
+| Directories | src/ |
+
+## Project Structure
+
+| Directory | Location |
+|-----------|----------|
+| Source | src/ |
+| 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*