ai-first-cli 1.1.5 → 1.2.0

package/test-projects/react-app/{ai/repo-map.json → .ai-dev/repo_map.json}

@@ -1,6 +1,6 @@
 {
-  "generated": "2026-03-18T01:15:17.625Z",
-  "totalFiles": 28,
+  "generated": "2026-03-18T19:21:54.378Z",
+  "totalFiles": 37,
   "structure": {
     "ai": {
       "type": "directory",
@@ -17,6 +17,10 @@
           "type": "file",
           "extension": "md"
         },
+        "cache.json": {
+          "type": "file",
+          "extension": "json"
+        },
         "context": {
           "type": "directory",
           "children": {
@@ -32,6 +36,10 @@
             "flows": {
               "type": "directory",
               "children": {
+                "UsersPage.json": {
+                  "type": "file",
+                  "extension": "json"
+                },
                 "dashboard.json": {
                   "type": "file",
                   "extension": "json"
@@ -60,6 +68,35 @@
           "type": "file",
           "extension": "md"
         },
+        "files.json": {
+          "type": "file",
+          "extension": "json"
+        },
+        "graph": {
+          "type": "directory",
+          "children": {
+            "knowledge-graph.json": {
+              "type": "file",
+              "extension": "json"
+            },
+            "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"
@@ -68,6 +105,10 @@
           "type": "file",
           "extension": "json"
         },
+        "repo-map.json": {
+          "type": "file",
+          "extension": "json"
+        },
         "repo_map.json": {
           "type": "file",
           "extension": "json"
@@ -176,11 +217,21 @@
       "name": "architecture.md",
       "extension": "md"
     },
+    {
+      "path": "ai/cache.json",
+      "name": "cache.json",
+      "extension": "json"
+    },
     {
       "path": "ai/context/features/src.json",
       "name": "src.json",
       "extension": "json"
     },
+    {
+      "path": "ai/context/flows/UsersPage.json",
+      "name": "UsersPage.json",
+      "extension": "json"
+    },
     {
       "path": "ai/context/flows/dashboard.json",
       "name": "dashboard.json",
@@ -211,6 +262,36 @@
       "name": "entrypoints.md",
       "extension": "md"
     },
+    {
+      "path": "ai/files.json",
+      "name": "files.json",
+      "extension": "json"
+    },
+    {
+      "path": "ai/graph/knowledge-graph.json",
+      "name": "knowledge-graph.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",
@@ -221,6 +302,11 @@
       "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",

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

@@ -0,0 +1,94 @@
+# Repository Map
+## ai
+  - ai_context.md
+  - ai_rules.md
+  - architecture.md
+  - cache.json
+  - conventions.md
+  - dashboard.json
+  - dependencies.json
+  - entrypoints.md
+  - files.json
+  - index-state.json
+  - knowledge-graph.json
+  - login.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
+  - UsersPage.json
+
+## package.json
+  - package.json
+
+## src
+  - App.tsx
+  - AuthContext.tsx
+  - DashboardPage.tsx
+  - LoginPage.tsx
+  - main.tsx
+  - useAuth.ts
+  - userService.ts
+  - UsersPage.tsx
+
+
+
+# Repository Structure (Tree View)
+├── ai/
+│   ├── context/
+│   │   ├── features/
+│   │   │   └── src.json
+│   │   └── flows/
+│   │       ├── UsersPage.json
+│   │       ├── dashboard.json
+│   │       ├── login.json
+│   │       └── users.json
+│   ├── graph/
+│   │   ├── knowledge-graph.json
+│   │   ├── 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/
+│   ├── context/
+│   │   └── AuthContext.tsx
+│   ├── hooks/
+│   │   └── useAuth.ts
+│   ├── pages/
+│   │   ├── DashboardPage.tsx
+│   │   ├── LoginPage.tsx
+│   │   └── UsersPage.tsx
+│   ├── services/
+│   │   └── userService.ts
+│   ├── App.tsx
+│   └── main.tsx
+└── package.json

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

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

package/test-projects/react-app/{ai → .ai-dev}/summary.md

@@ -1,11 +1,13 @@
 # Repository Summary
-- **Total files**: 9
+- **Total files**: 37
 
 ## Files by Extension
-  - .json: 1
+  - .json: 21
+  - .md: 8
   - .ts: 2
   - .tsx: 6
 
 ## Files by Directory
+  - ai: 28
   - package.json: 1
   - src: 8

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

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

package/test-projects/react-app/{ai → .ai-dev}/tech_stack.md

@@ -1,12 +1,13 @@
 # Technology Stack
 
-**Languages**: JSON, TypeScript (React), TypeScript
+**Languages**: Markdown, JSON, TypeScript (React), TypeScript
 
 **Frameworks**: React, Next.js, Remix
 
 **Package Managers**: npm
 
 ## Languages
+- Markdown
 - JSON
 - TypeScript (React)
 - TypeScript

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

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

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

@@ -0,0 +1,96 @@
+# 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 (React), TypeScript
+- **Frameworks**: React, Next.js, Remix
+- **Total Files**: 37
+
+---
+
+## 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 (React), TypeScript
+
+**Frameworks**: React, Next.js, Remix
+
+**Package Managers**: npm
+
+---
+
+## Architecture
+
+## Architectural Pattern
+**Primary**: Flat / Simple Structure
+
+## Key Modules
+| Module | Responsibility |
+|--------|----------------|
+| `ai` | Contains 28 files |
+| `package.json` | Contains 0 files |
+| `src` | Contains 8 files |
+
+
+---
+
+## Key Entrypoints
+
+---
+
+## Code Conventions
+
+## Naming Conventions
+- **Files**: PascalCase
+
+## Project Structure
+- **Source**: src/
+
+## Code Style
+- **Semicolons**: Required
+
+
+---
+
+## AI Rules
+
+- Language: Use Markdown, JSON, TypeScript (React), TypeScript
+- Frameworks: React, Next.js, Remix
+- Architecture: Follow Flat / Simple Structure pattern
+- File naming: PascalCase
+- 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/react-app/ai-context/ai_rules.md

@@ -0,0 +1,49 @@
+# AI Rules
+
+> Guidelines for AI assistants working on this project
+
+---
+
+## Guidelines
+
+- Language: Use Markdown, JSON, TypeScript (React), TypeScript
+- Frameworks: React, Next.js, Remix
+- Architecture: Follow Flat / Simple Structure pattern
+- File naming: PascalCase
+- Source directory: src/
+
+## Patterns
+
+- Layer structure: 
+
+## Constraints
+
+- Always use semicolons
+
+---
+
+## Quick Reference
+
+| Category | Value |
+|----------|-------|
+| Language | Markdown, JSON, TypeScript (React), TypeScript |
+| Framework | React, Next.js, Remix |
+| 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/react-app/ai-context/architecture.md

@@ -0,0 +1,39 @@
+# Architecture
+
+## Architectural Pattern
+**Primary**: Flat / Simple Structure
+
+## Key Modules
+| Module | Responsibility |
+|--------|----------------|
+| `ai` | Contains 28 files |
+| `package.json` | Contains 0 files |
+| `src` | Contains 8 files |
+
+
+## Module Details
+
+### ai
+- **Path**: `ai`
+- **Responsibility**: Contains 28 files
+
+
+### package.json
+- **Path**: `package.json`
+- **Responsibility**: Contains 0 files
+
+
+### src
+- **Path**: `src`
+- **Responsibility**: Contains 8 files
+
+
+
+## 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/react-app/ai-context/cache.json

@@ -0,0 +1,153 @@
+{
+  "files": {
+    "ai/ai_context.md": {
+      "hash": "eabfa1d98bb53e148d668bdac5400380",
+      "mtime": 1773861714386.4226
+    },
+    "ai/ai_rules.md": {
+      "hash": "287d4eac88479556a1903587e35e0716",
+      "mtime": 1773861714386.4226
+    },
+    "ai/architecture.md": {
+      "hash": "d337210d84e646d3d493daddbbcb6393",
+      "mtime": 1773861714378.4226
+    },
+    "ai/cache.json": {
+      "hash": "c6773221d9b92c5e78a50d2f87b8f19c",
+      "mtime": 1773854929733.0337
+    },
+    "ai/context/features/src.json": {
+      "hash": "2d248c2486297a3db63103469fcb4d7b",
+      "mtime": 1773861714389.4226
+    },
+    "ai/context/flows/UsersPage.json": {
+      "hash": "9c80be1645cd69f5ad66d24ba46e8b85",
+      "mtime": 1773854929733.0337
+    },
+    "ai/context/flows/dashboard.json": {
+      "hash": "0fbc56b67033373bb6157659552c82d9",
+      "mtime": 1773861714389.4226
+    },
+    "ai/context/flows/login.json": {
+      "hash": "9311af687ac6a30df3de225f1e18f879",
+      "mtime": 1773861714389.4226
+    },
+    "ai/context/flows/users.json": {
+      "hash": "b5ee48090ea670d1afe36d1fa13500b7",
+      "mtime": 1773861714389.4226
+    },
+    "ai/conventions.md": {
+      "hash": "cf36cf015f6c293ebf89ec2c7756bb57",
+      "mtime": 1773861714381.4226
+    },
+    "ai/dependencies.json": {
+      "hash": "6a39a4044a4a0ea07350ea8892172705",
+      "mtime": 1773861714385.4226
+    },
+    "ai/entrypoints.md": {
+      "hash": "34c8965a66697d9f1d428bb0904f5d8d",
+      "mtime": 1773861714380.4226
+    },
+    "ai/files.json": {
+      "hash": "48ab393f8b9df782ab081eeb57c5147d",
+      "mtime": 1773861714474.424
+    },
+    "ai/graph/knowledge-graph.json": {
+      "hash": "fa879b4bb2bbdf4ade73108745039e7b",
+      "mtime": 1773796549543.294
+    },
+    "ai/graph/module-graph.json": {
+      "hash": "3599338f9de3043664fde3c5ca8bc1ca",
+      "mtime": 1773861714464.4238
+    },
+    "ai/graph/symbol-graph.json": {
+      "hash": "cdd01d0b3bdb6f26648460fa8d33b069",
+      "mtime": 1773861714473.424
+    },
+    "ai/graph/symbol-references.json": {
+      "hash": "a2ec09612e8db86fc410fc8b4755c07b",
+      "mtime": 1773861714473.424
+    },
+    "ai/index-state.json": {
+      "hash": "4c8940a512edb67a82dd9bd2aeafe1bb",
+      "mtime": 1773854833164.3127
+    },
+    "ai/modules.json": {
+      "hash": "c539e0624fa9a288ddfb14bd48b5587e",
+      "mtime": 1773861714461.4238
+    },
+    "ai/project.json": {
+      "hash": "80e040d1760d6963ac373a95bb7f637e",
+      "mtime": 1773861714389.4226
+    },
+    "ai/repo-map.json": {
+      "hash": "d34906e17c1fe7863bf3dc15e05d9e81",
+      "mtime": 1773861714462.4238
+    },
+    "ai/repo_map.json": {
+      "hash": "558556f14ae4b340bfb78a16a24a1fa6",
+      "mtime": 1773861714377.4224
+    },
+    "ai/repo_map.md": {
+      "hash": "59a0f2ba5b4f1c8e3b6f3e20072400f0",
+      "mtime": 1773861714377.4224
+    },
+    "ai/schema.json": {
+      "hash": "80ae1651845b2ab8e40bc22c5c1a3d3e",
+      "mtime": 1773861714389.4226
+    },
+    "ai/summary.md": {
+      "hash": "7534e4a1ea946d1e802e62764e4df734",
+      "mtime": 1773861714377.4224
+    },
+    "ai/symbols.json": {
+      "hash": "ad94b9b17ac8aee49fe27f0113994ceb",
+      "mtime": 1773861714383.4226
+    },
+    "ai/tech_stack.md": {
+      "hash": "755fb19ec271aaab4faf80151b0c9d3e",
+      "mtime": 1773861714380.4226
+    },
+    "ai/tools.json": {
+      "hash": "b1356e52c74e9b3b6a0d397b790a4968",
+      "mtime": 1773861714389.4226
+    },
+    "package.json": {
+      "hash": "12744c74a0278dc2edfb68294b9b9125",
+      "mtime": 1773777304827.265
+    },
+    "src/App.tsx": {
+      "hash": "1bd200aa3ea7b4e1175a07d0f26f8dc4",
+      "mtime": 1773777339360.6953
+    },
+    "src/context/AuthContext.tsx": {
+      "hash": "4113336d7e2eb6ac2b78cebe8464276e",
+      "mtime": 1773777350783.8386
+    },
+    "src/hooks/useAuth.ts": {
+      "hash": "036b7295855cbd8214eb4653954f10cc",
+      "mtime": 1773777417490.685
+    },
+    "src/main.tsx": {
+      "hash": "283000b4b4218c8dc8b4e634a70bbbe3",
+      "mtime": 1773777310472.335
+    },
+    "src/pages/DashboardPage.tsx": {
+      "hash": "4c9a9c8fc6a53db6bdbb4d0de6561baf",
+      "mtime": 1773777385566.278
+    },
+    "src/pages/LoginPage.tsx": {
+      "hash": "16a9451aafa3dd13e3c62b8816ab98d6",
+      "mtime": 1773777377789.1794
+    },
+    "src/pages/UsersPage.tsx": {
+      "hash": "e24caa3c7d598228c36600eb1ca95b30",
+      "mtime": 1773777394130.387
+    },
+    "src/services/userService.ts": {
+      "hash": "78df2c3240cd630cedb2095347616301",
+      "mtime": 1773777428144.8215
+    }
+  },
+  "lastIndexed": "2026-03-18T19:21:54.475Z"
+}

package/test-projects/react-app/ai-context/context/features/src.json

@@ -0,0 +1,18 @@
+{
+  "name": "src",
+  "path": "src",
+  "files": [
+    "src/App.tsx",
+    "src/context/AuthContext.tsx",
+    "src/hooks/useAuth.ts",
+    "src/main.tsx",
+    "src/pages/DashboardPage.tsx",
+    "src/pages/LoginPage.tsx",
+    "src/pages/UsersPage.tsx",
+    "src/services/userService.ts"
+  ],
+  "entrypoints": [
+    "src/services/userService.ts"
+  ],
+  "dependencies": []
+}

package/test-projects/react-app/ai-context/context/flows/UsersPage.json

@@ -0,0 +1,14 @@
+{
+  "name": "UsersPage",
+  "entrypoint": "src/pages/UsersPage.tsx",
+  "files": [
+    "src/pages/UsersPage.tsx",
+    "react",
+    "src/services/userService"
+  ],
+  "depth": 3,
+  "layers": [
+    "unknown",
+    "service"
+  ]
+}

package/test-projects/react-app/ai-context/context/flows/dashboard.json

@@ -0,0 +1,9 @@
+{
+  "name": "dashboard",
+  "entrypoint": "src/pages/DashboardPage.tsx",
+  "files": [
+    "src/pages/DashboardPage.tsx"
+  ],
+  "depth": 0,
+  "layers": []
+}

package/test-projects/react-app/ai-context/context/flows/login.json

@@ -0,0 +1,9 @@
+{
+  "name": "login",
+  "entrypoint": "src/pages/LoginPage.tsx",
+  "files": [
+    "src/pages/LoginPage.tsx"
+  ],
+  "depth": 0,
+  "layers": []
+}

package/test-projects/react-app/ai-context/context/flows/users.json

@@ -0,0 +1,9 @@
+{
+  "name": "users",
+  "entrypoint": "src/pages/UsersPage.tsx",
+  "files": [
+    "src/pages/UsersPage.tsx"
+  ],
+  "depth": 0,
+  "layers": []
+}