ai-first-cli 1.1.5 → 1.2.0

package/test-projects/laravel-app/README.md

@@ -0,0 +1,107 @@
+# Laravel Blog API
+
+A Laravel REST API for a blog application with user authentication, posts, comments, and categories.
+
+## Features
+
+- **User Management**: Authentication with Laravel Sanctum, user profiles
+- **Blog Posts**: CRUD operations with publishing workflow
+- **Comments**: Nested comments on posts
+- **Categories**: Organize posts by categories
+- **REST API**: Full REST API with Laravel
+- **Authentication**: Token-based authentication
+
+## Project Structure
+
+```
+laravel-app/
+├── app/
+│   ├── Http/
+│   │   └── Controllers/
+│   │       └── Api/         # API Controllers
+│   └── Models/              # Eloquent Models
+│       ├── Post.php
+│       ├── Comment.php
+│       ├── Category.php
+│       └── User.php
+├── routes/
+│   └── api.php              # API Routes
+├── config/                  # Configuration
+└── composer.json
+```
+
+## Models
+
+### Post
+- title, content, slug, published status
+- Relationships: user, comments, categories
+- Scopes: published(), drafts()
+- Methods: publish(), unpublish()
+
+### Comment
+- content, post_id, user_id, parent_id (for nested)
+- Relationships: post, user, parent
+
+### Category
+- name, slug, description
+- Relationships: posts
+
+### User
+- name, email, bio, avatar, social links
+- Relationships: posts, comments
+- Methods: isAdmin(), publishedPostsCount()
+
+## API Endpoints
+
+### Posts
+- `GET /api/posts` - List posts (filter by published, category, search)
+- `POST /api/posts` - Create post
+- `GET /api/posts/{post}` - Get single post
+- `PUT /api/posts/{post}` - Update post
+- `DELETE /api/posts/{post}` - Delete post
+- `POST /api/posts/{post}/publish` - Publish post
+- `POST /api/posts/{post}/unpublish` - Unpublish post
+- `GET /api/my-posts` - Get current user's posts
+
+### Categories
+- `GET /api/categories` - List categories
+- `POST /api/categories` - Create category
+- `GET /api/categories/{category}` - Get category
+- `GET /api/categories/{category}/posts` - Get posts in category
+
+### Comments
+- `GET /api/posts/{post}/comments` - Get post comments
+- `POST /api/comments` - Create comment
+- `DELETE /api/comments/{comment}` - Delete comment
+
+## Setup
+
+```bash
+# Install dependencies
+composer install
+
+# Copy environment file
+cp .env.example .env
+
+# Generate application key
+php artisan key:generate
+
+# Run migrations
+php artisan migrate
+
+# Run server
+php artisan serve
+```
+
+## Testing with ai-first
+
+```bash
+# Generate AI context
+ai-first init --root laravel-app
+
+# Generate repository map
+ai-first map --root laravel-app
+
+# Generate SQLite index
+ai-first index --root laravel-app
+```

package/test-projects/laravel-app/ai-context/ai_context.md

@@ -0,0 +1,97 @@
+# AI Context
+
+> This file provides a comprehensive overview of the repository for AI coding assistants.
+
+---
+
+## Quick Overview
+
+- **Pattern**: Flat / Simple Structure
+- **Languages**: Markdown, JSON, PHP
+- **Frameworks**: None
+- **Total Files**: 39
+
+---
+
+## 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, PHP
+
+**Package Managers**: Composer
+
+---
+
+## Architecture
+
+## Architectural Pattern
+**Primary**: Flat / Simple Structure
+
+## Layers Identified
+- Application
+
+## Key Modules
+| Module | Responsibility |
+|--------|----------------|
+| `README.md` | Contains 0 files |
+| `ai` | Contains 27 files |
+| `app` | Contains 8 files |
+| `bootstrap` | Contains 1 files |
+| `composer.json` | Contains 0 files |
+| `routes` | API endpoints and request handling |
+
+
+---
+
+## Key Entrypoints
+
+---
+
+## Code Conventions
+
+## Naming Conventions
+- **Files**: PascalCase
+
+## Project Structure
+
+## Code Style
+- **Semicolons**: Required
+
+
+---
+
+## AI Rules
+
+- Language: Use Markdown, JSON, PHP
+- Architecture: Follow Flat / Simple Structure pattern
+- File naming: PascalCase
+
+---
+
+## 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/laravel-app/ai-context/ai_rules.md

@@ -0,0 +1,47 @@
+# AI Rules
+
+> Guidelines for AI assistants working on this project
+
+---
+
+## Guidelines
+
+- Language: Use Markdown, JSON, PHP
+- Architecture: Follow Flat / Simple Structure pattern
+- File naming: PascalCase
+
+## Patterns
+
+- Layer structure: application
+
+## Constraints
+
+- Always use semicolons
+
+---
+
+## Quick Reference
+
+| Category | Value |
+|----------|-------|
+| Language | Markdown, JSON, PHP |
+| Framework | N/A |
+| Architecture | Flat / Simple Structure |
+| Naming | PascalCase |
+| 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/laravel-app/ai-context/architecture.md

@@ -0,0 +1,60 @@
+# Architecture
+
+## Architectural Pattern
+**Primary**: Flat / Simple Structure
+
+## Layers Identified
+- Application
+
+## Key Modules
+| Module | Responsibility |
+|--------|----------------|
+| `README.md` | Contains 0 files |
+| `ai` | Contains 27 files |
+| `app` | Contains 8 files |
+| `bootstrap` | Contains 1 files |
+| `composer.json` | Contains 0 files |
+| `routes` | API endpoints and request handling |
+
+
+## Module Details
+
+### README.md
+- **Path**: `README.md`
+- **Responsibility**: Contains 0 files
+
+
+### ai
+- **Path**: `ai`
+- **Responsibility**: Contains 27 files
+
+
+### app
+- **Path**: `app`
+- **Responsibility**: Contains 8 files
+
+
+### bootstrap
+- **Path**: `bootstrap`
+- **Responsibility**: Contains 1 files
+
+
+### composer.json
+- **Path**: `composer.json`
+- **Responsibility**: Contains 0 files
+
+
+### routes
+- **Path**: `routes`
+- **Responsibility**: API endpoints and request handling
+
+
+
+## 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/laravel-app/ai-context/cache.json

@@ -0,0 +1,161 @@
+{
+  "files": {
+    "README.md": {
+      "hash": "63be1b116847a4eacdb95be2aeab72c2",
+      "mtime": 1773847786371.1416
+    },
+    "ai/ai_context.md": {
+      "hash": "d86085a2b3eef3cc32c82e7ce97a97f0",
+      "mtime": 1773861711501.377
+    },
+    "ai/ai_rules.md": {
+      "hash": "5af221d928c5336c36d50512370227e3",
+      "mtime": 1773861711501.377
+    },
+    "ai/architecture.md": {
+      "hash": "975b4cc2773637c327c10fb1c7c488b1",
+      "mtime": 1773861711496.377
+    },
+    "ai/cache.json": {
+      "hash": "b753a30235e999795838c0d5cb154c66",
+      "mtime": 1773854929730.0337
+    },
+    "ai/context/features/app.json": {
+      "hash": "48ed0274a6a81b1c50955d402b3c2695",
+      "mtime": 1773861711503.377
+    },
+    "ai/context/flows/category.json": {
+      "hash": "437bcbd406d6d1288bd16213b6be4767",
+      "mtime": 1773861711503.377
+    },
+    "ai/context/flows/comment.json": {
+      "hash": "c2ebad5e63035bae2fde39e9f863e9cb",
+      "mtime": 1773861711503.377
+    },
+    "ai/context/flows/post.json": {
+      "hash": "f704d1cdb7823ec237964b578e9935b7",
+      "mtime": 1773861711503.377
+    },
+    "ai/context/flows/unnamed.json": {
+      "hash": "0d3ba6968f125bdddd28f7b908d4c9e0",
+      "mtime": 1773854736911.5452
+    },
+    "ai/conventions.md": {
+      "hash": "d11ac646a8916e3c6cc376f610368317",
+      "mtime": 1773861711498.377
+    },
+    "ai/dependencies.json": {
+      "hash": "038f80a99cbcc45991786b645398758e",
+      "mtime": 1773861711500.377
+    },
+    "ai/entrypoints.md": {
+      "hash": "34c8965a66697d9f1d428bb0904f5d8d",
+      "mtime": 1773861711497.377
+    },
+    "ai/files.json": {
+      "hash": "99914b932bd37a50b983c5e7c90ae93b",
+      "mtime": 1773861711587.3784
+    },
+    "ai/graph/module-graph.json": {
+      "hash": "08886f9cf775a3e58668f9c166b6f1ae",
+      "mtime": 1773861711581.3782
+    },
+    "ai/graph/symbol-graph.json": {
+      "hash": "79a11e66d1c9ebdbec716c31b9eb11db",
+      "mtime": 1773861711587.3784
+    },
+    "ai/graph/symbol-references.json": {
+      "hash": "99914b932bd37a50b983c5e7c90ae93b",
+      "mtime": 1773861711587.3784
+    },
+    "ai/index-state.json": {
+      "hash": "e7da95c458fbcbf04c7d84fc58575b42",
+      "mtime": 1773854929730.0337
+    },
+    "ai/modules.json": {
+      "hash": "2a7554702c3a5bcd823e4c634f012bb7",
+      "mtime": 1773861711572.3782
+    },
+    "ai/project.json": {
+      "hash": "be6566712acac8596c31c67859b10b67",
+      "mtime": 1773861711504.377
+    },
+    "ai/repo-map.json": {
+      "hash": "51544ee73ec58dc7f97b3a744757c4b6",
+      "mtime": 1773861711573.3782
+    },
+    "ai/repo_map.json": {
+      "hash": "f47a48aa19e41f4511993fad9befd33a",
+      "mtime": 1773861711494.377
+    },
+    "ai/repo_map.md": {
+      "hash": "3eb00bcd4302149b347a5007060b9929",
+      "mtime": 1773861711494.377
+    },
+    "ai/schema.json": {
+      "hash": "9b5cbdb447d61923413f6a64d7be0935",
+      "mtime": 1773861711503.377
+    },
+    "ai/summary.md": {
+      "hash": "af28a79156d8952da4b7c3970375a4db",
+      "mtime": 1773861711495.377
+    },
+    "ai/symbols.json": {
+      "hash": "6edde050dc3089a9e15bf3934226a7c4",
+      "mtime": 1773861711499.377
+    },
+    "ai/tech_stack.md": {
+      "hash": "698c9093c45a5cd2a2d6433067ee212a",
+      "mtime": 1773861711497.377
+    },
+    "ai/tools.json": {
+      "hash": "b1356e52c74e9b3b6a0d397b790a4968",
+      "mtime": 1773861711504.377
+    },
+    "app/Http/Controllers/Api/CategoryController.php": {
+      "hash": "eae63919c19317d673da75fae862ac1b",
+      "mtime": 1773847799280.3206
+    },
+    "app/Http/Controllers/Api/CommentController.php": {
+      "hash": "6dac8cef07f04ac0b0f20d76f4ca8348",
+      "mtime": 1773847807128.4294
+    },
+    "app/Http/Controllers/Api/PostController.php": {
+      "hash": "105dfc4a6f054cd19e4e1b14453c02ac",
+      "mtime": 1773847736086.444
+    },
+    "app/Http/Controllers/Controller.php": {
+      "hash": "42517d7dc7e3d0d3045b06ed842b565e",
+      "mtime": 1773847748755.6199
+    },
+    "app/Models/Category.php": {
+      "hash": "8982d52ddaad742bd03abfe7ee89cf5c",
+      "mtime": 1773847700804.955
+    },
+    "app/Models/Comment.php": {
+      "hash": "9efa05310b8bc1ca407c4db0aaf191f5",
+      "mtime": 1773847664829.4568
+    },
+    "app/Models/Post.php": {
+      "hash": "235a49b0fb8acb6d27ad0a76f9e67e46",
+      "mtime": 1773847648272.2275
+    },
+    "app/Models/User.php": {
+      "hash": "20cc08b187ba186031da18582a03c9a9",
+      "mtime": 1773847685326.7407
+    },
+    "bootstrap/app.php": {
+      "hash": "9ce9c023ef044aa0246244f18202bd9e",
+      "mtime": 1773847620203.8389
+    },
+    "composer.json": {
+      "hash": "1fd162ecf419a1aa7a24e660429335ee",
+      "mtime": 1773847763470.8237
+    },
+    "routes/api.php": {
+      "hash": "2ce87617f3fee458e3e5fda64a536495",
+      "mtime": 1773847757081.7354
+    }
+  },
+  "lastIndexed": "2026-03-18T19:21:51.588Z"
+}

package/test-projects/laravel-app/ai-context/context/features/app.json

@@ -0,0 +1,21 @@
+{
+  "name": "app",
+  "path": "app",
+  "files": [
+    "app/Http/Controllers/Api/CategoryController.php",
+    "app/Http/Controllers/Api/CommentController.php",
+    "app/Http/Controllers/Api/PostController.php",
+    "app/Http/Controllers/Controller.php",
+    "app/Models/Category.php",
+    "app/Models/Comment.php",
+    "app/Models/Post.php",
+    "app/Models/User.php"
+  ],
+  "entrypoints": [
+    "app/Http/Controllers/Api/CategoryController.php",
+    "app/Http/Controllers/Api/CommentController.php",
+    "app/Http/Controllers/Api/PostController.php",
+    "app/Http/Controllers/Controller.php"
+  ],
+  "dependencies": []
+}

package/test-projects/laravel-app/ai-context/context/flows/.json

@@ -0,0 +1,9 @@
+{
+  "name": "",
+  "entrypoint": "app/Http/Controllers/Controller.php",
+  "files": [
+    "app/Http/Controllers/Controller.php"
+  ],
+  "depth": 0,
+  "layers": []
+}

package/test-projects/laravel-app/ai-context/context/flows/category.json

@@ -0,0 +1,12 @@
+{
+  "name": "category",
+  "entrypoint": "app/Http/Controllers/Api/CategoryController.php",
+  "files": [
+    "app/Http/Controllers/Api/CategoryController.php",
+    "app/Models/Category.php"
+  ],
+  "depth": 1,
+  "layers": [
+    "api"
+  ]
+}

package/test-projects/laravel-app/ai-context/context/flows/comment.json

@@ -0,0 +1,12 @@
+{
+  "name": "comment",
+  "entrypoint": "app/Http/Controllers/Api/CommentController.php",
+  "files": [
+    "app/Http/Controllers/Api/CommentController.php",
+    "app/Models/Comment.php"
+  ],
+  "depth": 1,
+  "layers": [
+    "api"
+  ]
+}

package/test-projects/laravel-app/ai-context/context/flows/post.json

@@ -0,0 +1,12 @@
+{
+  "name": "post",
+  "entrypoint": "app/Http/Controllers/Api/PostController.php",
+  "files": [
+    "app/Http/Controllers/Api/PostController.php",
+    "app/Models/Post.php"
+  ],
+  "depth": 1,
+  "layers": [
+    "api"
+  ]
+}

package/test-projects/laravel-app/ai-context/context/flows/unnamed.json

@@ -0,0 +1,9 @@
+{
+  "name": "",
+  "entrypoint": "app/Http/Controllers/Controller.php",
+  "files": [
+    "app/Http/Controllers/Controller.php"
+  ],
+  "depth": 0,
+  "layers": []
+}

package/test-projects/laravel-app/ai-context/conventions.md

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

@@ -0,0 +1,6 @@
+{
+  "totalDependencies": 0,
+  "totalModules": 0,
+  "dependencies": [],
+  "byFile": {}
+}

package/test-projects/laravel-app/ai-context/entrypoints.md

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