ai-first-cli 1.1.5 → 1.2.0

package/test-projects/flask-app/.ai-dev/repo_map.json

@@ -0,0 +1,400 @@
+{
+  "generated": "2026-03-18T19:21:50.770Z",
+  "totalFiles": 38,
+  "structure": {
+    "README.md": {
+      "type": "file",
+      "extension": "md"
+    },
+    "ai": {
+      "type": "directory",
+      "children": {
+        "ai_context.md": {
+          "type": "file",
+          "extension": "md"
+        },
+        "ai_rules.md": {
+          "type": "file",
+          "extension": "md"
+        },
+        "architecture.md": {
+          "type": "file",
+          "extension": "md"
+        },
+        "cache.json": {
+          "type": "file",
+          "extension": "json"
+        },
+        "context": {
+          "type": "directory",
+          "children": {
+            "features": {
+              "type": "directory",
+              "children": {
+                "app.json": {
+                  "type": "file",
+                  "extension": "json"
+                }
+              }
+            },
+            "flows": {
+              "type": "directory",
+              "children": {
+                "routes.json": {
+                  "type": "file",
+                  "extension": "json"
+                }
+              }
+            }
+          }
+        },
+        "conventions.md": {
+          "type": "file",
+          "extension": "md"
+        },
+        "dependencies.json": {
+          "type": "file",
+          "extension": "json"
+        },
+        "entrypoints.md": {
+          "type": "file",
+          "extension": "md"
+        },
+        "files.json": {
+          "type": "file",
+          "extension": "json"
+        },
+        "graph": {
+          "type": "directory",
+          "children": {
+            "module-graph.json": {
+              "type": "file",
+              "extension": "json"
+            },
+            "symbol-graph.json": {
+              "type": "file",
+              "extension": "json"
+            },
+            "symbol-references.json": {
+              "type": "file",
+              "extension": "json"
+            }
+          }
+        },
+        "index-state.json": {
+          "type": "file",
+          "extension": "json"
+        },
+        "modules.json": {
+          "type": "file",
+          "extension": "json"
+        },
+        "project.json": {
+          "type": "file",
+          "extension": "json"
+        },
+        "repo-map.json": {
+          "type": "file",
+          "extension": "json"
+        },
+        "repo_map.json": {
+          "type": "file",
+          "extension": "json"
+        },
+        "repo_map.md": {
+          "type": "file",
+          "extension": "md"
+        },
+        "schema.json": {
+          "type": "file",
+          "extension": "json"
+        },
+        "summary.md": {
+          "type": "file",
+          "extension": "md"
+        },
+        "symbols.json": {
+          "type": "file",
+          "extension": "json"
+        },
+        "tech_stack.md": {
+          "type": "file",
+          "extension": "md"
+        },
+        "tools.json": {
+          "type": "file",
+          "extension": "json"
+        }
+      }
+    },
+    "app": {
+      "type": "directory",
+      "children": {
+        "__init__.py": {
+          "type": "file",
+          "extension": "py"
+        },
+        "api": {
+          "type": "directory",
+          "children": {
+            "__init__.py": {
+              "type": "file",
+              "extension": "py"
+            },
+            "routes.py": {
+              "type": "file",
+              "extension": "py"
+            }
+          }
+        },
+        "auth": {
+          "type": "directory",
+          "children": {
+            "__init__.py": {
+              "type": "file",
+              "extension": "py"
+            },
+            "forms.py": {
+              "type": "file",
+              "extension": "py"
+            },
+            "routes.py": {
+              "type": "file",
+              "extension": "py"
+            }
+          }
+        },
+        "blog": {
+          "type": "directory",
+          "children": {
+            "__init__.py": {
+              "type": "file",
+              "extension": "py"
+            },
+            "forms.py": {
+              "type": "file",
+              "extension": "py"
+            },
+            "routes.py": {
+              "type": "file",
+              "extension": "py"
+            }
+          }
+        },
+        "main": {
+          "type": "directory",
+          "children": {
+            "__init__.py": {
+              "type": "file",
+              "extension": "py"
+            },
+            "routes.py": {
+              "type": "file",
+              "extension": "py"
+            }
+          }
+        },
+        "models.py": {
+          "type": "file",
+          "extension": "py"
+        }
+      }
+    },
+    "config.py": {
+      "type": "file",
+      "extension": "py"
+    }
+  },
+  "files": [
+    {
+      "path": "README.md",
+      "name": "README.md",
+      "extension": "md"
+    },
+    {
+      "path": "ai/ai_context.md",
+      "name": "ai_context.md",
+      "extension": "md"
+    },
+    {
+      "path": "ai/ai_rules.md",
+      "name": "ai_rules.md",
+      "extension": "md"
+    },
+    {
+      "path": "ai/architecture.md",
+      "name": "architecture.md",
+      "extension": "md"
+    },
+    {
+      "path": "ai/cache.json",
+      "name": "cache.json",
+      "extension": "json"
+    },
+    {
+      "path": "ai/context/features/app.json",
+      "name": "app.json",
+      "extension": "json"
+    },
+    {
+      "path": "ai/context/flows/routes.json",
+      "name": "routes.json",
+      "extension": "json"
+    },
+    {
+      "path": "ai/conventions.md",
+      "name": "conventions.md",
+      "extension": "md"
+    },
+    {
+      "path": "ai/dependencies.json",
+      "name": "dependencies.json",
+      "extension": "json"
+    },
+    {
+      "path": "ai/entrypoints.md",
+      "name": "entrypoints.md",
+      "extension": "md"
+    },
+    {
+      "path": "ai/files.json",
+      "name": "files.json",
+      "extension": "json"
+    },
+    {
+      "path": "ai/graph/module-graph.json",
+      "name": "module-graph.json",
+      "extension": "json"
+    },
+    {
+      "path": "ai/graph/symbol-graph.json",
+      "name": "symbol-graph.json",
+      "extension": "json"
+    },
+    {
+      "path": "ai/graph/symbol-references.json",
+      "name": "symbol-references.json",
+      "extension": "json"
+    },
+    {
+      "path": "ai/index-state.json",
+      "name": "index-state.json",
+      "extension": "json"
+    },
+    {
+      "path": "ai/modules.json",
+      "name": "modules.json",
+      "extension": "json"
+    },
+    {
+      "path": "ai/project.json",
+      "name": "project.json",
+      "extension": "json"
+    },
+    {
+      "path": "ai/repo-map.json",
+      "name": "repo-map.json",
+      "extension": "json"
+    },
+    {
+      "path": "ai/repo_map.json",
+      "name": "repo_map.json",
+      "extension": "json"
+    },
+    {
+      "path": "ai/repo_map.md",
+      "name": "repo_map.md",
+      "extension": "md"
+    },
+    {
+      "path": "ai/schema.json",
+      "name": "schema.json",
+      "extension": "json"
+    },
+    {
+      "path": "ai/summary.md",
+      "name": "summary.md",
+      "extension": "md"
+    },
+    {
+      "path": "ai/symbols.json",
+      "name": "symbols.json",
+      "extension": "json"
+    },
+    {
+      "path": "ai/tech_stack.md",
+      "name": "tech_stack.md",
+      "extension": "md"
+    },
+    {
+      "path": "ai/tools.json",
+      "name": "tools.json",
+      "extension": "json"
+    },
+    {
+      "path": "app/__init__.py",
+      "name": "__init__.py",
+      "extension": "py"
+    },
+    {
+      "path": "app/api/__init__.py",
+      "name": "__init__.py",
+      "extension": "py"
+    },
+    {
+      "path": "app/api/routes.py",
+      "name": "routes.py",
+      "extension": "py"
+    },
+    {
+      "path": "app/auth/__init__.py",
+      "name": "__init__.py",
+      "extension": "py"
+    },
+    {
+      "path": "app/auth/forms.py",
+      "name": "forms.py",
+      "extension": "py"
+    },
+    {
+      "path": "app/auth/routes.py",
+      "name": "routes.py",
+      "extension": "py"
+    },
+    {
+      "path": "app/blog/__init__.py",
+      "name": "__init__.py",
+      "extension": "py"
+    },
+    {
+      "path": "app/blog/forms.py",
+      "name": "forms.py",
+      "extension": "py"
+    },
+    {
+      "path": "app/blog/routes.py",
+      "name": "routes.py",
+      "extension": "py"
+    },
+    {
+      "path": "app/main/__init__.py",
+      "name": "__init__.py",
+      "extension": "py"
+    },
+    {
+      "path": "app/main/routes.py",
+      "name": "routes.py",
+      "extension": "py"
+    },
+    {
+      "path": "app/models.py",
+      "name": "models.py",
+      "extension": "py"
+    },
+    {
+      "path": "config.py",
+      "name": "config.py",
+      "extension": "py"
+    }
+  ]
+}

package/test-projects/flask-app/.ai-dev/repo_map.md

@@ -0,0 +1,98 @@
+# Repository Map
+## README.md
+  - README.md
+
+## ai
+  - ai_context.md
+  - ai_rules.md
+  - app.json
+  - architecture.md
+  - 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
+  - routes.json
+  - schema.json
+  - summary.md
+  - symbol-graph.json
+  - symbol-references.json
+  - symbols.json
+  - tech_stack.md
+  - tools.json
+
+## app
+  - __init__.py
+  - __init__.py
+  - __init__.py
+  - __init__.py
+  - __init__.py
+  - forms.py
+  - forms.py
+  - models.py
+  - routes.py
+  - routes.py
+  - routes.py
+  - routes.py
+
+## config.py
+  - config.py
+
+
+
+# Repository Structure (Tree View)
+├── ai/
+│   ├── context/
+│   │   ├── features/
+│   │   │   └── app.json
+│   │   └── flows/
+│   │       └── routes.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
+├── app/
+│   ├── api/
+│   │   ├── __init__.py
+│   │   └── routes.py
+│   ├── auth/
+│   │   ├── __init__.py
+│   │   ├── forms.py
+│   │   └── routes.py
+│   ├── blog/
+│   │   ├── __init__.py
+│   │   ├── forms.py
+│   │   └── routes.py
+│   ├── main/
+│   │   ├── __init__.py
+│   │   └── routes.py
+│   ├── __init__.py
+│   └── models.py
+├── README.md
+└── config.py

package/test-projects/flask-app/.ai-dev/schema.json

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

package/test-projects/flask-app/.ai-dev/summary.md

@@ -0,0 +1,13 @@
+# Repository Summary
+- **Total files**: 38
+
+## Files by Extension
+  - .json: 16
+  - .md: 9
+  - .py: 13
+
+## Files by Directory
+  - README.md: 1
+  - ai: 24
+  - app: 12
+  - config.py: 1

package/test-projects/flask-app/.ai-dev/symbols.json

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

package/test-projects/flask-app/.ai-dev/tech_stack.md

@@ -0,0 +1,32 @@
+# Technology Stack
+
+**Languages**: Markdown, JSON, Python
+
+## Languages
+- Markdown
+- JSON
+- Python
+
+## Frameworks
+- None detected
+
+## Key Libraries
+- None detected
+
+## Development Tools
+- None detected
+
+## Package Managers
+- None detected
+
+## Testing
+- None detected
+
+## Linters
+- None detected
+
+## Formatters
+- None detected
+
+---
+*Generated by ai-first*

package/test-projects/flask-app/.ai-dev/tools.json

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

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

@@ -0,0 +1,129 @@
+# Flask Blog
+
+A simple but complete blog application built with Flask.
+
+## Features
+
+- **User Authentication**: Registration, login, logout with Flask-Login
+- **Blog Posts**: Create, edit, delete posts with publishing workflow
+- **Categories & Tags**: Organize posts
+- **Comments**: Add comments to posts
+- **Search**: Full-text search
+- **Responsive Design**: Bootstrap 5
+- **REST API**: JSON API endpoints
+
+## Project Structure
+
+```
+flask-app/
+├── app/
+│   ├── __init__.py          # Application factory
+│   ├── models.py            # Database models
+│   ├── config.py            # Configuration
+│   ├── main/                # Main blueprint
+│   │   ├── __init__.py
+│   │   └── routes.py
+│   ├── auth/                # Auth blueprint
+│   │   ├── __init__.py
+│   │   ├── routes.py
+│   │   └── forms.py
+│   ├── blog/                # Blog blueprint
+│   │   ├── __init__.py
+│   │   ├── routes.py
+│   │   └── forms.py
+│   └── api/                 # API blueprint
+│       ├── __init__.py
+│       └── routes.py
+├── migrations/              # Database migrations
+└── requirements.txt
+```
+
+## Models
+
+### User
+- Authentication with Flask-Login
+- Profile information
+- One-to-many: posts, comments
+
+### Post
+- Title, content, slug, summary
+- Publishing workflow (draft → published)
+- Categories and tags
+- View counter
+- One-to-many: comments
+
+### Comment
+- Content
+- Approval system
+- Replies (self-referential)
+
+### Category
+- Name, slug, description
+- One-to-many: posts
+
+### Tag
+- Name, slug
+- Many-to-many: posts
+
+## Routes
+
+### Main
+- `/` - Home page with posts
+- `/about` - About page
+- `/post/<slug>` - Single post
+- `/category/<slug>` - Posts by category
+- `/tag/<slug>` - Posts by tag
+- `/search?q=query` - Search posts
+
+### Auth
+- `/auth/login` - Login
+- `/auth/register` - Registration
+- `/auth/logout` - Logout
+- `/auth/profile` - User profile
+
+### Blog
+- `/blog/create` - Create post
+- `/blog/<slug>/edit` - Edit post
+- `/blog/<slug>/delete` - Delete post
+- `/blog/<slug>/comment` - Add comment
+
+### API
+- `/api/v1/posts` - List posts (JSON)
+- `/api/v1/posts/<slug>` - Single post (JSON)
+- `/api/v1/categories` - List categories (JSON)
+- `/api/v1/tags` - List tags (JSON)
+
+## Setup
+
+```bash
+# Install dependencies
+pip install -r requirements.txt
+
+# Set environment variables
+export FLASK_APP=run.py
+export FLASK_ENV=development
+
+# Initialize database
+flask db init
+flask db migrate -m "Initial migration"
+flask db upgrade
+
+# Run the application
+flask run
+
+# Or
+python run.py
+```
+
+## Testing with ai-first
+
+```bash
+# Generate AI context
+ai-first init --root flask-app
+
+# Generate repository map
+ai-first map --root flask-app
+
+# Generate SQLite index
+ai-first index --root flask-app
+```